Installation Notes for Modules with S-PLUS for UNIX/Linux

Installation
============

1. Back up Previously Installed Modules
   First, remove or back up existing copies of the same module.
   From the S-PLUS installation directory, execute the following
   commands:
   
   - list the module folders currently installed
   
         ls module
      
   - if you have a directory there with the same name as the module
     you are installing, either move it to a different name using:
     
         mv module/[modulename] module/old[modulename]
         
     or remove the previous module installation using:
     
         rm -rf module/[modulename]
         
     where [modulename] is the name of the module installation folder.
     
2. Extract the Files from the CD-ROM
   To extract the module from the S-PLUS CD-ROM, execute the following
   command:
   
      cat /[mount_point]/[modname]/[modname].TZ | uncompress | tar xvf -
   
   where [mount_point] is the path to your CDROM drive (i.e. /mnt/cdrom)
   and [modname] is the name of the module you are installing.
   
   For example, if installing the S+FinMetrics module with cdrom mounted as
   above, the command would be: 
   
      cat /mnt/cdrom/FINMETRICS/FINMETRICS.TZ | uncompress | tar xvf -

If your system has the GNU zcat command, you can use it to shorten your
extraction command (zcat combines the cat and uncompress commands):

   zcat /[mount_point]/FINMETRICS.TZ | tar xvf -

   Depending on your platform, files on the CD may be listed in
   UPPERCASE, lowercase, or UPPERCASE;1. After mounting the CD-ROM drive,
   use the ls command to see the format shown on your system. Use the
   same format in the cat command as shown on your system.

3. Obtain a License Key for your Module  (if necessary)
   If you already have previously installed the module and obtained a
   license key for use with S-PLUS, installation is complete.  You do 
   not need a new license key.  
   
   NOTE: Module license keys for use with versions of S-PLUS prior to 
   S-PLUS 8 are NOT compatible with the current release.  You MUST 
   follow the instructions below to obtain new license keys.  
   
   The Insightful License Fulfillment Center allows you to generate a 
   license key using the license authorization code provided to you
   via e-mail or with your software.  You can access this site by pointing 
   your browser to http://keys.insightful.com. Select the Generate License 
   link to create a new key.  If you need to view your hostid, run 
   
      Splus LICENSE hostinfo
   
   to redisplay it.  This information is necessary to generate your key.  
   Save the key to SHOME/adm/lic/keys (where SHOME is the top level 
   S-PLUS installation directory) with any filename
   and an extension ending in .lic (e.g., finmetrics.lic)
   
   For detailed instructions on obtaining your licenses using the license 
   fulfillment website, please consult the Installation and Administration 
   Guide, located in your S-PLUS installation at SHOME/doc/admin.pdf.  
   The procedure for licensing your module is identical to licensing S-PLUS.  
   
   After you have obtained your license key and saved it to your S-PLUS
   installation, restart the license manager using the commands:  
   
      Splus LICENSE server stop
      Splus LICENSE server start
   

Starting the Module
===================

Each module must be loaded before it can be used at the start
of each S-PLUS session.  After S-PLUS has started type

        module(modulename, first=T)

   where 'modulename' is the name of the module.