06-Sep-2023 ================================ Altair SLC Installation on Linux ================================ Altair SLC for Linux version 2023.5 (5.23.5.0-GA-release) ----------------------------------------------------------------------- ======================================================================= 1. Prerequisites 2. Installation 2.1 Apply a license 2.2 Environment variables 3. wpsenv.sh shell script 4. Launch Altair Analytics Workbench ======================================================================= 1. Prerequisites ================ Altair SLC and Altair Analytics Workbench are supported on Red Hat Enterprise Linux 7 (or equivalent distribution) or later running on x86_64, AARCH64, PowerPC (LE), or s390x hardware. 2. Installation =============== Altair SLC and Altair Analytics Workbench are available as separate RPM installation packages or compressed tar archives which can be downloaded from the Altair One marketplace at www.altairone.com. You will require a username and password to access the download section of the site. The installation programs are: - altairanalyticsworkbench--linux-x86_64.rpm - altairslc--linux-x86_64.rpm Where is the release version of the installation program. Ensure that you have the same release version for both installation program. Use of the Altair SLC engine is controlled by means of a license which must be applied after installation. If only Altair Analytics Workbench is installed on a workstation, that workstation will not require a license. - To use Altair Analytics Workbench only, for example to connect to a remote installation of the Altair SLC engine, you require the altairanalyticsworkbench--linux-x86_64.rpm installation program. - To use Altair Analytics Workbench and the Altair SLC engine on the same device, you require both installation programs. - To use the Altair SLC engine only you require the altairslc--linux-x86_64.rpm installation program. RPM package ----------- To install the package requires the ability to use the sudo command to gain administrator privilege. The default installation location is /opt/altair/slc/. After downloading the package, install using the following command: sudo rpm --install //.rpm Compressed tar -------------- If you are not installing using the package files, download the following compressed archives - altairanalyticsworkbench--linux-x86_64.tar.gz - altairslc--linux-x86_64.tar.gz To install, change (cd) to a suitable installation location to which you have write-access. Extract the files from the required archive using gunzip and tar as follows. Unzip or untar the installation file by typing: tar -xzof .tar.gz or: gzip -cd .tar.gz | tar xvf - The archive is completely self-contained and can be unpacked anywhere. The installation location can be somewhere that requires root access such as /opt if installing for all users, or it can be in your home directory. 2.1 Apply a license =================== A license is required to run Altair SLC, this can be either Altair Units or a wpskey license file. Altair Units are served from either a hosted by Altair (HHWU) or an on-site the Altair License Manager (ALM); a wpskey license file is downloaded from the World Programming website (https://www.worldprogramming.com). If a workstation has both Altair SLC and Altair Analytics Workbench installed, the license can be applied through Workbench. For more information see the Altair Analytics Workbench User Guide in your installation, or available from the Altair community documentation site (https://help.altair.com). Where only Altair SLC is installed: - If using the Altair hosted license server, you need to specify the ALM_HHWU environment variable and obtain a configuration file to link the server hosting Altair SLC with the Altair hosted license server. - Log in to your Altair One account. In your user profile page, obtain an Altair One authorization code for the server hosting Altair SLC. Note that this code has a limited usage time. - On the server hosting Altair SLC, specify the following environment variable: export ALM_HHWU=TRUE - Run the following command: Almutil -hhwuath -code -system Where: - is the Altair One authorization code This command downloads a configuration file to the default location of /usr/local/altair/altair_hostedhwu.cfg. - If using an on-site license manager, specify the following environment variables: export ALM_HHWU=FALSE export ALTAIR_LICENSE_PATH=@ Where: - is the port on the which the license server communicates. - is the URL of the license server. When creating environment variables, we recommend creating a Bash shell script called wpsenv.sh that exports this and any other environment variables you create for Altair SLC. Using the shell script enables these variables to be sourced from system Bash shell scripts. - If using a wpskey license file downloaded from the World Programming website (worldprogramming.com), apply the key using the following command: /bin/wps -stdio -setinit < Where: - is the path to the downloaded license key file. A message will confirm the license had been applied successfully. 2.2 Environment variables ========================= Note: The following recommendation assumes that you use the Bash shell. Using Altair SLC with third-party applications, such as database servers, requires that the environment information needs to be available when Altair SLC is invoked, such as: * LD_LIBRARY_PATH, for example pointing to client libraries for a database * PATH, for example pointing to the bin folder for unixODBC * ODBCSYSINI, pointing to the unixODBC client libraries If you have not set these environment variables in another way, we recommend creating a Bash shell script called wpsenv.sh that exports these variables so that they can be sourced from system Bash shell scripts. If Altair SLC is used by multiple users, you should consider setting global environment variables: 1. Create a folder called altairslc in /etc and in this folder, create a wpsenv.sh shell script. 2. This file should be sourced from both the /etc/profile and /etc/bashrc files to ensure that the variables are available to Altair SLC. If Altair SLC is to be used by individual users, you should set the variables through a Bash shell script in the user's home directory: 1. Create a folder called .altairslc in the home directory and in this folder, create a wpsenv.sh shell script. 2. This file should be sourced from ~/.profile or ~/.bash_profile to ensure that the variables are available to Altair SLC. 3. wpsenv.sh shell script ========================= You can create a shell script that enables you to configure environment variables or other system options before running Altair SLC. The script can be called either wpsenv.sh, that can be executed by any version of Altair SLC, or wpsenv-2023.sh, which will only be executed by Altair SLC version 2023. The script you create can be located in either the root Altair SLC installation directory or the user's home directory. Using a version-specific shell script allows different environments to be configured individually as new releases are deployed. 4 Launch Altair Analytics workbench =================================== To launch Altair Analytics Workbench: /eclipse/workbench For information on using Workbench, see the Altair Analytics Workbench User Guide. A PDF version of this guide can be found in the doc directory of your installation. A similar version of this guide can also be accessed directly from Workbench by selecting the menu item Help > Help Contents. Copyright 2002-2023 World Programming, an Altair Company