Installing the Infrastructure Management Server on Linux with Oracle

This section provides instructions for installing the TrueSight Infrastructure Management Server on Linux 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.
• On Linux, ensure that you install the required libraries.

• BMC recommends that you use MobaXterm as the UI to install TrueSight Infrastructure Management on Linux computers.

• Ensure that you install the csh and tcsh shells.
• To install the TrueSight Infrastructure Management Server with a non-root user, you must provide certain permissions to the non-root user as a root user. For more information, see Preparing Linux computers for Infrastructure Management.

• Ensure that port 7 is opened between the TrueSight Infrastructure Management Server and Oracle database system.

  For more information about creating an Oracle database instance for the 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 Linux with Oracle as database

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

   • DVD — Insert the installation DVD. In the <installLocation>/Linux directory, open the TSIMServer directory.

   • BMC Software EPD website (http://webapps.bmc.com/epd) —  For more information about downloading the TrueSight Infrastructure Management software, see Downloading the Infrastructure Management installation files.
     
     

     Note

     If you are moving the files from one computer to another, ensure that you use binary mode.

2. 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

3. Open the command prompt using the Run as administrator option and run the following command:

   ./install.sh

   Note: BMC recommends that you do not use the setup.bin file to start the installation process.

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 Directory Selection page, retain the default directory (/opt/bmc/TrueSight), or click Browse to select a different parent directory (for example, <parent directory>/bmc/TrueSight), and click Next.

   Warning

   • Do not install TrueSight Infrastructure Management Server in a root directory.
   • The directory in which the TrueSight Infrastructure Management Server is installed and all its parent directories must have 755 permissions (read, write, and execute permissions to owner, groups, and others) and must be owned by root as well as the other group. Without these permissions and ownership, you will not be able to log on to the TrueSight Infrastructure Management Server.

   Note

   For Chinese, Korean, and Japanese installations, ensure that the system default locale is a UTF-8 locale. This enables the Input Method feature in the administration console.

7. On the Listening Address Configuration page, confirm the Fully Qualified Domain Name (FQDN). 

   Note

   Ensure that the TrueSight Infrastructure Management server FQDN is reachable from other BMC products.

8. 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.

9. On the Confirm Defaults page, click Next.

10. 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

    Note

    While installing with a non-root user, change the port numbers for Apache and Apache SSL between 1025 to 65535 because the non-root user does not have permissions to use ports below or equals to 1024.

11. 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.

12. 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.

13. 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.

14. 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.

15. 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.

16.  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

17.  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

18. 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.

    Warning

    Before 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.

    Note

    Configuring 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.

    Note

    The 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 .

19. 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.

20. On the Installation Summary window, select View Logs to open the installation logs, or click Done.

    Note

    If 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.

Post-installation task for non-root users

After you install TrueSight Infrastructure Management as a non-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 TrueSight Infrastructure Management 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.

1. Locate the script at <Infrastructure-Management-Installation-Directory>/pw/scripts.
2. Run the script in the following format:
   create_startup_script.sh [<Non-root-User-Name>]
   In the preceding script syntax, <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 for registering the service.

Where to go from here

For applying licenses, go to Applying Infrastructure Management licenses.

For installing integration services, go to Installing the Integration Service and Cell.

Related topics

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

Infrastructure Management installation and uninstallation issues