Installing Cloud Application Business Insights

Use this information to install the Cloud Application Business Insights on premises.

Before you begin

  • Ensure that the user has the recursive write and run access on the folder where you copied and extracted the TAR file for Cloud Application Business Insights. For example, /home/INSTALLERS/icabi that is referred to as DIST_DIR1.
  • If you want to use nonroot user to do the installation, make sure you give sudo access to the user. See Configuring sudo access to users.

Procedure

Run the installation as root user.

  1. Run the following command to install Cloud Application Business Insights as root user:
    
    cd $DIST_DIR1
    ./install [<install_dir>]
    Where,
    • <install_dir>

      The directory where you want to install the application. If you don’t specify the installation directory, it is installed in /opt/icabi folder by default.

    For example, for nondefault installation path, installation command can be as follows:
    
    ./install /home/icabi
    Important: Align the date and time of your system and the virtual machine on which you plan to install IBM® Cloud Application Business Insights to avoid the 401 unauthorized error status.

Run the installation as nonroot user.

  1. Run the Cloud Application Business Insights installation script as nonroot user.
    
    su – <username>
    sudo ./install
  2. If you have PostgreSQL database that is running in your environment, you can use it as a remote database server. Make sure you have a superuser role for the database and SSL is enabled for the remote PostgreSQL database. When prompted, provide the following details about your existing database server for remote database usage:
    • Database server IP address or hostname
    • Database port on the remote server
    • Database username
    • Password for the database user
  3. When prompted, provide the following details:
    • Username and password for the default user

      The default user has system administrator privileges on Dashboard Designer and Viewer privileges on Engine.

    • Scheduler username
      Important: Scheduler user is needed to trigger and create the scheduled reports. Typically, only this user has access to schedule the reports. The username and password that you enter must also be entered in the basic-registry file after the installation is completed.
    • Scheduler password

      Password for the Scheduler user

    • Server IP address

      IP address of the server where Cloud Application Business Insights is installed.

    • (Optional) Server hostname
      Hostname of the server where Cloud Application Business Insights is installed.
      Note:
      • If you provide the hostname, you can access the Dashboard Designer and Engine with hostname as well.
      • Ensure that you enter the hostname in lowercase only. If you use the hostname to access Dashboard Designer or Engine, and if the hostname is in uppercase, then an error message is displayed and you cannot access Dashboard Designer or Engine.
    • (Optional) Engine Instance Name

      If you do not provide an instance name, icabi is used by default.

    The following tasks are done in the background:
    • IBM Cloud Application Business Insights application is installed.
    • WebSphere® Liberty Profile is installed.
    • IBM Cloud Application Business Insights application is installed in onprem mode.
    • A tenant by name default is created.
    • The following schemas are created in the database:
      • PRD_ENGINE
      • PRD_TOOL
    • The following default tenant schemas are created:
      • T_DEFAULT_ENGINE
      • T_DEFAULT_TOOL
    • Cron job scheduler is configured which keeps count of the users that are using Cloud Application Business Insights.
    • Real Time Data Collector is installed along with the Cloud Application Business Insights application.
  4. Optional: If you’re reinstalling Cloud Application Business Insights, then complete the following steps:
    1. Uninstall Cloud Application Business Insights.
    2. Run the install command as specified in step 1.
  5. When prompted, provide the following details:
    • Username and password for the default user

      The default user has system administrator privileges on Dashboard Designer and Viewer privileges on Engine.

    • Scheduler username
      Important: Scheduler user is needed to trigger and create the scheduled reports. Typically, only this user has access to schedule the reports. The username and password that you enter must also be entered in the basic-registry file after the installation is completed.
    • Scheduler password

      Password for the Scheduler user

    • Server IP address

      IP address of the server where Cloud Application Business Insights is installed.

    • (Optional) Server hostname
      Hostname of the server where Cloud Application Business Insights is installed.
      Note: If you provide the hostname, you can access the Dashboard Designer and Engine with hostname as well.
    • (Optional) Engine Instance Name

      If you do not provide an instance name, icabi is used by default.

Results

Default installation output:
./install /opt/icabi/
[INFO] The installation directory specified is /opt/icabi/...
[INFO] Installing PRD UI...
warning: bin/prd_1.1.7.0-0-1.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 4049a56f: NOKEY
Verifying... ########################################
Preparing... ########################################
Installing prd at directory.
Updating / installing...
prd_1.1.7.0-0-1 ########################################
prd installed successfully.
Writing path to jvm.options
warning: bin/prd_WLP_installer-1.1.7.0-0-1.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID 4049a56f: NOKEY
Verifying... ########################################
Preparing... ########################################
Installing prd_WLP at directory.
Updating / installing...
prd_WLP_installer-1.1.7.0-0-1 ########################################
prd_WLP installed successfully.
[INFO] RPM installed successfully.
Are you going to use remote database server (Y/N)?n
[INFO] Database port set to 5432.
Enter ICABI administrator’s username:prdusr
Enter a Password for prdusr:
Reenter the password:
[WARNING] Please note the password, we will encrypt it for security purpose.
[INFO] Scheduler user is required to trigger and create the scheduled reports.
Enter ICABI scheduler username: prdsched
Enter a Password for prdsched:
Reenter the password:
[WARNING] Please note the password, we are encrypting it.
Updating for key adminUserName.
Updating for key schedulerUserName.
Updating for key schedulerUserPassword.
Updating for key schedulerLoginHostname.
Updating for key remoteDBServerHostName.
Updating for key prdDBPort.
Updating for key appName.
Updating for key PRD_DB_SVC_HOST.
Updating for key PRD_DB_SVC_PORT.
Updating for key PRD_DB_SVC_HOST.
Updating for key PRD_DB_SVC_PORT.
Updating for key database.name.
Updating for key database.create.flag.
Updating for key database.server.
Updating for key database.port.
Updating for key database.user.
Updating for key database.password.
[INFO] User postgres has been added to system.
[INFO] Creating ICABI database
PostgresSQL Database is initialized successfully......!
waiting for server to start.... done
server started
PostgresSQL Database is started successfully......!
[INFO] ICABI database created successfully.
[INFO] Creating ICABI Database schema.
[INFO] ICABI Database schema created successfully.

Inserting default HTML for landing page in Database.

Default HTML for landing page is inserted in Database.
[INFO] Updating Real Time Data Collector properties file.
RTDC setup completed. Please start RTDC application.
Cronjob configured successfully.
[INFO] Installation of PRD UI completed...

Provide server address details below:

Enter server IP: 10.00.00.00
Enter server hostname ( press Enter to skip ): HJS801-PRD-T-16

[INFO] Server address details updated successfully.
Note: If you skip this step, then ‘icabi’ is used as the default Engine Instance Name.
Enter Engine Instance Name (press Enter to skip):

[INFO]  Instance Name is set to icabi.
You have mail in /var/spool/mail/root

What to do next

  • Start the Cloud Application Business Insights server, Cloud Application Business Insights OIDC server, and PostgreSQL database with the following command:
    
    cd $install_dir
    ./start_prd.sh
    You can see the following output:
    
    Starting PRD DB
    waiting for server to start.... done
    server started
    
    Starting server prdapp.
    Server prdapp started with process ID 29922.
    
    Starting server prdauth.
    Server prdauth started with process ID 30054.
  • After the installation is successful, the basic-registry.xml file gets automatically updated with Default username and its encrypted password, and Scheduler username and its encrypted password that you set during installation.

    For more information, see Adding or modifying user information in registry.

  • If you installed Cloud Application Business Insights on a restricted network, then you must ensure that you can access it from your local system.