BMC 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 08 Jun
This section provides information about what is new or changed in this space, including urgent issues, documentation updates, service packs, and patches.

Placing a watch on this page is a great way to stay informed of changes to this space.




July 7,2017Version Patch 5 for version 8.7Lists the updates introduced in BMC Server Automation version 8.7 Patch 5.
November 19, 2016Version Patch 4 for version 8.7Lists the updates introduced in BMC Server Automation version 8.7 Patch 4.
June 14, 2016Notification of Windows RSCD Agent vulnerability in BMC Server Automation CVE-2016-5063Alerts users to a security problem in the RSCD agent on Microsoft Windows platforms for all versions of BMC Server Automation, up to and including version 8.7 Patch 2, as well as in any BMC solution that includes this technology.
June 8, 2016Version Patch 3 for version 8.7Lists the updates introduced in BMC Server Automation version 8.7 Patch 3.
March 2, 2016Notification of critical security issue in BMC Server AutomationAlerts users to a security problem in the RSCD agent on UNIX and Linux platforms for all versions of BMC Server Automation, as well as in any BMC solution that includes this technology.
January 6, 2016Version Patch 2 for version 8.7Lists the updates introduced in BMC Server Automation version 8.7 Patch 2.
December 3, 2015Version Patch 1 for version 8.7Lists the updates introduced in BMC Server Automation version 8.7 Patch 1.
September 18, 2015 8.7.00 enhancements and updates

Lists the enhancements introduced in BMC Server Automation version 8.7.


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.




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?

The following sections describe enhancements for BMC BladeLogic Server Automation version 8.7.00:


For information about issues corrected in this release, see 8901Known and corrected issues.

Installation and upgrade enhancements

The following enhancements have been introduced in BMC BladeLogic Server Automation 8.7.00 for Installation features:

Option for selecting an alternate tmp directory while installing the default Application Server node and additional Application Servers

During installation, the system stores temporary files in the /tmp directory. You can specify an alternate location to store the temporary files, if you do not have enough space or you do not have access to the /tmp directory.

Installing additional application servers using the SUDO and SU execution protocols

When adding additional Application Servers to the environment, you can choose to use SSH, SSH + SU, or SSH + SUDO, execution protocols for executing commands on the additional Application Server machine. You must specify this protocol, because the additional Application Server machine does not have an agent installed on it.

The SSH+ SU execution protocol elevates your privileges to a root user by issuing the SU command. The SSH + SUDO execution protocol elevates your privileges by appending SUDO command as a prefix to all commands executed on the host machine. The SSH execution protocol simply executes the commands on the host machine without elevating your privileges to a root user. For steps on selecting the required execution protocol, see Adding additional Application Servers.

Compliance Content, Compliance, and SCAP enhancements

The following enhancements have been introduced in BMC BladeLogic Server Automation 8.7.00 for Compliance features:

Improved performance of Compliance Jobs

The Compliance Job has been optimized and now performs better and faster. For more details, see the descriptions of Compliance-related improvements under Performance enhancements.

Updates in the processing of compliance rules

The following new developments have been introduced in BMC Server Automation 8.7.00 to enhance and improve the processing of compliance rules:

  • Groups of Command asset operands, which are used in compliance rules to analyze the output of shell scripting commands, are now executed as batch scripts, resulting in improved performance.
  • A new remediate operator has been introduced to work with Command asset LHS operands, enabling you to apply a shell command as a remediation action at the end of compliance analysis.
  • A group of new assets have been added to support the use of MSS Group Policy Objects (GPOs) as parts in rules. These new assets are displayed in Live Browse under Security Settings\Local Policies\Security Options, and all begin with MSS:.

Automatic component discovery replaces the need for manually running a Component Discovery Job

You no longer need to manually run Component Discovery Jobs on component templates in order to generate components. Instead, you can now authorize a Compliance Job, Snapshot Job, or Audit Job to perform component discovery immediately before running:

  • In the General panel or tab of a Compliance Job or Snapshot Job, select the new Run auto-discovery check box.
  • For an Audit Job, you can now select a server, rather than a component, as the master. This authorizes the Audit Job to perform automatic discovery.

New templates in Compliance Content for supporting additional policies and platforms

BMC BladeLogic Server Automation now supports the following additional Compliance Content component templates:

CIS templates

Operating systemOS VersionBenchmark versionBenchmark updateBMC version
Microsoft Windows Server2012 R21.1.0November, 20148.7.00
2008 R22.1.0December, 20138.7.00
Red Hat Enterprise Linux71.1.0April, 20158.7.00
Oracle Solaris11.11.0.0October, 20138.7.00


Operating systemOS VersionBMC version
Microsoft Windows Server20128.7.00
Red Hat Enterprise Linux78.7.00


Existing templates that are updated in version 8.7 are as follows:

PolicyOperating systemOS version
DISAMicrosoft Windows Server2012 Domain Controller
2012 Member Server
2008 R2 Domain Controller
2008 R2 Member Server
2003 Domain Controller
2003 Member Server
Red Hat Enterprise Linux ES/AS6.x
Oracle Solaris11 x86
10 x86
CISMicrosoft Windows Server2008
HIPAAMicrosoft Windows Server2003

For complete list of available templates, see Compliance policy standards supported by BMC Server Automation templates.

Compliance analysis of Docker containers based on SCAP 1.2

BMC BladeLogic Server Automation now supports compliance analysis of Docker containers and images on containerized Linux servers (see also Automatic detection of containers on servers and a new containerization property). This compliance analysis is based on SCAP 1.2 content with configuration assessments in Open Vulnerability and Assessment Language (OVAL).

To perform SCAP compliance analysis of containers and images, target servers must meet the following requirements:

  • Red Hat Enterprise Linux (RHEL) as the operating system.
  • RSCD agents of version 8.6 or later installed.
  • Docker Daemon installed.
  • OpenSCAP installed.
  • Docker containers on the host servers are based on RHEL or CentOS base images.

Several new depot objects and jobs are provided out-of-the-box in BMC BladeLogic Server Automation 8.7 for the compliance analysis of containers and images. Before you begin running a compliance analysis on your containers and images, you perform the following quick configuration tasks on these out-of-the-box items:

  1. Import relevant SCAP 1.2 content into the Container SCAP Policy (an out-of-the-box custom software package), to replace the use of the default sample SCAP content.
  2. Specify targets in the Container Scan Job (an out-of-the-box NSH Script Job), and optionally configure other parameters and settings in this job.

To run the Container Scan Job, the user who executes the job must be mapped to root on the target systems.

After running the Container Scan Job, results displayed in the BMC Server Automation Console connect you to a new HTML report that summarizes and aggregates the compliance statuses of all containers, and provides you with drill-down options to individual containers and images. This report is available for display in Internet Explorer (IE) and Firefox browsers.

For more information about performing container scans, see Scanning Docker containers for SCAP compliance and Walkthrough: Scanning containers for SCAP compliance.

Patch management enhancements

The following enhancements have been introduced in BMC BladeLogic Server Automation 8.7.00 for patch management features:

Improved patch troubleshooting experience

Patching error messages now include the following:

  • Error codes: Used to identify errors immediately.
  • Descriptive error message: More detailed error messages that provide information about variables, parameters, file names, path names, or object IDs that have caused the error.
  • Troubleshooting information: Most error messages provide troubleshooting steps to the user, wherever possible.

Patching Red Hat Enterprise Linux (RHEL) based on specific security vulnerabilities and exposures

The MITRE Corporation maintains a system for publicly known information security vulnerabilities and exposures. Each security vulnerability or exposure is referenced by a Common Vulnerabilities and Exposures (CVE) ID. BMC Server Automation includes the CVE ID of a patch in its properties. This allows you to create patch smart groups based on errata CVE IDs, and apply the patches on the RHEL servers based on specific vulnerabilities and exposures.

Detailed logging messages for patch remediation jobs

BMC Server Automation 8.7 now provides the user with more detailed logging information in the results view of patch remediation jobs for Windows target servers. You can now see reboot status, shavlik status, and other information related to the status of patch remediation on the target along with other errors and warnings.

For steps on accessing the patch remediation job results view, see Viewing Remediation Job results.

Support for downloading Windows patches on a UNIX machine

For offline Windows patching, you can now download patches from Shavlik to a Linux machine using the offline downloader. For more information about using the offline downloader on a Windows or UNIX machine, see Patch Downloader utility for Microsoft Windows.

Support for patching using errata-based filters for Red Hat Enterprise Linux (RHEL) 7

Although BMC Server Automation 8.6 supports patching for RHEL 7, the online and offline patch catalogs can only be created using channel-level filters.

BMC Server Automation 8.7 now supports errata type and errata ID filters for RHEL 7, while creating online and offline patch catalogs. For more information about the type of filters that you can use for RHEL 7, see Patch catalog - Red Hat Catalog. For steps on creating a configuration file for an offline RHEL 7 catalog with errata ID and errata type filters, see Preparing the configuration file for Red Hat Enterprise Linux.

Note that although we now support errata-based filters for RHEL 7, you still cannot use update-level filters for RHEL 7 in online and offline catalogs.

SafeReboot is used to simplify patching of Java installation files on Windows

BMC Server Automation 8.7 automatically creates the required pre-installation and post-installation environment on a Windows target server for patching Java installation files. The SafeReboot file is deployed on the Windows target server, whenever a Java installation files is patched. 

Note that BMC Server Automation does not decide whether to reboot the Windows target server. This option has to be manually selected by the user (if required), while creating a Deploy Job, see Deploy Job - Job Options.

Provisioning enhancements

The following enhancements have been introduced in BMC BladeLogic Server Automation 8.7.00 for the Provisioning feature:

  • BMC BladeLogic Server Automation now supports booting from the most recent version of WinPE images, WinPE  5.1. During the creation of a WinPE image through the Image Creation wizard, new options in the Toolkit Select panel enable you to switch the type of Windows kit from AIK (for older versions of WinPE) to ADK (for the newer versions of WinPE).
  • BMC BladeLogic Server Automation now supports booting using Unified Extensible Firmware Interface (UEFI), rather than BIOS. UEFI is supported on machines that run any of the following operating systems: RedHat 6 and 7, SuSE 11 SP2 and 12, and Windows 2008 R2 SP1 and 2012.
    To support the use of UEFI, new EFI options have been added to the Disk Partition panel displayed during configuration of the system package used by the Provision Job.
    For more information about setting up for EFI booting, see Preparing for UEFI booting.

For information about the provisioning process, see Implementation process for provisioning.

Virtualization enhancements

The following enhancements have been introduced in BMC BladeLogic Server Automation 8.7.00 for virtualization features:

Shared storage pool support for IBM AIX LPARs

With BMC BladeLogic Server Automation 8.7.00, you can now provision an IBM AIX LPAR that uses a shared storage pool. 

New options have been added to the automatic management Storage tab of the virtual guest package (VGP) for AIX LPARs to enable this support. When creating the VGP, you can now create a virtual disk on a shared storage pool that you select, and then assign it to the LPAR.

To do so, select Add Disk from the Storage tab of the VGP. On the Virtual Disk panel, you can make the following selections:

  • The new Location Type field contains a Shared Storage Pool option.
  • Once you select the option, you then select a server from a drop-down list, and select the shared storage pool from the available list. The shared storage pools are displayed with a naming convention of <cluster_name>:<shared_storage_pool_name>
  • You can also specify if you want the disk to be thin provisioned.

You can provision the LPAR from the BMC BladeLogic Server Automation console or by using the BLCLI. See IBM - Storage (automatic management).

Support for Microsoft Hyper-v generation 2 virtual machines

With BMC BladeLogic Server Automation 8.7.00, you can now set up and provision a Microsoft Hyper-v generation 2 virtual machine (VM) from a Hyper-V generation 2 template. For Hyper-v generation 2 VMs, the following capabilities are supported:

  • Provisioning a VM from a Hyper-V generation 2 template using a VGP and Virtual Guest Job (VGJ)
  • Ability to modify Memory, Disk, NIC, and CPU
  • Ability to live browse the provisioned VM
  • Ability to perform ad-hoc actions such as VM start, stop, and delete, from live browse 
  • REST API support and BLCLI support for all of the above

Note the following requirements for creating Microsoft Hyper-v generation 2 VMs:

  • Only template-based VGPs are supported
  • Supported guest OSs are according to the OSs supported by Microsoft for generation 2 templates: Red Hat Enterprise Linux version 7.1, Microsoft Windows 2012, and Microsoft Windows 2012 R2.
  • For static IP support, BMC Server Automation uses static IP pool from SCVMM. Therefore, the input IP address in the VGP must be part of the pool defined in SCVMM. More details are available from the Microsoft online documentation.

Support for LSI Logic SAS adapter type

(RFE QM001876319) In previous versions, bare-metal provisioning in Windows 2012 R2 with VMWare 5.5 environments did not complete, and produced an SCSI load driver error. This failure occured because, by default, BMC Server Automation passes the LSI Logical Parallel SCSI type, and VMWare takes the LSI Logical SAS SCSI controller type.

In version 8.7, the VGP checks if the OS is Windows 2012 or 2012 R2, and if the adapter type is something other than LSI Logic SAS, then a warning message is sent and the adapter type is set to the LSI Logic SAS adapter type.

VMware enhancements

The following enhancements have been made to VMware support in version 8.7:

  • Support for VMware vSphere version 6.0
  • Ability to use LSI SCSI controllers in VMware VGPs for Microsoft Windows 2012. You can also modify the SCSI controller type using a BLPackage. Note that if you are creating the BLPackage via Live Browse, you must create the package on the SCSI controller node, not on the hard disk node.
  • Support for vCenter Linux Appliance

User experience enhancements

Nested smart groups

You can now create nested smart groups to help you organize servers, jobs, depot items, and other assets more efficiently. For example, you can create a smart group for Windows servers and then, within that smart group, you can nest smart groups for Windows 2008 and 2012.

There is no limit to the number of levels you can nest. However, you may experience a performance degradation when you create deep structures, for example, nesting more than six levels deep.

For more information, see Walkthrough: Dynamically organizing assets with smart groups.

Automatic detection of containers on servers and a new containerization property

For every Red Hat Linux server that you enroll, BMC BladeLogic Server Automation now automatically scans the server host for the existence of containers. Currently only Docker containers on Red Hat Enterprise Linux (RHEL) are supported. The containers can be based on RHEL or CentOS base images. If containers are detected, the new property SERVER_CONTAINER_TYPE in the built-in Server property class is populated with a value (currently the only value is RHEL Docker Container). You can then use this property to create smart groups of containerized servers. 

Performance enhancements

Enhancements to product performance have been introduced into various areas of the product. The following product areas, in particular, now exhibit improved performance:

  • Catalog update jobs for online and offline Red Hat Enterprise Linux catalog. especially if the catalog is modified with minor changes.
  • Compliance Jobs now perform better and execute faster due to the following enhancements:
    • Evaluation of conditions within rules is now done at a more granular level.
    • Parts associated with the Compliance Job are collected dynamically at job run time, so that only relevant parts need to be collected.

    • In Compliance Content templates, complex compliance rules that evaluate extended objects (EO) were updated to work with native objects instead.
  • The version-neutral import mechanism for importing component templates can now handle the import of multiple component templates in parallel.

  • Connections to Application Servers of type NSH_Proxy, minimizing the number of handshakes necessary for connections between client and NSH proxy. 

    As part of this enhancement, a new mechanism of SSL sessions was introduced for connections from RSCD agents to the NSH proxy. In addition, a new blasadmin command, NshProxyApplicationSessionTimeOut, enables you to control the timeout for these connection sessions to the NSH proxy.


    This mechanism generates temporary files that contain encrypted session information. These temporary files accumulate in the RSCD/sessions folder on the agent. You can use a script provided by BMC to clean up these temporary files; obtain this script from BMC Communities. This cleanup script is necessary only in product version 8.7.00. As of version (Patch 1 for 8.7.00), the temporary files from NSH proxy sessions are automatically deleted when the NSH session times out or is closed and a new session is activated.

  • NSH file transfers and NSH Script Jobs

New icons in the user interface

Several key icons in the user interface have been updated. In particular, note the following changes:

  • Wherever used in the UI, the BMC logo has been updated to .
  • The icon for BLPackages has changed from  to .

Job enhancements

Controlling the size of job logs

You can now control the amount of data stored in job run logs, using the new blasadmin component jreLog. This new blasadmin component enables you to perform the following configuration tasks:

  • Restrict target-related log messages to a certain severity (or log level), using the new LogLevel parameter of the jreLog component. You configure the log level separately for each job type or group of job types.
  • Set the maximum number of messages to store in the log, using the new LogLimit parameter of the jreLog component. Configuration of this log limit depends on the type of messages:
    • To limit target-related log messages, you configure the log limit separately for each job type or group of job types.
    • To limit messages with job run data, you configure a single limit for all job types.

The job log settings that you configure through blasadmin are saved in the BMC Server Automation database and are applied to all Application Servers during job execution. You do not need to restart the Application Server after performing these tasks.

For more information, see Controlling the size of job logs.

Integration enhancements

The following enhancements have been introduced in BMC BladeLogic Server Automation 8.7.00 for integration:

Integrating BMC BladeLogic Server Automation with Chef-solo

This new integration, available in version 8.7, enables you to leverage Chef-solo content without having to provision a full-fledged Chef infrastructure in you environments. This feature enables you to:

  • Create content (depot objects and jobs) for deploying the Chef-solo agent
  • Create content (depot objects and jobs) for deploying Chef cookbooks, roles, environment, and databags.

Two new wizards enable you to execute NSH Scripts and NSH Script Jobs that are installed out of the box with BMC Server Automation version 8.7.

The scripts import Chef cookbook(s), roles, environment, databags and pre-requisites (such as Ruby) and generate Depot Objects such as Software Depot Objects and BLPackages as well as the corresponding Deploy Jobs to help users deploy a Chef cookbook (and if needed, its prerequisites) on servers managed by BMC Server Automation.

Also, BMC Server Automation system administrators can perform additional activities after execution of Chef cookbooks on the nodes without having knowledge of the Ruby code, which is required to write additional cookbooks and recipes. Additionally, if the same BMC Server Automation system administrators are performing regulatory compliance and patching activities on these servers and if they perform the application deployment activities through BMC Server Automation, the entire process provides stronger control of servers in your environment. Further, cookbooks can be reused into your production environment.

For more information, see Integrating BMC Server Automation with Chef-solo..

Administration enhancements

New Deploy module for online database cleanup

The online database cleanup mechanism, which enables you to delete old database rows while the Application Server is running and the database is online, was enhanced with a new module to support the cleanup of historical database rows from Deploy Jobs. The BLCLI command Delete cleanupHistoricalData now includes a new object type, Deploy, to enable this functionality.

Health and Value Dashboard enhancements

In previous versions, the BladeLogic Health and Value Dashboard provided only the current view of the BMC Server Automation environment status, which did not include any historic data.

In version 8.7, the Health and Value dashboard provides the overall status of all Infrastructure components (such as Application Servers, agents, the file server, and the database) over a period of time. You also now have the ability to monitor status with respect to key product usage trends. New features for the dashboard include:

  • A new Product Usage Trends tab is being added to the Health Dashboard in version 8.7. This tab enables you to view the BMC Server Automation license usage against the various licensing that you have purchased.
  • Ability to export support to CSV, PDF, as well as image formats for graphs
  • Improved Error Reporting - Ability to set the threshold on each parameter, which triggers warnings and errors that are displayed on the new Time Series graphs
  • New options for the Jobs tab. The following new options have been added in this version:
    • Option to identify the number of jobs without a timeout
    • Option to identify jobs with high verbosity (that is, a high number of logs)
  • New options for the Database Server tab. The following new options have been added in this version:
    • Last analyzed stats
    • Up to date / Stale stats
    • Tables by identity capacity
    • Historical run cleanup
    • Database cleanup
    • Hard delete shared object cleanup
    • Tables with high fragmentation

For more information, see Using the Health and Value Dashboards and Evaluating license and product usage trends.

New walkthrough topics added in this release

Walkthrough topics introduce you to a key BMC Server Automation use case (for example, compliance), and provide step by step, cookbook-style examples that demonstrate a specific aspect of that use case. The following walkthrough topics were adeed in 8.7:

For a full list of available walkthrough topics, see FAQs and additional resources.

BLCLI enhancements

The following series of tables list the new and updated BLCLI commands that support developments and enhancements in BMC BladeLogic Server Automation 8.7.00:

New BLCLI commands in 8.7.00

AuthorizationProfilelistAllAuthorizationProfilesLists all Authorization Profiles in the system, one profile on each line.
ExecutionTaskdeleteExecutionTaskByGroupAndNameDeletes an Execution Task by group and name.
JobexecuteJobAndReturnScheduleIDExecutes a job and returns the schedule ID.
PropertyInstanceapplyAclPolicyApplies an ACL Policy to a Property Instance and returns the DBKey of the updated instance.
RBACRoledeleteRoleDeletes an existing role.
TemplatelistPropertyInstanceNamesByGroupAndNameLists the names of all local property instances for a Component Template.
UtilityexportDeployRunStatusWithUndoByGroupExports the server/phase status of the latest run of all Deploy Jobs in a specified group including undo. It places this status information in a CSV file.

Updated BLCLI commands in 8.7.00

ComponentExceptioncreateComponentExceptionWithOneRuleUpdated to include the rule reference number in the input.
DeletecleanupHistoricalDataOption added for deleting historical data from Deploy Jobs.

Option added to return the permissions contained in the policy along with the policy name.

Related topics

Downloading the installation files
8901Known and corrected issues

Frequently asked questions and other information


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

Frequently asked questions

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

General questions

 When is the end of support for my version of BMC 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 BMC Server Automation product versions?

You can find information about the supported platform for BMC 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 BMC Server Automation) is located at

 What ports and protocols does BMC 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 BMC 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 BMC 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 BMC Server Automation, see the online documentation for BMC PATROL for BMC Server Automation and BMC ProactiveNet Automation Server Monitoring.

 Where can I find information about the third party software versions included with BMC 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 BMC Server Automation?

You can find information about the supported upgrade paths for BMC 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 BMC 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?
 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

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.

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.


 How can I determine where BMC 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.log

On UNIX: INSTALL_DIR/[NSH|RSCD]/log/rscd.log

 Where is the transaction or bldeploy log?


 Where is the BMC 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 BMC Server Automation documentation that you might find helpful:

    MultiExcerpt named 'pdf_list' was not found
The multiexcerpt named 'pdf_list' was not found. Please check the page name and MultiExcerpt name used in the MultiExcerpt Include macro. 

The following table lists topics that contain videos that supplement or replace the text-based documentation.

CategoryTopics with videos

Getting started


Console management

Patch management
Deploy Jobs

Support information


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