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

C.  Advanced Configuration

D.  Troubleshooting the SGD Gateway

Logging and Diagnostics

About SGD Gateway Logging

Changing the Logging Level

Log File Locations

Displaying SGD Gateway Process Information

Checking the Configuration From the Command Line

SGD Gateway Error Messages

Logging and Diagnostics

This section describes the logging and diagnostics features of the SGD Gateway.

This section includes the following topics:

About SGD Gateway Logging

SGD Gateway logging uses the Java logging application programming interface (API). For more details about how logging is implemented in Java, see http://java.sun.com/javase/6/docs/technotes/guides/logging/overview.html.

Changing the Logging Level

A logging properties configuration file, logging.properties, is supplied with the SGD Gateway. This file is in the /opt/SUNWsgdg/proxy/etc directory.

You can edit the logging.properties file to change the default logging level, and to configure logging levels for specific SGD Gateway services. Each SGD Gateway service is represented by an async.channel entry in the logging.properties file.

For example, if you want to increase logging levels for incoming and outgoing Transmission Control Protocol (TCP) connections, set the TCP service logging level to FINEST. Uncomment the following line in the logging.properties file:

# async.channel.tcp.level=FINEST

You must restart the SGD Gateway to enable any changes to logging levels you make by editing the logging.properties file.


Note - You can also use the SGD Gateway reflection service to change logging levels. See The Reflection Service for information about configuring and using the reflection service.


Log File Locations

If you have problems with the SGD Gateway, consult the following log files:

Displaying SGD Gateway Process Information

When you start the SGD Gateway, the process ID of the routing proxy is stored to the /opt/SUNWsgdg/proxy/var/run/proxy.pid file on the SGD Gateway host.

The process ID of the reverse proxy is stored to the /opt/SUNWsgdg/httpd/apache-version/logs/httpd.pid file. This file location can be changed using the PidFile directive in the httpd.conf Apache configuration file.

To display the running SGD Gateway processes, use the following command on the SGD Gateway host:

# ps -ef| grep SUNWsgdg

Checking the Configuration From the Command Line

You can use the following commands to check your SGD Gateway configuration.