TrueSight Server Automation (TSSA) - Install/upgrade Smart Agent configuration parameters

Knowledge Article

Article Number

000314117

Old Article Number

000191521

Article Type

FAQ/Procedural

Title

TrueSight Server Automation (TSSA) - Install/upgrade Smart Agent configuration parameters - TrueSight Server Automation

Summary

Product

TrueSight Server Automation

Component

TrueSight Server Automation

Applies to

TrueSight Server Automation Smart Agent (Introduced in TSSA 20.02)

Question

After Install or upgrade TSSA environment to 20.02 version, and installed and configured Smart Hub

The next is to upgrade or install agents in targets, which now include Smart Agent feature. (Smart Agent overview here)
What needs to be done to get it properly configured?

Answer

There are some parameters that need to be set on installer, here is the list and details about it

SMARTHUB_HOSTNAME	Specify the host name of the system where the Smart Hub is installed.
SMARTHUB_PORT	Specify the listener port of the Smart Hub. The default port is 443.
ENROLL_INTERVAL_MIN	Specify the interval at which the Smart Agent sends an enrollment request. The default interval is 15 minutes. The interval range can be 1 - 360 minutes.
ENROLL_AS	Shows the predefined identifier that is used for enrolling the server. Specify one of the following identifiers to be used for the enrollment: <HOSTNAME>: Indicates the server host name. This is the default identifier. <SMARTHUB_PEER_IP>: Indicates the IP address of the server. <SMARTHUB_PEER_FQDN>: Indicates the fully qualified domain name of the Smart Hub IP address. Also, you can specify a combination of <HOSTNAME>.domain or free text, such as smartagent.domain. Note: If you want to upgrade the RSCD agent using an Agent Installer Job, specify ??TARGET.NAME?? as a value for the enrollment. Other values are not permitted. As soon as the Agent has been enrolled, it may require a few minutes for the entire enrollment process to be completed.
HEARTBEAT_INTERVAL_MIN	Specify the interval at which the Smart Agent sends heartbeats to the Smart Hub for status updates. The default interval is five minutes. The interval range can be 1 - 360 minutes.
SMARTAGENT_SERVICE	Indicates whether the Smart Agent service is enabled. When the service is enabled, the Smart Agent is started automatically after installation. For new installation, the default value is set to 1, which indicates that the Smart Agent service is enabled. For upgrade, the default value is set to 0, which indicates that the Smart Agent service is disabled. The Agent is not started automatically after the upgrade.
ACCESS_KEY	Specify the access key, it should be used in encrypted format, the encrypted string can be obtained as follows Log in to the TrueSight Server Automation console as a member of the BLAdmins role or the role with the required permissions.. Click Configuration > Infrastructure Management. On the Infrastructure Management page, expand Smart Hubs in the left pane. Right-click the required Smart Hub and click Show Access key.

For Windows

-If installation/upgrade will be done manually executing msi package enter the values in this screen

-If it's going to be using Agent Installer Job, add "Optional Install MSI Customization Properties" to the installation package in TSSA Depot as follows
User-added image

For Linux

- If it will be done manually, create nsh-install-defaults file containing the list of parameters under /tmp directory (this file should be owned by root), then run installer.

Ex:

# vim /tmp/nsh-install-defaults
SMARTHUB_HOSTNAME=<hostname of Smart Hub>
SMARTHUB_PORT=443
ENROLL_INTERVAL_MIN=2
HEARTBEAT_INTERVAL_MIN=2
ENROLL_AS="<HOSTNAME><UPPER>"
ACCESS_KEY="eyjw....=="

# rpm -ivh RSCD-2102.rpm

This will install RSCD agent with 'Smart Agent' capabilities.

- If going to run AIJ, open Linux_64 install package and under support files edit _NSH_INSTALL_DEFAULTS and provide the location of nsh-install-defaults file
User-added image

Attachment(s):