Moving the Product Directory

To move SmartSockets from one directory to another after it has been installed, either:

remove the existing directory $RTHOME and reinstall

move $RTHOME from one directory to another and reconfigure SmartSockets for the new value of $RTHOME

Removing the Existing Directory and Reinstalling

To remove the existing SmartSockets directory, first shut down all SmartSockets processes that are using the directory. You should warn anyone using those processes before stopping them.

You can stop RTservers and all processes attached to them by including the -stop_all argument with the rtserver command:

$ rtserver -stop_all

	If an RTserver is stopped without stopping the RTclients, those RTclients can be configured to automatically try to restart the RTserver.

Before removing the old directory, save any SmartSockets customized files. For example, the files in the $RTHOME/standard directory, which include your license file and the command (.cm) files, should be saved in another location.

Remove the directory using this command:

$ rm -rf $RTHOME

Follow the instructions in Installing TIBCO SmartSockets to re-install SmartSockets.

Moving and Reconfiguring the Directory Tree

To move SmartSockets from one directory to another on the same disk partition, use the UNIX mv command. For example, if $RTHOME was to be moved from the directory /usr/local/ss68 to a new directory named /usr/ss68, use this command:

$ mv /usr/local/ss68 /usr/ss68

If SmartSockets is being moved between different disk partitions and the mv command failed, this error message is displayed:

mv: can’t mv directories across file systems

To move SmartSockets between disk partitions, use the UNIX tar command. Do not use the cp command, as cp does not preserve symbolic links. The contents of the file that the link refers to are copied, rather than the link itself being copied. Using the cp command to move SmartSockets results in extra disk storage being used for the copies of many files.

The tar command can be used twice in a pipeline to create an archive and unload it in one step. If $RTHOME is to be moved from /usr/local/ss68 to /usr/ss68, for example, use this command:

$ cd /usr 
$ (chdir /usr/local; tar cf - ss68) | tar xvpf - 
$ rm -rf /usr/local/ss68

Once SmartSockets has been moved to its new location, the shell script rtmove must be executed to change the value of $RTHOME in the SmartSockets text files. This script must be executed from the ss68 directory:

$ cd /usr/ss68 
$ install/rtmove

The rtmove script guides the user through the process. This text is displayed when running rtmove:

Welcome to rtmove, which reinitializes SmartSockets  
once it has been moved to a new directory. 
 
When this script asks you questions, a default answer 
is shown in brackets next to the question. To use the 
default answer, press <Return> in response to the question. 
Otherwise, type one of the other suggested responses and 
then press <Return>. 
 
This script will ask all its questions first, and then 
execute the actions you select. 
 
Would you like to continue? [y]: (press return) 
 
This script changes several SmartSockets files to reference this 
directory. Therefore it needs to know the correct name of 
this directory. If you will be accessing this directory via 
NFS on several hosts, make sure the pathname is valid on all 
those hosts. Do not use shell metacharacters (such as *  
or ~) when answering this question. 
 
Please enter the full pathname that you would like to use to refer 
to this directory [/usr/ss68]: (press return) 
Modifying SmartSockets text files to reference /usr/ss68. 
Updating libraries. 
 
Done moving SmartSockets to /usr/ss68.