C H A P T E R 2 |
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:
The component installed on hosts provides the main functionality of SGD.
The component installed on application servers, called an SGD Enhancement Module, provides additional functionality for SGD, for example to enable users to access the drives on their client device.
The component installed on client devices enables users to connect to an SGD server.
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:
Solaris OS platforms – The installation program asks you for the installation directory when you install the software.
Solaris 10 OS Trusted Extensions platforms – The installation program asks you for the installation directory when you install the software. You must select another installation directory because the /opt directory is a read-only directory. You must also install SGD in a labelled zone. Do not install SGD in the global zone.
Linux platforms – You can choose a different installation directory by using the ‐‐prefix option with the rpm command when you install the software.
Once you install SGD, the SGD server and the SGD Web Server are running.
![]() | 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. |
Download the software from http://www.sun.com/software/products/sgd or copy it from the CD‐ROM.
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 |
Verify that the SGD package is registered in the package database.
# pkginfo | grep -i tta |
# rpm -qa | grep -i tta |
# /opt/tarantella/bin/tarantella start |
The first time you start the SGD server, the SGD installation program runs. This program does the following:
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.
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.
|
Log in to the Windows host as a user with administrator privileges.
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.
Install the SGD Enhancement Module.
Double-click temwin32.exe and follow the instructions on the screen.
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.
|
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.
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:
Verify that the Enhancement Module package is registered in the package database.
# pkginfo | grep -i tem |
|
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.
Install the SGD Enhancement Module.
# rpm -Uvh tem-version.i386.rpm |
Verify that the Enhancement Module package is registered in the package database.
# rpm -qa | grep -i tem |
Start the Enhancement Module installation program.
# /opt/tta_tem/bin/tem start |
Configure settings for the Enhancement Module.
The Enhancement Module installation program presents the following settings that you can accept or change:
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:
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.
|
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.
(Optional) Select your preferred language.
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.
Change to the temporary directory and install the SGD Client.
Double-click sgdcwin-lang.exe and follow the instructions on the screen.
|
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.
(Optional) Select your preferred language.
Download the SGD Client tar file.
Click Download the Secure Global Desktop Client for platform.
Change to the temporary directory and extract the tar file.
$ cd /tempdir $ tar xvf tarfile |
$ sh sgdc/install |
On UNIX and Linux platforms, you start the SGD Client with the ttatcc command.
On Microsoft Windows platforms, you can either start the Client as part of the installation or click Start -> Programs -> Sun Secure Global Desktop -> Login.
The first time you start the SGD Client, it asks for the following information:
The Uniform Resource Locator (URL) of the SGD server to connect to. This is usually http://server.example.com/sgd, where server.example.com is the name of an SGD server.
The proxy settings to use. The settings can be determined from your default browser, if Java technology is enabled, or you can type them in.
Copyright © 2008, Sun Microsystems, Inc. All rights reserved.