Installing Cloud Application Business Insights Fix Pack 6 on Red Hat Linux on IBM Power (LE)

Use this information to install Fix Pack 6, Cloud Application Business Insights V 1.1.7.6 on premises, on Red Hat® Linux® on IBM® Power® (LE) 64-bit. You can install Fix Pack 6 on Power Linux System only if Fix Pack 4 is already installed.

Before you begin

  • Ensure that Cloud Application Business Insights V 1.1.7.4 is already installed on your IBM Power Systems host running Linux.
  • Ensure that the Cloud Application Business Insights server is up and running.
    Note: Tasks that are performed during the installation process might be lost.
  • Ensure that you back up all your important data.

About this task

The Fix Pack 6 tar file, icabi_1.1.7.6_plinuxle.tar, is digitally signed to assure the users that the tar file is not corrupted or tampered. If required, you can verify the digital signature, and then install Fix Pack 6 on your Power Linux system.

Procedure

Complete the following steps to verify the digital signature and to install Fix Pack 6 on Red Hat Linux on IBM Power (LE):

  1. Download the following IBM Cloud Application Business Insights Fix Pack tar files from IBM Fix Central and save it to a location of your choice:
    • icabi_1.1.7.6_plinuxle.tar
    • icabi-1.1.7.6-pub-key.tar
    For example, /opt/IBM/INSTALLERS/icabi, which is referred to as DIST_DIR.
  2. As a root user, run the following command to extract the icabi_1.1.7.6_plinuxle.tar file:

    tar -xvf icabi_1.1.7.6_plinuxle.tar

    The following file structure is displayed:
    icabi_1.1.7.6_plinuxle.tar
    	 /bin
    	 icabi_1.1.7.6.sh
    	 post_upgrade_1.1.7.4.sh
    	 README_ICABI_FP_1.1.7.6.txt
    	 prd-upgrade-1.1.7.6
  3. Extract the icabi-1.1.7.6-pub-key.tar file, by using the following command:

    tar -xvf icabi-1.1.7.6-pub-key.tar

    The following file structure is displayed:
    icabi-1.1.7.6-pub-key.tar
    	 /icabi_1.1.7.6.sig
    	 /icabi_certificate.pem
    	 /icabi_chain0.pem
    	 /public-key.pem

    The public keys and certificates are required for the digital verification.

  4. Optional: To verify the digital signature on icabi_1.1.7.6_plinuxle.tar file and to check the validity of the certificate, complete the following steps:
    • Run the following command to verify the signature:

      openssl dgst -sha256 -verify <public.pem> -signature <signature_filename> <file_verified_for_signature>

    For example, openssl dgst -sha256 -verify public-key.pem -signature icabi_1.1.7.6.sig icabi_1.1.7.6_plinuxle.tar

    If the signature is valid, then the command returns the following response:

    Response verify OK

    • Run the following command to verify whether the certificate is valid:

      openssl ocsp -no_nonce -issuer <chain0.pem> -cert <certificate.pem> -VAfile <chain0.pem> -text -url http://ocsp.digicert.com -respout ocsptest

    For example, openssl ocsp -no_nonce -issuer icabi_chain0.pem -cert icabi_certificate.pem -VAfile icabi_chain0.pem -text -url http://ocsp.digicert.com -respout ocsptest

    If the certificate is valid, then the command returns the following response:

    Response verify OK

  5. Run the post_upgrade_1.1.7.4.sh script by using the following command:
    cd <DIST_DIR>/
    ./post_upgrade_1.1.7.4 <INSTALL_DIR>

    Where, <INSTALL_DIR> is the location where Cloud Application Business Insights V1.1.7.4 is installed. By default, it is opt/icabi.

    For example, ./post_upgrade_1.1.7.4 /opt/icabi

    The following output is displayed:
    [INFO] Starting pre-upgrade process to upgrade IBM Cloud Application Business Insights to v1.1.7.6
       [INFO] Pre-upgrade is completed successfully. You can now upgrade IBM Cloud Application Business Insights to v1.1.7.6
  6. To install Fix Pack 6, run the icabi_1.1.7.6.sh script by using the following command:
    cd <DIST_DIR>/
    ./icabi_1.1.7.6.sh
    

    Where, <DIST_DIR> is the location where IBM Cloud Application Business Insights V 1.1.7.6 media is extracted.

  7. When prompted, provide the location where IBM Cloud Application Business Insights V 1.1.7 Fix Pack 4 is installed.
    For example, /opt/icabi

    If the location is not provided, then the script uses the default location, which is /opt/icabi/

    The Fix Pack is installed and logs are generated in the icabi_fixpack.logs file.

    The location for the log file is <DIST_DIR>, where the tar file is extracted.

  8. To verify whether the Fix Pack 6 is installed successfully, go to directory where you installed the Fix Pack, and run the following command to view the Fix Pack version:
    ./showVersion.sh
    The following output is an example of the output that is displayed:
    ICABI 1.1.7.6
    icabi_aquila_20221223_FP6
    Note: If the Fix Pack installation fails, then the changes that are made by the icabi_1.1.7.6.sh script are rolled back, and the previously installed IBM Cloud Application Business Insights version is restored. Contact your system administrator or support team for further assistance.

    To verify whether the changes are rolled back, repeat this step to recheck the version of IBM Cloud Application Business Insights.

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.