Upgrading the Agent
Any agent version
0.2.0-2017.06.20-195307-UTC or later is going to default to the new format.
Here's an example old-style TOML config file:
#/etc/appcanary/agent.conf api_key = "<YOUR_TOKEN_HERE>" [[files]] process = "rpm -qa" [[files]] path = "/path/to/a/Gemfile.lock" [[files]] path = "/path/to/a/composer.lock"
And here's the same configuration in new-style YAML.
#/etc/appcanary/agent.yml api_key: "<YOUR_TOKEN_HERE>" watchers: - process: "rpm -qa" - file: "/path/to/a/Gemfile.lock" - file: "/path/to/a/composer.lock"
Besides being easier to edit and understand, this new configuration format was necessary to enable some new features. For more information on how to configure the agent, click here.
What do I need to do?
Luckily, almost nothing. On first boot, the agent will parse your old
/etc/appcanary/agent.conf, move it to
/etc/appcanary/agent.conf.deprecated, and put a new
/etc/appcanary/agent.yml file in its place
Manually, through the shell
If you're deploying the agent manually, you're good. Just make sure to make any future configuration changes to
Make sure that you upgrade the cookbook to at least version
Make sure that you upgrade the module to at least version
Make sure that you upgrade the playbook to at least version
If you're using a custom script, make sure it's using the YAML format described above.
If you have any questions or need any help upgrading or otherwise, please contact us at email@example.com