IBM Support

QMGTOOLS: HTTP Collector for IBM i

Troubleshooting


Problem

The HTTP data collector (HTTPCOL) in QMGTOOLS that aids the customer in gathering data to debug HTTP server related problems.

Diagnosing The Problem

The HTTP data collector in QMGTOOLS aids in gathering data to debug HTTP server related problems. The data it collects includes:


PreHealthcheck for java and PASE
QMGTOOLS/SYSSNAP  LICLOGS(Y)
HTTP server log files
HTTP server configuration files
JPing to test host servers
 


Resolving The Problem

1. If the QMGTOOLS toolkit 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. The following URL is contains additional information. http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297

Note:  In September 2022, ECUREP data repository no longer allows anonymous FTP uploads. The tools have been updated to allow passing credentials for data upload.  This requires a build date of 9/23/2022.  To find out your version, take the steps: GO QMGTOOLS/MG and take option 12.

If the build date is 09/23/2022 or later, please proceed to step 2. Otherwise, download the current version of QMGTOOLS by following the steps in: http://www.ibm.com/support/docview.wss?uid=nas8N1020468


2. Add QMGTOOLS to your library list (ADDLIBLE QMGTOOLS) and type GO MG.

3. Take Option 7 for CTA/EWS menu

image 7633



4. Take option 7 for HTTP menu





5. Take Option 1 for the HTTP collector





6. Complete the command HTTPCOL with the parameters below.

HTTP Instance Name: The name of the HTTP server the data is going to be gathered against.
Include HTDOCS? Gives the user the option to include their htdocs directory. It may not be relevant to gather, so the option to exclude is there.
Include VLOGS? Gives the user the option to include VLOGS.
FTP Data*: This specifies if the data is going to be uploaded to ECUREP.
FTPTYPE: The method of upload.  Defaults to *IBMSDDUU. 

Note: For *HTTPS, you would need a transfer ID and password. Use the following URL to create a transfer ID. https://www.ecurep.ibm.com/transferids/.

*IBMSDDUU Encrypted standard FTP over port 21 in passive mode
*SFTP Encrypted secure FTP over port 22
*STDFTP Nonencrypted standard FTP over port 21 in passive mode
*BDFTP Encrypted SSL FTP over port 990 in passive mode
*HTTPS Encrypted SSL HTTP transfer over port 443

IBMID: User Identifier for IBMid.  This is the same that is used to log in to the CASE.  *STORED can also be specified in conjunction with STORFTPPWD.  More information is found at https://www.ibm.com/support/pages/qmgtools-store-ftp2ibmcmd-credentials

IBMPWD:  Password for IBMid

CASE NBR: The case identifier that the data will be routed to.  This starts with TSxxxxxxxxx.

Email Address: This is the email address that will get notified once the data is uploaded. This can be the customer email address, or the support center reps email to get notified.

image-20220926115355-1



This command can simply be typed below on a command line to bypass taking the numerous menu options:
 
HTTPCOL HTTP_INST(SERVERNAME) HTDOCS_RSP(Y) VLOG(Y) FTP_RSP(Y) FTPTYPE(*IBMSDDUU) IBMID(IBMIDGOESHERE) IBMPWD(passwordGoesHere) CASE_NBR(TS123456789)            

7. Once the command is run, it will initiate an HTTPcollector.sh script.





If the data is FTPd successfully to ECUREP, it will indicate it is complete. If the user chooses to not have the data sent in, the file /tmp/COLLECTORSCRIPTS/data/<httpInstanceName>collector.zip is produced. This can be sent in manually to ecurep if required.

The ECUREP site is http://www.ecurep.ibm.com/app/upload


Blue Diamond Data Upload

If data is for Blue Diamond account, the HTTPADMCOL command requires FTPRSP(N) and the upload should be with command:
QMGTOOLS/FTP2IBMCMD FTPTYPE(*BDFTP) IBMID(BDuseridGoesHere)  IBMPWD(PasswordGoesHere) INPUT(*IFS) SALESFRC(TS123456789) IFSFILE('/tmp/COLLECTORSCRIPTS /data/<InstanceName>collector.zip')

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CGqAAM","label":"IBM i HTTP Server"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2.0;7.3.0;7.4.0;7.5.0"}]

Document Information

More support for:
IBM i

Component:
IBM i HTTP Server

Software version:
7.2.0, 7.3.0, 7.4.0, 7.5.0

Operating system(s):
IBM i

Document number:
645551

Modified date:
03 June 2025

UID

nas8N1020202

Manage My Notification Subscriptions