Installing the Infrastructure Management Server on Microsoft Windows with Oracle

This section provides instructions for installing the BMC TrueSight Infrastructure Management Server on Microsoft Windows with Oracle as database. If you are upgrading from an earlier version, see Upgrading BMC TrueSight Infrastructure Management Server. 

You can install multiple BMC TrueSight Infrastructure Management Servers and configure them to run on a single instance of the Oracle database. For more information, see Configuring-multiple-Infrastructure-Management-child-servers-to-connect-to-the-same-Oracle-database.

Before you begin

• Ensure that there are no Integration Services installed on the computer where the TrueSight Infrastructure Management Server will be installed. If any Integration Services are installed on this computer, the TrueSight Infrastructure Management Server installation fails.
• Ensure that the computer on which you are installing the product adheres to the requirements listed in System-requirements-and-product-compatibility-for-Infrastructure-Management and Hardware-requirements-to-support-small-medium-and-large-environments.
• Ensure that the computer on which you are installing the product adheres to the requirements described in Preparing for your installation.

• If you are using the Remote Desktop Connection (RDC) to install the product, put the RDC in console mode.
• If you want to integrate TrueSight Infrastructure Management with SCOM 2007 and 2012, ensure that .NET Framework version 3.0 is installed. If you are installing it on Windows 2008, use the Role Management tool. For more information about installing .NET Framework, see the Microsoft website.

• Ensure that you perform the tasks at Preparing-to-install-Infrastructure-Management-server-with-Oracle.

• Ensure that port 7 is opened between the BMC TrueSight Infrastructure Management Server and Oracle database system.
  If port 7 cannot be opened due to security restrictions, run the installer using the following option:
  setup.bin -J SKIP_PING_VALIDATION=true

  For more information about creating an Oracle database instance for the BMC TrueSight Infrastructure Management Server , see Creating an Oracle database instance for the BMC TrueSight Infrastructure Management Server.

Encryption settings

The TrueSight Infrastructure Management Server uses 256-bit SSL encryption, by default. Due to import regulations in some countries, AES256-bit encryption is not allowed. You must select the appropriate encryption key size when you invoke the installer; otherwise, the installer uses the default 256-bit SSL encryption.

In a command line, navigate to the Disk1 folder in the installation file structure and enter the following command tochange the encryption key size:

• Windows
  

  setup.exe –J BMC_TS_KEY_SZ=<128/256>

• Linux
  
  

  ./setup.bin –J BMC_TS_KEY_SZ=<128/256>

128 is AES 128-bit encryption key
256 is AES 256-bit encryption key

To install the Infrastructure Management Server on Microsoft Windows with Oracle

1. Access the installation program by using one of these methods:

   • DVD — Insert the installation DVD.  In the <installLocation>\Windows directory, open the TSIMServer\Disk1 folder.
   • BMC Software EPD website (http://webapps.bmc.com/epd) — For more information about downloading the Infrastructure Management software, see Downloading the Infrastructure Management installation files.

2. Extract the contents of the zipped distribution file to an appropriate directory on the computer where the BMC TrueSight Infrastructure Management Server will be installed.

3. In the <installLocation>\Windows directory, open the TSIMServer\Disk1 folder. Double-click install.cmd.

   Important

   Ensure that you run the installer using install.cmd and not setup.exe.

4. On the Welcome page, click Next.
5. On the license agreement page, select I agree to the terms of the license agreement, and click Next.

6. On the Configuring Firewall Rules page, perform one of the following tasks, and click Next. You must configure firewall rules to allow Infrastructure Management processes to communicate through the firewall.

   Note

   If you turn on the firewall when Remote Desktop Protocol is running, the Remote Desktop Protocol session may get disconnected if Remote Desktop Protocol is blocked by the firewall.

   • To automatically configure the Windows Firewall rules, select Automatically configure Windows Firewall Rules.
     
     The Windows Firewall inbound rules are configured. An error message appears if you have not started the Windows Firewall.

     Note

     Ensure that you start the Windows Firewall before you configure the Windows Firewall rules. For more information about starting the Windows Firewall, see To start Windows Firewall.

   • To manually configure the firewall rules, select I will manually configure Windows Firewall Rules now before proceeding further
     • For more information about creating Windows Firewall inbound rules, see To manually configure Windows Firewall inbound rules.
     • If you prefer to use a third party firewall application, which is installed on your computer, ensure that you manually create the firewall inbound rules. For more information about creating firewall inbound rules, refer to the documentation of the third party firewall application.
7. (Cluster environment only) On the Cluster Group Configuration page, select the type of the cluster group in which to install the TrueSight Infrastructure Management Server, Default cluster group, or Custom cluster group.
   NoteBMC recommends that you install the TrueSight Infrastructure Management Server using a custom cluster group. Ensure that the custom cluster group is already created and that the cluster is working in the specified group. The custom cluster group name must be same as the custom cluster name.

8.  On the Directory Selection page, retain the default directory (\Program Files\BMC Software\TrueSight), or click Browse to select a different directory, and click Next.

   Warning

   • Do not install BMC TrueSight Infrastructure Management Server in a root directory (for example C: or D: ), on a shared drive, or in the Documents and Settings folder.
   • While installing BMC TrueSight Infrastructure Management Server on a 64-bit Windows computer, ensure that you do not install it in the Program Files (x86) directory path.
9. On the Listening Address Configuration page, confirm the Fully Qualified Domain Name (FQDN).
   NoteEnsure that the TrueSight Infrastructure Management server FQDN is reachable from other BMC products.

10. Select the tasks that you want to configure with Infrastructure Management, and click Next. The following figure displays the default tasks that are selected.

    
    Configuration task selection

    
    

    If you decide not to configure ports or cell details and have not selected either Server Ports - Change defaults, Cell - Change defaults, or both the options under System Configuration Tasks in the Configuration task selection page, the Confirm Defaults page is displayed with the default cell or port details. Otherwise, the Configure Server Ports page is displayed.

11. On the Confirm Defaults page, click Next.
12. If you selected Change TrueSight Infrastructure Server default ports under System Configuration Tasks in the Configuration task selection page, on the Configure Server Ports page, update the following port numbers, and click Next.
    

    Port name	Description
    Apache Port	Used by the operator console and web services. The default port number is 80.
    Apache SSL Port	Used by the operator console for secure channel access. The default port number is 443.
    AgentController Port	Used by the Agent Controller. The default port number is 12123.
    BMC Impact Admin Server Port	Used by BMC Impact Admin Server clients to communicate with BMC Impact Admin Server. The default port number is 3084.
    Remote Method Invocation Port	Used by the operator console. The default port is 1099.
    Service Desk Integration Port	Used by the Integration for Service Desk Integration service if BMC Atrium CMDB integration is enabled. The default port number is 3115.
    Tomcat Port	Used by the Tomcat process
    JBoss JMS Port	Used by the JBoss process
    Cache Server Port	Used by the Cache Manager process

13. If you selected Cloud Vista - Enable and Configure under Integration Configuration Tasks in the Configuration task selection page, on the Configuring TrueSight Infrastructure Management environment deployment information page, provide the following details, and click Next.Select any one of the following options based on your TrueSight Infrastructure Management environment.
    1. • Single Server Environment Installation: Select this option to install the TrueSight Infrastructure Management Server as a standalone server.

       • Multiple Server Environment Installation: Select any of the following options.
         • BMC TrueSight Operations Management Central Server: Select this option to install this instance as a central server.
         • BMC TrueSight Operations Management Child Server: Enter the following Server Router details:

    Field	Description
    Host Name/IP Address	FQDN name and IP address of the Central Server Router. FQDN name comprises the host name and the domain name.
    Protocol	Protocol with which to communicate to the Central Server Router. It can be either HTTP or HTTPS protocol.
    Port	Port number with which to communicate to the Central Server Router. The default HTTP port number is 80, and the default HTTPS port number is 443.

14. If you selected Configure TrueSight Infrastructure Server for Disaster Recovery Mode under System Configuration Tasks in the Configuration task selection page , on the Configuring Disaster Recovery page, enter a valid host name alias to configure disaster recovery, and click Next. The default host name alias is pronet.
15. If you selected Configure TrueSight Infrastructure Server default Cell under System Configuration Tasks in the Configuration task selection page, on the Configuring Cell page, enter the following details, and click Next.
    

    Field	Description
    Cell details
    Instance Name	Name of the cell instance. The default is pncell_hostname.
    Port	Port number in the range of 1024 to 65535. The default port for the cell is 1828.
    Encryption Key	Encryption key for the cell. The default is mc. No special characters are allowed.
    Admin cell details
    Port	Port number for the Admin cell. The default is 1827.
    Encryption Key	Encryption key for the Admin cell. The default is mc.

16. If you selected Administrator e-mail from TrueSight Infrastructure Management - Change defaults under System Configuration Tasks in the Configuration task selection page, on the Administrator Information page, enter the following details to receive e-mail notifications from the TrueSight Infrastructure Management Server, and click Next.
    

    Field	Description
    Sender E-mail ID	Email address that you specify as the sender of any notification e-mail messages. The format for the e-mail address must be hostName@company.com The administrator receiving the email message will know which host is having disk space problems or other issues that send notifications. The default value is blank.
    Administrator E-Mail ID	Fully qualified e-mail address of the administrator of the TrueSight Infrastructure Management Server. The format for the e-mail address must be user@company.com. The default value is blank.
    Name or IP Address of SMTP Server	Name or IP address of the SMTP server. The default value is blank.

17. If you have selected Configure to use an Oracle database (Separately Installed) under Database in the Configuration task selection page, the Configure Database page displays.

18.  On the Configure Database page, provide the following details, and click Next.

    Field	Description
    Database
    Standalone or RAC	If you want to connect to a standalone Oracle database instance, select Standalone and provide the following details: Host Name/IP Address — Host name or IP address of the computer that is running the standalone Oracle database instance. Port — Oracle listener port on the computer. The default port is 1521. Database SID — Oracle database SID If you are installing multiple BMC TrueSight Infrastructure Management Servers and configuring them to connect to the same Oracle database, ensure that value of the database SID is the same for all the servers. For more information see, Configuring-multiple-Infrastructure-Management-child-servers-to-connect-to-the-same-Oracle-database. If you want to connect to an Oracle Real Application Cluster (RAC) setup, select RAC and provide the following details: Service Name — Service name of the Oracle server If you are installing multiple BMC TrueSight Infrastructure Management Servers and configuring them to connect to the same Oracle database, ensure that the service name is the same for all the servers. For more information see, Configuring-multiple-Infrastructure-Management-child-servers-to-connect-to-the-same-Oracle-database. RAC SCAN Host Name — Host name of the computer that is running the Oracle RAC setup RAC SCAN Host Port — Port number through which the RAC communicates Notes When you provide the RAC SCAN host name, the pw dbconfig list displays the node count as 1 and node 1 is the SCAN host.
    Tablespace and Users
    Use Existing User or Create New User	If you have already created an Oracle user, select Use Existing User. Provide the following details, and click Next. Ensure that you run the run_oracle_db_scripts.sql script before selecting this option. For more information, see Manually setting up a customized Oracle database environment by using the run_oracle_db_scripts.sql script. To create a new Oracle user, select Create New User. This option enables you to create new users and table spaces. Provide the following details, and click Next. Ensure that you run the set_system_parameter_oracle_pnet.sql script before selecting this option. For more information, see Steps to run the BMC provided script set_system_parameter_oracle_pnet.sql.
    Username	User name of the database instance for the Infrastructure Management user. Do not use the terms "sys" or "system." The default user name is proact. Note: Another user called the report user is also created to access views in Oracle. The name of this user is the Infrastructure Management user name suffixed with "ru" and the password for this user is the same as the user name. For example, if the Infrastructure Management user name is proact, then the report user name is proactru and the password is proactru.
    Password	Password of the database instance for the Infrastructure Management user
    Confirm Password	Password of the database instance for the Infrastructure Management user

19. On the Configure Oracle Report User page, provide the following details, and click Next.

    Field	Description
    User Name	The user that you created in Oracle to view the default views and create reports.
    Password	Password for this Oracle user

20.  If you have selected Create New User in the Configure Database page, on the Tablespaces and Users Settings page, provide the following details, and click Next:

    Note

    Before you create a tablespace, see Recommendations and restrictions for creating Oracle objects.

    Note

    Only one data file is added to the tablespace created by the script. However, if required, you can add additional data files to the same tablespace before the tablespace is filled up. For information about adding additional data files, see Extending the tablespace.

    Field	Description
    Oracle DBA Username	Oracle database user name. The user must have SYSDBA privileges.
    Oracle DBA Password	Password for the Oracle DBA user name
    Deployment Type	Type of Infrastructure Management deployment. The size of the tablespace is determined by the type of deployment. The supported values are as follows: Small Medium Large
    Main Table Space Name	Name of the main tablespace to be created
    Temporary Tablespace Name	Name of the temporary tablespace to be created
    Main Tablespace Data File Name	Data file name with the absolute path for the main tablespace
    Temporary Tablespace Data File Name	Data file name with the absolute path for the temporary tablespace

21. If you selected Atrium CMDB - Enable and Configure under Integration Configuration Tasks in the Configuration task selection page, on the Integrating with CMDB page, provide the following details, and click Next.
    WarningBefore configuring BMC Atrium CMDB, ensure that BMC CMDB Extensions and modules are installed on the computer where the BMC Atrium CMDB is installed. If necessary, you can stop this installation, install the extensions, and then restart the TrueSight Infrastructure Management Server installation. For information about installing the TrueSight Infrastructure Management CMDB Extensions, see Installing-the-BMC-CMDB-Extensions-to-enable-integration-with-Atrium-CMDB.
    NoteConfiguring the TrueSight Infrastructure Management Server for integration with BMC Atrium CMDB is recommended, but not mandatory, during installation. If you do not configure the TrueSight Infrastructure Management Server for CMDB integration during installation, you can manually configure this integration any time after the installation is complete. For instructions, see Configuring BMC Atrium CMDB integration.

    Field	Description
    CMDB Host	Host name of the AR Server. When integrating with the AR Server group, host name of the Load Balancer or Integration Server.
    CMDB Port	BMC Atrium CMDB or AR System Server port number. The default is 0. If the AR System is configured with a Portmapper, enter port 0.
    CMDB User	User name required to log on to the AR System Server. The default is Demo. This user requires the AR Server Administration rights.
    CMDB Password	Password required to log on to the AR System server
    UDDI Host	Host name of the UDDI registry for BMC Atrium CMDB
    UDDI Port	Port number of the UDDI registry for CMDB. The default is 8080.
    UDDI User	UDDI registry user name. The default is admin.
    UDDI Password	Password for the specified UDDI user name. The default is admin.

    NoteThe UDDI parameters are optional and used only for enabling the cross-launch to other BMC products, such as Atrium AE and BMC Atrium Service Context.
    If you integrate with BMC Atrium CMDB in the AR Server Group, you must manually configure the pserver.conf file. Edit the ARSGroupMembers in the pserver.conf file and set to all AR Servers of the group that have reconciliation function enabled. See also Configuring the Publishing Server to integrate with an AR Server group.
22. On the Installation Preview page, click Install.The Preview page displays the Installation Mode as Standalone in a case of regular installation and High-Availability (Cluster) if you installing in the high availability mode.The TrueSight Infrastructure Management Server installation process takes a while to complete.
23. On the Installation Summary window, select View Logs to open the installation logs, or click Done.
    NoteIf the DNS configurations are not correct in a computer, a warning message, No DNS Entry Found, is displayed. You can either correct the DNS configuration and restart the installation, or if you want to continue with the installation, provide the IP address instead of the host name when you are required to enter the host name.

  For more information about creating and setting up the Oracle database, see Manually-setting-up-an-Oracle-database

To start the Windows Firewall

1. Start the Windows Firewall service from services.msc.
2. Run the following commands to turn on the firewall:
   • (Microsoft Windows 2008 R2) netsh advfirewall set allprofiles state on
   • (Microsoft Windows 2012 R2) netsh advfirewall set allprofiles state on
   • (Microsoft Windows 2012) netsh firewall set opmode mode = ENABLE

To manually configure Windows Firewall inbound rules

1. Start the Windows Firewall.
2. Configure the Windows Firewall inbound rules for the following pw processes. For more information about configuring Windows Firewall inbound rules, see To create an inbound firewall rule for a program or service from the Microsoft Technet Library:
   • pw/jre/bin/java_jboss.exe
   • pw/apache/bin/httpd.exe
   • pw/jre/bin/java_jsrv.exe
   • pw/jre/bin/java_agent.exe
   • pw/jre/bin/java_cntl.exe
   • pw/jre/bin/java_tunnel.exe
   • pw/jre/bin/java_rate.exe
   • pw/jre/bin/java_ps.exe
   • pw/Sybase/bin64/dbsrv16.exe
   • pw/server/bin/mcell.exe
   • pw/pronto/bin/ProactiveNetService.exe
   • pw/pronto/bin/ProNetAgent.exe

Where to go from here

To apply licenses, see Applying-Infrastructure-Management-licenses.

To install Integration Services, see Installing-the-Integration-Service-and-Cell.

For help resolving installation issues, see Infrastructure-Management-installation-and-uninstallation-issues,

Related topics

Configuring-multiple-Infrastructure-Management-child-servers-to-connect-to-the-same-Oracle-database

Infrastructure-Management-installation-and-uninstallation-issues

Common error messages when installing Infrastructure Management with Oracle as the database