test

Sun Identity Manager 8.1 System Administrator's Guide

Troubleshooting the Gateway

When troubleshooting the Sun Identity Manager Gateway, it is often useful to run the Gateway from the command line. Using command line options allows you to input a wider range of start-up options, which includes starting the Gateway as a normal application instead of a service and running the Gateway on a different port.

Note –

You must kill the Identity Manager Gateway as a service before running it from the command line. For example, type

gateway.exe -k

The following table describes the Gateway command line arguments.

Argument 

Description 

-i 

Install this program as an NT service, with specified startup 

-r 

Remove this program from the Service Manager 

-s 

Start the service 

-k 

Kill the service 

-t 

Set start-up for an existing service 

-d 

Debug, and run as a regular application 

-p 

Specify a TCP/IP port number (Default is 9278) 

-f 

Specify the path to the trace file 

-l 

Specify the level of tracing (Default is 0, no information) 

-m 

Specify the maximum trace file size in kilobytes 

-v 

Display the version 

Usage: gateway -i n -r -s -k -t n -d -p n -f name -l n -m n -v.

Note –

You can also use the Identity Manager Gateway Debug page (debug/Gateway.jsp ) to troubleshoot the Gateway. See How to Configure Tracing from the Gateway Debug Page for more information.