Creating deployable packages

As an administrator, you can select monitor installation components, such as the BMC PATROL Agent and monitoring solutions to create a deployable package. The components can then be installed together using the deployable package. You can reuse the deployable packages, or deploy the packages to multiple computers.

Before you begin

To create a deployable package

  1. Log on to the TrueSight console. In the navigation pane, expand Administration, select Repository, and select the Deployable Packages tab.

  2. ClickCreate Deployable Package.
    The Create Deployable Package wizard starts.

  3. On the Installation Package Solution Selection page, select the operating system for which you want to create a package, and then select a platform on which you want to install the package.
    The list of components in the repository that are supported on the specified operating system and platform is displayed.
  4. Select the components that you want to include in the package.

  5. From the Version list, select the version of the component that you want to include in the package.
    By default, the latest version available in the Presentation Server is selected. Select latest to automatically update the package with latest versions of components when they are imported to the Presentation Server.


    Deployment from the console is not supported if the deployable package contains the following components:

    • PATROL Configuration Manager
    • PATROL Classic console
    • Oracle JRE only

    If any of these components are present in the deployable package, the package is not seen in the Deploy and Install Packages screen.

  6. For monitoring solutions that contain sub-components, select the sub-components to be included in the deployable package.


     To reduce the deployable package file size, choose only the sub-components that you will use.

  7. Provide PATROL Agent related information:


    The following fields depend upon the components that are included in the deployable package. Not all fields may be displayed while creating a deployable package.  

    1. Specify the installation directory.
      Perform one of the following actions: 

      • Proceed with the installation in the default directory.
      • Enter a different directory for installation.
      • Leave the field blank and proceed with the installation.
        You can leave the field blank if you do not know the location where the KM or PATROL Agent is installed. When you leave the field blank, the correct directory is automatically selected through the BMC_BASE variable.
    2. Specify the PATROL 3.x product directory.

    3. Follow the instructions in the Important Information section of the wizard.
    4. For UNIX operating system, provide the System Root account details.
      Note: You can continue the package process without the Root details but you will need to complete the root configuration at a later time for the selected component to run correctly.
    5. Provide the PATROL default account credentials.
      You must create this account manually before continuing with the installation. If you plan to use a domain account, type the following otherwise type the local account details:
      1. (Windows) DOMAIN_NAME\account name
      2. (Linux) DOMAIN_NAME\\account name
        Double slash before the account name ensures that the account name is parsed correctly. While editing the package, if the double slash is deleted, type it again.


      To allow the PATROL Agent to use the Local System account as the default account, leave the username and password fields blank.

    6. Select the security level.
      The default security level is appropriate for most environments.
    7. Specify the PATROL Agent port number.
      The port number is used by the PATROL Agent to communicate with the console. If you are installing a new version of the PATROL Agent over an existing one, ensure that you specify the same port number used by the earlier Agent.
    8. Provide the Infrastructure Management integration configuration:
      1. INTEGRATIONSERVICES variable: this variable is used for automatic registration of the PATROL Agent with Infrastructure Management.

        Enter one or more existing Integration Service(s) to connect to. Separate each entry by a comma and use the format Protocol:IntegrationServiceHostname:PortNumber. For example tcp:Integration Service Hostname:3183, where 3183 is the port on which the Integration Service host listens for an incoming PATROL Agent auto-registration connection.


        You can connect to the local integration service installed on the Infrastructure Management Server, or Downloading and installing a new instance of the Integration Service Open link

      2. Central Monitoring Administration Tag(s):

        Provide comma separated tags that the PATROL Agent will use to get configuration from Central Monitoring Administration. Each tag follows the format TagName:Description. If there is a space in the description, enclose it with quotes. For example, WinOS:"Windows OS Monitoring".

    9. (Optional) Provide the cell configuration details.
      Enter the Infrastructure Management encryption key and the cell details in the format Host/Port.

      You can choose to route events via an Integration Service.


      To route events via an Integration Service, the /EventSetup/Configuration/ForwardEventsToIS PATROL Agent pconfig variable must be set to Yes

      During the upgrade of earlier versions of the BMC PATROL Agent, ensure to provide the correct Cell name in the Infrastructure Management - Primary Cell and Infrastructure Management - Secondary Cell fields in the Infrastructure Management Performance Management Cell Configurations installation screen.

      Proceeding with the default value resets the Event Destination of the BMC PATROL Agent to localhost/1828.

      If /EventSetup/Configuration/ForwardEventsToIS is set to Yes and Infrastructure Management - Primary Cell is set to localhost/1828, then the PATROL Agent sends events to the local Cell of the Integration Service.

    10. (Optional) Provide the RTSERVERS variable details.
      BMC PATROL 7 products communicate with each other through one or more RTservers. For previously installed PATROL Agents (version 3.5 or later), you must set the RTSERVERS variable and restart the PATROL Agent. Provide comma separated RTSERVERS variables in the format protocol:hostname:port. For example, tcp:localhost:2059.
    11. Configure the firewall.
      You can choose to automatically add the components to the firewall exception list.
  8. Review the deployable package details.

    If you added a monitoring solution that contains sub-components, click the plus sign to view the included sub-components.

  9. In the Installation Package Details window, enter the following information:

    • Name: The name of the deployable package. Can contain only A-Z, a-z, 0-9, and underscore (_).
    • (Optional)Description: Enter a description of the package.
      The description is displayed in the list of deployable packages.
    • Format: The default file format for the operating system is automatically selected. Select a different format if required.
  10. Perform one of the following steps:

    A template of the package is saved to the installationDirectory\truesightpserver\data\pproxy\installer_templates folder and is listed in the Deployable Packages tab.



    Pop-up blockers might prevent downloading the deployable package when you select Save and Download. Turn off pop-up blockers or click the pop-up blocked icon in the browser navigation bar to start downloading the deployable package.

Where to go from here

After creating deployable packages, perform one of the following:

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


  1. Ahmed Salman


    I need extract/create agent package without providing all parameters like installation directory, user name, password, etc. and provide these parameters during the installation.

    Please advise how to do this ...

    Jun 30, 2020 03:33
    1. Mukta Kirloskar

      Hello, Ahmed. Thank you for your comment. I have reached out to the R&D team for this information.

      Thank you.

      Jul 07, 2020 11:02
      1. Ahmed Salman

        Thanks Mukta.

        Please update us with R&D feedback.

        Jul 11, 2020 02:51
        1. Mukta Kirloskar

          Hello Ahmed,

          R&D tells us that it is not currently possible to provide these parameters during the installation.

          Thank you.

          Aug 06, 2020 01:03