Installing CATALYST Professional on Linux - Version 3 and Newer

This tutorial serves as a guide to installing the newer versions of CATALYST Professional on a Linux machine. CATALYST Professional is compatible with the following Linux operating systems:

• Ubuntu 20 - Retired (final supported software version is CATALYST Professional 3.1.2)
• Ubuntu 22
• Ubuntu 24 - Introduced in CATALYST Professional 3.3.0

Other system requirements and specifications can be found on the CATALYST Technical Specifications webpage.

More information on the installation process can be found in the Install Guide document in the installation package.

1. Downloading CATALYST Professional

The installation package for the software can be found on the CATALYST Earth Downloads webpage.

1. Navigate to the CATALYST Earth Downloads webpage.
2. Select the appropriate Ubuntu machine.
3. Optionally, you can download the Demo Data as well.
4. The installation package comes as a zipped folder. Unzip the downloaded files.

Note: The Ubuntu 20 installation package is not available on the webpage. Please contact the CATALYST Professional Support Team if you will be working with a compatible software version on that operating system.

2. Installing CATALYST Professional

The installation is performed entirely through the terminal and requires sudo privileges to begin.

1. Copy the the .deb file to the /tmp folder either through the file explorer or with the command:
   • cp <CATALYST-Professional-<platform>.deb> /tmp
2. To ensure the system packages are up to date, enter sudo apt update.
3. Install the downloaded .deb file through the apt package manager with sudo apt install /tmp/<CATALYST-Professional-<platform>.deb>
   • Note: Specify the path to the downloaded .deb file.
4. When prompted to confirm the installation, click Y (for yes) or N (for no). Note: if N is selected, the installation will not continue.
5. Once the installation process is done, it will be found in /opt/catalystpro.
6. The bash script, /etc/profile.d/catalystpro.sh, is created. This file must be sourced in non-login terminals to add the necessary CATALYST Professional components to the required system paths. Different options exist depending on your needs:
   • Manually (and temporarily) source the script in the current terminal. This is required in every new non-login terminal:
     • source /etc/profile.d/catalystpro.sh
   • Permanently source /etc/profile.d scripts in non-login terminals by adding the command below to the user's ~/.bashrc file (/home/qa/.bashrc):
     • if [ -f /etc/profile ]; then . /etc/profile; fi
7. To open the CATALYST Professional toolbar:
   • Change the directory to the exe folder found in the installation directory:
     • cd /opt/catalystpro/exe
   • Once in that directory, open the toolbar with ./catalystpro
   • You can also open the other tools in a similar fashion, e.g. ./focus, ./orthoengine, ./licenseairgappedsystem etc.

3. Installing the Demo Data

The demo data is installed similarly to the software.

1. Copy the the .deb file to the /tmp folder either through the file explorer or with the command:
   • cp <CATALYST-Professional-Data-<platform>.deb> /tmp
2. Install the downloaded .deb file through the apt package manager with sudo apt install /tmp/<CATALYST-Professional-Data-<platform>.deb>
3. When prompted to confirm the installation, click Y (for yes) or N (for no). Note: if N is selected, the installation will not continue.
4. Once the installation process is done, it will be found in /opt/catalystpro/demo.

4. Uninstalling CATALYST Professional and the Demo Data

To uninstall CATALYST Professional:

1. Open a terminal and uninstall the software with the apt package manager:
   • sudo apt remove catalystpro-full
2. The demo data can be uninstalled similarly with the command:
   • sudo apt remove catalystpro-demo-data
3. Optionally, the installed dependencies can be removed with:
   • sudo apt autoremove