home *** CD-ROM | disk | FTP | other *** search
/ ftp.uv.es / 2014.11.ftp.uv.es.tar / ftp.uv.es / pub / erl-clients / unix / sco / install.txt next >
Text File  |  1995-08-23  |  10KB  |  273 lines
  1. 23/Aug/95
  2.  
  3. This file contains instructions for the following:
  4.  
  5.  1. Installing UNIX-SPIRS on your machine
  6.      -Minimum requirements
  7.      -Installation steps
  8.      -TERMINFO information
  9.  2. Removing UNIX-SPIRS from your machine
  10.  
  11.  
  12.                   ==================================
  13.                   Installing UNIX-SPIRS Version 1.01
  14.                   ==================================
  15.  
  16.  -------------------------------------------------------------
  17.  UNIX-SPIRS Client Minimum Hardware Requirements (AIX)
  18.  -------------------------------------------------------------
  19.  * Minimum hardware requirements for the Operating System, however
  20.    we recommend at least an IBM Powerstation 320.
  21.  * 16 MB RAM for (1-10 users), add 1 MB per additional user
  22.  * Standard video
  23.  * 2 MB disk space
  24.  * TCP/IP
  25.  
  26.  -------------------------------------------------------------
  27.  UNIX-SPIRS Client Minimum Hardware Requirements (Sun Solaris)
  28.  -------------------------------------------------------------
  29.  * Sun SPARCstation 10  (Sun SPARCstation 20 if the ERL server and
  30.    UNIX-SPIRS are run on the same machine)
  31.  * 16 MB RAM plus 2 MB per simultaneous user  (use the ERL Solaris
  32.    server minimum requirement plus 2 MB per simultaneous UNIX-SPIRS
  33.    user if the ERL Solaris server and UNIX-SPIRS are run on the same
  34.    machine)
  35.  * Standard video
  36.  * Sun Solaris version 2.3 or higher
  37.  * 3 MB available hard disk space
  38.  * TCP/IP
  39.  
  40.  -------------------------------------------------------------
  41.  UNIX-SPIRS Client Minimum Hardware Requirements (SCO)
  42.  -------------------------------------------------------------
  43.  * Minimum hardware requirements for the Operating System, however
  44.    we recommend a 486DX/33 MHz IBM-compatible PC
  45.  * 16 MB RAM for (1-10 users), add 1 MB per additional user
  46.  * Standard video
  47.  * 2 MB disk space
  48.  * TCP/IP
  49.  
  50.  ------------------------
  51.  SUN and SCO Installation
  52.  ----------------------------------------------------------------
  53.  Follow these instructions to install UNIX-SPIRS on your machine.
  54.  ----------------------------------------------------------------
  55.  
  56.  NOTE: You must be logged in with super-user permissions to use the
  57.  pkgadd utility.
  58.  
  59.  
  60.  1. Make sure the current version of the file "UNIXSPIRS.pkg" is in
  61.      the current directory.
  62.  
  63.     NOTE: if you have a previously installed version of UNIX-SPIRS,
  64.       you must first remove the older version before installing the
  65.       current version.  See "Removing UNIX-SPIRS from your machine,"
  66.       below.
  67.  
  68.  2. Type the following:
  69.  
  70.        pkgadd -d /"pathname"/UNIXSPIRS.pkg
  71.     (where "pathname" is the full pathname to your current directory)
  72.  
  73.     The following prompt appears:
  74.       Select Packages you wish to process (or 'all' to
  75.       process all packages) (default : all) [?,??,q]:
  76.  
  77.  3. Enter either "1" or "all", or press [Enter] to install the package.
  78.  
  79.     The following prompt appears:
  80.       In what directory would you like to install
  81.       UNIX-SPIRS ? (it must be an absolute (full) path
  82.       name) [?,q]:
  83.  
  84.  4. Enter the complete path (beginning with a "/") for the directory
  85.     where UNIX-SPIRS will reside.
  86.  
  87.     The following prompt appears:
  88.       This package contains scripts which will be executed
  89.       with super-user permissions during the process of
  90.       installing this package. Do you want to continue
  91.       with the installation of this package? [y,n,?]:
  92.  
  93.  5. Enter "y" at the prompt.
  94.  
  95.     The following prompt appears:
  96.       Enter a valid User ID to assign ownership to the
  97.       UNIX-SPIRS Package (Enter ? to see a list of Valid
  98.       User ID's [?]:
  99.  
  100.  6. Enter the User ID for UNIX-SPIRS.
  101.  
  102.     The following prompt appears:
  103.       Enter a valid Group ID to assign ownership to the
  104.       UNIX-SPIRS Package (Enter ? to see a list of Valid
  105.       Group ID's [?]:
  106.  
  107.  7. Enter the Group ID for UNIX-SPIRS.
  108.  
  109.     The following message should appear:
  110.       Installation of <UNIXSPIRS> was successful
  111.  
  112.  UNIX-SPIRS will be installed in your directory.  For a text-based
  113.  UNIX-SPIRS manual, refer to the file unixspirs.txt. For the latest
  114.  enhancements and known problems with UNIX-SPIRS, please refer to
  115.  the file relnotes.txt.
  116.  
  117.  ----------------
  118.  AIX Installation
  119.  ----------------------------------------------------------------
  120.  Follow these instructions to install UNIX-SPIRS on your machine.
  121.  ----------------------------------------------------------------
  122.  
  123.  NOTE: You must be logged in with super-user permissions.
  124.  
  125.  
  126.  1. Make sure the current version of the file "unixspirs.tar" and
  127.     "install" is in the current directory.
  128.  
  129.  2. Type the following:
  130.  
  131.        install (or ./install)
  132.  
  133.     The following prompt appears:
  134.       Install SilverPlatter Inc. UNIX-SPIRS Client Software (AIX) [Y]/N:
  135.  
  136.  3. Enter "Y" to install the package.
  137.  
  138.     The following prompt appears:
  139.       In what directory would you like to install
  140.       UNIX-SPIRS ? (it must be an absolute (full) path
  141.       name) [/unixspirs]:
  142.  
  143.  4. Enter the complete path (beginning with a "/") for the directory
  144.     where UNIX-SPIRS will reside.
  145.  
  146.     The following prompt appears:
  147.       Enter a valid User ID or Hit Enter to see a list:
  148.  
  149.  5. Enter the User ID for UNIX-SPIRS.
  150.  
  151.     The following prompt appears:
  152.       Enter a Valid Group ID. Hit Enter to see a list:
  153.  
  154.  6. Enter the Group ID for UNIX-SPIRS.
  155.  
  156.     The following message should appear:
  157.       SilverPlatter Inc. UNIX-SPIRS Client Software (AIX) installed
  158.       successfully. Use `uninstall` for future UNINSTALLATION.
  159.  
  160.  UNIX-SPIRS will be installed in your directory.  For a text-based
  161.  UNIX-SPIRS manual, refer to the file unixspirs.txt. For the latest
  162.  enhancements and known problems with UNIX-SPIRS, please refer to
  163.  the file relnotes.txt.
  164.  
  165.  -----------------------
  166.  TERMINFO and UNIX-SPIRS
  167.  -----------------------
  168.  
  169.  UNIX-SPIRS uses a Screen Handling library called "Curses" that  
  170.  facilitates running applications on different terminals.   
  171.   
  172.  Curses uses the UNIX Terminal database called TERMINFO.  The TERMINFO  
  173.  database is actually a number of small compiled files located in the  
  174.  /usr/share/lib/terminfo (for Solaris) or /usr/lib/terminfo (for SCO)
  175.  directory.  Each of these files describes the capabilities of a
  176.  different terminal.
  177.   
  178.  One of the most common problems encountered while running UNIX-SPIRS
  179.  has been an incorrect entry in the TERMINFO database for a particular
  180.  terminal.  Because there is no central area for storing these entries,  
  181.  they have evolved through the years (sometimes incorrectly) and been  
  182.  passed on from one vendor to another.  
  183.  
  184.   
  185.  Troubleshooting TERMINFO
  186.  ------------------------
  187.  
  188.  To learn more about TERMINFO please refer to your system's man pages. 
  189.   
  190.  If there is a problem with keystrokes not working in UNIX-SPIRS, check  
  191.  the TERMINFO entry for your terminal type.  Enter: "infocmp" at the  
  192.  command prompt.  This command de-compiles the entry for the current  
  193.  terminal type (defined by the TERM environment variable) and displays
  194.  it on the screen.  To de-compile other terminal types, enter "infocmp
  195.  (termtype)" where (termtype) is the name of a valid terminal type name  
  196.  that is contained in the TERMINFO database.  
  197.   
  198.  In order to change a capability in a terminal entry, you must first
  199.  de-compile it and re-direct it to a file by entering: "infocmp >
  200.  (filename)".  This will send the current term type's capabilities to
  201.  the file.  You can then edit the file and recompile it by entering:
  202.  tic (filename).
  203.   
  204.  TermInfo Compiler, Tic,  reads the filename and adds the entry into
  205.  the TERMINFO database structure according to the name entered on the
  206.  terminal name line in the file.  
  207.   
  208.  Some of the most common mistakes in the terminal file are the  
  209.  definitions of the Function Keys (kf0 - kf12).  In order to correct  
  210.  them, check the manual that came with your terminal and identify what  
  211.  codes each key generates against the entries in the de-compiled
  212.  terminal file (remember that \E is TERMINFO's way of representing the
  213.  escape key). If the entry is missing, then add it to the file and
  214.  recompile.
  215.   
  216.  If you don't have the manual for the terminal, there is another way to  
  217.  determine what each of the function keys is generating.  Make sure the  
  218.  stty setting "echoctrl" is on (stty echoctrl), and press each one of
  219.  the function keys.  You should see a sequence of characters echo to
  220.  the screen after pressing each key (although some terminals may not be
  221.  able to do this).
  222.  
  223.                                    
  224.  
  225.                   ================================
  226.                   Removing UNIX-SPIRS Version 1.01
  227.                   ================================
  228.  -------------------
  229.  SUN and SCO Removal
  230.  -----------------------------------------------------------------
  231.  Follow these instructions to remove UNIX-SPIRS from your machine.
  232.  -----------------------------------------------------------------
  233.  
  234.  NOTE: You must be logged in with super-user permissions to use the
  235.  pkgrm utility.
  236.  
  237.  
  238.  1. Type the following:
  239.  
  240.        pkgrm UNIXSPIRS
  241.  
  242.     The following prompt will appear:
  243.      Do you want to remove this package [y,n,?,q]:
  244.  
  245.  2. Type "y" at the prompt.
  246.  
  247.     The following message should appear:
  248.      Removal of <UNIXSPIRS> was successful
  249.  
  250.  All files associated with UNIX-SPIRS should have been removed from
  251.  your machine.
  252.  
  253.  -----------
  254.  AIX Removal
  255.  -----------------------------------------------------------------
  256.  Follow these instructions to remove UNIX-SPIRS from your machine.
  257.  -----------------------------------------------------------------
  258.  
  259.  NOTE: You must be logged in with super-user permissions.
  260.  
  261.  
  262.  1. Type the following:
  263.  
  264.        uninstall
  265.  
  266.  2. Follow the prompts to uninstall the UNIX-SPIRS software.
  267.  
  268.     The following message should appear:
  269.      Removal of <UNIXSPIRS> was successful
  270.  
  271.  All files associated with UNIX-SPIRS should have been removed from
  272.  your machine.
  273.