Migrate from old to new S-PLUS

DESCRIPTION:
This command is used to update a newly installed S-PLUS with files from a previously installed S-PLUS. It can copy add-on products from the old to the new S-PLUS directory trees and check to see if new license keys need to be issued.

USAGE:
Splus MIGRATE <oldSHOME>

REQUIRED ARGUMENTS:
oldSHOME:
the home directory name of the old S-PLUS software. This is generally the result of a command like SplusOLD SHOME where SplusOLD is what the old Splus script was copied to prior to installing the new S-PLUS software. Note that this directory name can be the same as the new S-PLUS home if it was installed into the same directory with the old S-PLUS software (an unrecommended, but sometimes necessary approach).

WARNINGS:
This command requires write permissions in the new S-PLUS directory tree. It should be run sometime after the new S-PLUS has been completely installed.

This command appends to (and creates, if necessary) a file named tree. The log file contains a transcript of questions asked by MIGRATE, responses and the output of commands run by MIGRATE.


SAMPLE:
What follows is some of the output that could be generated by running MIGRATE where the new S-PLUS is stored into /usr/local/splus3.3 and contains some add-on modules. Checking old S-PLUS tree for file to copy to new S-PLUS tree. Copy dox from old to new S-PLUS tree? [y] y /usr/local/splus3.3/module/dox/ONELINER.TXT /usr/local/splus3.3/module/dox/acs.o /usr/local/splus3.3/module/dox/Version [...etc...] Copy wavelets from old to new S-PLUS tree? [y] n WARNING: The following command(s) need to be run to update configuration information for newly copied modules:

Splus MODINSTALL dox

WARNING: Could not locate license key for S+GISLINK for ARC/INFO.

WARNING: A new license key will be needed for S+GISLINK for ARC/INFO, then the following commands will need to be run to complete their installation:

cd /usr/local/splus3.3/library/arcinfo ./INSTALL.NEWKEY


SEE ALSO:
CONFIGURE , INSTALL

EXAMPLES:
# Save old files.
cd /usr/local/bin
cp Splus SplusOLD

# Install new S-PLUS, getting license keys for S-PLUS and ALL # add-on modules that need license keys.

# Get extras from old S-PLUS tree. Splus MIGRATE SplusOLD SHOME

# Re-setup add-on modules (per instructions from running MIGRATE, # above). Splus MODINSTALL dox Splus MODINSTALL wavelets