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 yum command. To ensure that any package dependencies are resolved automatically, yum should be configured to use a suitable Linux package repository. See Creating a Linux Package Repository From an ISO Image if an online repository is not available.

By default, the SGD Gateway is installed in the /opt/SUNWsgdg directory. On Oracle Solaris platforms, you can change the installation directory when the installation program prompts you for the installation directory.

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

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

    • SUNWsgdg-version.x86_64.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_64.pkg
    

    To install on Oracle Solaris on SPARC technology platforms:

    # pkgadd -d /tempdir/SUNWsgdg-version.sol-sparcv9.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:

    # yum install --nogpgcheck /tempdir/SUNWsgdg-version.x86_64.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 IP address, or 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, enter gateway1.example.com:443 for the network entry point.

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

    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.