XCOM UNIX/Linux install verification with loopback transfer test

Products

• XCOM Data Transport
• XCOM Data Transport - Windows
• XCOM Data Transport - Linux PC

Issue/Introduction

How can I verify the installation of XCOM for Linux or UNIX?

Environment

Release: All supported releases

Resolution

Doing a successful loopback transfer for the default (unsecure) port 8044 will ensure that XCOM was installed correctly for use with the TCP/IP protocol. 

Here is a sample loop.cnf file which copies XCOM file /opt/CA/XCOM/config/xcom.cnf to /tmp/test.cnf. It assumes XCOM has been installed into the default directory /opt/CA/XCOM (XCOM_HOME environment variable):

REMOTE_SYSTEM=127.0.0.1
LOCAL_FILE=/opt/CA/XCOM/config/xcom.cnf
REMOTE_FILE=/tmp/xcom.cnf
FILE_OPTION=REPLACE

The file loop.cnf can be created in any directory but for future retention, it is a good idea to create it in the /opt/CA/XCOM/config directory.
Execute the following xcomtcp command, entering valid values for the USERID and PASSWORD:

xcomtcp -c1 -f /opt/CA/XCOM/config/loop.cnf USERID=xxxxxxx PASSWORD=xxxxxx

Additional Information

1. To run a loopback test on the default SSL port 8045 the loop.cnf file requires 2 additional parameters as follows:

REMOTE_SYSTEM=127.0.0.1
LOCAL_FILE=/opt/CA/XCOM/config/xcom.cnf
REMOTE_FILE=/tmp/xcom.cnf
FILE_OPTION=REPLACE
SECURE_SOCKET=YES
PORT=8045

That also assumes that SSL certificates have already been configured. Examples documented here:
XCOM Data Transport for UNIX/Linux 11.6.1 > Using > Generating TLS/SSL Certificates
XCOM Data Transport for UNIX/Linux 12.0 > Installing > Complete Configuration Tasks > Set Up TLS/SSL Mode


2. If any errors are encountered, enable XCOM trace as follows:
Edit the file $XCOM_HOME/config/xcom.glb and change parameter XTRACE=0 to XTRACE=10. Restart the xcomd.
After the loopback transfer is executed incoming and outgoing trace files *.TRA will be created in the $XCOM_HOME/trace subdirectory.
Upload the trace files to XCOM Support via a support case and also include the files loop.cnf, $XCOM_HOME/xcom.log, $XCOM_HOME/config/xcom.glb.


3. For more information, refer to the online documentation for versions 11.6 and 12.0:
XCOM™ Data Transport® for UNIX/Linux 11.6.1.
XCOM Data Transport for UNIX/Linux 12.0