C H A P T E R  2

Installing SGD

This chapter describes how to install Sun Secure Global Desktop (SGD).

If you are upgrading, read the upgrade instructions in Chapter 3 before installing the software.

SGD contains several installable components:

Topics in this chapter include the following:


Performing the Installation

On Solaris OS platforms, install SGD with the pkgadd command.

On Linux platforms, install SGD with the rpm command.

By default, SGD is installed in the /opt/tarantella directory. You can change the installation directory as follows:

Once you install SGD, the SGD server and the SGD Web Server are running.



Note - Installation of SGD might take longer than expected and might appear to hang. This is because the installation program attempts to access a location on /net/telford. To avoid this issue, add a Domain Name System (DNS) entry for telford. This issue is documented on page 41 of the Sun Secure Global Desktop 4.41 Release Notes.



procedure icon  How To Install SGD



caution icon

Caution - If you are upgrading from a release before SGD version 4.40, this release contains significant changes to the SGD organizational hierarchy. Read Organizational Changes for Versions 4.40 and Later before you upgrade.



  1. Obtain the software.

    Download the software from http://www.sun.com/software/products/sgd or copy it from the CD‐ROM.

    Save the software to a temporary directory on the host.

    These are the package files:

    • tta-version.sol-x86.pkg for Solaris OS on x86 platforms

    • tta-version.sol-sparc.pkg for Solaris OS on SPARC technology platforms

    • tta-version.i386.rpm on Linux platforms

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

  3. Install SGD.

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

    To install on Solaris OS on x86 platforms:


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

    To install on Solaris OS on SPARC technology platforms:


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



    Note - On Solaris OS platforms, if the installation fails with a pwd: cannot determine current directory! error message, change to the /tempdir directory and try again.



    To install on Linux platforms:


    # rpm -Uvh /tempdir/tta-version.i386.rpm
    

  4. Verify that the SGD package is registered in the package database.

    On Solaris OS platforms:


    # pkginfo | grep -i tta
    

    On Linux platforms:


    # rpm -qa | grep -i tta
    

  5. Start the SGD server.


    # /opt/tarantella/bin/tarantella start
    

    The first time you start the SGD server, the SGD installation program runs. This program does the following:

    • Asks you to agree to the Software License Agreement.

    • Presents a list of recommended settings that you can accept or change, including the following:

      • TCP port. If a web server is currently running on TCP port 80, the SGD installation program asks you which TCP port to use for the SGD Web Server.

      • Peer DNS name. You must use a fully-qualified DNS name. If you are running SGD on a network with a firewall, use the DNS name that the host is known by inside the firewall.

    • Installs and configures the software. This includes creating an organizational hierarchy with some sample applications, and making the UNIX or Linux system root user an SGD Administrator.

    • Adds a file to the system startup directory to ensure that the SGD server and the SGD Web Server start 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-base.

    • Modifies root’s crontab to archive the SGD log files weekly.

    • On Linux platforms only, adds a SGD Pluggable Authentication Module (PAM) configuration file, /etc/pam.d/tarantella. This is copied from the existing /etc/pam.d/passwd file. If this file does not exist, the PAM configuration file is not created.

    • Creates a log file, /tmp/tta_inst.log. This file contains a copy of the messages displayed during installation.


Installing the SGD Enhancement Module for Microsoft Windows

The SGD Enhancement Module for Microsoft Windows contains modules for advanced load balancing, client drive mapping (CDM), and seamless windows. When you install the Enhancement Module, you can choose which of these modules to install.

By default, the Enhancement Module is installed in the C:\Program Files\Tarantella\Enhancement Module directory, but the installation program asks you for the installation directory.

After installation, the load balancing service is running. The load balancing service starts automatically whenever the Windows host is rebooted.

procedure icon  How to Install the SGD Enhancement Module for Microsoft Windows

  1. Log in to the Windows host as a user with administrator privileges.

  2. Save the Enhancement Module installation program to a temporary directory on the host.

    If you are installing from the CD-ROM, the installation program is in the EnhancementModules directory.

    Alternatively, download the installation program from an SGD Web Server from http://server.example.com, where server.example.com is the name of an SGD server. When the SGD Web Server Welcome Page displays, click Install a Sun Secure Global Desktop Enhancement Module.

    The SGD Enhancement Module installation program is temwin32.exe.

  3. Install the SGD Enhancement Module.

    Double-click temwin32.exe and follow the instructions on the screen.


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 Solaris OS platforms, the UNIX audio module can be installed only in the global zone.

On Linux platforms, the UNIX audio module can be installed only if your kernel version is 2.4.20 or later. 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 Solaris OS platforms, install the Enhancement Module with the pkgadd command.

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

On Solaris OS and Linux platforms, the Enhancement Module is installed in the /opt/tta_tem directory by default. On Solaris OS platforms, the installation program asks you for the installation directory when you install the software. On Linux platforms, you can choose a different installation directory by using the ‐‐prefix option with the rpm command when you install the software.

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 Sun Secure Global Desktop 4.41 Administration Guide.

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.

procedure icon  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 CD-ROM, the package is in the EnhancementModules directory.

    Alternatively, download the installation program from an SGD Web Server from http://server.example.com, where server.example.com is the name of an SGD server. When the SGD Web Server Welcome Page displays, click Install a Sun Secure Global Desktop Enhancement Module.

    These are the package files:

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

    • tem-version.sol-sparc.pkg for Solaris OS 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 Solaris OS on x86 platforms:


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

    To install on Solaris OS 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 | grep -i tem
    

procedure icon  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 CD-ROM, the package is in the EnhancementModules directory.

    Alternatively, download the installation program from an SGD Web Server from http://server.example.com, where server.example.com is the name of an SGD server. When the SGD Web Server Welcome Page displays, click Install a Sun 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 -qa | grep -i 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.

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 platform module does not install, check the following:


Installing the SGD Client Manually

The SGD Client is usually installed automatically when a user connects to an SGD server using a browser with Java technology enabled. Follow these instructions only if you want to install the SGD Client manually.

You do not need superuser (root) or administrator privileges to install the SGD Client.

On Microsoft Windows platforms, the SGD Client is installed in the C:\Program Files\Sun\Secure Global Desktop Client directory by default, but you can choose a different installation directory when you install the software. A shortcut for the SGD Client is added to the Windows Start Menu.

On UNIX and Linux platforms, the SGD Client is installed in the $HOME/bin directory by default, but you can choose a different installation directory when you install the software.

procedure icon  How to Install the SGD Client Manually on Microsoft Windows Platforms

  1. In a browser, go to an SGD Web Server.

    For example, http://server.example.com, where server.example.com is the name of an SGD server.

    The SGD Web Server Welcome Page displays.

  2. (Optional) Select your preferred language.

    Click one of the flags at the top of the Welcome Page.

    The Welcome page displays in the selected language.

  3. Click Install the Sun Secure Global Desktop Client.

    The Sun Secure Global Desktop Client page displays.

  4. Download the SGD Client installation program.

    Click Download the Secure Global Desktop Client for Microsoft Windows.

    Save the installation program to a temporary directory on the PC.

    The SGD Client installation program is sgdcwin-lang.exe.

  5. Change to the temporary directory and install the SGD Client.

    Double-click sgdcwin-lang.exe and follow the instructions on the screen.

procedure icon  How to Install the SGD Client Manually on Solaris OS and Linux Platforms

  1. In a browser, go to an SGD Web Server.

    For example, http://server.example.com, where server.example.com is the name of an SGD server.

    The SGD Web Server Welcome Page displays.

  2. (Optional) Select your preferred language.

    Click one of the flags at the top of the Welcome Page.

    The Welcome page displays in the selected language.

  3. Click Install the Sun Secure Global Desktop Client.

    The Sun Secure Global Desktop Client page displays.

  4. Download the SGD Client tar file.

    Click Download the Secure Global Desktop Client for platform.

    Save the tar file to a temporary directory on the host.

    Tar file names indicate a platform, as follows:

    • sgdci3so.tar for Solaris OS on x86 platforms

    • sgdcspso.tar for Solaris OS on SPARC technology platforms

    • sgdci3li.tar for Linux platforms

  5. Change to the temporary directory and extract the tar file.


    $ cd /tempdir
    $ tar xvf tarfile
    

  6. Install the SGD Client.


    $ sh sgdc/install
    

    Follow the instructions on the screen.

Logging in Using the SGD Client

The first time you start the SGD Client, it asks for the following information: