Rolling back to SSL configuration
By default, TrueSight Infrastructure Management and its associated components use Transport Layer Security (TLS) versions earlier than TLS 1.2 to communicate with each other. BMC provides an option to upgrade the security in your enterprise environment by using TLS 1.2 to communicate with TrueSight Infrastructure Management components. 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.
There are different communication channels established between the components of the TrueSight Infrastructure Management components. Perform the roll back operations per communication channel. Select the communication channel which you want to roll back and perform the tasks accordingly. To roll back to default configuration, complete the procedures by navigating the following tabs. The following table lists the abbreviations and their definitions used in the tabs.
Abbreviation | Definition |
---|---|
TSIM | TrueSight Infrastructure Management |
TSPS | TrueSight Presentation Server |
IS | TrueSight Integration Service |
PA | BMC PATROL Agent |
IIWS | BMC Impact Integration Web Services |
PS | BMC Publishing Server |
Perform the following steps to roll back the Infrastructure Management Server to the Presentation Server communication to default configuration:
- Step 1:To configure the Presentation Server
- Step 2:To configure the Infrastructure Management Server
- Step 3:To start the servers
- Step 4:To register the Infrastructure Management Server with the Presentation Server
To configure the Presentation Server
Navigate to the <Presentation Server Install Directory>\truesightpserver\bin directory, and run the following command to check whether the TrueSight Presentation Server is running.
tssh server statusLog on to the TrueSight console and select Administration> Components.
Displays the components that are registered with the Presentation Server. Ensure that no TrueSight Infrastructure Management Server is registered with the TrueSight Presentation Server. If a TrueSight Infrastructure Management Server is registered delete the same. For more information, see To delete a component
Set the property in the database by running the following command:
tssh properties set tsps.cell.conntype tcp
tssh properties set pronet.jms.conntype tcp- Using a text editor, open mcell.dir file located in <Presentation Server Install Directory>\conf directory.
Comment out the instances of the code lines having the encryption key value as *TLS as shown in the following code block:
#Type <name> encryption key <host>/<port>
#gateway.gateway_subtype ts_event_gateway *TLS localhost:1900
#cell pncell_tsim_server1 *TLS tsim_server1.bmc.com:1828Set the encryption key value to mc as shown in the following code block:
#Type <name> encryption key <host>/<port>
gateway.gateway_subtype ts_event_gateway mc localhost:1900
cell pncell_tsim_server1 mc tsim_server1.bmc.com:1828- Save and close the file.
Stop the Presentation Server by running the following command:
tssh server stop
To configure the Infrastructure Management Server
Stop the Infrastructure Management Server by running the following command:
pw system stop- Navigate to the <Infrastructure Management Server Install Directory>\pw\wildfly\store directory location.
- Open the tcp.activemq-rar.rar file and extract the amq-broker-config.xml file.
- Take a backup of the amq-broker-config.xml file.
In the amq-broker-config.xml file, update the URI attribute of transportConnector property to the new port number as shown in the following example:
- After the change, save the amq-broker-config.xml file and add it to the tcp.activemq-rar.rar file in the <Infrastructure Management Server Install Directory>\pw\wildfly\store directory again.
Navigate to the <Infrastructure Management Server Install Directory>\pw\pronto\bin directory by running the following command:
# Microsoft Windows operating system
$cd <Infrastructure Management Server Install Directory>\pw\pronto\bin
# Unix operating system
$cd <Infrastructure Management Server Install Directory>/pw/pronto/binNavigate to the <Infrastructure Management Server Install Directory>\pw\pronto\bin directory, and run the switchTLSMode.pl script as shown in the following code block:
#Syntax perl switchTLSMode.pl -<on/off> -flow <communication channel> -tsps <TrueSight Presentation Server name>
#Example
perl switchTLSMode.pl -off -flow event_and_data -tsps myserver.bmc.com
To start the servers
Start the Presentation Server by running the following command:
tssh server startStart the Infrastructure Management Server by running the following command:
pw system start
To register the Infrastructure Management Server with the Presentation Server
Ensure that all the processes of the Infrastructure Management Server are up by running the following command:
pw p lRegister the Infrastructure Management Server with the Presentation Server. For more information, see Registering the component products with the Presentation Server.
Perform the following steps to roll back the Integration Service to Infrastructure Management Server communication to default configuration. Select the steps based on the type of the Integration Service.
- Step 1: To configure the local Integration Service
- Step 2: To configure the remote Integration Service
- Step 3: To start the servers
To configure the local Integration Service
Stop the Infrastructure Management Server by running the following command:
pw system stop- Using a text editor, open pronet.conf file located in <Infrastructure Management Server Install directory>\pw\custom\conf directory.
Comment out the instance of the code line having the conntype value as ssltcpas shown in the following code block:
#pronet.apps.agent.conntype=ssltcpSet the conntype value to tcp as shown in the following code block:
#Configuration settings to roll back the default configuration between Infrastructure Management Server to Local Integration Service
pronet.apps.agent.conntype=tcp- Save and close the file.
To configure the remote Integration Service
Stop the Infrastructure Management Server by running the following command:
pw system stop- Using a text editor, open pronet.conf file located in <Infrastructure Management Server Install directory>\pw\custom\conf directory.
Comment out the instance of the code line having the conntype value as ssltcp as shown in the following code block:
#pronet.apps.agent.conntype=ssltcpSet the conntype value to tcp as shown in the following code block:
pronet.apps.agent.conntype=tcp- Save and close the file.
Stop the Integration Service. For more information, see Starting and stopping the TrueSight Operations Management components.
- Using a text editor, open pronet.conf file located in <Integration Service Install directory>\agent\pronto\conf directory.
Comment out the instance of the code line having the conntype value as ssltcp as shown in the following code block:
#pronet.apps.agent.conntype=ssltcpSet the conntype value to tcp as shown in the following code block:
pronet.apps.agent.conntype=tcp- Save and close the file.
To start the servers
Start the Infrastructure Management Server by running the following command:
pw system startStart the Integration Service. For more information, see Starting and stopping the TrueSight Operations Management components.
The following section guides you to configure the Integration Service to Cell communication to enable default configuration. Choose the appropriate configuration steps based on the type (local / remote) of the Integration Service and the cell used.
- Step 1: To configure the local Integration Service
- Step 2: To configure the remote Integration Service
- Step 3: To configure the default Infrastructure Management Cell
- Step 4: To configure a remote Cell
- Step 5: To start the servers
To configure the local Integration Service
Stop the Infrastructure Management Server by running the following command:
pw system stop- Using a text editor, open pronet.conf file located in <Infrastructure Management Server Install directory>\pw\custom\conf directory.
Comment out the instance of the code line having the encryptionkey value as *TLS as shown in the following code block:
#pronet.apps.is.cell.encryptionkey=*TLSSet the encryptionkey value to mc as shown in the following code block:
pronet.apps.is.cell.encryptionkey=mc- Save and close the file.
- Using a text editor, open mcell.dir file located in <Infrastructure Management Server Install directory>\pw\server\etc directory.
Comment out the instances of the code lines having the encryption key value as *TLS as shown in the following code block:
#Type <name> encryption key <host>/<port>
#cell_1 pncell_tsim_server1 *TLS cell_1.bmc.com:1828
#cell HA_Cell *TLS primaryhost.bmc.com:1828 secondaryhost.bmc.com:1828Set the encryption key value to mc as shown in the following code block:
#Type <name> encryption key <host>/<port>
cell_1 pncell_tsim_server1 mc cell_1.bmc.com:1828
cell HA_Cell mc primaryhost.bmc.com:1828 secondaryhost.bmc.com:1828
To configure the remote Integration Service
Log in to the computer where the remote Integration Service is installed, and stop the Integration Service. For more information, see Starting and stopping the TrueSight Operations Management components.
- Using a text editor, open pronet.conf file located in <Integration Service Install directory>\agent\pronto\conf directory.
Comment out the instance of the code line having the encryptionkey value as *TLS as shown in the following code block:
#pronet.apps.is.cell.encryptionkey=*TLSSet the encryptionkey value to mc as shown in the following code block:
pronet.apps.is.cell.encryptionkey=mc- Save and close the file.
- Using a text editor, open mcell.dir file located in <Integration Service Install directory>\Agent\server\etc directory.
Comment out the instances of the code lines having the encryption key value as *TLS as shown in the following code block:
#Type <name> encryption key <host>/<port>
#cell_1 pncell_tsim_server1 *TLS cell_1.bmc.com:1828
#cell HA_Cell *TLS primaryhost.bmc.com:1828 secondaryhost.bmc.com:1828Set the encryption key value to mc as shown in the following code block:
#Type <name> encryption key <host>/<port>
cell_1 pncell_tsim_server1 mc cell_1.bmc.com:1828
cell HA_Cell mc primaryhost.bmc.com:1828 secondaryhost.bmc.com:1828- Save and close the file.
To configure the default Infrastructure Management Cell
- Stop the cell service
(Unix) Run the following command:
mkill -n cellname- (Microsoft Windows) Navigate to Start > Settings > Control Panel.
- Double-click the Services icon to launch the Services dialog box.
- Locate the BMC TrueSight Event Manager cell_name or BMC TrueSight Event Manager HA_CELL on the list of services, highlight, then click Stop.
- Click Yes to close the warning message that is displayed.
The status for the cell service changes from Started to (blank).
- Using a text editor, open mcell.conf file located in <Infrastructure Management Server Install Directory>\pw\server\etc\pncell_<TSIM_MACHINE_NAME> directory.
Comment out the instance of the code line having the ServerTransportProtocol value as tls as shown in the following code block:
#ServerTransportProtocol=tlsSet the properties as shown in the following code block:
ServerTransportProtocol=tcp
ServerCertificateFileName=mcell.crt
ServerPrivateKeyFileName=mcell.key- Save and close the file.
To configure a remote Cell
- Logon to the computer where the remote cell is installed.
- Stop the cell service.
(Unix) Run the following command:
mkill -n cellname- (Microsoft Windows) Navigate to Start > Settings > Control Panel.
- Double-click the Services icon to launch the Services dialog box.
- Locate the BMC TrueSight Event Manager cell_name or BMC TrueSight Event Manager HA_CELL on the list of services, highlight, then click Stop.
- Click Yes to close the warning message that is displayed.
The status for the cell service changes from Started to (blank).
- Using a text editor, open mcell.conf file located in <Remote Cell Install Directory>\pw\server\etc\cell_name directory.
Comment out the instance of the code line having the ServerTransportProtocol value as tls as shown in the following code block:
#ServerTransportProtocol=tlsSet the properties as shown in the following code block:
ServerTransportProtocol=tcp
ServerCertificateFileName=mcell.crt
ServerPrivateKeyFileName=mcell.key- Save and close the file.
To start the servers
- Start the cell service:
(Unix) Run the following command:
mcell -n cellname- (Microsoft Windows) Navigate to Start > Settings > Control Panel.
- Double-click the Services icon to launch the Services dialog box.
- Locate the BMC TrueSight Event Manager cell_name or BMC TrueSight Event Manager HA_CELL on the list of services, highlight, then click Restart.
- Click Yes to close the warning message that is displayed.
The status for the cell service changes to Started from (blank).
Start the Integration Service. For more information, see Starting and stopping the TrueSight Operations Management components.
Perform the following steps to roll back the Infrastructure Management Server to Oracle database communication to default configuration.
To configure the Infrastructure Management Server
Stop the Infrastructure Management Server by running the following command:
pw system stopNavigate to the <Infrastructure Management Server Install Directory>\pw\pronto\bin directory, and run the switchTLSMode.pl script as shown in the following code block:
#Syntax
perl switchTLSMode.pl -<on/off> -flow <communication channel> -dbport <Oracle Database port> -dbver <Oracle Database version>
#Example
perl switchTLSMode.pl -off -flow oracle -dbport 1521 -dbver 19COpen the pronet.conf file in the <Infrastructure Management Server Install directory>\pw\custom\conf directory, and verify that the configuration parameters are set as shown in the following code block:
pronet.api.database.portnum=1521
#Configuration settings to make TLS compliant
pronet.api.database.conntype=tcp- Verify that the JDBC driver ojdbc7_patched.jar is copied in the <TrueSight Installation Directory>\pw\apps3rdparty\jdbc directory.
Start the Infrastructure Management Server by running the following command:
pw system start
Perform the following steps to roll back the PATROL Agent to Integration Service communication to default configuration.
- Step 1a: To configure the remote Integration Service
- Step 1b: To configure the local Integration Service
- Step 2: To configure the PATROL Agent
- Step 3: To start the servers
To configure the remote Integration Service
Stop the Integration Service. For more information, see Starting and stopping the TrueSight Operations Management components.
Navigate to the <Remote Integration Service Install Directory>\agent\patrol\common\security\config_v3.0 directory by running the following command:
# Microsoft Windows operating system
$cd <Remote Integration Service install directory>\agent\patrol\common\security\config_v3.0
# Unix operating system
$cd <Remote Integration Service install directory>/agent/patrol/common/security/config_v3.0Run the following command:
#Syntax
set_unset_tls_IS.cmd <$BMC_ROOT> <SET_TLS;UNSET_TLS> <security_level> -serverDbPath <serverDbPath> -identity <identity>
#Example
$set_unset_tls_IS.cmd <Remote Integration Service Install Directory> UNSET_TLS 2 -serverDbPath "C:\Certificates\server_db" -identity "PatrolServer - BMC"
To configure the local Integration Service
Stop the Infrastructure Management Server by running the following command:
pw system stopNavigate to the <Infrastructure Management Server Install Directory>\agent\patrol\common\security\config_v3.0 directory by running the following command:
# Microsoft Windows operating system
$cd <Infrastructure Management Server Install Directory>\pw\patrol\common\security\config_v3.0
# Unix operating system
$cd <Infrastructure Management Server Install Directory>/pw/patrol/common/security/config_v3.0Run the following command:
#Syntax
set_unset_tls_IS.cmd <$BMC_ROOT> <SET_TLS;UNSET_TLS> <security_level> -serverDbPath <serverDbPath> -identity <identity>
#Example
$set_unset_tls_IS.cmd <Infrastructure Management Server Install Directory>\pw UNSET_TLS 2 -serverDbPath "C:\Certificates\server_db" -identity "PatrolServer - BMC"
To configure the PATROL Agent
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.
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.0Run 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
To start the servers
Restart the following servers based on the Integration Service type.
- Start the Integration Service:
(Local Integration Service) Run the following command:
pw system start(Remote Integration Service) Start the remote Integration Service. For details, see Starting and stopping the TrueSight Operations Management components.
Start the PATROL Agent by running the following command:
#If you do not specify the port number, the PATROL Agent will use the default port number, 3181.
patrolagent -p <port number>For more information, see Starting and stopping the PATROL Agent.
Perform the following steps to roll back the Infrastructure Management Server to BMC Impact Integration Web Services (IIWS) communication to default configuration.
- Step 1: To configure the Infrastructure Management Server
- Step 2: To configure the BMC Impact Integrations Web Services server
- Step 3: To start the servers
To configure the Infrastructure Management Server
Stop the Infrastructure Management Server by running the following command:
pw system stop- Using a text editor, open the mcell.dir located in the <Infrastructure Management Server Install Directory>\server\etc directory.
Comment out the instance of the code line having the encryption key value as *TLS as shown in the following code block:
#gateway.imcomm IIWSGatewayServer *TLS IIWSGatewayServer.bmc.com:1859Set the encryption key as shown in the following code block:
gateway.imcomm IIWSGatewayServer mc IIWSGatewayServer.bmc.com:1859- Save and close the file.
To configure the BMC Impact Integrations Web Services server
Navigate to the <Impact Web Services installation directory>\tomcat\webapps\imws\WEB-INF\etc directory by running the following command:
# Microsoft Windows operating system
$cd <Impact Web Services installation directory>\tomcat\webapps\imws\WEB-INF\etc
# Unix operating system
$cd <Impact Web Services installation directory>/tomcat/webapps/imws/WEB-INF/etc- Using a text editor, open the mcell.dir file.
Comment out the instances of the code lines having the encryption key value as *TLS as shown in the following code block:
#type Name encryption key <Host>:1828
#gateway.imcomm IIWSGatewayServer *TLS localhost:1859
#cell pncell_tsim_server *TLS tsim_server.bmc.com:1828Set the encryption key value to mc as shown in the following code block:
#syntax
#type Name encryption key <Host>:1828
#example
gateway.imcomm IIWSGatewayServer mc localhost:1859
cell pncell_tsim_server mc tsim_server.bmc.com:1828- Save and close the file.
To start the servers
Start the Infrastructure Management Server by running the following command:
pw system start- Restart the IIWS server by running the following commands:
- From the desktop or Start menu, navigate to Services.
- To stop the server, select the BMC Impact Integration Web Services service, and right-click to open the menu. The service name is BMCIWS, and the display name is Impact Integration Web Service.
- To stop the application server, select Stop.
Perform the following steps to roll back the Infrastructure Management Server to BMC TrueSight Operations Management Reporting communication to default configuration.
- Step 1: To configure the Infrastructure Management Server
- Step 2: To configure the BMC TrueSight Operations Management Reporting
- Step 3: To start the servers
To configure the Infrastructure Management Server
Stop the Infrastructure Management Server by running the following command:
pw system stop- Using a text editor, open the mcell.dir located in the <Infrastructure Management Server Install Directory>\pw\custom\conf directory.
Comment out the instance of the code line having the encryption key value as *TLS as shown in the following code block:
#Type <name> encryption key <host>/<port>
#cell ts_event_gateway *TLS localhost:1900Set the encryption key value to mc as shown in the following code block:
#Type <name> encryption key <host>/<port>
cell ts_event_gateway mc localhost:1900- Save and close the file.
To configure the BMC TrueSight Operations Management Reporting
Stop the Reporting engine service. For more information, see Stopping the Reporting Engine service.
Navigate to the reportsCLIdirectory by running the following command:
# Microsoft Windows operating system
$cd <TrueSight Operations Management Reporting Install directory>\bin\reportsCLI
# Unix operating system
$cd <TrueSight Operations Management Reporting Install directory>/bin/reportsCLIRun the command as shown in the following code block:
TLSConfig disable -keystore <keystorefile> -keystorepassword <keystore password> -truststore <truststorefile> -truststorepassword <truststore password>
To start the servers
Start the Infrastructure Management Server by running the following command:
pw system startRestart the TrueSight Operations Management Reporting component. For more information, see Starting the TrueSight Operations Management Reporting Engine service
Perform the following steps to roll back the Publishing Server to Infrastructure Management server communication to default configuration.
Stop the Infrastructure Management Server by running the following command:
pw system stop- Using a text editor, open the mcell.dir located in the <Infrastructure Management Server Install Directory>\pw\custom\conf directory.
Comment out the instances of the code lines having the encryption key value as *TLS as shown in the following code block:
#Type <name> encryption key <host>/<port>
#cell pncell_hostname *TLS pncell_hostname.bmc.com:1828
#gateway.imcomm gw_ps_pncell_hostname *TLS hostname.bmc.com:1839Set the encryption key value to mc as shown in the following code block:
#Type <name> encryption key <host>/<port>
cell pncell_hostname mc pncell_hostname.bmc.com:1828
gateway.imcomm gw_ps_pncell_hostname mc hostname.bmc.com:1839- Save and close the file.
- Using a text editor, open the smmgr.conf located in the <Infrastructure Management Server Install Directory>\pw\server\etc directory.
Comment out the instance of the code line having the ServerTransportProtocol value as tls as shown in the following code block:
#ServerTransportProtocol=tlsSet the properties as shown in the following code block:
ServerTransportProtocol=tcp
ServerCertificateFileName=mcell.crt
ServerPrivateKeyFileName=mcell.key- Save and close the file.
Start the Infrastructure Management Server by running the following command:
pw system start
Where to go from here
Securing-communication-among-Infrastructure-Management-components