06-Sep-2023

==================================
Altair SLC Installation on AIX
==============================

Altair SLC for AIX version 2023.5 (5.23.5.0-GA-release)

-----------------------------------------------------------------------

=======================================================================
  Installation
  Environment variables
  wpsenv.sh shell script
=======================================================================


Installation
============
Altair SLC for AIX is currently available as a compressed tar (.tar.Z)
archive file and is supported on AIX 7.2 or later running on
PowerPC (ppc)/POWER/System p hardware.

The Altair SLC tar archive for AIX can be downloaded from the
World Programming website. You will require a username and password to
access the download section of the site.

Once you have downloaded the archive to your system, you will need to
extract the files.

First uncompress the downloaded file using the following command:

    uncompress <installation-file>.tar.Z

Choose a suitable installation location to which you have write access
and change (cd) to that directory. The archive is completely
self-contained and can be unpacked anywhere. The installation location
can be somewhere that requires root access such as /usr/local if
installing for all users, or it can be in your home directory.

Unpack the tar file using the following command:

    tar -xof <installation-file>.tar

Note that the -o option is recommended when unpacking as root to ensure
that the files have the correct uid and guid.

You will need a license to run Altair SLC. The wpskey license file is
downloaded from the World Programming website and applied by calling
the main executable for Altair SLC as follows:

  <installation-dir>/bin/wps -stdio -setinit < <wps-key-file>


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:

*	LIBPATH, 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, and can be sourced from system Bash shell scripts.

If WPS is used by multiple users, you should consider setting global
environment variables:

1.	Create a folder called altairslc in /etc.
    and within 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 within 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.


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, which can be executed by any version of
Altair SLC, or version-specific for example 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.


Copyright 2002-2023 World Programming, an Altair Company