home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / dos / tools / tsx420 / install.doc < prev    next >
Encoding:
Text File  |  1994-10-11  |  18.6 KB  |  472 lines
  1.  
  2.  
  3.                               Installing TSX-Lite
  4.  
  5.  
  6.  
  7.       Installation of TSX-Lite is a simple process which  takes  about  10
  8.       minutes.   The  installation process will create the TSX-Lite system
  9.       directory, usually named TSX32SYS,  on  the  destination  disk.   It
  10.       will  extract  the  TSX-Lite  system files from compressed libraries
  11.       and write  them  into  this  directory.   The  TSX  kernel  program,
  12.       TSX32.SYS,  will  be  copied to the root directory of your C: drive.
  13.       When the installation is complete, your current  directory  will  be
  14.       the  TSX-Lite  system  directory  on the destination drive.  The TSX
  15.       installation process does not modify AUTOEXEC.BAT or CONFIG.SYS.
  16.  
  17.       The TSX-Lite  operating  system  coexists  peacefully  on  the  same
  18.       computer  with  DOS.   To  start  TSX-Lite  you first boot DOS, then
  19.       change to the TSX-Lite system directory  (usually  named  \TSX32SYS)
  20.       and issue the RUNTSX command.
  21.  
  22.       See   Section  1.13  on  page  8  for  information  about  obtaining
  23.       technical assistance.
  24.  
  25.  
  26.       1.1 Hardware Requirements
  27.  
  28.       TSX-Lite requires a 386 or 486 based system with at least  4  MB  of
  29.       memory.   VGA  and  MDA  display adapters are supported as well as a
  30.       variety  of  disk  adapters.   Disk  compression  schemes  such   as
  31.       DoubleSpace and Stacker are not supported.
  32.  
  33.  
  34.       1.2 Disk Space Requirements
  35.  
  36.       After  installation,  the  distributed  files in the TSX-Lite system
  37.       directory will occupy approximately 5 Mb.  In addition,  the  kernel
  38.       file,  TSX32.SYS (which is always placed in the root of the C drive)
  39.       will require about 1 Mb.
  40.  
  41.       However, when you  start  TSX,  a  virtual  memory  "page  file"  is
  42.       created  in  the  TSX system directory which, by default, occupies 4
  43.       MB of disk space.  The name of the page  file  is  PAGEFILE.TSX  and
  44.       its  size  is  determined  by  the  TSX  system generation parameter
  45.       PGFILSIZ.  The page file is used to hold the virtual memory  portion
  46.       of  programs  that  are  not  currently present in main memory.  The
  47.       PGFILSIZ parameter is discussed in the TSX-Lite documentation.   The
  48.       total  required  disk space for a running TSX-Lite system is roughly
  49.       10 megabytes.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                        1
  59.  
  60.       1.3 Installation Modes
  61.  
  62.       TSX-Lite is distributed both on  floppy  disks  and  via  electronic
  63.       distribution.   In either case, you will run an installation program
  64.       which will:
  65.  
  66.         . Create the TSX-Lite directory on your hard disk.
  67.  
  68.         . Decompress the TSX-Lite files into that directory.
  69.  
  70.         . Ask you a series of questions about your system,  and  create  a
  71.           configuration  file  based  on  your  answers  and  what  it can
  72.           automatically detect about your system.
  73.  
  74.  
  75.       1.4 Floppy Disk Installation
  76.  
  77.       If you received TSX-Lite on floppy disks, you  are  ready  to  start
  78.       the  installation.   Simply  insert Disk #1 in drive A or B and type
  79.       the command
  80.  
  81.           x:INSTALL
  82.  
  83.       where x is either A or B depending on which diskette drive  you  are
  84.       using.
  85.  
  86.       Now  proceed  to  Section  1.6  which  describes  the details of the
  87.       installation process.
  88.  
  89.       When the installation is finished, the TSX-Lite documentation  files
  90.       will   be   stored   in   the  TSX32SYS  directory.   To  print  the
  91.       documentation, simply type PRINT *.DOC after booting  TSX-Lite  (the
  92.       TSXLITE.DOC manual is about 175 pages long).
  93.  
  94.  
  95.       1.5 Installation from ZIP Files
  96.  
  97.       If  you  downloaded  TSX-Lite from a bulletin board, you should have
  98.       four files with an extension of .ZIP.  The first file in the  series
  99.       contains  the  TSX-Lite  documentation, and is much smaller than the
  100.       others.   You  may  wish  to  download  this  file  and   read   the
  101.       documentation before downloading and installing TSX-Lite.
  102.  
  103.       You   will   have   to   "unzip"  these  files  before  running  the
  104.       installation program.  To do this, use the PKUNZIP utility  program.
  105.       If  you  do not have a copy of PKUNZIP, you can download it from the
  106.       same bulletin board where you got TSX-Lite.  Note, each of the  four
  107.       .ZIP  files  contains a file named FILE_ID.DIZ.  These files provide
  108.       descriptive information for bulletin boards  but  are  not  used  by
  109.       TSX-Lite.
  110.  
  111.       To  unzip  the files, create a temporary directory on your hard disk
  112.       and "CD" to that directory.   Now,  copy  all  .ZIP  files  to  that
  113.       directory.  Then, type the command
  114.  
  115.  
  116.  
  117.                                        2
  118.  
  119.           PKUNZIP -O *
  120.  
  121.       You  should  now have the following files in the temporary directory
  122.       in addition to the ZIP files:
  123.  
  124.           INSTALL.EXE      ! The installer program
  125.           TSX-32.001       ! TSX-Lite compressed file #1
  126.           TSX-32.002       ! TSX-Lite compressed file #2
  127.           TSX-32.003       ! TSX-Lite compressed file #3
  128.           TSXLITE.DOC      ! The TSX-Lite documentation
  129.           REGISTER.DOC     ! TSX-Lite registration information
  130.           INSTALL.DOC      ! This file
  131.           READ.ME          ! Basic information about TSX-Lite
  132.           FILE_ID.DIZ      ! Information file for BBS sysops
  133.  
  134.       Now, simply type INSTALL to start the  installation  program.   When
  135.       you  have  completed  the installation, copy the documentation files
  136.       to another directory, or print them out with the TSX command
  137.  
  138.           PRINT *.DOC.
  139.  
  140.       You may then erase the files in the temporary directory.
  141.  
  142.  
  143.       1.6 The Installation Program
  144.  
  145.       The Install program will display a  Main  Menu  with  the  following
  146.       options:
  147.  
  148.           Install TSX-Lite
  149.           Copy Individual Files
  150.           Exit
  151.  
  152.       The  first option, Install TSX-Lite, will be highlighted, and is the
  153.       appropriate one for all new  systems  and  system  upgrades.   Press
  154.       Enter to select this option.
  155.  
  156.       If  you  make  an error any time during the installation process and
  157.       wish to exit, simply  press  Ctrl-X.   You  may  then  re-start  the
  158.       installation.
  159.  
  160.       If  this  is a new installation, the installation program will check
  161.       the system for adequate memory and disk space, and  will  check  the
  162.       CONFIG.SYS   file   for   possible  device  driver  conflicts.   The
  163.       following types of drivers many  interfere  with  TSX-Lite  when  it
  164.       begins  running:  Extended  memory  managers  such  as  QEMM.SYS and
  165.       HIMEM.SYS;  disk  caching  programs  such  as   SMARTDRV.SYS;   disk
  166.       compression programs such as DBLDISK.SYS and Stacker.
  167.  
  168.       The  first question you will be asked is "Does this system contain a
  169.       SCSI host adapter?" If you reply "Y" you will  be  asked  to  select
  170.       from  a  menu  the  type  of  SCSI adapter you have.  Currently, the
  171.       supported adapters are:
  172.  
  173.  
  174.  
  175.  
  176.                                        3
  177.  
  178.           Adaptec 1540 SCSI Adapter and compatibles
  179.           Adaptec 1740 EISA SCSI Adapter/Enhanced mode
  180.           Western Digital 7000 SCSI Adapter
  181.           CAM CSA-6000 EISA SCSI Adapter
  182.           PS/2 SCSI Adapter
  183.  
  184.       After selecting the adapter from this list, you will  be  asked  the
  185.       IRQ, SCSI ID and I/O address for the adapter.
  186.  
  187.       You  will  now  be  asked a series of questions to determine whether
  188.       certain detached jobs should be started at system bootup.  The  jobs
  189.       which  may  be  started  are  the print spooler and the window print
  190.       facility.  Reply "Y" for each job your system will  require.   These
  191.       selections  can  be changed later by using the TSGEN program.  If in
  192.       doubt about an option the safest choice is "Y".
  193.  
  194.       The installation  program  will  now  begin  extracting  files  from
  195.       compressed  libraries  and  copying them to your selected hard disk.
  196.       Please do not interrupt this process until it is finished.
  197.  
  198.       After all files are copied, you will be asked  questions  about  the
  199.       hard  disk configuration on your system.  The first question is "How
  200.       many fixed disk drives are in your computer?" When replying to  this
  201.       question,  include  removeable  hard  disks and CD ROM drives.  Also
  202.       include disk partitions which have been created with FDISK.  Do  NOT
  203.       include  disks  or  partitions  which  have  been  formatted  with a
  204.       non-DOS operating system or which have been compressed with  a  file
  205.       compression utility like Stacker or DoubleSpace.
  206.  
  207.       Then,  for  each  drive on the system, you will be asked to select a
  208.       disk type from the following list:
  209.  
  210.           Standard AT (or IDE)
  211.           PS2 Model 80 adapter
  212.           Unisys SCSI
  213.           All other SCSI controllers
  214.  
  215.       If you specify that the drive in question is a SCSI disk,  you  will
  216.       then  be asked to provide the SCSI ID, the SCSI LUN, and whether the
  217.       disk is removable or is a CD ROM.
  218.  
  219.       After providing information about all drives  on  your  system,  you
  220.       will  then  be  asked  to  assign  drive letters to the drives.  The
  221.       drive letters may be the same as those used under DOS,  or  you  may
  222.       use different letters if you wish.
  223.  
  224.       The  installation  process will now create a file named TSX32.GEN in
  225.       your  TSX-Lite  system  directory  with   information   about   your
  226.       configuration  and  choice of options.  Then, the TSGEN program will
  227.       run, applying the GEN options  to  the  kernel  file,  C:\TSX32.SYS.
  228.       The  TSX-Lite manual explains how you can use TSGEN to customize and
  229.       optimize TSX-Lite for your needs.
  230.  
  231.       The installation procedure checks for the presence of the  COM1  and
  232.       COM2  serial  ports and defines them as TSX devices TTB0 and TTC0 if
  233.  
  234.  
  235.                                        4
  236.  
  237.       they are present.  See the TSXLITE.DOC file  for  information  about
  238.       setting up COM3 and COM4 ports.
  239.  
  240.  
  241.       1.7 Starting TSX-Lite
  242.  
  243.       Since  TSX-Lite  is an operating system and must have full access to
  244.       the computer when it  starts  running,  some  TSR  programs  or  DOS
  245.       device  drivers  may  interfere  with it.  In particular, you should
  246.       remove any of  the  following  programs  and/or  drivers  from  your
  247.       CONFIG.SYS   and  AUTOEXEC.BAT  files  and  reboot  before  starting
  248.       TSX-Lite:
  249.  
  250.         . Memory managers such as QEMM.SYS and  HIMEM.SYS.   TSX-Lite  has
  251.           its own virtual memory manager built into it.
  252.  
  253.         . Disk  compression schemes such as Stacker or DoubleSpace.  Note:
  254.           TSX-Lite does NOT support  disk  compression  and  if  you  have
  255.           compressed  your  disks  you  will  need  to  decompress  before
  256.           starting TSX-Lite.
  257.  
  258.         . Disk caching programs such as SMARTDRV.SYS.
  259.  
  260.       When the installation procedure completes, make  sure  your  current
  261.       directory  is  the TSX-Lite system directory (normally TSX32SYS) and
  262.       type RUNTSX to start TSX.   A  screen  will  appear  displaying  the
  263.       progress  of  the  bootup  process.   When  system initialization is
  264.       finished (it takes 15 to 30 seconds),  you  will  see  the  TSX-Lite
  265.       greeting  and  a  system  prompt.   To  return  to DOS, type the TSX
  266.       "SHUTDOWN" or "BOOT" commands.
  267.  
  268.       If the  TSX-Lite  start-up  process  fails,  save  a  copy  of  your
  269.       CONFIG.SYS  and  AUTOEXEC.BAT files, create minimal ones without any
  270.       TSR's or unnecessary device drivers, reboot, and then try  to  start
  271.       TSX-Lite  again.   See  Section  1.12 for solutions to some possible
  272.       problems.
  273.  
  274.  
  275.       1.8 Using TSX-Lite
  276.  
  277.       When TSX-Lite starts it prints a welcome message and  then  displays
  278.       a  command  prompt.   At this point you may type TSX commands or run
  279.       your own application programs.  You may want to try  a  few  of  the
  280.       following  commands  to  get  a  feeling for the system: "TSXSHELL",
  281.       "HELP",  "SYSMON",  "FMAN",  "SHOW  SYSTEM",   "SHOW   USE",   "SHOW
  282.       TERMINALS",  "SHOW  MEMORY",  "SHOW  PAGING",  "SHOW  CACHE",  "SHOW
  283.       FILES", "SHOW FSTATUS", "SHOW ERRORS".
  284.  
  285.  
  286.       1.9 Documentation Files
  287.  
  288.       The following documentation files are provided with  TSX-Lite.   See
  289.       the   REGISTER.DOC  file  for  information  about  purchasing  other
  290.       manuals.
  291.  
  292.  
  293.  
  294.                                        5
  295.  
  296.       TSXLITE.DOC  -- Reference manual for TSX-Lite.
  297.       REGISTER.DOC -- Registration information and order form.
  298.       INSTALL.DOC  -- Installation instructions.
  299.       README.DOC   -- Basic introductory information.
  300.       VENDOR.DOC   -- Information for vendors.
  301.  
  302.  
  303.       1.10 System Upgrades
  304.  
  305.       The installation program will detect if TSX is already installed  on
  306.       the  target  drive.   If  so,  you  will  not be asked the questions
  307.       mentioned above and the new files will simply  be  copied  over  the
  308.       old ones.
  309.  
  310.       Certain  files  which  are  considered  "user-specific"  will not be
  311.       overwritten.  These include the GEN  file,  startup  command  files,
  312.       etc.   A  list  of  these  files  will appear on the screen (see the
  313.       following section for a complete list).  If you wish  any  of  these
  314.       files  to  be  replaced,  press  Ctrl-X to exit, delete the file(s),
  315.       then restart the installation program.
  316.  
  317.  
  318.       1.11 Copy Individual Files Installation Option
  319.  
  320.       Use this option  to  copy  one  or  more  selected  files  from  the
  321.       distribution  disks.   Because  files are stored on the distribution
  322.       disks in compressed format, they cannot be  copied  to  your  system
  323.       with the COPY command.
  324.  
  325.       When  you select this option, you will be prompted for the name of a
  326.       file to copy.  Type the filename and extension only, with  no  drive
  327.       or  directory specification.  Press Enter to continue.  You will now
  328.       be prompted for another file to copy.  You may continue to enter  as
  329.       many  files  as  you  wish  in  this  way.   Wildcard  filenames are
  330.       acceptable.
  331.  
  332.       Simply press Enter without entering a filename when  you  are  done.
  333.       All  files you selected will now be copied to the TSX-Lite directory
  334.       on your system.  If you asked for the file  TSX32.SYS,  it  will  be
  335.       copied to the root directory on drive C:.
  336.  
  337.       Certain   files   are  known  by  the  Installation  program  to  be
  338.       user-modifiable.  The  Installation  program  will  not  copy  these
  339.       files  to  your hard disk if another file with the same name already
  340.       exists.  To get a new copy of these files, you must first erase  the
  341.       original copy.  The files in this category are as follows:
  342.  
  343.          START.CMD
  344.          LSTARTUP.CMD
  345.          LSHUTDOWN.CMD
  346.          STARTQUE.CMD
  347.          QINIT.CMD
  348.          E32.INI
  349.          KERMIT.INI
  350.          *.KEY
  351.  
  352.  
  353.                                        6
  354.  
  355.       1.12 Possible Installation Problems
  356.  
  357.       1.  During  the  installation process, a message appears of the form
  358.           "We had a problem reading a file." This  indicates  a  corrupted
  359.           compressed  distribution  library  file.   Please  obtain  a new
  360.           distribution.
  361.  
  362.       2.  During the execution of the  TSGEN  program  (immediately  after
  363.           the  installation program "farewell" screen), an "out of memory"
  364.           message appears.  TSGEN requires a  substantial  amount  of  DOS
  365.           memory.   It  cannot  use  EMS  or  XMS.  Remove all drivers and
  366.           TSR's from your CONFIG.SYS and AUTOEXEC.BAT files,  reboot,  and
  367.           try again.
  368.  
  369.       3.  The  TSX  boot  process  fails with a message of the form "error
  370.           opening keyboard monitor." This indicates  that  TSX  is  having
  371.           trouble  finding  its  files  on  the  hard disk.  Run the TSGEN
  372.           program,  select  "Set  Tuning  Parameters",  then  select  "All
  373.           Parameters".   Press  the  letter  "S"  and  scroll  down to the
  374.           parameter SYSDEV, then press enter.  This  parameter  tells  TSX
  375.           where its files are stored.
  376.  
  377.           The  disk  drive  is  specified as DHxy: where 'x' indicates the
  378.           disk (a letter) and 'y' indicates a partition on  that  disk  (a
  379.           number).   So,  for example, the C drive is always DHA0:.  The D
  380.           drive may be either DHA1: if it is  the  2nd  partition  on  the
  381.           first  disk,  or  DHB0: if it is the 1st partition on the second
  382.           disk.  Verify that the SYSDEV  parameter  contains  the  correct
  383.           disk  name.  See the TSX-Lite documentation for more information
  384.           on running the TSGEN program.
  385.  
  386.       4.  The boot process fails with a message of the form "Error  moving
  387.           data"  or  "Error  allocating  memory." This usually indicates a
  388.           conflict with a  DOS  memory  manager  or  device  driver.   Try
  389.           removing  all  such drivers from the CONFIG.SYS and AUTOEXEC.BAT
  390.           files and rebooting the computer.  If the problems persist,  try
  391.           running  the  CMOS setup program for your computer and disabling
  392.           all ROM and video shadowing.
  393.  
  394.       5.  The  boot  process  completes  successfully  and  the   greeting
  395.           message  appears  on  the  screen,  but the system appears to be
  396.           "dead." This symptom may  occur  when  TSX  has  had  a  problem
  397.           initializing  the  keyboard.   Reboot  the  computer and run the
  398.           TSGEN program.  Select  "Set  Tuning  Parameters",  then  select
  399.           "Console  Keyboard Parameters".  Increase the value of KBDELAY1,
  400.           KBDELAY2, KBDELAY3, and KBDELAY4  to  30000  (thirty  thousand).
  401.           Exit  TSGEN  and  try  running  TSX  again.   See  the  TSX-Lite
  402.           documentation  for  more  information  on  running   the   TSGEN
  403.           program.
  404.  
  405.       6.  The  screen  goes  blank  after  entering  the RUNTSX command to
  406.           start TSX.  TSX is having a problem  with  your  video  adapter.
  407.           Try  setting  the adapter to its most basic mode and try booting
  408.           again.
  409.  
  410.  
  411.  
  412.                                        7
  413.  
  414.       1.13 Telephone Support
  415.  
  416.       If you need assistance installing TSX-Lite you are welcome  to  call
  417.       the  S&H support team.  The fee for this service is $1.50 per minute
  418.       which may be charged to a  Visa,  MasterCard,  or  American  Express
  419.       credit  card.   There is a $10.00 minimum charge for each call.  The
  420.       S&H support number is 615-327-3670.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.                                        8
  472.