IBM Support

Collecting GSKit trace in Reverse Proxy (WebSEAL) on ISAM Appliance

Troubleshooting


Problem

How to collect and upload a GSKit trace from Reverse Proxy (WebSEAL) to IBM Support from the IBM Security Verify Access Appliance.

Resolving The Problem

Statement of Intent

This document serves as instructions for gather and uploading a GSKit trace to the IBM Support Team. IBM Support recommends verifying the available space on the ISAM for Web appliance to successfully complete the data gathering.

Failure to do so may cause an outage.

This sequence should only be attempted on direct request from IBM Support.

How to enable GSKit trace in Reverse Proxy

1. Edit the Reverse Proxy Configuration file.

To open this file navigate to Secure Web Settings -> Reverse Proxy and select the Reverse Proxy Instance. Then use the Manage Button and Configuration -> Edit Configuration File

2. Add the following lines into existing stanza [system-environment-variables]



GSK_TRACE_FILE =  ../../../log/trace__gskit.log
GSKTRACE_NOBUFFERING = YES
GSK_TRACE_FILE_NUMBER = 10

3. Save the changes, deploy it and then restart this Reverse Proxy Instance

4. Reproduce the issue

5. Create the Appliance support file and upload this to IBM ECuRep

How to disable GSKit trace in Reverse Proxy

6. Edit the Reverse Proxy Configuration file.

To open this file navigate to Secure Web Settings -> Reverse Proxy and select the Reverse Proxy Instance. Then use the Manage Button and Configuration -> Edit Configuration File

7. Remove all GSKit trace related lines from stanza [system-environment-variables]. For example remove the following lines:



GSK_TRACE_FILE = gskit.trace.out
GSKTRACE_NOBUFFERING = YES
GSK_TRACE_FILE_NUMBER = 10

8. Save the changes, deploy it and then restart this Reverse Proxy Instance

[{"Type":"MASTER","Line of Business":{"code":"LOB24","label":"Security Software"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSRGTL","label":"IBM Security Verify Access"},"ARM Category":[{"code":"a8m0z000000cxuqAAA","label":"Security Verify Access-\u003EReverse Proxy"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
09 December 2022

UID

swg21981215

Page Feedback