Install Planning Analytics Workspace Local on Red Hat Enterprise Linux

To install Planning Analytics Workspace Local on Red Hat Enterprise Linux, run the ./Start.sh script.

Before you begin

Review Prerequisites to ensure that you meet the prerequisites for your version of Red Hat Enterprise Linux.

All versions of Planning Analytics Workspace Local are supported on Red Hat Enterprise Linux version 7.

Important: Support for Planning Analytics Workspace Local on Red Hat Enterprise Linux 7 will end in June 2024.This coincides with Red Hat's announced end of maintenance support for Red Hat Enterprise Linux 7. For more information, see https://www.redhat.com/en/blog/end-maintenance-red-hat-enterprise-linux-7-almost-here.

Planning Analytics Workspace Local versions 2.0.70 and later are supported on Red Hat Enterprise Linux version 8.

Planning Analytics Workspace Local versions 2.0.93 and later are supported on Red Hat Enterprise Linux version 9.

About this task

The start script performs the following checks:

Red Hat Enterprise Linux® 7
  1. Checks if Docker is installed. If Docker is not found, the script tries to install it:
    Note: If the Red Hat system is not registered with the Red Hat subscription manager, the script displays an error and exits.
    • Installs the Docker package.
    • Adds the Docker group.
    • Adds the current user to the Docker group.
    • Starts the Docker service.
    • Configures the Docker service to start on reboot.
    • Prints the Docker version to the terminal window.
    • Prints a success message and tells you that you must log off and log in again for the group membership to take effect.
  2. Installs the Planning Analytics Workspace Docker images.
  3. Opens the Planning Analytics Workspace administration tool
Red Hat Enterprise Linux 8 or 9
  1. Checks if Podman is installed. If Podman is not found, the script tries to install it:
    • Installs the Podman package.
    • Starts the Podman service.
    • Starts the Podman socket .
    • Adds the current user to the root group.
    • Enables group read and execute permissions to the Podman socket (/run/podman/podman.sock)
  2. If Podman is already installed, checks that the current user has access to the Podman socket. If you do not have access to the Podman socket, the script prints a message indicating the required access configuration.
The installation does not set Planning Analytics Workspace containers to start automatically upon computer restart. You must start the Planning Analytics Workspace containers after a system restart.

Follow these steps to install Planning Analytics Workspace Local.

Procedure

  1. Open a terminal window, go to the directory where you extracted the installation kit, and type the following command: 
    ./Start.sh
    Note: The first time you run the start script, it automatically installs the Docker images. The next time you run the start script, you can skip installing or updating the Docker images and go straight into the administration tool.
  2. Reply y when you are asked if you want to start the administration tool.
    The Planning Analytics Workspace administration tool opens in your browser.
    Note: Keep the command or terminal window open. Closing the window stops the administration tool.

What to do next

If the administration tool doesn't open, copy and paste the address shown in the command or terminal window into a browser window. If you have issues connecting to Planning Analytics Workspace on Linux OS, see Access the Planning Analytics Workspace administration tool remotely on Linux.