Installer

Running

Where the values used for --key and --app are from the Circonus API Tokens page.

remote

sudo -i
\curl -sSL "https://onestep.circonus.com/install" \
  | bash -s -- \
  --key ... \
  --app ...

local

curl -o cosi-install.sh "https://onestep.circonus.com/install"
sudo bash cosi-install.sh --key ... --app ...

or

curl -o cosi-install.sh "https://onestep.circonus.com/install"
chmod 700 cosi-install.sh
sudo ./cosi-install.sh --key ... --app ...

or

sudo rpm -ivh "https://onestep.circonus.com/install/rpm"
sudo /opt/circonus/cosi/bin/cosi-install.sh --key ... --app ...

Important note for NAT

Ensure the Circonus Broker will be able to connect, to the system being setup, on TCP port 2609. (e.g. An AWS security group.) Alternatively, use the --agent push cosi-install command line parameter (after --key and --app) to enable sending metrics to Circonus, or --agent reverse (recommended) to instruct NAD to establish a connection to the Broker and have the Broker begin requesting metrics through this reverse connection.

Note that the Play functionality in the Circonus UI is limited when metrics are being sent (pushed) from a system to a Circonus Broker rather than being actively requested(pulled) from the system by the Broker.

Information

1. /opt/circonus/cosi is the default cosi location.
2. /opt/circonus/cosi/bin contains cosi utilities, registration script, and circonus-nadpush script.
3. /opt/circonus/cosi/log/install.log - information on what the installer did. Useful for troubleshooting or as a record.
4. /opt/circonus/cosi/cache contains copies of the NAD package downloaded and the cosi utilities file downloaded.
5. /opt/circonus/cosi/etc contains configuration files for the cosi utilities which were generated by the installer.
6. /opt/circonus/cosi/registration contains all of the files created by the cosi registration utility.
   • template-* configuration templates retrieved from cosi-site.
   • config-* configurations cosi registration utility generated for this specific host using the templates.
   • registration-* results returned from Circonus API calls to create each check, graph, and worksheet.