Configuring the PATROL Agent to enable the default configuration

To configure the PATROL Agent to enable the default configuration

By default, the PATROL Agent uses either Transmission Control Protocol (TCP) or Secure Sockets Layer (SSL) protocol for communication. BMC provides an option to configure the PATROL Agent to enable TLS 1.2. If you have configured the system to be TLS 1.2 compliant and subsequently want to roll back to the default configuration the following section guides you to achieve the same. 

1. Navigate to the config_v3.0 folder by running the following command:

   # Microsoft Windows operating system
   $cd <PATROL Agent installation directory>\common\security\config_v3.0
    
   # Unix operating system
   $cd <PATROL Agent installation directory>/common/security/config_v3.0

2. Run the script to disableTLS mode as shown in the following code block:

   #Syntax
   set_unset_tls.cmd <$BMC_ROOT> <SET_TLS;UNSET_TLS> <security_level> -serverDbPath <serverDbPath> -clientDbPath <clientDbPath> -identity <identity>
   #Example
   $set_unset_tls.cmd "C:\Program Files (x86)\BMC Software" UNSET_TLS 0 -serverDbPath "C:\Certificates\server_db" -clientDbPath "C:\Certificates\client_db" -identity bmcpatrol

   Notes

   • Use set_unset_tls.cmd script on the Microsoft Windows operating system, and set_unset_tls.sh script on the Unix operating system.

   • When you run the set_unset_tls.sh script on AIX and HP-UX operating systems to enable TLS 1.2, the system creates symbolic links for Mozilla NSS v3.20 libraries in the default system library directory /usr/lib.

   • set_unset_tls.sh -h will display the help for the set_unset_tls command.
   • There are six command line arguments for the set_unset_tls script as explained in the following section:
     • BMC_ROOT: The directory where the PATROL Agent is installed.
     • SET_TLS / UNSET_TLS: The second command line argument can either be SET_TLS, or UNSET_TLS. If you select SET_TLS, the PATROL Agent is configured in TLS mode. If you select UNSET_TLS, the PATROL Agent is configured in Non-TLS mode.
     • security_level: Applicable security levels are 2,3, and 4.
     • serverDbPath: The directory where the server certificates are present. This argument is mandatory if the security_level is set to 3.
     • clientDbPath: The directory where the client certificates are present. This argument is mandatory if the security_level is set to 3.
     • identity: The certificate identity. If you do not specify any value to this argument, the default value is set to bmcpatrol.

Related topics