home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / useful / disk / misc / scsimounter / scsimounter.doc < prev    next >
Text File  |  1992-05-13  |  17KB  |  515 lines
  1. SCSIMounter 2.0
  2. ===============
  3.  
  4. Removable media partition mounter for Kickstart 2.0 or higher.
  5.  
  6. Refer to 'SCSIMounter.guide' for an AmigaGuide version of this
  7. document.
  8.  
  9. WANTED: Someone who translates this document to German!
  10.  
  11. ------------------------------------------------------------------------
  12. Versions
  13. --------
  14.  
  15. 2.02 - Terrible bug fixed which caused SCSIMounter to fail on 68000
  16.        machines.
  17. 2.00 - SCSIMounter is a commodity now
  18.        bi-lingual user interface
  19. 1.30 - MASK tooltype added
  20. 1.20 - Minor changes to the CLI interface. New tool type 'NOUNMOUNT'
  21. 1.10 - ReadArgs() CLI Interface added
  22. 1.04 - Now works with beta kickstarts (V 36)
  23.        Keyboard equivalents for everything (including list view)
  24.        Layout bug fixed
  25.        No funtional changes.
  26. 1.03 - Made more tolerant :-)
  27. 1.02 - Fix for gvpscsi.device (GVP Series II) added.
  28.  
  29.  
  30. ------------------------------------------------------------------------
  31. Disclaimer
  32. ----------
  33.  
  34. SCSIMounter may be freely distributed for non-commercial purposes only. 
  35. The entire risk as to the quality and performance of this program is 
  36. with you. 
  37.  
  38. The author assumes no responsibility or liability whatsoever with
  39. respect to your use or inability to use of this software.
  40.  
  41.  
  42. ------------------------------------------------------------------------
  43. Purpose
  44. -------
  45.  
  46. Most owners of removable media SCSI drives are stuck with the problem
  47. that their software doesn't handle disk changes correctly.
  48. For example, the current Commodore implementation doesn't mount the 
  49. partitions on a removable media SCSI drive (e.g. SyQuest or Ricoh)
  50. when there was no cartridge in the drive at boot time. 
  51.  
  52. Even worse, after another cartridge with a different Rigid Disk Block 
  53. (i.e. a different partition table) has been inserted, the system
  54. gets totally confused and reports read/write errors when trying
  55. to access the device which can lead to loss of important data on 
  56. the cartridge.
  57.  
  58. Until now, the only possibility to work around this problem was to
  59. reboot the system every time a new cartridge has been inserted.
  60.  
  61. SCSIMounter allows you to mount and unmount partitions without rebooting 
  62. the machine. It sports a nice 2.0-style point-and-click user interface
  63. that makes handling removable media a piece of cake.
  64.  
  65.  
  66. ------------------------------------------------------------------------
  67. Secondary use
  68. -------------
  69.  
  70. SCSIMounter can also be used to mount partitions that have intentionally
  71. not been mounted (e.g. the wb_1.3: partition on an A3000 when running 
  72. under 2.0). You don't have to create a mountlist for it! 
  73.  
  74.  
  75. ------------------------------------------------------------------------
  76. Requirements
  77. ------------
  78.  
  79. · Any Amiga with a SCSI host adaptor that supports the Commodore
  80.   RDB (Rigid Disk Block) and 'SCSI Direct' standards.
  81. · Kickstart 2.0 or higher (version 37.175 preferred)
  82.  
  83. The program has been tested on an A3000 with Commodore's scsi.device
  84. and on an A2500 with a Microbotics HardFrame (HardFrame.device) but
  85. I see no reason why it shouldn't work on any other host adaptor. 
  86.  
  87. The program may be of no use for owners of certain GVP controllers 
  88. which support removable media correctly (Though not all GVP software 
  89. might do so).
  90.  
  91.  
  92. ------------------------------------------------------------------------
  93. Before you begin
  94. ----------------
  95.  
  96. First, determine the name of the device driver of your hard disk 
  97. controller card. 
  98.  
  99.     Examples of popular controllers and their devices:
  100.  
  101.     manufacturer/controller           device
  102.     --------------------------------------------------
  103.     Commodore A590/A2091/A3000        scsi.device
  104.     Old GVP                           scsidev.device
  105.     GVP Series II                     gvpscsi.device
  106.     Supra SupraDrive                  harddisk.device
  107.     Advanced Storage Systems Nexus    nexus.device
  108.     Microbotics HardFrame             HardFrame.device
  109.     ICD AdSCSI                        icddisk.device
  110.     IVS Trumpcard Professional        ivs_scsi.device
  111.     BSC ALF2/3                        ALF.device
  112.     BSC Oktagon 2008                  Oktagon.device
  113.     --------------------------------------------------
  114.  
  115. Click once one the SCSIMounter icon and select 'Information' from the
  116. 'Icons' menu.
  117.  
  118. Add or change the following tool type:
  119.  
  120.     DEVICE=Name_of_your_scsi_device_here
  121.  
  122. for example if you use a HardFrame controller write:
  123.  
  124.     DEVICE=HardFrame.device
  125.  
  126. Don't add path names here, only the name of the device is required.
  127. Take care to capitalize the device name correctly (exec device names 
  128. are case sensitive!)
  129.  
  130. NOTE
  131.  
  132. SCSIMounter will not work with the Commodore A2090(A) controller card
  133. because this product does not support Commodore's own 'SCSI direct' and
  134. 'RDB' standards properly.
  135.  
  136.  
  137. ------------------------------------------------------------------------
  138. Start SCSIMounter
  139. -----------------
  140.  
  141. SCSIMounter can be used either from Workbench or from the CLI.
  142.  
  143.  
  144. * Workbench use
  145.  
  146.   Double click on the SCSIMounter icon. After a short time, a window
  147.   with a listview and three buttons will appear (assuming CX_POPUP
  148.   is set to `yes'). If the window doesn't appear several things could 
  149.   have gone wrong:
  150.  
  151.   · Do you use Kickstart 2.0 or higher?
  152.   · Did you specify and spell the name of your device driver correctly?
  153.   · Does your host adaptor support RDB?
  154.   · Is there any memory left on your system?
  155.   · Do you have commodities.library (supplied with Workbench 2.04)
  156.     in libs:?
  157.  
  158.   Requesters will try to tell you the cause if SCSIMounter fails to run.
  159.  
  160.  
  161. * CLI use
  162.  
  163.   Type 'SCSIMounter gui device Name_of_your_scsi_device'
  164.   example:
  165.  
  166.   1> SCSIMounter gui device HardFrame.device
  167.  
  168.   If the 'gui' argument is not given, SCSIMounter will be started
  169.   in command line mode as described later in this document.
  170.  
  171.  
  172. ------------------------------------------------------------------------
  173. Panels
  174. ------
  175.  
  176. 1) Main panel
  177.  
  178.    The main panels shows all devices connected to the SCSI port with
  179.    information about their capacity and current status. The currently 
  180.    selected unit is higlighted.
  181.  
  182.    UNIT - This is the unit number of a SCSI device.
  183.           Up to seven devices can be connected to the SCSI bus
  184.  
  185.    DRIVE TYPE - Manufacturer and product specification
  186.  
  187.    REV. - Revision of Hardware, Firmware and ROM of device
  188.  
  189.    CAP. - Device capacity in Megabytes or Kilobytes
  190.  
  191.    STATUS - Current Status of device. If the device is busy or
  192.             not accessable due to the lack of media (if it's a
  193.             removable media drive) the status will be set to
  194.             'not ready'
  195.  
  196.    There are three 'action buttons' present:
  197.  
  198.    HIDE - Put SCSIMounter to sleep. To wake it up again, use the
  199.           hotkey as specified in CX_POPKEY or the Commodities Exchange
  200.           program on you system partition. Closing the window
  201.           using its closegadget has the same effect.
  202.  
  203.    UPDATE - Re-scan SCSI bus and update display
  204.  
  205.    MOUNT - Mount partitions on selected drive
  206.  
  207.    For every action buttons there's also a menu item with identical
  208.    function. All buttons have keyboard equivalents (marked with an
  209.    underscore in the label text). The listview can be scrolled using
  210.    the arrow up and arrow down keys on your keyboard rather than using
  211.    the mouse.
  212.  
  213.    There's one important menu item that has no button equivalent:
  214.  
  215.    QUIT - Quits SCSIMounter and removes it from the list of commodity
  216.           programs
  217.  
  218.  
  219. 2) 'Partition Selector' panel
  220.  
  221.    This panel shows all available partitions and allows you to 
  222.    individually mount them.
  223.  
  224.    CHECKGADGETS - Determine if the particular partition should 
  225.                   be mounted or not.
  226.  
  227.                   checked: mount corresponding partition
  228.                   not checked: don't mount specified partition
  229.  
  230.  
  231.    Other partition Information on the partition selector -
  232.  
  233.           Number of Partition == keyboard equivalent
  234.  
  235.           Device name of partitions
  236.  
  237.           Size of partitions
  238.  
  239.           Dostype (FileSystem) of partition
  240.  
  241.              Examples of dostypes:
  242.  
  243.              DOS0 - Old filesystem partition
  244.              DOS1 - FastFileSystem partition
  245.              UNI1 - Unix boot partition
  246.              RESV - Reserved partition
  247.  
  248.    CANCEL - Go back to main panel, don't mount anything
  249.