1.4. Installing the SGD Enhancement Module for UNIX and Linux Platforms

The SGD Enhancement Module for UNIX and Linux Platforms contains modules for advanced load balancing, CDM and UNIX audio.

The UNIX audio module of the Enhancement Module is optional and is not installed by default. If you choose to install the UNIX audio module, the SGD audio driver is installed in the kernel of the operating system.

On Oracle Solaris platforms, the UNIX audio module can be installed only in the global zone.

On Linux platforms, the SGD audio driver is compiled before it is installed in the kernel. To compile the audio driver, the following must be available on the host:

On Oracle Solaris platforms, install the Enhancement Module with the pkgadd command.

On Linux platforms, install the Enhancement Module with the rpm command.

By default, the Enhancement Module is installed in the /opt/tta_tem directory. You can change the installation directory as follows:

After installation, the advanced load balancing module and the UNIX audio module, if selected, are running. The CDM module is not running, because this requires additional configuration. The additional configuration needed is described in the Oracle Secure Global Desktop Administration Guide for Release 4.7.

The Enhancement Module installation program adds a file to the system startup directory to ensure that the Enhancement Module starts when the system reboots. For example, if you install the software in run level 3, the file is in the /etc/rc3.d directory and named *sun.com-sgd-em.

1.4.1. How To Install the SGD Enhancement Module on Solaris Platforms

  1. Save the SGD Enhancement Module to a temporary directory on the host.

    If you are installing from the installation media, the package is in the modules directory.

    Alternatively, download the installation program from an SGD web server from https://server.example.com, where server.example.com is the name of an SGD server. When the SGD web server Welcome Page displays, click Install an Oracle Secure Global Desktop Enhancement Module.

    These are the package files:

    • tem-version.sol-x86.pkg for Oracle Solaris on x86 platforms

    • tem-version.sol-sparc.pkg for Oracle Solaris on SPARC technology platforms

    where version is the SGD version number.

  2. Log in as superuser (root) on the host.

  3. Install the SGD Enhancement Module.

    If the package file is compressed, you must expand it before installing.

    To install on Oracle Solaris on x86 platforms:

    # pkgadd -d /tempdir/tem-version.sol-x86.pkg
    

    To install on Oracle Solaris on SPARC technology platforms:

    # pkgadd -d /tempdir/tem-version.sol-sparc.pkg
    

    When you install, the Enhancement Module installation program presents the following settings that you can accept or change:

    • The installation directory.

    • The amount of virtual memory the host has. This is used for load balancing.

    • Whether to install the UNIX audio module.

  4. Verify that the Enhancement Module package is registered in the package database.

    # pkginfo -x tem

1.4.2. How To Install the SGD Enhancement Module on Linux Platforms

  1. Save the SGD Enhancement Module to a temporary directory on the host.

    If you are installing from the installation media, the package is in the modules directory.

    Alternatively, download the installation program from an SGD web server from https://server.example.com, where server.example.com is the name of an SGD server. When the SGD web server Welcome Page displays, click Install an Oracle Secure Global Desktop Enhancement Module.

    The package files are tem-version.i386.rpm, where version is the SGD version number.

  2. Log in as superuser (root) on the host.

  3. Install the SGD Enhancement Module.

    # rpm -Uvh tem-version.i386.rpm
    
  4. Verify that the Enhancement Module package is registered in the package database.

    # rpm -q tem
  5. Start the Enhancement Module installation program.

    # /opt/tta_tem/bin/tem start
  6. Configure settings for the Enhancement Module.

    The Enhancement Module installation program presents the following settings that you can accept or change:

    • The amount of virtual memory the host has. This is used for load balancing.

    • Whether to install the UNIX audio module.

1.4.3. Troubleshooting Installing the UNIX Audio Module on Linux Platforms

On Linux platforms, if the UNIX audio module does not install, the SGD Enhancement Module installation program asks you whether to cancel the installation or to continue the installation without installing the UNIX audio module. If the UNIX audio module does not install, check the following:

  • Are the header files for your Linux kernel version installed?

  • Do the version numbers of the header files and the Linux kernel match?

  • Does the GCC version match the version used to compile the Linux kernel?

  • Does the dmesg utility reveal any other errors?

  • If the ARCH environment variable is set in your environment, does it contain the path to a directory that exists on the system?