Configuring the Continuous Optimization Agents

You can configure the Continuous Optimization Agents that are installed in your environment. The configuration includes updating values of parameters in the AgentSilentInstall.txt file. 

To modify the Agent configuration parameters

  1. Log in to the system where the Continuous Optimization Agent is installed.
    • (Windows) Log in as a user with administrator privileges.
    • (UNIX and Linux) Log in as a root user.
  2. Navigate to the directory where the Continuous Optimization Agent is installed. The default installation path is as follows:
    • (Windows): C:\Program Files\BMC Sofware\Patrol3
    • (UNIX and Linux): /opt/bmc/Patrol3
  3. Open the AgentSilentInstall.txt file.
  4. Update values of the required parameters.

    Parameter nameDescription
    installLocation

    Retain the following default installation directory path or type a new path:

    • (Windows) C:\Program Files\BMC Software\Patrol3
    • (Linux/opt/bmc/Patrol3

    Examples: 

    • (Windows) installLocation=C:\Program Files\BMC Software\Patrol3
    • (Linux) installLocation=/opt/bmc/Patrol3
    (UNIX and Linux) BPA_USER

    (Optional) Accept or override this default value.

    The AgentSilentInstallOptions.txt assigns a default value to this parameter.

    To override this value, type a username for installing the Continuous Optimization Agent. Specify a non-root username.

    Example: BPA_USER=sam

    (Windows) PERFORM_AGENT_START_WINDOWS

    Specify whether you want to start the Continuous Optimization Agent after installing.

    Default value: True

    Example: PERFORM_AGENT_START_WINDOWS=True

    (UNIX and Linux) PERFORM_AGENT_START_UNIX

    Specify whether the installer should start the Continuous Optimization Agent at the end of the installation.

    Default value: True

    Example: PERFORM_AGENT_START_UNIX=True

    PERFORM_AGENT_ENABLE_HISTORY

    Specify whether you want to enable the collection of historical data.

    Default value: True

    Example: PERFORM_AGENT_ENABLE_HISTORY=True

    PERFORM_AGENT_HISTORY_REPOSITORY

    Type a directory to store the collected historical data.

    Default value:
    (Windows) C:\Program Files\BMC Software\Patrol3\BEST1\<version_number>\History

    (UNIX and Linux) /opt/bmc/Patrol3/perform/history

    Example:
    PERFORM_AGENT_HISTORY_REPOSITORY=C:\Program Files\BMC Software\Patrol3\BEST1\23.4.00\History

    (UNIX and Linux) PERFORM_AGENT_COLLECT_REPOSITORY

    Type a directory path to store the data collected daily.

    Default value: /opt/bmc/Patrol3/perform/collect

    Example: PERFORM_AGENT_COLLECT_REPOSITORY=/opt/bmc/Patrol3/perform/collect

    (WindowsPERFORM_AGENT_MIGRATION

    Specify whether you want to migrate old configuration files of Continuous Optimization Agents.

    Default value: True

    Example: PERFORM_AGENT_MIGRATION=True

    PERFORM_AGENT_PORT

    Type the port number to be used by the Continuous Optimization Agent.

    Default value: 6767

    Example: PERFORM_AGENT_PORT=6767

    PERFORM_INVESTIGATE_PORT

    Type the port number to be used by the Investigate tool.

    Default value: 6768

    Example: PERFORM_INVESTIGATE_PORT=6768

    PERFORM_AGENT_SERVICE_PORT

    Type the port number to be used by the Agent service.

    Default value: 10128

    Example: PERFORM_AGENT_SERVICE_PORT=10128

    (UNIX and Linux) PERFORM_CREATE_DEFAULT_LINK

    Specify whether you want to create a default link.

    Default value: True

    Example: PERFORM_CREATE_DEFAULT_LINK=True

    PERFORM_PROCESS_LENGTH

    Type the process command length that the Agent must collect.

    Default value: 2048

    Other possible values are 4096, 8192, 16384, and 32768.

    Example: PERFORM_PROCESS_LENGTH=2048

    PERFORM_SECURITY_CONFIGURATION_TYPE

    Type Basic or Advanced for the security level that you want to use for communication between the Gateway Server and the Application Server. Use Advanced when a direct network connection does not exist between the Agent and the Gateway Server.

    Default value: BASIC

    Example: PERFORM_SECURITY_CONFIGURATION_TYPE=BASIC

    (UNIX and Linux)
    PERFORM_UNIX_MIGRATION

    Specify whether you want to upgrade the existing version of the Continuous Optimization Agent if detected.

    Default value: True

    Example: PERFORM_UNIX_MIGRATION=True

    (UNIX and Linux) PERFORM_UNIX_UNINSTALL

    Specify whether you want to uninstall the existing version of the Continuous Optimization Agent if detected.

    Default value: False

    Example: PERFORM_UNIX_UNINSTALL=False

    PERFORM_AGENT_IP_TYPE

    Type a number that indicates your preference for the protocol - IPv6 or IPv4.

    Default value: 46. This number indicates that the IPv6 protocol must be used only when the IPv4 protocol is not available.

    To force use of IPv6, type 64.

    Example: PERFORM_AGENT_IP_TYPE=46

    PERFORM_SSLCONF_SECURITY_LEVEL

    Defines the parameters that need to be enabled in the TLS configuration.

    Default value if not set: SOCKCOMM_SSL_NONE

    Valid values:

    • SOCKCOMM_SSL_NONE: TLS is Disabled
    • SOCKCOMM_TLSv1_3: Use TLSv1_3
    • SOCKCOMM_SSL_SKIP_HOST_CHECK: Client skips common name check against hostname
    • SOCKCOMM_SSL_ALLOW_EXPIRED_CERTIFICATE: Allow expired certificates
    • SOCKCOMM_SSL_NO_FALLBACK: Client does not fallback to plain sockets

    To specify more than one parameter for SSL configuration, separate them with "|" (pipe) symbol without any spaces in between.

    Example: PERFORM_SSLCONF_SECURITY_LEVEL=SOCKCOMM_TLSv1_3|SOCKCOMM_SSL_SKIP_HOST_CHECK

     
  5. Restart the Agent service:
    • (Windows) Restart the BGS_SDService service.
    • (UNIX and Linux
      1. Run this command to obtain the process IDs of the following agent servicesbgscollect and bgsagent
        ps -ef | grep bgs
      2. Run this command to kill the services:
        kill (process ID of bgscollect, process ID of bgsagent)
      3. Run the b1config<version>.sh script to start the services. The default location of the script is /opt/bmc/Patrol3.
    The Agent is configured with the updated parameter values.
  6. (Optional) Repeat these steps to configure the Continuous Optimization Agents that are installed on other managed systems.
Was this page helpful? Yes No Submitting... Thank you

Comments