IBM Support

QMGTOOLS: HTTPAdmin Collector for IBM i

Troubleshooting


Problem

The HTTPAdmin data collector (HTTPADMCOL) in QMGTOOLS aids the customer in gathering data to IBM i Web Administration related issues.

Diagnosing The Problem

The HTTPAdmin data collector in QMGTOOLS aids in gathering data to IBM i Web Administration related issues. The data it collects includes:

Application Runtime Expert (ARE) for the Admin
QMGTOOLS/SYSSNAP LICLOGS(Y)
JDK Healthcheck
DCM Application Listing
Logfiles
Joblogs

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 contains additional
information:  http://www-01.ibm.com/support/docview.wss?uid=nas8N1011297
Ensure the QMGTOOLS is updated before moving forward even if you already have it on the system:

Note: 
Note: This document is written to accommodate the changes made in September 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.
It is important that this update be made as the upload facility to ECUREP no longer allows an anonymous FTP.  
Otherwise, download the current version of QMGTOOLS by following the steps in: http://www.ibm.com/support/docview.wss?uid=nas8N1020468

 
2. Take Option 7 for CTA/EWS menu
image-20180914120238-1

3. Take option 7 for HTTP menu

image-20180914120357-2

4. Take Option 2 for HTTPAdmin Collector

image-20180914120516-3

5. Complete the command HTTPADMCOL with the parameters below.

Run ARE: Leave the default Y.  This will run the Administration Runtime Expert template that will allow support to spot known errors in configuration.

SYSSNAP? :  Leave the default Y.  This will capture SYSSNAP data (PTF, TCP config, Software and hardware resources, WRKACTJOB, etc.)
FTP Data*: This specifies if the data is going to be FTP'd to ecurep for a CASE. This will require the CASE number to be completed. Valid values are Y (Yes) and N (No).
*If using Blue Diamond, specify N and follow Blue Diamond FTP instructions below

FTPTYPE: Defaults to *IBMSDDUU.  The types are shown below.  Note: For *HTTPS, you would need a transfer ID and password. Use the following URL to create a transfer ID. https://www.secure.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:  The userid to sign in with.

IBMPWD: Password

CASE_NBR:  The case you are uploading the data to.  This will notify the case owner of upload.

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-20220926101244-1
 


This command can simply be typed below on a command line to bypass taking the numerous menu options:
                                         
HTTPADMCOL ARE_FLAG(Y) SYSSNAP(Y) FTPRSP(Y) FTPTYPE(*IBMSDDUU) IBMID(IBMIDGOESHERE) IBMPWD(PasswordGoesHere) CASE_NBR(TS123456789) EMAIL(OPTIONAL@YOURCOMPANY.COM)                                                   

6. Once the command is run, it will initiate an httpAdmincollector.sh script. Some steps take longer than others, particularly the Application Runtime Expert.

The current status is logged to /tmp/collectorscripts/data/ADMIN_COLLECTOR_OUT.txt   
                    
image-20220926100153-2

Page down
image-20220926100248-3

7. If FTP is specified, view the status for upload with GO MG and take option 11 (FTP status screen). In cases where the source system does not have FTP access to ECUREP from their IBM i, it will be necessary to manually send the resulting /tmp/COLLECTORSCRIPTS/data/httpAdmincollector.zip file to ecurep at http://www.ecurep.ibm.com/app/upload

Blue Diamond Data Upload

If data is for Blue Diamond account, the HTTPADMCOL specifies FTPTYPE(*BDFTP) with command:
 HTTPADMCOL ARE_FLAG(Y) SYSSNAP(Y) FTPRSP(Y) FTPTYPE(*BDFTP) IBMID(userid) IBMPWD(password) CASE_NBR(TS123456789)                                                                                                     

[{"Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CIcAAM","label":"IBM i Administration Server"}],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.2.0;7.3.0;7.4.0;7.5.0","Type":"MASTER"}]

Document Information

Modified date:
26 September 2022

UID

nas8N1020078

Page Feedback