Upgrading PAW on Linux with MobaXterm and QueBIT Script Files

  1. Environment Setup:
    1. Obtain a Linux user ID user that has “sudo” rights
    2. Confirm with IT team that Linux install has all basic components including:
      1. i. yum-utils
      2. 11. unzip
  2. Note that Word may change a short hyphen to a long hyphen so be careful copying and pasting Linux commands from this document
  3. Download the latest PAW release from IBM Fix Central
    1. Search for IBM Planning Analytics Local
    2. Follow prompts to browse all fixes
    3. Select the latest BA-PAWL-*.*.**.zip file
    5.  Follow the prompts to download the BA-PAWL-* file for Linux
    1.  Save file to the side to be uploaded to the server at a later step
  5. Obtain the QueBIT install scripts
  6. Use an SSH client [MobaXterm] to open an SSH session to the Linux server IP addressa
    1. When entering a password to log into a server, the password field may appear empty even though you have typed/pasted the password in. This is a security feature. Also note that the ‘paste’ shortcut is SHIFT+INSERT, not CTRL+V.
  7. Ensure your Linux account has been granted ‘Sudo’ administrative access with the below command:
    1. a. sudo -l
  8. Once logged in perform the following actions
    1. Check that there are at least 30gb of available space using the below command: df -h /opt
    2. Create the below paw directory and subdirectories with these five commands. Note that the ‘2060’ folders below should match the release number of the PAW version being installed:
      1. sudo mkdir /opt/paw
      2. sudo mkdir /opt/paw/docker
      3. sudo mkdir /opt/paw/paw2060
      4. sudo mkdir /opt/paw/paw2060/quebit
      5. sudo mkdir /opt/paw/paw2060/backups
    3. Set permissions to writeable ‘777’ for the paw parent directory and its children using the below command:
      1. sudo chmod 777 -R /opt/paw/
  9.  Move Install Files to the Server
    1.  Upload the BA-PAWL-*.*.**.zip file to the /opt/paw/paw2060/ directory using the SSH client’s upload feature
    2.  Open the quebit-init.sh script using a file editor
      1. Update the three install folder paths shown below
      3. Update the three TM1 Planning Analytics server locations
      5.  If there is an existing PAW server, the TM1 Planning Analytics server locations can be found in the /apps/ibm/paw/paw_2.0.2_mp_m/config/paw.env file shown below
      7. Upload the 11 quebit-*.sh install script files, including the updated quebit-init.sh script, to the /opt/paw/paw2060/quebit/ directory using the SSH client’s upload feature
  10. Note the installing Linux account’s current ‘group’ membership using the below command: groups
  11. Add the ‘docker’ group using the below command: sudo groupadd docker 2>&1
  12. Add the installing Linux account to the new docker group using the below command. Note that “${USER}” is a Linux function, not a placeholder: sudo usermod -aG docker “${USER}” 2>&1
  13. Apply the new group to the session using the below command. Note the syntax is: newgrp space short hyphen space docker: newgrp – docker
  14. Check the installing Linux account’s updated groups using the below command. Note you should now see the new docker group included in the list: groups
  15. Navigate to the QueBIT install script file directory using the below command: cd /opt/paw/paw2060/quebit
  16. Run the QueBIT install master script using the below command. Note that it will prompt for your password to be re-entered:
    1. /quebit-start.sh
    2.  The install script should take <10 minutes
    3. When complete the install log file will be generated at the location below:
      1. /opt/paw/paw2060/quebit/ q_install.log
  17.  If possible, log into PAW or PAX as an end user to check that everything looks correct by creating a book with a cube view and saving it.
  18. Reboot the Linux server using the below command: sudo reboot -h now
  19.  Confirm that the server starts back up and that PAW is still successfully running