Installing the Infrastructure Management server in the high-availability cluster mode using the wizard
Where you are in the Installation process
You need to perform the following tasks to install the Infrastructure Management server in the high-availability cluster mode using the wizard:
- Step A: To install the Infrastructure Management server on the primary computer (Windows and Linux)
- Step B: To perform post-install tasks after installing on the primary computer
- Step C: To install the Infrastructure Management server on the secondary computer
- Step D: To perform post-install tasks after installing on the secondary computer
Step A: To install the Infrastructure Management server on the primary computer
You can manually install the TrueSight Infrastructure Management server on the primary computer. Automatic Failover is handled by the Microsoft Cluster Server software. Infrastructure Management server can be installed with Oracle or SAP SQL Anywhere as the database. Infrastructure Management is integrated with SAP SQL Anywhere, which is configured by default. If you want to install it with Oracle, you can configure the Oracle database during installation.
Do the following:
- Log in to the host computer on which the cluster is installed. Ensure that the cluster is pointing to the host computer on which you plan to install the primary Infrastructure Management server.
- Delete all the files from the temporary directory:
- (Windows) %temp%
- (Linux) /tmp
- Extract the downloaded zip files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts:
- (Windows) S:\Program Files
- (Linux) /opt
- (Linux) Apply executable rights to all the installation files by running the following command: chmod -R 755 installationDirectoryFolderName installationDirectoryFolderName is the name of the folder that contains all the installation files.For example, chmod -R 755 Disk1
- (Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately.
export DISPLAY=<IP address of the host computer>:0.0 - (Linux) Change the host name of the primary computer to the logical host name configured for the cluster by entering hostname logicalHostName. For example, hostname bmccluster.bmc.com.
Navigate to the Disk1 directory of the extracted folder, use one of the following options to run the installer.
BMC recommends that you run the installer by using install.cmd and not setup.exe.
- Review the welcome page, and click Next.
- Read the license agreement, agree to the terms, and click Next.
- (Windows) Start the Windows Firewall service from services.msc and run the following commands:
- (Microsoft Windows 2012 R2) netsh advfirewall set allprofiles state on
- (Microsoft Windows 2012) netsh firewall set opmode mode = ENABLE
- (Windows) On the Configuring Firewall Rules page, perform one of the following tasks, and click Next.
- Select Automatically configure the Windows Firewall rules.
- The Windows Firewall inbound rules are configured.
- Select I will manually configure Windows Firewall Rules now before proceeding further and configure inbound rules for the pw processes that are listed on the page.
If you prefer to use a third party firewall application that is installed on your computer, you must manually create the firewall inbound rules. For more information about creating firewall inbound rules, refer to the documentation of the third party firewall application.
(Windows) On the Cluster Group Configuration page, select one of the following Cluster Group types, type the cluster group name, and click Next:
- Default cluster group
- Custom cluster group
Set the installation directory.
- (Windows) The default directory is S:\Program Files\BMC Software\TrueSight
- (Linux) During the installation, choose the cluster file system (/global) that is shared on both the primary and secondary computers as the installation location.
- Select the configuration tasks that you want to perform, and click Next.
By default, Administrator e-mail from BMC TrueSight Infrastructure Management is selected. You can deselect it.By default, SAP SQL Anywhere, which is integrated with TrueSight Infrastructure Management, is configured. If you want, you can choose to configure the Oracle database instead. - (Optional) Based on your selection, the applicable configuration pages are displayed. Type the appropriate details, and click Next.
- (Oracle database only) If you are configuring an Oracle database, specify these details, and click Next.
- Review the installation details, and click Install. The installation may take upto 30 minutes.After the installation is complete, the Installation Summary page is displayed.
- Select View Logs to open the installation logs.
- (Linux) Verify that the following environment variables are set.
- $BPPM_SERVER_HOME
- $BMC_PROACTIVENET_HOME
- Run the following command to verify the Infrastructure Management installation:(Windows) # pw system status
(Linux)# pw system statusA list of pw server processes is displayed.
If errors occur, restart the BMC TrueSight Infrastructure Management Server by running the following command:(Windows)# pw system start
(Linux) # pw system start
BMCTrueSight.service (Applicable only to version 11.3.04 and later on Linux)You can use the systemd service BMCTrueSight.service located in the /etc/systemd/system directory to start and stop the Infrastructure Management server on Linux. For more information, see Starting and stopping the TrueSight Operations Management components. - Apply the Infrastructure Management license. When you purchased the product, you would have received the following license files in a .zip file from your BMC Software representative:
- proactivenet.lic
- proactivenet.sign
- (Linux) After successful installation of the Infrastructure Management server, change the logical host name back to the host name of the primary computer by entering hostname primaryHostName.
- (Linux) Remove the following files so that the Infrastructure Management server processes do not start automatically:
- /etc/rc3.d/S81BMCTrueSight
- /etc/rc0.d/K09BMCTrueSight
- /etc/rc1.d/K09BMCTrueSight
(Linux) If you installed Infrastructure Management Server as a non-root user, do the following:
- Configure the TrueSight Infrastructure Management process to automatically start each time the TrueSight Infrastructure Management server is restarted. To do this, register the process as a service by running the script described in the following procedure. Running this script also results in copying the Integration Service security files required by the PATROL Agent to connect with the Integration Service.
- Locate the script at <Infrastructure-Management-Installation-Directory>/pw/scripts.
- Run the script in the following format:
create_startup_script.sh [<Non-root-User-Name>]
where, <Non-root-User-Name> refers to the non-root user name with which the process must be registered as a service.
Providing the non-root user name is optional. If you do not provide the non-root user name, by default, the script uses the non-root user name used for installing TrueSight Infrastructure Management to register the service.
- After you have installed the Infrastructure Management server using a non-root user, ensure that you do not restart the cell as a root user.
- Configure the TrueSight Infrastructure Management process to automatically start each time the TrueSight Infrastructure Management server is restarted. To do this, register the process as a service by running the script described in the following procedure. Running this script also results in copying the Integration Service security files required by the PATROL Agent to connect with the Integration Service.
- (Windows) Go to the <DownloadLocation>\TSIMServer\Disk1\utility directory, and open the TrueSightIMMaintenanceTool.
- (Windows) Run the tool, and click the Logs tab.
- (Windows) Click Install Log to view the tsim_server_install_log.txt file.
- (Windows) Click File and use the Save as command to open the Save as dialog box.
- (Windows) Select Project Options File from the Save As Type list.
- (Windows) Type the file name and click Browse to navigate to the directory where you want to save the options file as shown in the following example:
- (Windows) Click OK to save the file.
(Windows) Open (or edit) the options file and update the INSTALL_TYPE property as SECONDARY as shown in the following code block:
INSTALL_TYPE=SECONDARY- (Windows) Copy the options file to the shared drive.
Note: After the cluster points to the secondary computer, the options file will be accessible by the computer on which you plan to install the secondary Infrastructure Management Server.
Step B: To perform post-install tasks after installing on the primary computer
Post-install tasks on Windows
- Stop the TrueSight Infrastructure Management server on the primary server.
- Move the cluster control to the secondary server.
Post-install tasks on Linux
- Stop all processes on the primary computer by running the following command:
pw sys stop. Move the shared disk from the primary computer to the secondary computer by running the following commands on the primary computer:
(For RHEL 6.x) clusvcadm -r logicalhostname -n Standbymodehostname(For RHEL 7.x) pcs resource move <resource group name> Standbymodehostname
Do not execute the above commands on the shared disk.
Step C: To install the Infrastructure Management server on the secondary computer
Installing on Windows
Do the following:
- Log in to the host computer on which the cluster is installed. Ensure that the cluster is pointing to the host computer on which you plan to install the secondary Infrastructure Management server.
- Delete all the files from the temporary directory:
%temp% Extract the downloaded zipped files (the installer) to a temporary location outside the following directory location to avoid any file sharing conflicts:
S:\Program FilesNavigate to the Disk1 directory of the extracted folder, and run one of the following commands from the command prompt:
- Review the welcome page, and click Next.
- Read the license agreement, agree to the terms, and click Next.
- (Windows) Start the Windows Firewall service from services.msc and run the following commands:
- (Microsoft Windows 2012 R2) netsh advfirewall set allprofiles state on
- (Microsoft Windows 2012) netsh firewall set opmode mode = ENABLE
- (Windows) On the Configuring Firewall Rules page, perform one of the following tasks, and click Next.
- Select Automatically configure the Windows Firewall rules.
- The Windows Firewall inbound rules are configured.
- Select I will manually configure Windows Firewall Rules now before proceeding further and configure inbound rules for the pw processes that are listed on the page.
If you prefer to use a third party firewall application that is installed on your computer, you must manually create the firewall inbound rules. For more information about creating firewall inbound rules, refer to the documentation of the third party firewall application.
If required, you can change the following default installation directory, and click Next:
S:\Program Files\BMC Software\TrueSight
- Review the installation details, and click Install. The installation may take upto 30 minutes.After the installation is complete, the Installation Summary page is displayed.
- Select View Logs to open the installation logs.
Run the following command to verify the Infrastructure Management installation:
pw system status
A list of pw server processes is displayed.
If errors occur, restart the Infrastructure Management server by running the following command:
pw system start
Installing on Linux
Do the following:
- Copy the /etc/patrol.d folder from the primary computer to the secondary computer (in the same location).
This step is needed to enable the PATROL Agent to connect to the Integration Service. - On the secondary computer, perform the following steps to create environment variables:
- Copy the bmc_profile and the bmc_cshrc files from the user's home directory on the primary computer to the secondary computer (in the same location).
- On the secondary computer, perform the following actions:
- In the <User-Home-Directory>/.bash_profile file, add the following entry, and save the file.
- <User-Home-Directory>/.bmc_profile
- /home/jack/.bmc_profile
- In the <User-Home-Directory>/.bashrc file, add the following entry, and save the file.
- <User-Home-Directory>/.bmc_cshrc
- {{code language="none"}}
/home/jack/.bmc_cshrc
{{/code}}
- Log out and then log in to the secondary computer so that the changes made in the preceding steps are applied.
- In the <User-Home-Directory>/.bash_profile file, add the following entry, and save the file.
- On the secondary computer, create the required links for the Infrastructure Management server by entering the following commands:
- ln -s /serverInstallDirectory/pw /usr/pw
- ln -s /usr/pw/pronto /usr/pronto
- ln -s /usr/pw/pronto/bin/pw /bin/pw
- Start all processes on the secondary computer. Use the following command:
pw sys start
BMCTrueSight.service (Applicable only to version 11.3.04 and later on Linux)You can use the systemd service BMCTrueSight.service located in the /etc/systemd/system directory to start and stop the Infrastructure Management server on Linux. For more information, see Starting and stopping the TrueSight Operations Management components. - On the secondary computer, check for the Infrastructure Management server crontab entries:
- Identify the crontab entries by using the crontab -l command and check for all entries between the lines # begin_pronto and # end_pronto.
- If the crontab entries are missing, open the command prompt, navigate to the <installDirectory>\pw\scripts folder, and run the following command:
CreateCrontabEntries.sh linux <Database>
where <Database> can be Oracle or SAP SQL Anywhere
For example, CreateCrontabEntries.sh linux Oracle
Step D: To perform post-install tasks after installing on the secondary computer
Post-install tasks on Windows
After you complete the installation on the secondary computer, do the following:
- Run the pns.reg file located at installationDirectory\pw\pproxy\PNS\security. If you do not run this file, existing policy configurations are not applied on the PATROL Agent during a failover, and therefore policy creation and update fails.
Go to installationDirectory\pw\patrol\pis\security\bppmpis.reg, and find all the keys that contain single slashes in the path value. Replace the single slashes with double slashes. Use the following examples:
- Import the installationDirectory\pw\patrol\pis\bppmpis.reg file in the registry.
- Create dependencies for the Infrastructure Management server cluster resource.
- Stop the Infrastructure Management server using the pw system stop command.
- Go to Start > All Programs > Administrative Tools > Failover Cluster Manager and click on the cluster name.
- Scroll down to the Cluster Core Resources section, right-click PnService, and click Properties.
- In the PnService Properties dialog box, click the Dependencies tab.
- Click Insert to add a resource.
- From the Resource list, select a cluster name and click Insert.
- Select the cluster resource with the ‘AND’ option. Similarly, add all the resources (Name, IP address, and Disk).
- Click Apply and OK.
- Restart the Infrastructure Management server using the pw system start command.
Restart both the primary and secondary servers.
Register Infrastructure Management server with the Presentation Server.
- Use the following format to define the Infrastructure Management Server URL, and launch the application in a browser.
- (Windows) http(s)://<TSIMFQDN>
- (Linux) http(s)://<TSIMFQDN>
- Type the default Admin credentials (User name: admin, Password: admin12345), and click Log In.
The Infrastructure Management console opens.
Post-install tasks on Linux
Do the following:
Register Infrastructure Management server with the Presentation Server.
- After moving the shared disk from the primary computer to the secondary computer, the status of all the TrueSight Infrastructure Management components must be displayed as Connected on the TrueSight console.
- The Infrastructure Management server must successfully connect to Integration Service and PATROL Agent.
Related topics
For information about adding a failover domain and other post-installation tasks, see:
Next step in the Installation process
Step 5 Phase B — Now that you have successfully installed the Infrastructure Management Server, you must install the Integration Service and Remote Cell.