Manually deploy DataStax Agents from RPM
It is preferable to install DataStax Agents automatically. However, when automatic DataStax Agent installation is unsuccessful, manually install them.
This procedure uses a Yum package to manually install DataStax Agents on Linux nodes running DataStax Enterprise (DSE) clusters. Use this procedure if your DSE instance was also installed with a Yum package. Otherwise, choose one of the following procedure types that does match:
Prerequisites
-
An IBMid.
-
If you are an existing IBM customer with an IBMid, you can continue to use your established account.
-
If you don’t have an IBMid, you can create one.
-
If your company uses Enterprise Federation (EF) for authentication with corporate credentials, see the EF documentation.
-
-
Root or sudo access to the machines where the DataStax Agents are installed.
-
The DSE cluster is up and running.
-
OpsCenter is installed and configured.
-
JMX connectivity is enabled on each node in the cluster.
opscenterd.conf
The location of the opscenterd.conf file depends on the type of installation:
-
Package installations:
/etc/opscenter/opscenterd.conf -
Tarball installations:
install_location/conf/opscenterd.conf
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
Procedure
-
Download the OpsCenter RPM packages from Fix Central:
-
Sign in to Fix Central.
-
In the Product selector field, enter
IBM DataStax OpsCenter. -
Select the version you want to install from the Release list, and then click Continue.
-
On the Identify fixes page, click Continue to use the default Browse for fixes option.
-
Select the fix pack (OpsCenter version) you want to install, and then click Continue.
-
Review the terms and conditions, and then click I agree.
-
-
Click the DSE RPM package link to download the file, for example,
opscenter-6.8.47-rpm.zip. -
Extract the RPM files from the
.zipfile:unzip opscenter-6.8.47-rpm.zipYou can use the package signing public key (
rpm-signing.pub.key) in the file to set up and verify the RPM packages. -
Import the package signing public key:
sudo rpm --import rpm-signing.pub.key -
Set up a local Yum repository to host the downloaded RPM files.
-
Apache
-
nginx
-
Red Hat Satellite
See Apache in the Red Hat documentation for more information.
See nginx in the Red Hat documentation for more information.
See Uploading content to custom RPM repositories in the Red Hat Satellite documentation for more information.
-
-
Add the local DataStax Yum repository to a file called
/etc/yum.repos.d/datastax.repo:[datastax] name={company} Repo for DSE baseurl=file://**REPOSITORY_DIRECTORY_PATH** enabled=1 -
Install the DataStax agent:
sudo yum install datastax-agentIf you are using an earlier version of OpsCenter, add the supported version to the command:
sudo yum install datastax-agent-6.8.version-1 -
In DataStax Agent configuration, set
stomp_interfaceto the IP address that OpsCenter is using. You might have to create the address.yaml file.echo "stomp_interface: reachable_opscenterd_ip" | sudo tee -a /var/lib/datastax-agent/conf/address.yaml -
If SSL communication is enabled in
opscenterd.conf, use SSL inaddress.yaml:echo "use_ssl: 1" | sudo tee -a /var/lib/datastax-agent/conf/address.yaml -
Start the DataStax agent:
sudo service datastax-agent start