Exit Print View

Oracle Secure Global Desktop Gateway Administration Guide for Version 4.6

Document Information

Preface

1.  Installing the SGD Gateway

About the SGD Gateway

System Requirements

Known Issues

Performing the Installation

How To Install the SGD Gateway

Upgrading the SGD Gateway

How to Upgrade the SGD Gateway

2.  Configuring the SGD Gateway

A.  SGD Gateway Architecture Overview

B.  Command-Line Reference

C.  Advanced Configuration

D.  Troubleshooting the SGD Gateway

Performing the Installation

On Solaris OS 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:

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 http://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 Solaris OS on x86 platforms

    • SUNWsgdg-version.sol-sparc.pkg for Solaris OS 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 Solaris OS on x86 platforms:

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

    To install on Solaris OS on SPARC technology platforms:

    # pkgadd -d /tempdir/SUNWsgdg-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/SUNWsgdg-version.i386.rpm
  4. Verify that the SGD Gateway package is registered in the package database.

    On Solaris OS 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.


    Note - These settings can be changed later, by using the gateway config create command. See 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.