SCSIMounter.doc

(16 KB) Pobierz
SCSIMounter 2.0
===============

Removable media partition mounter for Kickstart 2.0 or higher.

Refer to 'SCSIMounter.guide' for an AmigaGuide version of this
document.

WANTED: Someone who translates this document to German!

------------------------------------------------------------------------
Versions
--------

2.02 - Terrible bug fixed which caused SCSIMounter to fail on 68000
       machines.
2.00 - SCSIMounter is a commodity now
       bi-lingual user interface
1.30 - MASK tooltype added
1.20 - Minor changes to the CLI interface. New tool type 'NOUNMOUNT'
1.10 - ReadArgs() CLI Interface added
1.04 - Now works with beta kickstarts (V 36)
       Keyboard equivalents for everything (including list view)
       Layout bug fixed
       No funtional changes.
1.03 - Made more tolerant :-)
1.02 - Fix for gvpscsi.device (GVP Series II) added.


------------------------------------------------------------------------
Disclaimer
----------

SCSIMounter may be freely distributed for non-commercial purposes only. 
The entire risk as to the quality and performance of this program is 
with you. 

The author assumes no responsibility or liability whatsoever with
respect to your use or inability to use of this software.


------------------------------------------------------------------------
Purpose
-------

Most owners of removable media SCSI drives are stuck with the problem
that their software doesn't handle disk changes correctly.
For example, the current Commodore implementation doesn't mount the 
partitions on a removable media SCSI drive (e.g. SyQuest or Ricoh)
when there was no cartridge in the drive at boot time. 

Even worse, after another cartridge with a different Rigid Disk Block 
(i.e. a different partition table) has been inserted, the system
gets totally confused and reports read/write errors when trying
to access the device which can lead to loss of important data on 
the cartridge.

Until now, the only possibility to work around this problem was to
reboot the system every time a new cartridge has been inserted.

SCSIMounter allows you to mount and unmount partitions without rebooting 
the machine. It sports a nice 2.0-style point-and-click user interface
that makes handling removable media a piece of cake.


------------------------------------------------------------------------
Secondary use
-------------

SCSIMounter can also be used to mount partitions that have intentionally
not been mounted (e.g. the wb_1.3: partition on an A3000 when running 
under 2.0). You don't have to create a mountlist for it! 


------------------------------------------------------------------------
Requirements
------------

? Any Amiga with a SCSI host adaptor that supports the Commodore
  RDB (Rigid Disk Block) and 'SCSI Direct' standards.
? Kickstart 2.0 or higher (version 37.175 preferred)

The program has been tested on an A3000 with Commodore's scsi.device
and on an A2500 with a Microbotics HardFrame (HardFrame.device) but
I see no reason why it shouldn't work on any other host adaptor. 

The program may be of no use for owners of certain GVP controllers 
which support removable media correctly (Though not all GVP software 
might do so).


------------------------------------------------------------------------
Before you begin
----------------

First, determine the name of the device driver of your hard disk 
controller card. 

    Examples of popular controllers and their devices:

    manufacturer/controller           device
    --------------------------------------------------
    Commodore A590/A2091/A3000        scsi.device
    Old GVP                           scsidev.device
    GVP Series II                     gvpscsi.device
    Supra SupraDrive                  harddisk.device
    Advanced Storage Systems Nexus    nexus.device
    Microbotics HardFrame             HardFrame.device
    ICD AdSCSI                        icddisk.device
    IVS Trumpcard Professional        ivs_scsi.device
    BSC ALF2/3                        ALF.device
    BSC Oktagon 2008                  Oktagon.device
    --------------------------------------------------

Click once one the SCSIMounter icon and select 'Information' from the
'Icons' menu.

Add or change the following tool type:

    DEVICE=Name_of_your_scsi_device_here

for example if you use a HardFrame controller write:

    DEVICE=HardFrame.device

Don't add path names here, only the name of the device is required.
Take care to capitalize the device name correctly (exec device names 
are case sensitive!)

NOTE

SCSIMounter will not work with the Commodore A2090(A) controller card
because this product does not support Commodore's own 'SCSI direct' and
'RDB' standards properly.


------------------------------------------------------------------------
Start SCSIMounter
-----------------

SCSIMounter can be used either from Workbench or from the CLI.


* Workbench use

  Double click on the SCSIMounter icon. After a short time, a window
  with a listview and three buttons will appear (assuming CX_POPUP
  is set to `yes'). If the window doesn't appear several things could 
  have gone wrong:

  ? Do you use Kickstart 2.0 or higher?
  ? Did you specify and spell the name of your device driver correctly?
  ? Does your host adaptor support RDB?
  ? Is there any memory left on your system?
  ? Do you have commodities.library (supplied with Workbench 2.04)
    in libs:?

  Requesters will try to tell you the cause if SCSIMounter fails to run.


* CLI use

  Type 'SCSIMounter gui device Name_of_your_scsi_device'
  example:

  1> SCSIMounter gui device HardFrame.device

  If the 'gui' argument is not given, SCSIMounter will be started
  in command line mode as described later in this document.


------------------------------------------------------------------------
Panels
------

1) Main panel

   The main panels shows all devices connected to the SCSI port with
   information about their capacity and current status. The currently 
   selected unit is higlighted.

   UNIT - This is the unit number of a SCSI device.
          Up to seven devices can be connected to the SCSI bus

   DRIVE TYPE - Manufacturer and product specification

   REV. - Revision of Hardware, Firmware and ROM of device

   CAP. - Device capacity in Megabytes or Kilobytes

   STATUS - Current Status of device. If the device is busy or
            not accessable due to the lack of media (if it's a
            removable media drive) the status will be set to
            'not ready'

   There are three 'action buttons' present:

   HIDE - Put SCSIMounter to sleep. To wake it up again, use the
          hotkey as specified in CX_POPKEY or the Commodities Exchange
          program on you system partition. Closing the window
          using its closegadget has the same effect.

   UPDATE - Re-scan SCSI bus and update display

   MOUNT - Mount partitions on selected drive

   For every action buttons there's also a menu item with identical
   function. All buttons have keyboard equivalents (marked with an
   underscore in the label text). The listview can be scrolled using
   the arrow up and arrow down keys on your keyboard rather than using
   the mouse.

   There's one important menu item that has no button equivalent:

   QUIT - Quits SCSIMounter and removes it from the list of commodity
          programs


2) 'Partition Selector' panel

   This panel shows all available partitions and allows you to 
   individually mount them.

   CHECKGADGETS - Determine if the particular partition should 
                  be mounted or not.

                  checked: mount corresponding partition
                  not checked: don't mount specified partition


   Other partition Information on the partition selector -

          Number of Partition == keyboard equivalent

          Device name of partitions

          Size of partitions

          Dostype (FileSystem) of partition

             Examples of dostypes:

             DOS0 - Old filesystem partition
             DOS1 - FastFileSystem partition
             UNI1 - Unix boot partition
             RESV - Reserved partition

   CANCEL - Go back to main panel, don't mount anything

   MOUNT - Unmount all currently mounted partitions on the selected
           device and mount the new partitions (if any).

   UNMOUNT ALL - If this gadget is checked, SCSIMounter will try
                 to unmount all partitions currently mounted on the
                 selected unit. If there are locks on this device
                 there will be a 'BUSY' icon on your Workbench screen.

                 WARNING:

                 This option can be dangerous if used with non-removable
                 devices because it will unmount all partitions 
                 including your boot partition (SYS:) forcing you to 
                 reboot your computer. Use it with care!


------------------------------------------------------------------------
Operation
---------

SCSIMounter is pretty self-explanatory. Nevertheless, here are some 
basic operation procedures.

* Mount a new cartridge

  ? Click on the listview entry of the desired device. (Make sure its
    status is 'ready')

  ? Click on the 'Mount' button

    The 'select partitions' panel will ask you which partitions to mount

  ? Chosse the partitions you would like to mount

  ? Make sure that the 'Unmount all' gadget is checked

  ? Click on 'Mount' button on the partition selector panel

    SCSIMounter will automatically unmount all existing partitions
    on the device and mount the new partitions.


* Add a SCSI drive that was not present at boot time

  ? Click on the 'Update' button

    The new drive's name and other information should appear in the 
    listview

  ? Click on the corresponding entry
  ? Click on the 'Mount' button

    and so on.....
Zgłoś jeśli naruszono regulamin