IBM Support

QMGTOOLS: FTP Data to IBM

Troubleshooting


Problem

This document explains how to send and upload data to IBM i Support that uses the MustGather tool.

Environment

IBM i OS v7.2 and later

Diagnosing The Problem

The IBM MustGather tool provides an automated option for sending and uploading MustGather data files to IBM i Support from the IBM i Server.

When executed, the tool automatically sends and uploads a save file or files in the IFS from your IBM i Server to IBM i Support.

Resolving The Problem

On the IBM i server, refer to the following instructions to send and upload the MustGather information needed by IBM Support to help diagnose the cause of and resolve your issue.

Note: In September 2022, IBM no longer allows 'anonymous' FTP uploads to IBM i Support.  Please make sure QMGTOOLS is updated to a build date of 9/26/2022 or later to ensure data collectors using FTP2IBMCMD accommodate credentials for uploading.  Step 1 below details how to keep QMGTOOLS current.

If the method in this document fails, refer to the following link for more methods:
MustGather: Instructions for Sending Data to IBM i Support

Step 1 Install QMGTOOLS

To install the MGTOOLS toolkit, refer to the following document for how to download and install the MGTOOLS toolkit on your IBM i server.

MustGather: How to obtain and Install QMGTOOLS and keep it current


Step 2 The FTP option

A) Add the QMGTOOLS library to your library list by issuing the following command:

ADDLIBLE QMGTOOLS

B) Go to the QMGTOOLS main menu.

GO MG

C) In the following example, option 10 is the FTP data to IBM option.

image 12108

Step 3 Parameters

To send a save file, choose *SAVF for the File Type parameter. The FILE and LIBRARY parameter is where you put in the save file information.


image-20220927105458-3


To send an IFS file, such as an HMC pedbg file, choose *IFS for the File Type parameter. The IFS FILE parameter is where you put the location of the file in the IFS.

image-20220927105429-2


Note: Choosing *SFTP uses secure FTP for non-Blue Diamond customers. For Blue Diamond customers, choose *BDFTP as that uses both SFTP and SSL FTP. Refer to the Blue Diamond link at the end of this document for further details.

FTP type -  ECUREP now supports three methods of upload.  *SFTP uses secure FTP (port 22) to IBM,  *BDFTP is for Blue Diamond customers, *HTTPS uses HTTPS (port 443) to transfer data to IBM

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/. The following URL provides some guidance on creating an IBM transfer ID. QMGTOOLS: Create a transfer ID to upload data to IBM

*IBMSDDUU Encrypted standard FTP over port 21 in passive mode. This does not support SSL and will failover to *SFTP (Port 22)
*SFTP Encrypted secure FTP over port 22.  This can use either IBMid credentials OR Transfer ID
*STDFTP Nonencrypted standard FTP over port 21 in passive mode.  This is no longer supported. 
*BDFTP Encrypted SSL FTP over port 990 in passive mode.  This requires Blue Diamond enhanced support with a Blue Diamond ID.
*HTTPS Encrypted SSL HTTP transfer over port 443.  This requires Transfer ID credentials.  https://www.secure.ecurep.ibm.com/transferids/

The hosts used by QMGTOOLS can be found in the following URL.

Enhanced Customer Data Repository (ECuRep) - Send data


IBM/BD/Transfer ID and Pass - IBM ID, Transfer ID, Blue Diamond ID, or *STORED. This no longer allows being set to 'anonymous'. IBM requires an IBM ID to upload data if you are not a Blue Diamond client. Refer to the following link to register for an IBM ID:

Register for an IBM ID

GDPR-related Changes to ECuRep and Testcase FTP File Uploads

QMGTOOLS: Create a transfer ID to upload data to IBM

If the preceding URLs do not work, do a search for "IBM ID" using an Internet search engine.

For current information on what ID is required for transferring files to IBM, refer to the following URL. If the following URL does not work, do a search for "Ecurep" using an Internet search engine.

Enhanced Customer Data Repository (ECuRep) - Send data

*STORED refers to if the user stored credentials using the option "Store FTP2IBMCMD credentials" from the QMGTOOLS main menu.


File type - is the file located in the IFS or is this a save file. Note: If file type is *IFS, you must refer to the full path of the file located in the IFS and not the IFS directory.

There are 3 options to enter an IBM problem number:
PMR#, Branch, Country - the PMR information
RCMS# - an RCMS number
Case Number# - case number

After you press Enter, more parameters are presented. IBM recommends these values remain default unless directed by IBM. If you would like to receive a confirmation of the upload, you are welcome to enter your email address in the "Email address" field. Leave all other fields as default.


An FTP2IBM job gets submitted to execute the FTP transfer. Details on the FTP transfer are logged in option 11 of the main QMGTOOLS menu, View FTP to IBM Statuses. Select V to view the FTP log.

FTP to IBM statuses screen


Refer to the following documents for more information:


QMGTOOLS: Front end interface for IBM Secure Diagnostic Data Upload Utility


IBM Secure Diagnostic Data Upload Utility in the IBM i Environment

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Component":"Data Collection","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Historical Number

671168757

Document Information

Modified date:
03 October 2022

UID

nas8N1010370