Share This:

With the TrueSight Server Automation (TSSA) 20.02 release two new features were added, the Smart Agent and Smart Hub.  Here is a brief introduction to the features and highlights of some items around installation and configuration.

 

The Smart Agent is an add-on feature for the RSCD Agent which allows communication back to the TSSA Application Server, via the Smart Hub.  The Smart Hub is a new component which will relay information from Smart Agents to the Application Servers.  The Smart Agent will allow for an RSCD Agent to auto-enroll itself and proactively provide agent state information to the application server.

 

Overviews of these components can be found here:

https://docs.bmc.com/docs/tssa2002/overview-of-smart-agents-919901683.html

https://docs.bmc.com/docs/tssa2002/overview-of-the-smart-hub-941857309.html

 

 

Smart Agent and Smart Hub supported platforms

With the TSSA 20.02 release the Smart Agent & Hub are supported on Windows and RedHat Linux.

 

Smart Agent

Operating System

Version

Windows

2012, 2016 & 2019

RedHat Linux (RPM installer only)

6, 7 & 8

 

Smart Hub

Operating System

Version

Windows

2012, 2016 & 2019

RedHat Linux

7 & 8

 

Additional platform support will be added with later releases.  Currently supported platform information is also detailed here:

https://docs.bmc.com/docs/tssa2002/supported-platforms-910749868.html

 

 

Install and upgrade of RSCD and Smart Agent

With 20.02 the Smart Agent will be included and enabled for new RSCD Agent installs.

RSCD Agent installs via the Agent Installer Job will also add and enable the Smart Agent.

Installation of the RSCD Agent via a Provisioning Job though will not include the Smart Agent component, as this currently installs the agent via the RSCD Agent shell script.  In this case instead select to install the RSCD Agent as a post provisioning job and gain the Smart Agent.

 

When upgrading RSCD Agents from a prior version to 20.02 the Smart Agent components will be added as part of the upgrade, but by default the Smart Agent services will be disabled.

 

 

Smart component silent install considerations

Silent installation of the Smart Agent is supported for both Windows and RedHat.  There are new silent install parameters available to support these actions.  The updated silent install procedure for Windows targets is covered here:

https://docs.bmc.com/docs/tssa2002/using-silent-mode-to-install-an-rscd-agent-windows-910750322.html

 

For RedHat the Smart Agent silent install and associated nsh-install-defaults file is outlined here:

https://docs.bmc.com/docs/tssa2002/using-rpm-to-install-nsh-or-the-rscd-agent-910750500.html

 

The Smart Hub can also be installed in silent mode.  Steps for this procedure are here:

https://docs.bmc.com/docs/tssa2002/installing-the-smart-hub-silently-919901905.html

 

 

How to disable Smart Agent services

 

With the Smart Agent component added with the installation, it may be desired to not use the Smart Agent features.  The Smart Agent service can be disabled.  During install the service will be disabled if the option SMARTAGENT_SERVICE is set to 0 in nsh-install-defaults for Linux installations or the Optional MSI Customization Properties for Windows installations.

 

  • For new installations, the default value is set to 1, which indicates that the Smart Agent service is enabled.
  • For upgrades, the default value is set to 0, which indicates that the Smart Agent service is disabled.  The Smart Agent Service is not started automatically after the upgrade.

 

After installation, on Windows the service can be stopped via the Windows Services panel (services.msc).  The service name is “TrueSight Server Automation Smart Agent”.

 

On RedHat stop the service via the command “smartagent stop”.

 

For more detail about the Smart Agent configuration and service see:

https://docs.bmc.com/docs/tssa2002/managing-the-smart-agent-919902012.html

 

 

Troubleshooting logs and files

There are new logs and configuration files for the Smart Agent & Smart Hub, which will be helpful to diagnose and troubleshoot issues.

 

Smart Agent:

Log file

<rscd_home>\smartagent.log

<rscd_home>/log/smartagent.log

Config file

C:\Windows\rsc\smartagent.conf

/etc/rsc/smartagent.conf

 

Smart Hub:

Smart Hub log file

<smarthub_dir>\smarthub\logs\smarthub.log

Redis log file

<smarthub_dir>\smarthub\redis\redis.log

Config file

<smarthub_dir>\smarthub\config\config.json

 

Application server:

Application server smart hub log

<appserver_dir>\NSH\br\appserver-smarthub.log

<appserver_dir>/NSH/br/appserver-smarthub.log