Exit Print View

Oracle Secure Global Desktop Gateway Administration Guide for Version 4.6

Document Information

Preface

1.  Installing the SGD Gateway

2.  Configuring the SGD Gateway

A.  SGD Gateway Architecture Overview

B.  Command-Line Reference

The gateway Command

Syntax

Description

Examples

gateway start

Syntax

Description

Examples

gateway stop

Syntax

Description

Examples

gateway restart

Syntax

Description

Examples

gateway config

Syntax

Description

Examples

gateway config create

Syntax

Description

Examples

gateway config list

Syntax

Description

Examples

gateway config edit

Syntax

Description

Examples

gateway config enable

Syntax

Description

Examples

gateway config disable

Syntax

Description

Examples

gateway server

Syntax

Description

Examples

gateway server add

Syntax

Description

Examples

gateway server remove

Syntax

Description

Examples

gateway server list

Syntax

Description

Examples

gateway status

Syntax

Description

Examples

gateway version

Syntax

Description

Examples

gateway sslcert

Syntax

Description

Examples

gateway sslcert export

Syntax

Description

Examples

gateway sslcert print

Syntax

Description

Examples

gateway sslkey

Syntax

Description

Examples

gateway sslkey import

Syntax

Description

Examples

gateway sslkey export

Syntax

Description

Examples

gateway cert export

Syntax

Description

Examples

gateway key import

Syntax

Description

Examples

gateway setup

Syntax

Description

Examples

gateway uninstall

Syntax

Description

Examples

The tarantella gateway Command

Syntax

Description

Examples

tarantella gateway add

Syntax

Description

Examples

tarantella gateway list

Syntax

Description

Examples

tarantella gateway remove

Syntax

Description

Examples

The --security-gateway Attribute

C.  Advanced Configuration

D.  Troubleshooting the SGD Gateway

The tarantella gateway Command

Use the tarantella gateway command to configure authorized gateways for an SGD array.

Syntax

tarantella gateway add | list | remove

Description

Using the tarantella gateway command, you can add, remove, and list the gateways for an SGD array.

The tarantella gateway command can be used on any SGD server in the array. Any changes you make are automatically replicated on other array members.

When an SGD server joins an array, the set of gateways defined on the primary SGD server is copied to the new array member, overwriting any authorized gateways already present. Registered gateways are not deleted from an SGD server when it is detached from an array.

The available subcommands for the tarantella gateway command are shown in the following table.

Subcommand
Description
More Information
add
Adds an SGD Gateway for an SGD array
list
Lists the SGD Gateways for an SGD array
remove
Removes an SGD Gateway for an SGD array

Note - All tarantella gateway subcommands include a --help option. You can use this option to display help for the subcommand.


Examples

The following example adds gateway1.example.com to the list of registered gateways for the SGD array.

$ tarantella gateway add --name gateway1.example.com \
--certfile /opt/gateway1_cert_file.pem

tarantella gateway add

Registers an SGD Gateway with an SGD array.

Syntax
tarantella gateway add { 
                        --name server-name 
                        --certfile cert-file 
                        } | --file file
Description

The following table shows the available options for this command.

Option
Description
--name
Name of the SGD Gateway to register.
--certfile
SGD Gateway certificate used by the SGD server. The certificate can be in Definite Encoding Rules (DER) or PEM format.
--file
A batch file containing configuration settings for multiple SGD Gateways.
Examples

The following example adds gateway1.example.com to the list of registered gateways for the SGD array.

$ tarantella gateway add --name gateway1.example.com \
--certfile /opt/gateway1_cert_file.pem

The following example uses the --file option of tarantella gateway add to register multiple gateways at the same time.

$ tarantella gateway add --file gateways.list

The --file option specifies a batch file, gateways.list, that contains a line of settings for each gateway, as follows:

--name gateway1.example.com --certfile /opt/gateway1_cert_file.pem
--name gateway2.example.com --certfile /opt/gateway2_cert_file.pem

tarantella gateway list

Lists the SGD Gateways registered for an SGD array.

Syntax
tarantella gateway list
Description

Shows details for the SGD Gateways that have been registered for an SGD array using tarantella gateway add.

Examples

The following example lists the registered gateways for the SGD array.

$ tarantella gateway list

tarantella gateway remove

Removes an SGD Gateway from the list of registered gateways for an SGD array.

Syntax
tarantella gateway remove --name server-name | --file file
Description

The following table shows the available options for this command.

Option
Description
--name
Name of the SGD Gateway to remove registration details for
--file
A batch file containing configuration settings for multiple SGD Gateways
Examples

The following example removes the SGD Gateway gateway1.example.com from the list of registered gateways for the SGD array.

$ tarantella gateway remove --name gateway1.example.com