On UNIX

The installation consists of these steps:

  1. Create the install directory for SLM. The default directory is:
    /usr/slm
  2. Create a global environment variable SLMHOME that directs to this installation directory.

    On AIX, use the /etc/environment file. On other platforms, use /etc/profile file or any other file that permits you to set a system-wide environment variable.

  3. Transfer the SLM client files.
    Transfer the appropriate .tar file from the ..\client\<OS> installation software to the $SLMHOME directory and untar the file, according to the platform specifications.

    You can find the correct .tar file under the …\client directory of the SLM installation software, for example:

    …\client\HP-UX11.31ia64\client_HPUX.tar

    For example, the command to untar the file on a Solaris computer is:

    $ cd $SLMHOME

    $ tar xvf /tmp/client_SUN.tar

  4. Set the PATH variable.
    Adapt the environment variable that governs the search path to enable the OS to find the SLM shared libraries in $SLMHOME/shlib:
    Variable OS
    PATH Win32
    LIBPATH AIX
    LD_LIBRARY_PATH Solaris, IA64 HPUX, SuSe, RedHat

    Ensure this environment variable is exported to all processes.

    Java programs can also use the SLM licensing scheme. For this purpose, the environment variable CLASSPATH must be extended with the com_baan_bclm.jar file (in the korn shell):

    export CLASSPATH=${CLASSPATH:+${CLASSPATH}:}$SLMHOME/java/com_baan_bclm.jar

    Ensure this environment variable is exported to all processes.

  5. Create the $SLMHOME/etc/servers.xml file
    This file tells the client which SLM server must be contacted. Use slmconfig -c or by copying the file from an already configured SLM client (of the same version!).
  6. Ensure that all SLM users can read these files and directories:
    • $SLMHOME/shlib/*
    • $SLMHOME/java/com_baan_bclm.jar

    These directories must have write permissions for all.

    • If you are using 'automatic client update': $SLMHOME/etc/servers.xml
    • $SLMHOME/log

    For example, set the directories and the files to 755 (drwxr-xr-x). You must set the log directory to 777 (drwxrwxrwx) because every user must be permitted to write a file in the log directory.

  7. Ensure the variable SLM_API_SL is pointing to the file:
    <SLM_install>/shlib/SLMClient.so

    Dependent of platform the suffix is .a, .so or .sl

    An alternative is to link the file:

    ln -s SlmClient.so libBclmEx.so

    If you use the 64bits client of SLM use:

    ln -s SlmClient64.so libBclmEx.64.so

  8. Check the installation and configuration with slmclienttest.