Installing TrueSight Operations Management Report Engine with the Oracle database

This section provides installation information for TrueSight Operations Management Report Engine, with Oracle as the Reporting database. You must install the Report Engine on a computer different from the one where TrueSight Smart Reporting is installed.

You can install Report Engine on a single or multiple computers. You must install Report Engine on multiple computers when you want to collect data from multiple TrueSight Infrastructure Management servers.

Where you are in the Installation process

To install  TrueSight Operations Management Report Engine on the first computer

1. Log in as an administrator (Windows) or a root user (Linux) to the computer where you want to install Report Engine.

   Note

   On Linux, ensure that you have installed the nss-softokn-freebl-3.12.9-11.el6.i686 & glibc-2.12-1.47.el6.i686.rpm package.

2. (Optional) If you want to change the default AES encryption size of the Report Engine to 128-bit, set the following environment variable:

   AES_ENCRYPTION_KEY_SIZE=128

3. Extract the downloaded files to your temporary directory.
4. (Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately.
   export DISPLAY=<IP address of the host computer>:0.0

5. Navigate to the Reports/ReportEngine/platform folder, where platform is Linux or Windows.

   • For Windows, double-click ReportEngine<version>_buildnumber.exe.

   • For Linux, at the command line, run the following command:
     ReportEngine11.3.01.bin
     

     Notes

     • If there is not enough space in the temporary directory, the system prompts you to select an alternate directory. On UNIX-based computers, you can set the IATEMPDIR environment variable to an alternate directory that has enough space.
     • For Linux installations, the installation file supports only the graphical user interface (GUI) mode. There is no support for the console or silent mode installation methods.
6. Review the Welcome page, and click Next.
7. Review the licence agreement, agree to the terms, and click Next.

8. On the Feature Selection page, select the task that you want to perform, and click Next.

   • Select Install TrueSight Operations Management Report Engine to install the Report Engine.
   • If you have installed TrueSight Smart Reporting earlier, select Configure TrueSight Smart Reporting to configure it with the Report Engine details.
     You can also choose to configure it after installation by running the Report Engine installer again.

9. If you have selected to install the Report Engine, do the following:

   1. Select one of the following databases, and click Next:
      • Oracle Standard Edition
      • Oracle Enterprise Edition. Select this option if you have the Oracle Enterprise Edition with partitioning.
   2. Enter the following database details, and click Next.
      • The fully-qualified database name, and its port number. The default port number is 1521.
      • The database SID or service name.
      • The database user name and password for the Report Engine.
   3. Select the time zone of the computer where you are installing the Report Engine, and click Next.
   4. Specify the directory for the Report Engine installation, and click Next.
   5. Enter the following TrueSight Infrastructure Management Server details, and click Next.
      • The host name, protocol, and port number of the TrueSight Infrastructure Management Server. 
        The default protocol is HTTPS.
        The default port is 443.
      • The user name and password for the TrueSight Infrastructure Management Server user.
        The user must have Super Admin privileges.

   6. Review the details and ensure that Enable Event and Impact reporting option is selected, and click Next.
      If you do not select this option, you must configure the TrueSight Infrastructure Management cells for event and impact reporting by configuring TrueSight Infrastructure Management cells.

10. If you have selected to configure TrueSight Smart Reporting, provide the following details, and click Next:

    • TrueSight Smart Reporting server name and port number
    • TrueSight Smart Reporting administrator user name and password
11. Review the details, and click Install.
12. Click Done to exit the installation wizard.

13. Apply the Hotfix_113010000010 hotfix.

    This is a mandatory hotfix, which resolves the issue where information about daylight saving information for the period after 31 December 2019 is not present in the Report Engine database.

    For more information, see Adding-daylight-saving-information-in-the-Reporting-database.

To install TrueSight Operations Management Report Engine on additional computers

You can install multiple Report Engines on the same database. While installing multiple Report Engines, you must install them one after another, and not simultaneously.

After the first Report Engine installation, subsequent Report Engines use the same tablespace and database user.

To install multiple Report Engines, do the following for each Report Engine one by one:

1. Depending on your operating system, perform one of the following tasks: 

   • (Windows) Run the \Reports\ReportEngine\ReportEngine11.3.01.exe file
   • (Linux) Run the  ReportEngine11.3.01.bin command from the \Reports\ReportEngine folder

2. Follow the instructions on the wizard pages. When prompted, enter the following information:

   • Database connection information.
     Default port number is 1521.
     Details of the database user that you created are required.

     Note

     The Time Zone selection page is not displayed when you install subsequent instances of the Report Engine.

   • Directory where you want to install the product.
   • The TrueSight Infrastructure Management Server registration details.
   • If you select the Configure TrueSight Smart Reporting check box, TrueSight Smart Reporting server and user details.
3. In the Installation Preview page, click  Install. The installer begins the installation process.
4. Click Done to exit the installation wizard.