23/Aug/95 This file contains instructions for the following: 1. Installing UNIX-SPIRS on your machine -Minimum requirements -Installation steps -TERMINFO information 2. Removing UNIX-SPIRS from your machine ================================== Installing UNIX-SPIRS Version 1.01 ================================== ------------------------------------------------------------- UNIX-SPIRS Client Minimum Hardware Requirements (AIX) ------------------------------------------------------------- * Minimum hardware requirements for the Operating System, however we recommend at least an IBM Powerstation 320. * 16 MB RAM for (1-10 users), add 1 MB per additional user * Standard video * 2 MB disk space * TCP/IP ------------------------------------------------------------- UNIX-SPIRS Client Minimum Hardware Requirements (Sun Solaris) ------------------------------------------------------------- * Sun SPARCstation 10 (Sun SPARCstation 20 if the ERL server and UNIX-SPIRS are run on the same machine) * 16 MB RAM plus 2 MB per simultaneous user (use the ERL Solaris server minimum requirement plus 2 MB per simultaneous UNIX-SPIRS user if the ERL Solaris server and UNIX-SPIRS are run on the same machine) * Standard video * Sun Solaris version 2.3 or higher * 3 MB available hard disk space * TCP/IP ------------------------------------------------------------- UNIX-SPIRS Client Minimum Hardware Requirements (SCO) ------------------------------------------------------------- * Minimum hardware requirements for the Operating System, however we recommend a 486DX/33 MHz IBM-compatible PC * 16 MB RAM for (1-10 users), add 1 MB per additional user * Standard video * 2 MB disk space * TCP/IP ------------------------ SUN and SCO Installation ---------------------------------------------------------------- Follow these instructions to install UNIX-SPIRS on your machine. ---------------------------------------------------------------- NOTE: You must be logged in with super-user permissions to use the pkgadd utility. 1. Make sure the current version of the file "UNIXSPIRS.pkg" is in the current directory. NOTE: if you have a previously installed version of UNIX-SPIRS, you must first remove the older version before installing the current version. See "Removing UNIX-SPIRS from your machine," below. 2. Type the following: pkgadd -d /"pathname"/UNIXSPIRS.pkg (where "pathname" is the full pathname to your current directory) The following prompt appears: Select Packages you wish to process (or 'all' to process all packages) (default : all) [?,??,q]: 3. Enter either "1" or "all", or press [Enter] to install the package. The following prompt appears: In what directory would you like to install UNIX-SPIRS ? (it must be an absolute (full) path name) [?,q]: 4. Enter the complete path (beginning with a "/") for the directory where UNIX-SPIRS will reside. The following prompt appears: This package contains scripts which will be executed with super-user permissions during the process of installing this package. Do you want to continue with the installation of this package? [y,n,?]: 5. Enter "y" at the prompt. The following prompt appears: Enter a valid User ID to assign ownership to the UNIX-SPIRS Package (Enter ? to see a list of Valid User ID's [?]: 6. Enter the User ID for UNIX-SPIRS. The following prompt appears: Enter a valid Group ID to assign ownership to the UNIX-SPIRS Package (Enter ? to see a list of Valid Group ID's [?]: 7. Enter the Group ID for UNIX-SPIRS. The following message should appear: Installation of was successful UNIX-SPIRS will be installed in your directory. For a text-based UNIX-SPIRS manual, refer to the file unixspirs.txt. For the latest enhancements and known problems with UNIX-SPIRS, please refer to the file relnotes.txt. ---------------- AIX Installation ---------------------------------------------------------------- Follow these instructions to install UNIX-SPIRS on your machine. ---------------------------------------------------------------- NOTE: You must be logged in with super-user permissions. 1. Make sure the current version of the file "unixspirs.tar" and "install" is in the current directory. 2. Type the following: install (or ./install) The following prompt appears: Install SilverPlatter Inc. UNIX-SPIRS Client Software (AIX) [Y]/N: 3. Enter "Y" to install the package. The following prompt appears: In what directory would you like to install UNIX-SPIRS ? (it must be an absolute (full) path name) [/unixspirs]: 4. Enter the complete path (beginning with a "/") for the directory where UNIX-SPIRS will reside. The following prompt appears: Enter a valid User ID or Hit Enter to see a list: 5. Enter the User ID for UNIX-SPIRS. The following prompt appears: Enter a Valid Group ID. Hit Enter to see a list: 6. Enter the Group ID for UNIX-SPIRS. The following message should appear: SilverPlatter Inc. UNIX-SPIRS Client Software (AIX) installed successfully. Use `uninstall` for future UNINSTALLATION. UNIX-SPIRS will be installed in your directory. For a text-based UNIX-SPIRS manual, refer to the file unixspirs.txt. For the latest enhancements and known problems with UNIX-SPIRS, please refer to the file relnotes.txt. ----------------------- TERMINFO and UNIX-SPIRS ----------------------- UNIX-SPIRS uses a Screen Handling library called "Curses" that facilitates running applications on different terminals. Curses uses the UNIX Terminal database called TERMINFO. The TERMINFO database is actually a number of small compiled files located in the /usr/share/lib/terminfo (for Solaris) or /usr/lib/terminfo (for SCO) directory. Each of these files describes the capabilities of a different terminal. One of the most common problems encountered while running UNIX-SPIRS has been an incorrect entry in the TERMINFO database for a particular terminal. Because there is no central area for storing these entries, they have evolved through the years (sometimes incorrectly) and been passed on from one vendor to another. Troubleshooting TERMINFO ------------------------ To learn more about TERMINFO please refer to your system's man pages. If there is a problem with keystrokes not working in UNIX-SPIRS, check the TERMINFO entry for your terminal type. Enter: "infocmp" at the command prompt. This command de-compiles the entry for the current terminal type (defined by the TERM environment variable) and displays it on the screen. To de-compile other terminal types, enter "infocmp (termtype)" where (termtype) is the name of a valid terminal type name that is contained in the TERMINFO database. In order to change a capability in a terminal entry, you must first de-compile it and re-direct it to a file by entering: "infocmp > (filename)". This will send the current term type's capabilities to the file. You can then edit the file and recompile it by entering: tic (filename). TermInfo Compiler, Tic, reads the filename and adds the entry into the TERMINFO database structure according to the name entered on the terminal name line in the file. Some of the most common mistakes in the terminal file are the definitions of the Function Keys (kf0 - kf12). In order to correct them, check the manual that came with your terminal and identify what codes each key generates against the entries in the de-compiled terminal file (remember that \E is TERMINFO's way of representing the escape key). If the entry is missing, then add it to the file and recompile. If you don't have the manual for the terminal, there is another way to determine what each of the function keys is generating. Make sure the stty setting "echoctrl" is on (stty echoctrl), and press each one of the function keys. You should see a sequence of characters echo to the screen after pressing each key (although some terminals may not be able to do this). ================================ Removing UNIX-SPIRS Version 1.01 ================================ ------------------- SUN and SCO Removal ----------------------------------------------------------------- Follow these instructions to remove UNIX-SPIRS from your machine. ----------------------------------------------------------------- NOTE: You must be logged in with super-user permissions to use the pkgrm utility. 1. Type the following: pkgrm UNIXSPIRS The following prompt will appear: Do you want to remove this package [y,n,?,q]: 2. Type "y" at the prompt. The following message should appear: Removal of was successful All files associated with UNIX-SPIRS should have been removed from your machine. ----------- AIX Removal ----------------------------------------------------------------- Follow these instructions to remove UNIX-SPIRS from your machine. ----------------------------------------------------------------- NOTE: You must be logged in with super-user permissions. 1. Type the following: uninstall 2. Follow the prompts to uninstall the UNIX-SPIRS software. The following message should appear: Removal of was successful All files associated with UNIX-SPIRS should have been removed from your machine.