Troubleshooting
Problem
This document explains how to collect data for issues with the IBM Web Administration for i GUI. Gathering this information before calling IBM Support will help familiarize you with the troubleshooting process and save you time.
Symptom
Environment
Resolving The Problem
If you encounter an error when accessing the IBM Web Administration for i application (HTTPAdmin), you should collect the following information when the internal application server and application(s) are experiencing the problem:
Enable tracing for the ADMIN4 application server



End the IBM i Administration Server
- From a 5250 Emulation session, execute the command, ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN).
- Execute the command, WRKACTJOB SBS(QHTTPSVR).
- Wait for all of the ADMINx jobs to end.
- After all ADMINx jobs have ended, proceed to the next step.
Implement additional JVM options for the ADMIN4 application server
NOTE: These steps are only required if you are experiencing issues managing WebSphere Application Servers in the IBM Web Administration for i GUI.- Issue the following command.
EDTF STMF('/qibm/userdata/os/admininst/admin4/wlp/usr/servers/admin4/jvm.options') - Insert the following lines into the file (optional: This is only required for issues with managing WebSphere Application Servers).
-Dcom.ibm.websphere.os400.express.AdminWrapperTracing=true
-Dcom.ibm.websphere.os400.express.AdminWrapperTracingDetail=true
-DtraceSettingsFile=wasAdminTracing.properties
- Press F3 twice to save & exit the file.
Restart the HTTP Admin server
- From a 5250 Emulation session, execute the command, STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN).
- Execute the command, WRKACTJOB SBS(QHTTPSVR).
- Wait for all of the ADMINx jobs to start and stop utilizing CPU.
- After all ADMINx jobs have started and their CPU utilization is 0~1%, proceed to the next step.
Recreate the issue
- Open a web browser.
- Navigate to the IBM Web Administration for i GUI using the debug URL (http://<server>:2001/HTTPAdmin?debug=finest).
- Recreate the issue.
* Typically, it is recommended to gather a screen shot of the issue/error message and provide IBM Support with the detailed steps followed to recreate the issue.
Execute the QMGTOOLS/HTTPADMCOL utility and upload the httpAdmincollector.zip file
- If the QMGTOOLS library has not yet been installed, you should refer to the following document for information on how to download and install the QMGTOOLS toolkit on your IBM i server.
- Type the following command on the IBM i command line: ADDLIBLE QMGTOOLS
- Take an opt. 13 to check for an update and follow the prompts to automatically download and restore the updated library. NOTE: If the system cannot connect to IBM please perform 'Method 3' from the following document to manually update the QMGTOOLS library: https://www.ibm.com/support/pages/qmgtools-how-check-and-update-qmgtools
-
Uploading data to IBM requires a data transfer ID. Ensure that you create a transfer ID and transfer PASSWORD at the following website: https://www.secure.ecurep.ibm.com/transferids/#
-
We can then run our collector command: HTTPADMCOL ARE_FLAG(Y) FTPRSP(Y) FTPTYPE(*HTTPS) IBMID('transferid') IBMPWD('password') CASE_NBR(TSxxxxxxxxx) EMAIL(YOUREMAIL@COMPANY.COM)
IMPORTANT!!!
*** If the local IBM i server does not have access to IBM's EcuRep FTP server, the automatic upload will fail. As a result, the /tmp/collectorscripts/data/httpAdmincollector.zip file will need to be uploaded manually to https://www.secure.ecurep.ibm.com/app/upload_sf.
For transferring files to IBM that are smaller than 2GB each (files may exceed 2GB in total):
- If you have an existing IBM Support Case
https://www.secure.ecurep.ibm.com/app/upload_sf
https://www.ibm.com/mysupport
For complete instructions on using the HTTPADMCOL utility in QMGTOOLS, refer to the URL, https://www.ibm.com/support/pages/qmgtools-httpadmin-collector-ibm-i.
Historical Number
533853574
Was this topic helpful?
Document Information
Modified date:
07 August 2024
UID
nas8N1012789