home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / cli / sksh017.lzh / doc / Install.doc < prev    next >
Encoding:
Text File  |  1991-05-04  |  8.8 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                          Installation Guide to
  17.  
  18.                                  SKsh
  19.  
  20.                     A ksh-like Shell for the Amiga
  21.  
  22.                               Version 1.7
  23.  
  24.  
  25.                          (Copyright) 1988-1991
  26.  
  27.                               Steve Koren
  28.  
  29.                               May 4, 1991
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.        Installing SKsh
  74.  
  75.      This  section  descibes how to install SKsh.  It is vitally im-
  76.      portant that all the steps be  performed.   If  they  are  not,
  77.      SKsh  will  not  operate correctly.  In addition, SKsh requires
  78.      version 1.3 or later of AmigaDos to operate correctly.
  79.  
  80.      Please  examine this file for each release, as it may change at
  81.      any  time.   In  SKsh  1.7,  for  example, the instructions are
  82.      quite  different than in  previous version.  Installation after
  83.      version  1.7  has  been  simplified by the use of a interactive
  84.      installation script.  Most of the steps are  now  automated and
  85.      require  simply that you  press  return when the script prompts
  86.      you.  This file  still  contains alot of words, but it is now a
  87.      tutorial on  using the install script, which mostly consists of
  88.      answering  simple  questions and  pressing return.  Its simpler
  89.      to do than to explain!
  90.  
  91.      Before  you  start,  you  should  have   extracted  the  entire
  92.      SKsh*.lzh archive into a  previously empty directory, and cd'ed
  93.      to that directory. If  you  have  enough  memory,  installation
  94.      will  proceed faster if  this  directory is on a ram: disk, but
  95.      this is not necessary.  In any case, the ram: disk  should  ex-
  96.      ist when the script is run.
  97.  
  98.      The  install script is  designed for installation to hard disk.
  99.      It may  be  possible to use it for floppy installation, but you
  100.      must have enough disk space on the floppy (it takes  alot,  and
  101.      you will probably not have enough  room).   Also,  I  have  not
  102.      tested it  for  installation to a floppy disk, so I can't claim
  103.      it will work.
  104.  
  105.  
  106.         1)   Make sure your stack size  is  set  to  at  least  8000
  107.              bytes.  You must  also  have  arp.library  installed in
  108.              your   system  in  the  LIBS:   directory.    This   is
  109.              essential.  If you are not sure how  to  do  this,  see
  110.              the arp documentation.  arp is  available on most Amiga
  111.              BBS systems.  It is best to use the most  recent avail-
  112.              able arp.library, since SKsh  will  not  run  correctly
  113.              with some early versions.
  114.  
  115.  
  116.         2)   Invoke an empty AmigaDos  CLI  window, one which is NOT
  117.              running SKsh.  Type:
  118.  
  119.                sksh -n Install_?.?.pp
  120.  
  121.              (where  ?.?  is  the  current  version number of SKsh).
  122.              Don't  forget  the  -n  parameter.   The   installation
  123.              script  will  briefly  describe what it is going to do.
  124.              Read this and press return.
  125.  
  126.  
  127.  
  128.  
  129.        SKsh Amiga Shell             Page 2           Installation Guide
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.              If  errors are  generated at any point when running the
  140.              script,  they  will  be  reported and the  script  will
  141.              abort.  A  list  of  errors is left in the file ram:In-
  142.              stall_Sksh.err.  You can examine this list later.
  143.  
  144.  
  145.         3)   Step one  of  the  installation script will insure that
  146.              your SKsh*.lzh  file  contained all the necessary files
  147.              and  was  unarchived  correctly to the  current working
  148.              directory.  Press return when this is complete.
  149.  
  150.  
  151.         4)   Step two of the script asks you  for  various directory
  152.              names where SKsh files will be installed.  If you  have
  153.              installed  SKsh  before, the script will prompt you us-
  154.              ing  the  values of your old sksh:, skshbin:, and sksh-
  155.              scr: aliases as  defaults, if they exist.  If this is a
  156.              new  installation, or if you are updating from SKsh 1.6
  157.              (which doesn't have  skshbin: or skshscr:), you will be
  158.              prompted  using other defaults. In either case, you can
  159.              change the defaults by typing new values.
  160.  
  161.              If this is a  new  SKsh  installation, and you type di-
  162.              rectories which do not  yet  exist, the script will ask
  163.              you if you wish to create them.
  164.  
  165.  
  166.         5)   Step three of  the  script  encompasses most of the old
  167.              installation instructions.  It  installs all SKsh files
  168.              into  the  locations  you  indicated in the above step,
  169.              and sets the proper  file  permission bits.  If this is
  170.              a new SKsh  installation, then the default .skshrc file
  171.              is  installed.    Otherwise, your old one  is  left  in
  172.              place.
  173.  
  174.              You may skip this step  by  answering the prompt affir-
  175.              matively, in which case SKsh will NOT  be  installed or
  176.              updated.    After you  answer the one prompt, this step
  177.              proceeds without interaction.
  178.  
  179.  
  180.         6)   Step four  of  the  installation script will check your
  181.              device  assignments for sksh:,  skshbin:, and skshscr:.
  182.              If they  both  exist and agree with the directories you
  183.              input   several  steps  ago,   no   further  action  is
  184.              required.  If the  assignments do no exist, you will be
  185.              warned, and the script will ask if  you  wish  to  make
  186.              them now.  If you ask it to, it will make  the  correct
  187.              assignments, but they will  only  exist until your com-
  188.              puter is rebooted.
  189.  
  190.              Also, if you  have  existing assignments by those names
  191.              which don't agree  with  the  directories you input be-
  192.              fore, this fact is  reported and you are given a chance
  193.  
  194.  
  195.        SKsh Amiga Shell             Page 3           Installation Guide
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.              to change the assignments.
  206.  
  207.  
  208.         7)   Step five of the script  will  verify  that  all  files
  209.              have  been  installed in  the  correct places.  It will
  210.              also verify that all files  have  correct checksums and
  211.              that none have been corrupted.  No  interaction is nec-
  212.              essary  in  this  step  (besides pressing return at the
  213.              end).    Error messages will be issued if any files are
  214.              missing,  have  incorrect checksums, or have  incorrect
  215.              file permission bits.
  216.  
  217.  
  218.         8)   Step six of the script will re-create  your  .skshrc.pp
  219.              file for you.  If you don't have  one  already, it will
  220.              create a new  one.   The  .pp  file  will  simply cause
  221.              start times to be faster, but you  must  not  have  any
  222.              syntax errors in your .skshrc file for this to work.
  223.  
  224.  
  225.         9)   Step  seven  is  optional, and if you choose to perform
  226.              it, it  will  install the SKsh manpages in the MAN:SKsh
  227.              directory.   These  manpages are generated by splitting
  228.              the Reference.doc  and  ExtCmds.doc  files.   You  must
  229.              have enough disk space to perform this step.
  230.  
  231.  
  232.         10)  Step  eight  of  the  script  examines your  s:startup-
  233.              sequence  file  and  generates  a  checklist of  manual
  234.              steps  necessary  to  complete the  SKsh  installation.
  235.              Since this file can widely vary in  contents, it is not
  236.              possible (or for that  matter advisable) for the script
  237.              to make the changes itself.   The  checklist generation
  238.              may take a few seconds.
  239.  
  240.              The  script  prints  this  checklist to the screen, and
  241.              also saves it to  the  file  called  "ram:ManSteps.txt"
  242.              which can be examined later.
  243.  
  244.              The  checklist will  contain items that  install script
  245.              thinks you  need  to  add  to  your  s:startup-sequence
  246.              file.  Since  there  are  so  many  configurations pos-
  247.              sible, this may not  be  accurate.   (For  example, you
  248.              could  perform the same tasks in  another startup file,
  249.              and this script would not see them).   Just  make  sure
  250.              you  perform these tasks  somewhere where they will al-
  251.              ways be done when you reboot your system.
  252.  
  253.              If the script finds  no  problems, it will not generate
  254.              the checklist.
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.        SKsh Amiga Shell             Page 4           Installation Guide
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.        Notes about the Installation
  272.  
  273.      *  The script source to the  SKsh  script  commands is provided
  274.         in the scr_source directory.  These files are not  installed
  275.         by the test  script  since  they  are  not  necessary to run
  276.         SKsh.  If you wish to save them, do  it  before deleting the
  277.         directory containing the unarchived files.
  278.  
  279.      *  The same note  applies to the files in the "misc" directory.
  280.         These are shipped in an lharc archive to save space.
  281.  
  282.      *  If  you  run  into  any  problems with  the  install script,
  283.         please let  me  know.   I  have  debugged it as much as pos-
  284.         sible, but there is  always the chance that some system con-
  285.         figuration I have not tested it with  will  somehow cause it
  286.         to fail.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.        SKsh Amiga Shell             Page 5           Installation Guide
  328.  
  329.  
  330.  
  331.