XCOM for Linux and AIX utility to gather Support troubleshooting documentation

Products

• XCOM Data Transport - Linux PC
• XCOM Data Transport

Issue/Introduction

Users that would contact Support to report a problem would be asked to gather the necessary logs, configuration files, etc. to be provided to Support for further research/debugging of the problem. This would have to be done manually and the user would be instructed on how to find the documentation.

This article describes a new utility that the user can run to easily collect the required troubleshooting documentation (xcom_docs.sh)

Environment

XCOM Data Transport r12.0 for Linux

XCOM Data Transport r12.0 for AIX

Resolution

With fix LU16219 for Linux and LU20112 for AIX we have introduced a script  with XCOM r12.0 for Linux and AIX called "xcom_docs.sh". The script will be found in directory $XCOM_HOME/cmd. 

The purpose of the utility is to allow you to gather documentation requested by XCOM Support to help debug a problem that
you may have reported when you opened a case.

The utility has a series of prompts:

- It will request that you create a directory where the files will be copied.
- Two other prompts will ask to tar the full $XCOM_HOME directory or the $XCOM_HOME/q directory if requested.
- The rest of the prompts will ask for what specific file(s) need to be copied to the directory in order to provide to XCOM Support.

All files copied to the above directory will be tar'd and you can then upload the tar file to the Support Case you opened to report a problem. 

Additional Information

Requirements:

- You must have root permission to run the script because it will copy files that only the Administrator should have
access to.

To run:

- The utility is found in  $XCOM_HOME/cmd/xcom_docs.sh

Documentation that can be collected:

The prompts you will be presented with will request for specific documentation and you will have the option of replying to the prompts in order to gather the documentation that is requested by XCOM Support.

- The release of XCOM. This is automatically gathered without a prompt.

- The complete $XCOM_HOME directory if requested specifically by Support

- The complete $XCOM_HOME/q directory if requested specifically by Support

- The xcom.log, xcom.cnf, xcom.glb, configssl.cnf, logs from the Uninstaller directory, logs from the UninstallPatch directory, and Trace directory if traces were requested.