On Oracle Solaris platforms, install SGD with the pkgadd command.
On 32-bit Linux platforms, install SGD with the rpm command.
On 64-bit Linux platforms, install SGD with the yum command. To ensure that any package dependencies are resolved automatically, yum should be configured to use a suitable Linux package repository. See Section 1.1.1, “Creating a Linux Package Repository From an ISO Image” if an online repository is not available.
By default, SGD is installed in the
/opt/tarantella
directory. You can change the
installation directory as follows:
Oracle Solaris platforms – The installation program asks you for the installation directory when you install the software.
Oracle Solaris 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 – On
32-bit Linux platforms you can choose a different installation
directory by using the --prefix
option with
the rpm command when you install the
software.
When you install the main SGD component, you install the SGD web server. The SGD installation program asks you for the TCP port that the SGD web server listens on for HTTP connections. This is usually TCP port 80. If another process is listening on that port, the installation program asks you to choose another port.
You can install SGD in the following ways:
Secure mode. This is the default mode of installation. The installation program does the following:
Installs a Secure Sockets Layer (SSL) certificate and configures the SGD server for secure connections between client devices and the SGD server.
If you do not specify certificate details during installation, a self-signed SSL certificate is created and installed automatically. Only use a self-signed SSL certificate for test purposes.
Enables secure intra-array communication for the SGD server. This means that connections between the SGD servers in an array are secure.
When you install in secure mode, the installation program uses the tarantella security enable command to configure and enable secure connections automatically. See the Oracle Secure Global Desktop Administration Guide for Release 4.7 for more information about using this command to install an SSL certificate and enable secure connections.
Non-secure mode. The SGD server is not configured for secure connections during installation. Connections can be secured after installation, as described in the Oracle Secure Global Desktop Administration Guide for Release 4.7.
Once you install SGD, the SGD server and the SGD web server are running.
Before you begin, if you are installing in secure mode ensure you have access to your SSL certificate, and the private key and CA certificate, if needed. The certificates must be in PEM format.
Obtain the software.
Download the software from http://www.oracle.com, or copy it from the installation media.
Save the software to a temporary directory on the host.
These are the package files:
tta-
for Oracle Solaris on x86 platforms
version
.sol-x86.pkg
tta-
for Oracle Solaris on SPARC technology platforms
version
.sol-sparc.pkg
tta-
on Linux platforms
version
.i386.rpm
Log in as superuser (root) on the host.
Install SGD.
If the package file is compressed, you must expand it before installing.
To install on Oracle Solaris on x86 platforms:
# pkgadd -d /tempdir
/tta-version
.sol-x86.pkg
To install on Oracle Solaris on SPARC technology platforms:
# pkgadd -d /tempdir
/tta-version
.sol-sparc.pkg
On Oracle Solaris platforms, if the installation fails
with a pwd: cannot determine current
directory!
error message, change to the
/
directory and try again.
tempdir
To install on 32-bit Linux platforms:
# rpm -Uvh /tempdir
/tta-version
.i386.rpm
To install on 64-bit Linux platforms:
# yum install /tempdir
/tta-version
.i386.rpm
Verify that the SGD package is registered in the package database.
On Oracle Solaris platforms:
# pkginfo -x tta
On Linux platforms:
# rpm -q tta
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:
Install in secure mode? By default, SGD is installed and configured to use secure connections to the SGD server and secure intra-array communication. Alternatively, SGD can be installed without secure connections.
Certificate file
name. The SSL certificate used to secure
connections to the SGD server. If you
have your own SSL certificate, enter the path to the
certificate file. The path must be readable by the
ttasys
user.
The default setting of *
means
that a self-signed certificate is installed
automatically.
Private key file
name. If you are using your own SSL
certificate, enter the full path to the private key
file. The path must be readable by the
ttasys
user.
(Optional) Root certificate
file name. If you are using your own SSL
certificate, enter the full path to the root CA
certificate file. The path must be readable by the
ttasys
user.
This setting is only required if the SSL certificate is signed by an unsupported CA or an Intermediate CA.
Peer DNS name. You must use a fully-qualified Domain Name System (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.
TCP port. If another process is currently running on TCP port 80, the SGD installation program asks you which TCP port to use for the SGD web server.
Archive logs every
week? By default, SGD
archives its log files each week at 3 a.m. on
Sunday. The log files are archived in the
/opt/tarantella/var/log
directory.
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.
(Optional) Installs an SSL certificate. For installations in secure mode, the certificate is used to configure the SGD server for secure connections.
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 an 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.