As an administrator, you can deploy packages to BMC PATROL Agents. The installation runs silently with the information entered during the package creation. The deployable package is copied to the file system of the targeted PATROL Agents, is extracted and installed.

Tip

To deploy packages to PATROL Agents prior to version 10.0, see Deploying packages to PATROL Agents#Deploying packages to earlier versions of PATROL Agents.

Requirements for deploying packages

You need to create deployable packages before you can deploy them. For more information, see Creating deployable packages.

The following validations are performed before deploying packages:

  • PATROL Agent version - Packages are deployed only to PATROL Agents version 10.0 and later.
  • Integration Service version - Packages are deployed only to PATROL Agents that are connected to Integration Services version 10.5 and later.
  • Monitoring solution version - Monitoring solutions in the deployable package that are of earlier versions than what are available on the PATROL Agent are not deployed.

    Examples

    • Package created with one monitoring solution, Sol A, version 1.0. PATROL Agent PA1 contains Sol A, version 2.0.
      When you deploy this package on PATROL Agent PA1, a validation message is displayed and deployment does not continue.
    • Package created with two monitoring solutions Sol A, version 1.0 and Sol B, version 2.0. PATROL Agent PA1 contains Sol A, version 2.0.
      When you deploy this package on PATROL Agent PA1, the deployment occurs and only Sol B, version 2.0 is installed on PATROL Agent PA1; Sol A, version 1.0 is not installed.
  • Operating system - Packages that do not match the operating system of the target PATROL Agents are not deployed.

  • Installation directory - The directory specified in the deployable package and the PATROL Agent installation directory must match.
  • Disk space - The Integration Service and PATROL Agent host must have sufficient disk space for deployment and installation.
    • The Integration Service must have free disk space of at least the deployable package size.
    • The PATROL Agent host must have free disk space of at least four times the deployable package size.

To deploy and install packages to PATROL Agents

Tip

If multiple PATROL Agent instances are running on the same host, stop the PATROL Agent instances that are not connected to the Presentation Server before deploying packages. This step ensures the deployment does not fail due to files that are locked by the other PATROL Agents. 

  1. Log on to the TrueSight console. In the navigation pane, expand Configuration and select Managed Devices.
  2. Expand the entries list to display the PATROL Agents that you want to deploy and install the package to.

  3. From the action menu for the PATROL Agent, select Deploy and Install Packages.

    If you are simultaneously deploying the package to multiple PATROL Agents, use the action menu from the column heading to deploy the package to the selected PATROL Agents.

  4. Select the packages that you want to deploy to the PATROL Agent and select Deploy and Install.

    Note

    Deploying a package restarts the PATROL Agent.



  5. If any package deployment validation fails, an error message is displayed and the remaining compatible packages, if any, are deployed and installed to the PATROL Agent.

    Note

    During a deployment, if an Integration Service is disconnected, the deployment continues when the Integration Service is reconnected.

  6. View the status in the Deploy Status column.

To view the deployment and installation status

The icons in the Deploy Status column indicate the deployment and installation status. See the following table for a description of the icons and the status.

Note

The status of only the latest action (deployment or installation) is displayed in the Deploy Status column.

IconDeployment statusDescription

  • Deploy in Progress

A deployment has been triggered on the PATROL Agent and is currently in progress.

Hover over the icon to view details.

  • Install in Progress

A deployment or installation has been triggered on the PATROL Agent and is currently in progress.

  • Install Completed

The latest installation on the PATROL Agent was successful. Hover over the icon to view details.

  • Deploy Failed

The latest deployment or installation on the PATROL Agent failed.

The same icon represents both deployment and installation status. Hover over the icon to view details.

  • Install Failed

The latest deployment or installation on the PATROL Agent failed.

  • Uninstall in Progress
The latest uninstallation of monitoring solution has been triggered on the PATROL Agent and is currently in progress.

  • Uninstall Completed
The latest uninstallation of monitoring solutions on the PATROL Agent was successful.

  • Uninstall Failed
The latest uninstallation of monitoring solutions on the PATROL Agent failed.

  • Install Aborted

The latest deployment on the PATROL Agent was aborted.

  • Unknown

The status of the latest deployment or installation on the PATROL Agent is unknown.

This is the default status when a deployment job has not yet been triggered on a PATROL Agent.

Deploying packages to earlier versions of PATROL Agents

The deploy and install feature in the TrueSight console does not support PATROL Agents prior to version 10.0.

To deploy to such PATROL Agents, perform the following steps:

  1. Use the Save and Download option while creating a deployable package, as described in Creating a deployable package.
  2. Copy the deployable package to the PATROL Agent host and extract it.
  3. Run the following file in the bmc_products directory:
    (Windows) RunSilentInstall.exe
    (UNIX) RunSilentInstall.sh

    Note

    The following section describes the RunSilentInstall script options:

    RunSilentInstall.sh [ -version ] [ -license ] [ -no_restart ] [ -validate ] [ -log_path=<directory path for log generation> ]

    -version: Displays the version of the utility

    -license: Displays the EULA.txt

    -log_path: Directory path where the files related to the RunSilentInstall script will be generated.

    -no_backup: Disable backup while upgrading the PATROL Agent.

    -no_restart: PATROL Agents that are running are not restarted after the installation.

    -validate: Enables you to perform validation of stored credentials.

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

2 Comments

  1. The documentation does not include a guide to install PATROL agent. There should be a step "How to install PATROL Agents" prior to the "Deploying Packages to PATROL Agents" step.

  2. Our apologies for this oversight. Until we can update this page, you can find the PATROL Agent documentation at the following location: PATROL Agent 10.0.

© Copyright 2013-2016 BMC Software, Inc.
© Copyright 2013-2016 BladeLogic, Inc.
Legal notices