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.
Note
Ensure that you set the Oracle database system parameters before running the Infrastructure Management installer. For information about setting Oracle database system parameters, see Steps to run the BMC provided script set_system_parameter_oracle_pnet.sql
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 key256
is AES 256-bit encryption key
To install the Infrastructure Management Server on Linux with Oracle as database
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.
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
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.
- On the Welcome page, click Next.
- On the license agreement page, select I agree to the terms of the license agreement, and click Next.
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.
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.
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 selectionIf 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.
On the Confirm Defaults page, click Next.
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.
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.
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. 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.
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. 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. - 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.
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
- Service Name — Service name of the Oracle server
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 - If you want to connect to a standalone Oracle database instance, select Standalone and provide the following details:
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
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.
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.
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.
Note
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.
- 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>]
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
Comments
Instructions under numbers 3, 10, and 13 on this page all contain errors such as: Error: [com.ctc.wstx.exc.WstxLazyException] Unexpected close tag ; expected . at [row,col {unknown-source}]: [1,758]
Hello Shea,
These errors are now fixed.
Thank you.