Editing Scanco Administration (section)

==USB Drive==

===Use a USB drive===
Connect USB to VMS system and format. Transfer files from the terminal after plugging in the USB device.
  $ show device dna
Usually the device is dna1 or dna2
  $ mount /over=id dna2
  $ create/dir dna2:[microct]
  $ backup/log disk1:[microct]login.com dna2:[microct]
  $ dismount dna2
Transfer files back again
  $ mount /over=id dna2
  $ dir dna2:[microct]
  $ copy dna2:[microct]login.com disk1:[microct]
I'm not sure the difference between using <code>copy</code> and <code>backup</code>.

You can initialize a USB drive using <code>uct_backup</code>. Or you can do it from the command line:
  $ set host 0                      ! login as system
  $ init dna7: raw001/own=microct   ! <b>deletes</b> anything on the drive
  $ mount dna7: raw001 
  $ create/dir dna7:[microct]/own=microct

Or in case the directory already exists:

  $ set file dna7:[000000]microct.dir/own=microct
  $ dismount dna7:

For manual backup of files, you need to mount the filesystem (without the /foreign):

  $ mount dna7: raw001
  $ backup login.com dna7:[microct]/log
  $ dismount dna7:

[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

===Trouble shooting a USB drive===

Sometimes we have problems with USB devices. Check the status of the device to find if it has been allocated already and that there are no current jobs running that may have hung.

The device may look like this:

<pre>
$ sh dev dna

Device                  Device           Error    Volume         Free  Trans Mnt
 Name                   Status           Count     Label         Space Count Cnt
SC3418$DNA7:            Online alloc         0
</pre>

The <code>Online alloc</code> instead of  <code>Online</code> suggests the device is already allocated. So we get a more full output:

<pre>
$ sh dev dna/full

Disk SC3418$DNA7:, device type ST1500LM 003-9YH148 CC9F, is online, allocated,
    file-oriented device, shareable, available to cluster, error logging is
    enabled, device is busy.

    Error count                    0    Operations completed            1424772
    Owner process        "BATCH_357"    Owner UIC                      [SYSTEM]
    Owner process ID        0000A94A    Dev Prot         S:RWPL,O:RWPL,G:R,W:RW
    Reference count                3    Default buffer size                 512
    Total size                1.36TB    Sectors per track                     1
    Total cylinders            31536    Tracks per cylinder                   1
</pre>

This suggests that the owner is process <code>BATCH_357</code>. The <code>357</code> refers to the job that ran on the queue.

<pre>
$ sh que/all
Printer queue HPLJET, idle, on SC3418::"IP_LPD/hpljet", 
mounted form DCPS$DEFAULT (stock=DEFAULT)

Batch queue SYS$ADMIN, idle, on SC3418::

  Entry  Jobname         Username             Status
  -----  -------         --------             ------
    752  RELAY_PUMP_10_MIN_ON
                         MICROCT              Holding until 31-JAN-2025 02:00:00

Batch queue SYS$BACKUP, idle, on SC3418::

Batch queue SYS$BATCH, idle, on SC3418::

Batch queue SYS$FAST, idle, on SC3418::

Batch queue SYS$FE, idle, on SC3418::

Batch queue SYS$SLOW, idle, on SC3418::
</pre>

But there are no jobs running. So let's try manually dismounting the device, but do so as user <code>system</code>:

<pre>
$ dism/abort dna7:
%SYSTEM-F-DEVNOTMOUNT, device is not mounted
</pre>

Well, that didn't work, so let's see if there is a list of running processes, again as user <code>system</code>:

<pre>
$ show user/full
      OpenVMS User Processes at 30-JAN-2025 15:20:04.96
    Total number of users = 2,  number of processes = 3

 Username Process Name    PID     Terminal
 MICROCT  BATCH_357     0000A94A  (Batch)
 MICROCT  MICROCT       0000D2A3  FTA154:  
 SYSTEM   SYSTEM        0000D2A4  RTA1:    (SC3418::MICROCT)
</pre>

Stop the process associated with running the USB device:

<pre>
$ stop/id=0000A94A
$ sh user /full
      OpenVMS User Processes at 30-JAN-2025 18:28:23.65
    Total number of users = 2,  number of processes = 3

 Username Process Name    PID     Terminal
 MICROCT  BATCH_357     0000A94A  (Batch)
 MICROCT  MICROCT       0000D2A6  FTA155:  
 SYSTEM   SYSTEM        0000D2A7  RTA1:    (SC3418::MICROCT)
</pre>

Ok, did that still not work? Try unplugging the USB drive and waiting 30 seconds before plugging it back in. Perhaps that will force the job to end.

<pre>
$ sh dev dna

Device                  Device           Error    Volume         Free  Trans Mnt
 Name                   Status           Count     Label         Space Count Cnt
SC3418$DNA7:            Online               0
</pre>

That seems to have worked!


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

===USB Device Usage with Scanco Backup/Archive Software===

For illustrated help on USB device usage on Itanium systems, please refer to [[Media:Scanco_TD387_USB_Device_Usage.pdf ‎ | '''Scanco_TD387_USB_Device_Usage.pdf ‎''' ]]
 
====Initialize procedure====
If an external USB device is to be used to archive measurement data, the USB device must be initialized by Open-
VMS. The data will not be accessible from any other operating system.

- Attach the USB device to the front USB port of the Itanium rx2660.
(note: Itanium rx2620 only supports USB1.1, which will have a very slow transfer rate)

- Open the Scanco backup/archive software.

- Select the correct USB device with the arrow buttons in the “USB Device” section.

- Use the “Initialize<” button in the “USB Device” section to initialize the USB device.

- Confirm the Warning message. Note: All data currently on the device will be erased!

- Enter a six-character label

The USB device will be initialized and mounted.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Archive procedure====

- Attach an OpenVMS formatted USB device to the front USB port of the Itanium.
(note: Itanium rx2620 only supports USB1, which will have a very slow transfer rate)

- Open the Scanco backup/archive software.

- Select the correct USB device with the arrow buttons in the “USB Device” section.

- Use the “Mount” button in the “USB Device” section to mount the USB device.

The device label of the mounted USB device will be shown in the “USB Device” section.

- Select the measurement data to be archived.

- Select “Move To:” and “USB/VMS” and click “Start<” to archive the selected data to the USB device.

After the move procedure, the new current location of the measurement data will be shown next to the files path.

- “Dismount” the USB device when done with archiving.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Manual file copy procedure====
An OpenVMS formatted USB device can also be mounted and used for file storage using commands in a DECterm.

- Attach an OpenVMS formatted USB device to the front USB port of the Itanium.
(note: Itanium rx2620 only supports USB1, which will have a very slow transfer rate)

- List available devices. The last shown device is usually the attached USB device; dna12 in this example.
    $ show device dna

- Mount the USB device using the correct device name
    $ mount /over=id dna12

- Create a root directory. Ignore any messages if the directory already exists.
    $ create /dir dna12:[microct]

- Copy any wished files to the USB device
    $ copy {source files} dna12:[microct] /log

- Dismount the USB device
    $ dismount dna12


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

====Exporting Files / FAT file system====
If an external USB device is to be used to export measurement data to a Windows or MAC OS, the USB device must be formatted as FAT file system.

- Attach the USB device to the front USB port of the Itanium.
(note: Itanium rx2620 only supports USB1, which will have a very slow transfer rate)

- Open the Scanco backup/archive software.

- Do not “Initialize<” or “Mount” the USB device !

- Select the measurement data to be copied to the USB device, may be even sub-select the wished file type
(TIF files in the example below).

- Select “Copy To:” and “USB/FAT” and click “Start<” to copy the selected data to the USB device.

Once the USB device is connected to Windows or MAC OS, it will show a ZIP file named like the copied measurement
number. This ZIP file contains the same directory structure like the data disk on OpenVMS: 

data\sample number\measurement number

In the lowest sub-directory are the copied files, as selected in the backup/archive software (TIF files in this example).


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]

===Problems with connected USB devices===

Sometimes USB configurations can be problematic, in which case log in as "system" on the server and run

  $ dir/date SYS$SYSROOT:[SYSEXE]USB$UCM_DEVICES.DAT

to see whether a file was created recently. If one has, delete that file and reboot the server.


[[Image:Redirect.jpg|15px]] [[#top|''Return to Contents'']] or [[Main_Page|''Return to Main Page'']]