DataStax Agent configuration
Configure DataStax agents with options in the address.yaml file. Fix and troubleshoot agent connections.
Agent auto-connect
If you are adding an existing cluster to OpsCenter, and the nodes do not have the agent installed, OpsCenter displays a Fix Agents link next to the number of nodes. Clicking Fix Agents causes 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.
- Verify the agent is able to start up without errors on the node. Look through the agent logs for errors.
- Check the settings of the
stomp_interface
andstomp_port
options for each agent to make sure they match and are pointing to the OpsCenter host and port, respectively. - Test that the OpsCenter host and port are accessible from the node. A firewall might be blocking access to the OpsCenter port, for example.
- Verify that agents have the correct configuration settings for SSL communication if OpsCenter is configured to use SSL communication between itself and the agents.
- Test that the SSH credentials you have entered in OpsCenter work on each node.
- Verify JMX connectivity is enabled on the node.
In most environments, stomp_interface
is the only property that will need
to be explicitly configured, and this might happen automatically as previously mentioned.
You can set most of these properties in the [agent_config]
section of
cluster_name.conf on the opscenterd machine and the
properties propagate automatically to all agents. Some properties or some cases will require
setting these properties directly in address.yaml on applicable
agents.
The address.yaml configuration file
The address.yaml file contains configuration options for the DataStax Agent.
hosts
option in address.yaml now determines which nodes the agent
connects to. For further information on configuration changes and migration paths, see the
Upgrade Guide.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
- hosts
- The DataStax Enterprise node or nodes responsible for storing OpsCenter data. By
default this will be the local node, but may be configured to store data on a separate
cluster. The hosts option accepts an array of strings specifying the IP
addresses of the node or nodes. For example,
["1.2.3.4"]
or["1.2.3.4", "1.2.3.5"]
- alias
- A name for the node to use as a label throughout OpsCenter.
- restore_on_transfer_failure
- Determines whether to allow a restore operation from S3 to continue after any file
fails to download. Setting the value to
1
allows the restore operation to continue. The default setting is0
. - max-number-queued-files
- Sets the maximum number of files to queue for uploading to a remote backup destination. Increasing this number impacts memory. The default setting is 100000.
- 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 to1
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.
- tmp_dir
- The location of the Backup Service staging directory for backups. The default location is /var/lib/datastax-agent/tmp.
Advanced options
- metrics_enabled
- Whether or not to collect and store metrics for the local node. Setting this option to
0
turns off metrics collection. The default setting is1
. - cassandra_port
- Port used to connect to Cassandra. The default setting is 9042. 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. Setting this option to
0
means the agent will not use sudo, and the agent user will not run using elevated privileges. Setting this option to1
means the agent will run using sudo, and elevated privileges. - max_reconnect_time
- Maximum delay in ms for an agent to attempt reconnecting to Cassandra. The default is 15000 ms (15 s).