DataStax Agent configuration
Agent autoconnect
If you are using OpsCenter to provision a cluster, agent autoconnection should work with no need to alter the configuration of the agent. In this case, OpsCenter installs the agent on each node and then uses the agent to install Cassandra or DSE.
If you are adding an existing cluster to OpsCenter, and the nodes do not have the agent installed, OpsCenter will display a Fix Agents link next to the number of nodes. Clicking Fix Agents will cause OpsCenter to attempt to install and start the agent on any nodes that do not have a running agent, as described in Automatic installation of DataStax agents and Installing DataStax agents.
- That the agent is able to start up without errors on the node. Look through the agent logs for errors.
- The settings of the
stomp_interface
andstomp_port
options for each agent, to make sure they match they are pointing at the OpsCenter host and port, respectively. - That the OpsCenter host and port are accessible from the node. For example, a firewall may block access to the OpsCenter port.
- If you've configured OpsCenter to use SSL communication between OpsCenter and the agents, but the agents do not have the correct configuration settings for SSL communication.
- That the SSH credentials you've entered in OpsCenter work on each node.
- That JMX connectivity is enabled on the node.
The address.yaml configuration file
The address.yaml file contains configuration options for the DataStax Agent.
address.yaml
The location of the address.yaml file depends on the type of installation:
- Package installations: /var/lib/datastax-agent/conf/address.yaml
- Tarball installations: install_location/conf/address.yaml
opscenterd.conf
The location of the opscenterd.conf file depends on the type of installation:
Location | Package | Installer (GUI or text mode) | Tarball | |
---|---|---|---|---|
Service | No-service | |||
/etc/opscenter/opscenterd.conf | X | X | ||
install_location/conf/opscenterd.conf | X | X |
Options
- stomp_interface
- Reachable IP address of the opscenterd machine. The connection made
will be on
stomp_port
- stomp_port
- The
stomp_port
used by opscenterd. The default setting is 61620. - local_interface
- The IP used to identify the node. If broadcast_address is set in cassandra.yaml, this should be the same as that; otherwise, it is typically the same as listen_address in cassandra.yaml. A good check is to confirm that this address is the same as the address that nodetool ring outputs.
- agent_rpc_interface
- The IP that the agent HTTP server listens on. In a multiple region deployment, this is typically a private IP.
- agent_rpc_broadcast_address
- The IP that the central OpsCenter process uses to connect to the DataStax agent.
- use_ssl
- Whether or not to use SSL communication between the agent and
opscenterd. Affects both the STOMP connection and agent HTTP
server. Corresponds to
[agents].use_ssl
in opscenterd.conf. Setting this option to true turns on SSL connections. The default setting is0
. - cassandra_conf
- The agent will attempt to auto-detect the location of the cassandra.yaml file via JMX, but if it cannot this needs to be set to the full path of cassandra.yaml. By default /etc/cassandra/cassandra.yaml on package installs or <install_location>/conf/cassandra.yaml on tarball installs.
- cassandra_install_location
- The location where Cassandra is installed for tarball installs if OpsCenter is unable to auto-detect the install location.
- cassandra_log_location
- The location of Cassandra's system.log file. This is only used for the diagnostics tarball, and should only be set if system.log is in a non-standard location.
Advanced options
- metrics_enabled
- Whether or not to collect and store metrics for the local node. Setting this option to
false
turns off metrics collection. The default setting istrue
. - thrift_port
- Port used to connect to local thrift server. The default setting is 9160. This information will be sent by opscenterd for convenience, but can be configured locally as needed.
- jmx_host
- Host used to connect to local JMX server. The default setting is
localhost
. This information will be sent by opscenterd for convenience, but can be configured locally as needed. - jmx_port
- Port used to connect to local JMX server. The default setting is 7199. This information will be sent by opscenterd for convenience, but can be configured locally as needed.
- api_port
- Port the local HTTP server will bind to. The default setting is 61621. This option needs to be identical across all agents, and set explicitly in opscenterd.conf if changed.
- runs_sudo
- Sets whether the DataStax Agent will be run using sudo or not. Setting this option to
false
means the agent will not use sudo, and the agent user will not run using elevated privileges. Setting this option totrue
means the agent will run using sudo, and elevated privileges.