Troubleshooting
Problem
A Tivoli Storage Manager client is installed on Ubuntu. Trying to access the client graphical user interface (GUI) or the Web client produces the ANS2600S error.
Symptom
The GUI or Web client fails to launch with the following error :
ANS2600S Browser trying to establish connection to client: received
socket exception: java.net.ConnectException: Connection refused
Diagnosing The Problem
Review the dsmerror.log errors. For example :
2012-06-07 11:14:20 ANS0361I DIAG: Error opening input file
/opt/tivoli/tsm/client/ba/bin/COM.ibm.storage.adsm.cadmin.clientgui.DDsmApplet.class 2012-06-07 11:14:34 ANS0361I DIAG: Unexpected error invoking /opt/tivoli/tsm/client/ba/bin/dsmagent, errno = 14.
2012-06-07 11:14:34 ANS0361I DIAG: Error starting Remote Client Agent.
2012-06-07 11:14:34 ANS0361I DIAG: return code is -1
The above shows that the dsmagent process fails to load. Try loading the program from a shell, i.e :
cd /opt/tivoli/tsm/client/ba/bin
./dsmagent
In this case, the dsmagent failed to load with the following error :
./dsmagent: error while loading shared libraries:
libxmlutil-6.3.0.0.so: cannot open shared object file: No such file or directory
In this instance, the 6.3.0.5 client installation was missing symbolic links to libxml and libxerces files. Specifically on a Redhat system, the following links are created in /usr/lib64 :
# ls -la /usr/lib64 | grep -i "/opt/tivoli/tsm/client"
lrwxrwxrwx 1 root bin 52 Jun 8 13:51 libApiTSM64.so -> ../../opt/tivoli/tsm/client/api/bin64/libApiTSM64.so
lrwxrwxrwx 1 root root 44 Jan 12 21:55 libdmapi.so -> /opt/tivoli/tsm/client/api/bin64/libdmapi.so
lrwxrwxrwx 1 root root 43 Jan 12 21:55 libgpfs.so -> /opt/tivoli/tsm/client/api/bin64/libgpfs.so
lrwxrwxrwx 1 root bin 57 Jun 8 13:51 libtsm630xerces-c1_6_0.so -> ../../opt/tivoli/tsm/client/api/bin64/libxerces-c1_6_0.so
lrwxrwxrwx 1 root bin 59 Jun 8 13:51 libxmlutil-6.3.0.0.so -> ../../opt/tivoli/tsm/client/api/bin64/libxmlutil-6.3.0.0.so
Resolving The Problem
In this case, the installation of the client was done using alien in order to convert the RPMs.
The "--script" option to alien was also used. Since/usr/lib64 is not a standard LD path on Ubuntu, a config file was created with ldconfig to resolve the missing symbolic links.
Notes :
- The Tivoli Storage Manager V6 client installation on Ubuntu system is a "best effort" supported distribution as mentioned in the following document :
http://www-304.ibm.com/support/docview.wss?uid=swg21417165
- Starting with the Tivoli Storage Manager Backup-Archive client V7.1.2, the client is officially supported on Ubuntu 14.04 distribution and debian packages are available.
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21598369