In the OS level high availability (HA) mode, you must install the Integration Service on both, the primary and the secondary servers.
Note
Log in to a virtual node (assuming that the cluster service is started on both the primary and secondary servers).
Copy the Integration Service installer (TSIMAgent.zip) on the local drive (for example, C:\).
Set the environment variable PATROL_VIRTUALNAME=<virtual IP address of the cluster>.
Open the command prompt using the Run as administrator option and access the install.cmd file located in the TSIMAgent\windows directory.
install.cmd -J INSTALL_TYPE=PRIMARY
On the License Agreement screen, select I agree to the terms of the license agreement and click Next.
The pre-installation check utility verifies whether or not the computer meets the requirements for installing the Integration Service.
If the pre-installation check fails, click Cancel, correct the issues if there are errors or warnings listed in the Pre-install Validation Summary window, and restart the installation process. If you do not want to resolve the warnings click Next.
If Microsoft .NET Framework is not found on the computer, a warning message is displayed. Install Microsoft .NET Framework version 3.0 using the Role Management tool.
On the Directory Selection screen, accept the default directory or choose a different directory and click Next. Do not install the product in a root directory (for example, C:\ or D:\), shared drive, or directly under the Documents and Settings folder.
Select the features for Integration Service. By default, Integration Service and Remote Cell are selected.
On the Configuring Remote Cell screen, enter the following details:
Field | Description |
---|---|
Instance Name | Type the cell instance name. The default is <host name>. Note: Hyphens and underscores are the only special characters allowed for cell instance names. |
Port | Enter a port number in the range of 1024 to 65535. The default port number of the cell is 1828. |
Encryption Key | Enter the cell encryption key. The default is mc. No special characters are allowed. |
On the Installation Preview screen where the installation details are displayed, click Install.
The Integration Service installation process begins. This process may take several minutes to complete.
On the Installation Summary screen, click View Log to view the log file and click Done to exit the installation.
A message that the installation is complete on the primary server is displayed.
Notes
Log in to the virtual node (assuming clustering service is started on both the primary and the secondary servers).
Copy the Integration Service installer (TSIMAgent.zip) on the local drive (for example, C:\).
Set the environment variable PATROL_VIRTUALNAME=<virtual IP address of the cluster>.
At the command prompt, access the install.cmd file located in the TSIMAgent\Windows directory.
Run the following command as an administrator:
Note
Before running the following command, ensure to do the following in the options file:
INSTALL_TYPE
parameter, add this parameter with value as SECONDARY
, that is, INSTALL_TYPE=SECONDARY
.PRIMARY
, update it to SECONDARY
. That is, modify the value of INSTALL_TYPE=PRIMARY
to INSTALL_TYPE=SECONDARY
. install.cmd -DOPTIONS_FILE=<options file generated using primary install log>
install.cmd -i silent -DOPTIONS_FILE=<options file generated using primary install log>
The installation is performed on the shared drive.
After the Integration Service is installed on both the primary and secondary servers, a “TrueSightAgent” resource is created on the cluster.
If this resource is not created automatically, you may receive warnings. To create the resource, perform the following steps:
Go to the <installation directory>\Agent directory and execute the following file:
(Windows Server 2008)GenericService.bat
(Windows Server 2012)GenericService.ps1
Execute the following command to enable the TrueSightAgent cluster resource:
(Windows Server 2008)
(Windows Server 2012)cluster.exe resource TrueSightAgent
/ONLINE /WAIT:
5
00
powershell.exe Start-ClusterResource -Name TrueSightAgent -Wait 500
Stop the BMC TrueSight Infrastructure Management Integration Service using Services.msc.
Go to Start > All Programs > Administrative Tools > Failover Cluster Manager and click on the cluster name.
Click the Dependencies tab in the TrueSightAgent Properties window and click Insert to add a resource.
Restart the BMC TrueSight Infrastructure Management Integration Service using Services.msc.
Notes
To increase the maximum uptime and to avoid the Integration Service to be in the failed state, BMC recommends you to set the value for the Maximum failures in the specified period option to a higher value (for example, 100 for 6 hours). To set this value, in Failover Cluster Manager, select Roles properties and click Failover.
Perform the following steps on the secondary node to start or stop the cell automatically during failover:
Go to the <installation directory>\Agent directory and make the copy of the following file:
(Windows Server 2008) GenericService.bat
(Windows Server 2012) GenericService.ps1
Edit the copied file:
Replace the cluster resource value from "TrueSightAgent" to"TrueSightCell".
Modify the ServiceName value from "TrueSightAgent" to the Cell service name (you can obtain the cell service name from services.msc).
Execute the modified file with the Run as administrator option to create the new cluster resource as "TrueSightCell".
Create the similar dependencies for TrueSightCell as of TrueSightAgent.
Execute the following command with the Run as administrator option to enable the TrueSightCell cluster resource:
(Windows Server 2008)
(Windows Server 2012) cluster.exe resource
TrueSightCell
/ONLINE /WAIT:
5
00
powershell.exe Start-ClusterResource -Name
-Wait 500TrueSightCell
If the cell service is set to Automatic in services.msc, update it to Manual.
After installing the Integration Service in HA mode, you can configure it for extended security. This allows the BMC PATROL Agent to connect only to the Integration Service that you specify and not to multiple Integration Services.
Preparing to install Infrastructure Management in high availability mode
Installing the BMC TrueSight Infrastructure Management Server in HA mode on Windows
Installing the BMC TrueSight Infrastructure Management Server in HA mode on Linux/Solaris