If you cannot access the Gateway, you can enable tracing to debug problems with Windows accounts on Waveset. You can enable or disable tracing from the Gateway Debug page (Gateway.jsp) or, if you want a wider range of options, you can enable tracing from the command line
Use the following instructions to enable and configure tracing from the Gateway Debug page (Gateway.jsp).
Log in to the Waveset Administrator interface.
Type the following URL in to your browser to open the Gateway Debug page:
http://host :port/idm/debug/Gateway.jsp
Choose a resource to trace from the Gateway Resource list.
If necessary, modify existing settings.
Click the following buttons to modify the settings:
Get Version. Returns the Gateway version and the operating system of the machine on which you are running the Gateway.
Get Trace File. Returns the contents of the trace file.
Get Trace Parameters. Returns the path of the trace file, the trace level, and the maximum size of the trace file.
Set Trace Parameters. See To Create a New Trace Configuration Object for information about these options.
Get Loaded Modules. Returns the load addresses of modules (DLLs) being used by the Gateway.
The Get Loaded Modules list consists of load addresses, followed by module names and only includes loaded modules. The list does not include delay-loaded modules that have not been called.
The Get Loaded Modules option only supports Active Directory and Domino.
Open a command window.
Start the Gateway.
To start the gateway as a service, type the following command:
#gateway -s
To start the gateway as a regular application rather than a service, type the following command:
#gateway —d
Do not use the -d and -s options at the same time on the same command line.
—p. Use this argument to specify a TCP/IP port number. (The default port is 9278.) For example,
#gateway -d -p 9278
Specify the necessary trace command arguments.
The following table describes the Gateway tracing command line arguments.
Usage: #gateway -l level -m size -f name -s
For example:
cd %WSHOME%\bin\winnt #gateway -p 11319 -l 2 -m 500 -f %CD%\gateway.trc -s |
The preceding invocation starts the Gateway with the following characteristics:
-p 11319 – Use port 11319
You must configure this port for Gateway resources from the Waveset resource configuration. For example, for an Active Directory resource
-l 2 – Trace the gateway at output level 2.
-m 500 – Limit the size of the trace log file to 500 Kilobytes.
-f C:\gateway.trc – Write the trace output to a file called gateway.trc in the C:\ directory.
-s – Start the gateway service.
If specified, Waveset saves -p, -l, -m, and -f values in the registry, so the next time you run Gateway from the command line or as a service, the same values are used.
If you started the gateway using the -d option, Waveset sends the Gateway trace output to the console and to a trace file.
Log in to the Waveset Administrator interface.
Type the following URL in to your browser to open the Gateway Debug page:
http://host:port/idm/debug/Gateway.jsp
Deselect the Show Trace option or delete the file name from the Get Trace File text box.
If necessary, open a command window.
Stop the Gateway service.
If you started the Gateway service using the -s option, stop the service by typing the following command:
#gateway -k
If you used the -d option to start the gateway as a regular application, stop the gateway by typing Control-C in the same command window you used to start the gateway.
Start the gateway with trace level 0 using the -l option. (You do not have to specify the -m or -f option.) For example
#gateway -d -l 0