TrueSight Server Automation 20.02

All versions
TrueSight Server Automation, one of BMC's digital enterprise automation solutions, allows you to quickly and securely provision, configure, patch, and maintain physical, virtual, and cloud servers.
Release notes and notices
updated 16 Feb
This section provides information about what is new or changed in TrueSight Server Automation, including urgent issues, documentation updates, feature packs, and fix packs.




February 21, 202020.02 enhancements

Lists the enhancements added in TrueSight Server Automation version 20.02.


  • To stay informed of changes to this list, click the  icon on the top of this page.
  • Ready-made PDFs are available on the PDFs page. You can also create a custom PDF.

     Click here to see the steps.

    The BMC Documentation portal gives you the ability to generate PDF and Microsoft Word documents of single pages, and to create PDF exports of multiple pages in a space.  

    Creating PDF and Word exports

    You can create a PDF of a page or a set of pages. (Non-English page exports are not supported.) You can also create a Word document of the current page.

    To export to PDF or Word

    1. From the Tools menu in the upper-right, select a format:
      • Export to Word to export the current page to Word format
      • Export to PDF to export the current page or a set of pages to PDF
    2. If exporting to PDF, select what you want to export:
      • Only this page to export the current page
      • This page and its children to export a set of pages
      For example, selecting This page and its children from the home page exports the entire space to PDF.


Related topics

Known and corrected issues

Getting started






Concepts, architecture, deployment, planning, and system requirements.



Information about installing the product and migrating product data.

Configuring after installation


Required post-installation configuration.



Upgrade process, migration, and configuration.



Issues resolution, error messages, logs, and contacting Support.



Interface descriptions, using the product.



Security, system administration, maintenance.



Development interfaces and toolkits.



Integrations with other products.
What's new?

TrueSight Server Automation 20.02 offers the following key features and enhancements:

RSCD agent enhancement

The RSCD agent now includes a new Smart Agent feature to perform the following tasks:

  • Monitor the status of RSCD agent and share the status information with the Application Server.
  • Send a request to the Application Server to register the new server without manual intervention.

For more information about the capabilities provided by Smart Agents, see Overview of Smart Agents.

For information about using the Smart Agent capabilities, see Getting started with Smart Agents.

Patch enhancement

TrueSight Server Automation now supports the rebooting of Windows servers before applying patches to prevent patch job failures. When you run a patch job on the Windows server that is waiting for a reboot, the server is first rebooted and then the job is started.

For information about using this option, see Specifying job options.

Enhanced offline database cleanup

TrueSight Server Automation now supports the cleaning of unused data from the BL_Value tables to improve the Application Server performance. For details, see Running the offline database cleanup utility.

Compliance template enhancements

TrueSight Server Automation now supports the following new templates: CIS Windows 2019 and DISA STIG Windows 2019 

For information about downloading and importing these templates, see the following topics:

BLCLI enhancement

The new "Utility - simpleExportAuditResultV2" command is added to export the results of an Audit job. For more information, see BLCLI commands added, updated, or removed in recent versions.

Security enhancement

The "* rw" parameter, which allowed anonymous access to the RSCD agent host, is now disabled in the Exports file that is deployed with the RSCD agent installation. Therefore, you must configure the Exports file to grant access to the RSCD agent. If you want to use the "* rw" parameter, configure the Exports file to uncomment this parameter.

You can configure the Exports file during the RSCD agent installation. For more information, see the following topics:

Support for new REST APIs

New REST APIs are added to the following resources: Deploy jobs, NSH script jobs, Patching jobs, and BLPackage

You can use these new APIs to perform the following operations:

  • Execute with approval operation on Deploy, NSH Script, and Patching jobs.
  • Update schedules for NSH Script and Deploy jobs.
  • Retrieve the details of a BLPackage.

For more information, see REST API endpoints.

Support for new operating system

TrueSight Server Automation now supports RHEL 8 for virtualization. For more information, see Supported platforms.

Frequently asked questions and other information


This topic provides information that supplements the TrueSight Server Automation documentation. It contains the following sections:

Frequently asked questions

This section provides answers to frequently asked questions (FAQs) about TrueSight Server Automation.

General questions

 When is the end of support for my version of TrueSight Server Automation? Is my version supported? (Should I be thinking about upgrading?)

For supported version information, see the following BMC Support Support page:
Note that as of June 26, 2012, version 7.x releases are no longer supported.

 Where can I find information about the platforms currently supported for TrueSight Server Automation product versions?

You can find information about the supported platform for TrueSight Server Automation on BMC Support Central, under Product Availability and Compatibility.

 Where is the Knowledge Base?

The BMC Knowledge Base (which includes answers for common problems with TrueSight Server Automation) is located at

 What ports and protocols does TrueSight Server Automation require?

See the ports and protocols list.

 Where can I find the build number for a release?

You can find the build number for the various releases (base version, SPs, and patches) in Preparing for a Windows upgrade using the unified product installer or Preparing for a Linux or UNIX upgrade using the unified product installer.

 Where can I find information about the integration of TrueSight Server Automation with BMC ProactiveNet?

See the following documentation resources:

  • For information about enabling the retrieval of change information from BMC BladeLogic Server Automation for Probable Cause Analysis (PCA), see the chapter about integrating with TrueSight Server Automation in the BMC ProactiveNet User Guide.
  • For information about transferring data to BMC PATROL and BMC ProactiveNet regarding the status, availability, and performance of hosts and servers managed by TrueSight Server Automation, see the online documentation for BMC PATROL for TrueSight Server Automation and BMC ProactiveNet Automation Server Monitoring.

 Where can I find information about the third party software versions included with TrueSight Server Automation?

You can find information about the included software versions in the Third-party software section of the Minimum software requirements topic and in the Browsing discovered software applications topic.

Installation and upgrade questions

 What are the Supported upgrade paths for TrueSight Server Automation?

You can find information about the supported upgrade paths for TrueSight Server Automation in the Upgrading using individual component installers section of the online technical documentation (in the Preparing for a Windows upgrade using the unified product installer or Preparing for a Linux or UNIX upgrade using the unified product installer topics).

 Where can I find deployment architecture recommendations for implementing TrueSight Server Automation?

You can find deployment architecture recommendations in the following Planning section: Deployment use cases

 What do I do if I just upgraded and am getting errors in Jobs that reference Custom/Server Objects?

 Where are the Microsoft Visual C++ 2015 Redistributable installation log files located?

%temp% directory

 How do I find the description of Microsoft Visual C++ 2015 Redistributable related errors reported in log files?
 How to debug the failures reported during psexec commands ?

Check the debug level rscd.log file on the Psexec server.
You can also try to convert the blpsexec command from rscd.log to native psexec command and try to execute it on psexec server from Administrative command prompt (cmd.exe started as “Run as Administrator”).

blpsexec command: blpsexec -s -u Administrator -p TNEKNUDRFET -h cmd /c hostname

psexec command: psexec \\ -u Administrator -p password_of_Administrator_user -h cmd /c hostname

 What will happen if Microsoft Visual C++ 2017 redistributable is already installed on a server?

Internal version of Visual C++ 2015 and 2017 is same (i.e. 14.0). So when we try to install VC++ 2015 redistributable it detects that newer version is already installed on the server, so installation is skipped. 
As Visual C++ 2017 is binary compatible with 2015, our product will still work with Visual C++ 2017 redistributable.

 Will 8.9.2 Application server (that uses Microsoft Visual C++ 2015) have any backword compatibility issues with older Agents (which uses Microsoft Visual C++ 2005 redistributable)?

No. There won’t be any issue in communication between 2 components which are using different versions of redistributable. 

General product usage

 I'm having trouble with an RSCD agent. How do I open up the permissions temporarily?

Use the following process:

  1. Start by looking at the rscd.log. Who are your requests currently mapping to? If it is someone who does not exist in your users or users.local file, consider adding a temporary definition for them.
  2. Remove the "nouser" line from the users file.
  3. Change the contents of the exports file so that it contains a single line: "* rw,user=root" or "* rw,user=Administrator" (or the name of your local admin account).

Once you have finished troubleshooting, make sure to restore the original configuration.

 What do I do if my Application Server will not start up?

The following list shows some common causes for this issue:

  • Review the Application Server log and look for a Java stack trace; this usually indicates the issue.
  • A few common things can cause problems with the Application Server start up:
    • The File Server RSCD Agent is not licensed (for pre-8.2 versions).
    • ACLs were pushed to the File Server agent.
      • Add a 'System:System  rw,map=<root|Administrator>' to the users.local on the File Server agent.
 I have multiple Application Servers but I cannot see all Application Server status in the Infrastructure Manager window.

In this case, you need to synchronize the bladelogic.keystore across all Application Servers.

See To synchronize keystore files of multiple Application Servers for more information.

 How do I configure NSH/ZSH command history to persist across sessions?

See the following Knowledge Article for information on this issue:
Knowledge Article ID: 000022404

 Where can I find sizing recommendations for Application Servers?

You can find recommendations for sizing Application Servers in Sizing Application Servers.

 Where can I find "how to" information for specific user scenarios?

You can find a list of user contributed tutorial information in the BMC Contributor topics topic.

In addition, the taking the reins article on Communities includes additional videos and "how to" information.

 Are videos available that help to explain how to accomplish specific user tasks?
See the PDFs and videos topic for a list of all videos.

In addition, the taking the reins article on Communities includes additional videos and "how to" information.

 What are the directories on the file server used for ?

The following table provides information about the file server directories and their contents:

Directory nameContent
ContentContent version file
agentbundlesAgent-related files
blassetclassesCO packages
blpackagesBldeploy xml file for blpackages
dashboardBladeLogic-related dashboard report
extended_objectsscriptutil-based scripts
filesFiles that are used for Audit jobs
grammarsGrammar files
importedThe bldeploy.xml file imported after you log in as a BLAdmin
installablesInstallers and scripts, such as Notepad ++, deployable msi, and RSCD installer

Installers of Application Server, PXE, RSCD, and TrueSight Server Automation console

patchPatch analysis related Jason files and catalog-related files
scriptsNSH scripts (chef and puppet packager and DB_FS_Cleanup)
templatesWindows patch data in the zip format
tmpEmpty (used for storing temporary files)

Patch management

 How do I make sure my catalog does not get any new patches?

If the catalog is in Online mode, updating the catalog obtains any new patches or modifies existing patches that have changed. To prevent new patches from being downloaded, do not run the Catalog Update Job until you need new patches in the catalog.
If the catalog is in Offline mode, then to prevent new patches from being downloaded, you must ensure:

  • The source location has not been updated by re-running the downloader
  • The metadata file(s), if applicable, in the depot have not been changed since the last run

If you ensure the preceding items, running a Catalog Update Job does not add any new patch metadata or modify existing patch metadata.

 How do I make sure that my patching job remediates servers on execution?

While creating the Patching Job, from the Deploy Job options menu within the Remediation Options panel, select the Execute job now option. The same options are available while creating a remediation job from the Analysis results.

 How do I make sure that I run analysis every x hours?

You can specify a schedule for any Job to ensure that it is executed every x hours.

 How do I ensure that my catalog contains only attributes that meet "my" criteria?

You must create a custom property on an appropriate depot object. For example, to set certain criteria on a Windows Hotfix object, by selecting Property Dictionary View > Built-in Property Classes > Hotfix, you can add a new property. You can then create a new smart group using an appropriate condition to include this new property.

 How do I know which filters are missing from my Windows catalog to cover all products installed on all my targets that have been added to my patching job?

The job log of the Patching Job displays a warning message that indicates the filters that must be added so that all products on all targets that are part of the Patching Job are analyzed in the next run of the Patching Job. A sample warning message is shown below.

WarningSep 8, 2010 6:15:54 PMPatches belonging to following filters were found missing during analysis:
Skype, English
Adobe, English
Windows Media Player, English
Microsoft Office, English
Microsoft Office 2007, English
SQL Server 2005, English
Flash, English
Microsoft Office 2003, English
.Net Framework, English
Microsoft Windows XP, English
Please update your catalog with these filters to avoid any vulnerabilities
 How do I get more details about the Deploy Job that was executed when I installed patches on my targets?

You can use the drop-down list in the Deploy Job options settings to get the desired information about the execution of that Deploy Job. For example, if you select the All Information option within Logging level, subsequent execution of the Deploy Job provides you with all information about the Deploy Job execution.

Powershell execution

 How do I change the default blpowershell configuration values in blpowershell.cnf file?

Create an NSH Type 1 script with blpowershell command and use the required option as mentioned in To manage PowerShell configurations.

 How do I reset the PowerShell configurations to default values?

Create an NSH Type 1 script with blpowershell -resetoption command and execute the script against the server whose PowerShell configuration needs to be reset.

 How do I configure the blpowershell.cnf file if the PowerShell is installed in a non-default location (for example, C:\Powershell\bin\pwsh.exe) and is not present in the PATH environment variable?

You must have PS_DIR=C:\Powershell\bin and PS_CMD=pwsh.exe in the blpowershell.cnf file. Create an NSH Type 1 script with blpowershell command and use the required option as mentioned in To manage PowerShell configurations. For example,

blpowershell -setoption "PS_DIR" "C:\Powershell\bin"
blpowershell -setoption "PS_CMD" "pwsh.exe"
 I have installed PowerShell in a non-default location (for example, C:\Powershell\bin\pwsh.exe) and is not mentioned in the PATH environment variable. How do I use this PowerShell at runtime?

Additional runtime options are provided to override the configured PowerShell values in blpowershell.cnf. You need to pass the following additional runtime argument when executing the PowerShell script:

-blpsusedir "C:\Powershell\bin"
-blpsusecmd "pwsh.exe"

For more information about overriding options at runtime, see Overriding the PowerShell options at runtime.

 PowerShell script returns an error message, but TrueSight Server Automation reports it as Success. Why is this behaviour?

After the PowerShell script is executed, TrueSight Server Automation decides Success/Failure based on the exit code of PowerShell command. You can try executing the same PowerShell script manually on the target server from the command prompt and check the exit status (%errorlevel% or $?). It was observed that the PowerShell version before version 5 returns Success message even if the script execution fails.


 How can I determine where TrueSight Server Automation is installed?

On UNIX, look in /etc/lib/rsc/HOME or /usr/lib/rsc/HOME. If that file does not exist, you are running a local or self-contained installation, and will need to derive the installation location from running processes. For example:


ls -la /proc/`ps -ef | grep rscw | grep -v grep | awk '{print $2}'` | grep exe | awk '{print $11}'


pargs -l `ps -ef | grep rscd | head -1 | awk '{print $2}'`

 Where are the RSCD Agent logs located?
On Windows: INSTALL_DIR\RSCD\rscd.logOn UNIX: INSTALL_DIR/[NSH|RSCD]/log/rscd.log

 Where is the transaction or bldeploy log?

 Where is the TrueSight Server Automation Application Server log that contains deployment messages?
<INSTALLDIR>\br\<deployment name>.log
The default deployment name is appserver, while other common deployments have names such as job-1.

 How do I analyze the *Trace.txt* file that is generated by a Windows Patch Analysis Job?
For detailed instructions on analyzing the Trace.txt file, see How to analyze Trace.txt generated by a Windows Patch Analysis Job (user contribution).
For a list of frequently asked questions for Agent troubleshooting, see Frequently asked questions for agent troubleshooting.

Top Knowledge Articles from BMC Customer Support

BMC Communites maintains a list of the top 10 Knowledge Articles (KAs) as recommended by the Customer Support team for BMC BladeLogic Server Automation.The KAs are selected by a combination of both the collective experience of the team and other quantitative factors, with the goal of sharing the most relevant and useful information in a easy to consume format.See Top 10 Knowledge Articles for BladeLogic Server Automation on BMC Communities for the list.

Available walkthroughs

Walkthrough topics introduce you to a key BMC BladeLogic Server Automation use case (for example, compliance), and provide step by step, cookbook-style examples that demonstrate a specific aspect of that use case. 

 Click here to see a list of the topics in this space that are walkthroughs.
CategoryWalkthrough topics
Getting started with automation
Configuration management
Patch management
Job management

Additional resources

The following BMC sites provide information outside of the TrueSight Server Automation documentation that you might find helpful:

Was this page helpful? Yes No Submitting... Thank you