1.2. Installing the Main SGD Component

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:

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:

Once you install SGD, the SGD server and the SGD web server are running.

1.2.1. How To Install SGD

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.

  1. 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-version.sol-x86.pkg for Oracle Solaris on x86 platforms

    • tta-version.sol-sparc.pkg for Oracle Solaris 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 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
    
    Note

    On Oracle Solaris 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 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
    
  4. Verify that the SGD package is registered in the package database.

    On Oracle Solaris platforms:

    # pkginfo -x tta

    On Linux platforms:

    # rpm -q 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:

      • 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.