Installing the Infrastructure Management Server on Linux with SAP SQL Anywhere

This section provides instructions for installing the TrueSight Infrastructure Management Server on Linux with SAP SQL Anywhere as database. If you are upgrading from an earlier version, see Upgrading TrueSight Infrastructure Management Server. 

This section includes the following topics:

• • Before you begin
  • Encryption settings
  • To install the TrueSight Infrastructure Management Server on Linux with SAP SQL Anywhere
  • Post-installation task for non-root users
  • Where to go from here

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.

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 TrueSight Infrastructure Management Server on Linux with SAP SQL Anywhere

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).
   NoteEnsure that the TrueSight Infrastructure Management server FQDN is reachable from other BMC products.
8. Select the tasks to configure with TrueSight 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 Configure TrueSight Infrastructure Server default Cell, Change TrueSight Infrastructure Server default ports, 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, see Installing TrueSight Infrastructure Management Server with Oracle as the database. Otherwise, SAP SQL Anywhere will be configured, which is integrated with TrueSight Infrastructure Management. 
16. 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.
17. 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.
18. 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.
    
    
    

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.