TrueSight Server Automation provides templates for Inventory report data collection, and scripts for agent log data collection and running the ETL and archival processes. To use these templates and scripts, you must obtain them from the <TSSA-DWInstallationDirectory>/bsa/content_installer directory and create TrueSight Server Automation jobs. This topic describes how to download and install the templates and scripts.

The templates and scripts are included in the file. The file also includes the Content Installer, which you need to run to install the templates and scripts.

The file includes the Content Installer and the following artifacts:

Before you begin

  • Access the file from the <TSSA-DWInstallationDirectory>/bsa/content_installer directory.
  • Verify that your TrueSight Server Automation Application Server environment meets the following prerequisites (for information about setting up the TrueSight Server Automation Application Server, see Installing components on Linux and UNIX Open link  and  Installing components on Microsoft Windows Open link in the TrueSight Server Automation documentation).

    • Network Shell is installed on the TrueSight Server Automation Application Server.

    • The agentinfo command works and displays the correct information when it is run on the TrueSight Server Automation Application Server. 

    • To verify that the command works, start nsh and run the command as follows:

      agentinfo <hostName>

      <hostName> is the Application Server name.

      The command should return a message similar to the following example:

        Agent Release: :
        Hostname: :vm-w23-rds896
        Operating System:WindowsNT 5.2
        User Permissions:BladeLogicRSCD@VM-W23-RDS896->Administrator@VM-23-RDS896:PrivilegeMapped(Identity via trust)
        Security :Protocol=5, Encryption=TLS1
        Host ID :24612116
        # of Processors: 1
        License Status :Licensed for NSH/CM

To run the Content Installer

  1. Locate the file in the <TSSA-DWInstallationDirectory>/bsa/content_installer directory. 
  2. Extract the zip file into a folder of your choice that is near to the root folder on your TrueSight Server Automation Application Server.


    BMC recommends that you extract the zip file into a folder that is near to the root folder on the server. Otherwise, the Content Installer files might not work. For example, you could extract the zip file into the /tmp directory on Linux and the c:\tmp directory on Windows.


  3. On the TrueSight Server Automation Application Server, from a command prompt, navigate to the directory in which you extracted the files in the previous step.
  4. Run the blcred utility to acquire credentials, as follows:

    blcred cred -acquire


    Do not run the installation from the TrueSight Server Automation - Data Warehouse server, as the the blcred utility that is located on this server might not be compatible with the TrueSight Server Automation Application Server.

    For more information about how to acquire credentials by using the blcred utility, see Using the blcred utility Open link in the TrueSight Server Automation documentation.

  5. Enter the following parameters for the utility:
    • Profile Name: Name of the profile created on TrueSight Server Automation
    • User Name: TrueSight Server Automation user
    • Password: Password for the TrueSight Server Automation user
  6. Execute the following scripts in any order:

    nsh load-bsara-nsh-script.nsh -v <authenticationProfileName> 
    nsh load-bl-inventory-templates.nsh -v <authenticationProfileName> 

    <authenticationProfileName> is the authentication profile name for the local or remote application server. Use this parameter if you do not want to use the default profile or there is no default profile.

The first script provides the following options:

  • Load BDSSA Collect Agent Logs Scripts: Imports the collect_agent_logs.nsh script. Use this option if you want to create agent log collection jobs.
  • Load BDSSA ETL and Archival Scripts: Imports the run_etl_from_om.nsh and run_archival_from_om scripts. Use this option if you want to create TrueSight Server Automation Server Network Shell Script Jobs to run the ETL and archival processes.
  • Load All: Loads the collect_agent_logs.nshrun_etl_from_om.nsh, and run_archival_from_om scripts. BMC recommends that you use this option.
  • Exit: Stops the execution of the load-bsara-nsh script.

The second script provides options to import the Inventory templates for your operating system type. Use this option to load the Inventory templates for your operating system type. These templates are required for Inventory reporting.
When you run these scripts, a log file, called content-install.log, is created in the contents_installer directory.

To locate the scripts

Log on to TrueSight Server Automation to locate the templates and scripts:


Location on the TrueSight Server Automation console

Inventory templatesBladeLogic\Component Templates\BladeLogic Inventory Templates

Collect Agent Logs Script

(For the collect_agent_logs.nsh script)

BladeLogic\Depot\BladeLogic Reports Scripts\Collect Agent Logs

Run ETL From OM Script

(For the run_etl_from_om.nsh script)

BladeLogic\Depot\BladeLogic Reports Scripts\Run ETL from OM

Run BDSSA Archival Script

(For the run_archival_from_om.nsh script)

BladeLogic\Depot\BladeLogic Reports Scripts\Run BDSSA Archival

Where to go from here

Enabling Inventory assets

Upgrade Assistance

The BMC Assisted Migration Offering (AMIGO) program is designed to assist customers with the planning of product upgrades to a newer version – “Success through proper planning”.
Explore AMIGO Program ›
Was this page helpful? Yes No Submitting... Thank you