06-Sep-2023 =================================== Altair SLC Installation on macOS =================================== Altair SLC for macOS version 2023.5 (5.23.5.0-GA-release) ----------------------------------------------------------------------- ======================================================================= 1. Prerequisites 2. Installation 2.1 Apply a license 3. Launch Altair Analytics workbench ======================================================================= 1. Prerequisites ================ macOS -------- Altair SLC and Altair Analytics Workbench are supported on macOS 10.11 (El Capitan) and later running on x86_64 hardware. 2. Installation =============== Altair SLC and Altair Analytics Workbench are provided as separate installation programs which are available 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--macos-x86_64.dmg - altairslc--macos-x86_64.dmg Where is the release version of the installation program. Ensure that you have the same release version for both installation programs. 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--macos-x86_64.dmg 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--macos-x86_64.dmg installation program. Once the required installation program is downloaded, double-click the files, read and accept the EULA and follow the on-screen instructions. Each installation program must be run independently. 1 Download the required file .dmg. The file is stored in your download folder. 2 For each downloaded file, open the download folder and double-click the installation program file. A Finder window opens, through which the content of the .dmg file is made available. 3 Drag the application from the .dmg window into your system's Applications folder. To do this you might need to enter an administrator password. 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. To apply a license in Workbench, you need to be an administrative user. 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. - To apply a wpskey license file through a terminal command line using the following command: /Applications/AltairSLC.app/Contents/MacOS/wps -setinit Where: is the name of the file that contains your license key. 3 Launch Altair Analytics workbench =================================== You can now invoke Altair Analytics Workbench. To do this, open the Applications folder and double-click WPS.app. For information on using Workbench, see the Altair Analytics Workbench User Guide, which can be viewed: - From Workbench, by selecting the menu item Help > Help Contents. - As a PDF file, which can be found in the doc folder of the Altair SLC installation. To view the doc folder: 1 Open the Applications folder, find WPS.app and right-click it (alternatively, you can use Ctrl + click). 2 From the dialog that opens, select Show Package Contents. 3 From this folder, open the Contents/doc folder. All Altair SLC documentation is stored in locale folders in the doc folder. Starting Altair SLC from the command line -------------------------------------------- You can start Altair SLC from the command line: 1 Start the Terminal application (found in the Utilities folder of the Applications folder) 2 Invoke Altair SLC from the command line by entering: /Applications/AltairSLC.app/Contents/MacOS/wps Copyright 2002-2023 World Programming, an Altair Company