1.3. Performing the Installation

On Oracle Solaris platforms, install the SGD Gateway with the pkgadd command.

On Linux platforms, install the SGD Gateway with the rpm command.

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

1.3.1. How To Install the SGD Gateway

  1. Save the SGD Gateway package to a temporary directory on the host.

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

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

    These are the package files:

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

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

    • SUNWsgdg-version.i386.rpm on Linux platforms

    where version is the SGD Gateway version number.

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

  3. Install the SGD Gateway.

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

    To install on Oracle Solaris on x86 platforms:

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

    To install on Oracle Solaris on SPARC technology platforms:

    # pkgadd -d /tempdir/SUNWsgdg-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 Linux platforms:

    # rpm -Uvh /tempdir/SUNWsgdg-version.i386.rpm
    
  4. Verify that the SGD Gateway package is registered in the package database.

    On Oracle Solaris platforms:

    # pkginfo -x SUNWsgdg

    On Linux platforms:

    # rpm -qa | grep -i SUNWsgdg
  5. Run the SGD Gateway setup program.

    # /opt/SUNWsgdg/bin/gateway setup

    The SGD Gateway setup program presents the following settings that you can accept or change:

    • SGD Gateway port settings. The interface and port used by the SGD Gateway for incoming connections. By default, the SGD Gateway listens on port 443 on all interfaces.

    • Network entry point. The Internet Protocol (IP) address, or Domain Name System (DNS) name, and the port that client devices use to connect to the SGD Gateway. This is not always the same as the address of the SGD Gateway. Depending on the configuration of your network, this can be the address of a load balancer or other external device.

      For example, if users connect directly to an SGD Gateway at gateway1.example.com, type gateway1.example.com:443 for the network entry point.

      If users connect to the SGD Gateway through a load balancer at lb.example.com, type lb.example.com:443 for the network entry point.

    • Secure connections. Whether to secure the connections between the SGD Gateway and the SGD servers in the array. By default, the SGD Gateway uses secure connections. To use secure connections, the SGD servers in the array must be running in secure mode.

      See Section C.4, “Using Unencrypted Connections to the SGD Array” for more information about using unencrypted connections to the SGD servers in the array.

    Note

    These settings can be changed later, by using the gateway config create command. See Section 2.2.1.1, “How to Configure the Ports and Connections for the SGD Gateway”.

    After installing the software, you must perform additional configuration of the SGD Gateway. See Chapter 2, Configuring the SGD Gateway for details of what you need to do.