Migration process

If you already have an earlier version of CS Linux installed and are now migrating to Version 7.1, you need to take the following steps:

Save any customized configuration files
If any of the files listed below exist, save them to a temporary directory. Not all of these files will exist in all installations.
  • /etc/opt/ibm/sna/sna_node.cfg
  • /etc/opt/ibm/sna/sna_domn.cfg
  • /etc/opt/ibm/sna/sna.net
  • /etc/opt/ibm/sna/sna_tps
  • /etc/opt/ibm/sna/environment
  • /etc/opt/ibm/sna/logfilter.txt
  • /etc/opt/ibm/sna/ibmcs.kdb
  • /etc/opt/ibm/sna/ibmcs.sth
  • /etc/opt/ibm/sna/ibmcs.rdb
  • /etc/opt/ibm/sna/ibmcs.crl

In addition, if you customized the startup file /etc/rc.d/init.d/snastart as described in Enabling CS Linux to remove the sna start command, so that CS Linux is not started automatically at system startup, make a note of the changes you made to this file.

Uninstall the old release
Use the following commands to stop CS Linux and uninstall it. Depending on which previous version is installed and how you installed it, not all of the RPM packages listed may exist on your system.
sna stop
rpm -e ibm-conmserver-ptf
rpm -e ibm-commserver-docs
rpm -e ibm-commserver-ecl
rpm -e ibm-commserver
rpm -e gskssl32
rpm -e gskcrypt32
rpm -e gskssl64
rpm -e gskcrypt64
Uninstall LiS
Use the following commands to uninstall the current level of the LiS open source package.
PATH=$PATH:/sbin
unset LD_PRELOAD
cd /usr/src/LiS
make uninstall
make very-clean
cd /usr/src
rm -rf LiS*
Change PATH and other environment variables
If you modified any of the following environment variables for the earlier CS Linux version, you should remove the changes you made, because the paths may be different for the CS Linux Version 7.1 Program Product.
  • PATH
  • LD_LIBRARY_PATH
  • LD_RUN_PATH
  • LD_PRELOAD
  • CLASSPATH

You may want to use the env command to check all environment variables for references to sna:

env | grep sna
Other packages
You are recommended to check your Java installation and update it to the latest level if necessary.
Final clean-up
The following commands will remove any remaining items from the old level of the product.
rm -rf /etc/opt/ibm/sna /var/opt/ibm/sna /opt/ibm/sna
Install the new level of the CS Linux Version 7.1 Program Product
Follow the instructions in this manual and in the README file to install the product.
Restore the saved configuration
If you saved any configuration files in the first step of this process, now is the time to restore them. First stop the CS Linux software with the following command:
/opt/ibm/sna/bin/sna stop

If you saved any ibmcs.* files in the first step of this process, remove all ibmcs.* files from the /etc/opt/ibm/sna directory now. For example, if you saved ibmcs.kdb and ibmcs.sth, you need to remove ibmcs.crl and ibmcs.rdb even though you do not have saved files to replace them. It is important that you do not run with a mix of saved and new files.

Restore the files you saved to the /etc/opt/ibm/sna directory.

In addition, if you have saved changes to the startup file /etc/rc.d/init.d/snastart, make the same changes to the new copy of the file as described in Enabling CS Linux to ensure that CS Linux is not started automatically at system startup.

Now start the CS Linux software again with the following command:

/opt/ibm/sna/bin/sna start