eventmq/docs, branch 0.4

Merge pull request #39 from com4/feature/status_subcommands

2017-05-05T23:30:27+00:00

Feature/status subcommands

Merge branch 'master' into 0.4

2017-04-05T23:55:18+00:00

Config refactor tweaks

2017-04-05T22:20:21+00:00

- Catch KeyboardInterrupt in the scripts and die gracefully
- Don't explicitly set `conf.section` in the devices. This is done during
  `load_settings_from_dict/file`.
- Add missing documentation
- Remove some old commented out code.
- Update the publisher code to use new settings
- Raise a value error when trying to load settings for an unknown section

Update docs copyright year

2017-04-05T20:31:44+00:00

Update settings_file documentation

2017-04-05T19:59:35+00:00

- restructure the Using EventMQ section into two subsections one for developers
  and the other for sysadmins.
- move the settings file documentation under the sysadmin guide
- update the settings file documentation to cover all possible settings.

Refactor eventmq configuration

2017-04-05T17:17:32+00:00

* Update config file loading. Each device will load the ``global`` section followed by it's own section of the provided config (router for emq-router, jobmanager for emq-jobmanager, etc)
* Allow configurations options to be set via command-line.

Backwards incompatible changes

* `emq-pubsub` has been renamed to `emq-publisher`
* Configuration: The name and section for the listening addresses has changed:
   * Job Manager: `WORKER_ADDR` is now `CONNECT_ADDR` in the `[jobmanager]` section
   * Job Manager: `WORKER_ADDR_DEFAULT` is now `CONNECT_ADDR_DEFAULT` in the `[jobmanager]` section
   * Job Manager: `WORKER_ADDR_FAILOVER` is now `CONNECT_ADDR_FAILOVER` in the `[jobmanager]` section
   * Publisher: `PUBLISHER_FRONTEND_ADDR` is not `FRONTEND_LISTEN_ADDR` in the `[publisher]` section
   * Publisher: `PUBLISHER_BACKEND_ADDR` is not `BACKEND_LISTEN_ADDR` in the `[publisher]` section
   * Router: `FRONTEND_ADDR` is now `FRONTEND_LISTEN_ADDR` in the `[router]` section
   * Router: `BACKEND_ADDR` is now `BACKEND_LISTEN_ADDR` in the `[router]` section
   * Scheduler: `SCHEDULER_ADDR` is now `CONNECT_ADDR` in the `[scheduler]` section
   * `RQ_HOST` is now `REDIS_HOST`
   * `RQ_PORT` is now `REDIS_PORT`
   * `RQ_DB` is now `REDIS_DB`
   * `RQ_PASSWORD` is now `REDIS_PASSWORD`
   * `ADMINISTRATIVE_ADDR` is now `ADMINISTRATIVE_LISTEN_ADDR` in each respective section
   * `CONNECT_ADDR_DEFAULT` has been removed from the `[jobmanager]` section. HA will be retooled and added back in the High Availability Milestone.
   * `CONNECT_ADDR_FAILOVER` has been removed from the `[jobmanager]` section. HA will be retooled and added back in the High Availability Milestone.
* Configuration: Command line options for emq-jobmanager
   * `--broker-addr` `-B` has been renamed to `--connect-addr` `-A`
   * `--jobs` has been renamed to `--concurrent-jobs`

fixes: #20

Refactor eventmq configuration management

2017-03-28T21:12:10+00:00

- Refactor each device's configuration loading. The global section will be
  loaded then the section for the app will overrite any sections.
- Defines ambiguous settings that cannot be defined globally. skip these
  settings and emit a warning if they are
- update eventmq.conf-dist to include comments and more of the settings that can
  be defined.
- Refactor some option names.
  * Job Manager: `WORKER_ADDR` is now `CONNECT_ADDR` in the `[jobmanager]`
    section
  * Job Manager: `WORKER_ADDR_DEFAULT` is now `CONNECT_ADDR_DEFAULT` in the
    `[jobmanager]` section
  * Job Manager: `WORKER_ADDR_FAILOVER` is now `CONNECT_ADDR_FAILOVER` in
    the `[jobmanager]` section
  * Publisher: `PUBLISHER_FRONTEND_ADDR` is not `FRONTEND_LISTEN_ADDR` in
    the `[publisher]` section
  * Publisher: `PUBLISHER_BACKEND_ADDR` is not `BACKEND_LISTEN_ADDR` in the
    `[publisher]` section
  * Router: `FRONTEND_ADDR` is now `FRONTEND_LISTEN_ADDR` in the
    `[router]` section
  * Router: `BACKEND_ADDR` is now `BACKEND_LISTEN_ADDR` in the `[router]`
    section
  * Scheduler: `SCHEDULER_ADDR` is now `CONNECT_ADDR` in the `[scheduler]`
    section
  * `RQ_HOST` is now `REDIS_HOST`
  * `RQ_PORT` is now `REDIS_PORT`
  * `RQ_DB` is now `REDIS_DB`
  * `RQ_PASSWORD` is now `REDIS_PASSWORD`
  * `ADMINISTRATIVE_ADDR` is now `ADMINISTRATIVE_LISTEN_ADDR` in each
    respective section

See also: #20

Update the router to use STATUS sub commands

2017-03-21T23:04:43+00:00

- Update the router to use STATUS subcommands. This commit refactors the
  SHOW_SCHEDULERS and SHOW_WORKERS (renamed to SHOW_MANAGERS) into a
  STATUS_COMMANDS constants class. These commands are now valid only during a
  STATUS command. The protocol has been updated to reflect these changes.

See also: #15

Update logic to handle empty strings, update docs

2017-03-14T19:24:40+00:00

Update links in the documentation

2017-02-22T22:10:52+00:00