Editing Archive (section)

==Tape==

===How To: Tape is allocated to another user===

:* Before using tape, test with <code>sh dev tp0 /full</code>
:* Status <code>online allocated</code> or <code>offline</code>. Should be <code>online</code> before using.
:* If somebody else is using the tape, wait.
:* If you are the one using the tape, make sure you <code>dismount tp0</code> or <code>dismount tp0/nounload</code> from the same window you mounted the tape.
:* If there is a serious error in getting the tape use back, then logout of blund completely (<code><exit></code> button on CDE at top of screen) and log back (<code>xuct</code>).
:* Any currently running queued jobs, including current measurements, will not be affected by the logout.


===How To: Deal with a full backup tape===

:<i>Option 1: From an archive script</i>
:* Wait for the script to fail after typing no for the request for volume 2 tape by the program.
:* dismount tp0 to remove tape.
:* Insert new tape, initialize with <code>uct_backup</code>, and start script again so that it includes only those filesthat were not already backed up on the previous tape (check the measurement directories).
:<I>Option 2: From the uct_backup utility</I>
:* Resume the operation on a new backup tape.
:*To abort the <code>uct_backup</code> utility, type<code> ctrl-y</code>. It is very slow. Be patient!
:* Insert the new tape.
:* With <code>uct_backup</code>, initialize the tape. Name is <code>RAW007</code> (max 6 characters).
:*Continue backing up after mounting the new tape.
:<i>Option 3: From <code>bltp</code> utility.</I>
:* Type <code>ctrl-y</code>.


===How To: Initialize a new backup tape===

:* Put new tape in drive.
:* Start <code>uct_backup</code>
:*Select <code><initialize></code> <I>before</I> <code><mount></code>.
:* An alternative to using <code>uct_backup</code> is to type at the command line: <code>init tp0 BE0007</code>


===How To: Archive (RSQ and AIM) files with a batch job===

:* <code> RAW</code> = RSQ, <code>IMA</code> = AIM.
:*Create an ARCHIVE.COM file and put it in the COM directory. Always add any files that have been backed up for the project to this file so that restoration is simply a matter of changing this file.
:* Automatic generation of the ARCHIVE.COM file is possible using the command: <code>archive</code>
::- <code>start_date</code>: copy and paste date of the first measured file (12-DEC-2001).
::- <code>end_date</code>: Last measured file.
::- <code>RAW data only</code>: N
::- <code>*seg.aim</code>: N
:* edit the ARCHIVE.COM to include only the files that you want backed up. The version of ARCHIVE.COM can be temporarily modified at any time to:
::- archive the IMA files (AIMs).
::- restore either the IMA or RAW files from tape.
:* @ARCHIVE.COM from the COM directory to execute the backup once the appropriate RAW/IMA tape is in the drive.
:* Note the tape number on the project sheet.


===How To: Archive the RSQ (and AIM) files with the uct_backup tool===

:<i>Step 1: Tape in drive</I>
:* Type <CODE>sh dev tp0</code> to ensure nobody else is using the drive (should not be mounted).
:* Put <code>RAW006</code> in drive.
:*Door up to insert tape.
:*Door down to close.
:*Wait for flashing light to stop. Indicates tape is loaded.
:<I>Step 2: Back up utility</I>
:*Start <code>uct_backup</code>
:*Click on <code><mount>/code>
:*Click on file to backup in window and file type (i.e. <code>RSQ</code>).
:*Select <code><move to></code> (from disk to tape), or <code><copy to></code> (from tape to disk).
:*Check that we are moving to <code>tape</code>, not <code>trash</code>!
:*Click <code><start></code>
:*Click <code><yes></code>
:*Then minimize the window. Never re-open the minimized window during the backup process. It will open automatically when done.
:*Note the tape label on the project sheet.
:<i>Step 3: Remove tape</I>
:*Click on <code><unmount></code>.
:*Wait for green light, then pop open the door. Done!


===HowTo: Delete a measurement===

:<i>Option 1: Permanent deletion (i.e., a failed measurement)</I>
:* Use <code>uct_backup</code>
:* Then <code>move to</code> the <code>trash bin</code>. Click on the <code>all</code> box.
:* Type <code>exit</code>.
:* This removes the measurement from the micro-CT database and prevents future confusion.
:<i>Option 2: Delete a restored RSQ (i.e., a good measurement was restored from backup tape)</I>
:* Confirm that the RSQ is stored on tape (<code>read_meas</code>).
:*Delete the file manually (i.e., <code>del SOME.RSQ</code>).


===HowTo: Archive a project===

:* Do this once MODELS has been created.
:* In the project directory, type <code>bltp</code> to remind yourself how to use the command.
:* Choose an appropriate name for the SAV name. It must be 13 characters max, and must not be the same name as another sav file on the backup tape.
:* Type: <code>bltp HERZOG HERZOG_NORMAL BE0002</code> (project name, SAV name, tape label).
:* If <i>only</I> backing up the MODELS directory, type: <code>bltp HERZOG.MODELS HERZOG_NORMAL BE0002</code>
:*Creates a BCK directory and puts the SAV (equivalent to a tar) filename in that directory.
:*Use <code>quick mail</code> in the busy terminal to notify myself when the backup is complete.
:*Type to dismount the tape once done: <code>dismount tp0</code>
:*This command does not delete anything from the disk. That is up to you to decide. 
::-Usually the AIM GFILT data should be deleted to save space, but keep the thresholded AIMs as they are much smaller files.


===How To: Restore a project===

:* Insert the backup tape into the drive.
:* Check what SAV name (in the project BCK directory) includes the files that you want to restore.
:* Type: <code>blud HERZOG_NORMAL</code> or <code>blud MICH_BAT01</code> to restore that SAV batch.
:* Restored files are automatically put into their original directories.