Editing Scanco Administration (section)

===UI Procedures===

====µCT Disk-Utility====
The µCT Disk-Utility Program is used to archive and restore scan data. To start the program type <code>$ uct_backup</code> in a DEC terminal, or use the disk button.

[[File:Uct_backup.jpg|40px]]
*The backup captures both the programs and databases.
*A little helper terminal comes up and gives feedback of every file backed up.
[[File:Uct_backup_pic01.jpg|600px]] 


Two possible ways to use <code>UCT_BACKUP</code>:
:* COPY TO -> this does not update the database.
:* MOVE TO -> this updates the database.

Scenario 1: 
<pre>
1. Use UCT_BACKUP to 'move' the RSQ to 'tape'
2. Use UCT_BACKUP to 'move' the ISQ to 'garbage'
3. Use UCT_BACKUP to 'move' the remainder (AIM/GOBJ) to 'tape'
</pre>
*At operation 3, the measurement directory will be deleted from the measurement disk.  
*The directory will automatically be restored if you restore your data from tape.

Scenario 2:
<pre>
1. Use UCT_BACKUP to 'move' the RSQ to 'tape'
2. Use UCT_BACKUP to 'move' the ISQ to 'garbage'
3. Move all the GOBJ/AIM/etc to a project directory.
4. Generate a .SAV file and put on the IMA tape.
</pre>
*You will have to delete the measurement directories (using UCT_BACKUP if you like). 
*The disadvantage of this scenario is that the image data cannot be restored using UCT_BACKUP.


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

====Raw Data Backup====
*Ideally 1-2 week after scanning.
*RSQ files are backed up onto RAW tapes (see [[Scanco_Administration#Tape_Label_Convention|'''Tape Label Convention''']]).  Put the most recent RAW tape into the tape drive, then press "Mount". 
*Show "Current (with RAW)", use the file filter (Measurement:     ) to search for your files (e.g., CAMOS) and press enter or press "Update List".  
*Select all the files to backup by highlighting them using the left mouse button and ctrl to select individual files or shift to select a range.  
*Highlight RAW, choose "Move To" and "Tape".  Press "Start...".  
*When the backup is complete press "Dismount" to eject the tape. 
*If the tape auto-ejected without pressing "Dismount" then the tape is full (see [[Scanco_Administration#Full_Tape|'''Full Tape''']]).
*If you select multiple files, be sure they all need to be backed up, otherwise you will get an error.
:[[File:Uct_backup_pic04.jpg|500px]]


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

====Image Data Backup====
*Ideally 1-2 months after scanning, after contouring, onsite analysis and copied image data to project disk.

#'''Delete ISQ After Evaluation''' 
#*ISQ files are normally deleted after completing your evaluation since they are very large files and can be reconstructed from the RSQ file. 
#*Show "Current (on Disk)", type the beginning of your sample name (e.g., CAMOS) in the file filter and press enter or press "Update List".
#*Select all the files for which you have completed the evaluation (there will be a + sign next to any scan that has been evaluated).  #*Highlight IMA, choose "Move To" and "Trash".  
#*[[File:Important.JPG|20px]] After you choose the trash symbol, you will now be given the option to select specific file types, choose "Select" and "ISQ".  Press "Start...".
#*Only choose one file type to delete at a time. The wildcard (*) indicate all files other than "ISQ" and "AIM" files.
#*Once you have deleted all of the different file types the directory itself needs to be deleted, which can be done by deleting "all file types"
#:[[File:Uct_backup_pic05.jpg|500px]]
#:<br>
#'''Backup IMAGE Data''' 
#*AIM, GOBJ and other evaluation files are backed up onto IMA tapes (see [[Scanco_Administration#Tape_Label_Convention|'''Tape Label Convention''']]).  
#*Put the most recent IMA tape into the tape drive, then press "Mount". 
#*Show "Current (on Disk)", type in the beginning of your sample names (e.g., CAMOS) in the file filter and press enter or press "Update List". 
#*Select all the files to backup by highlighting them using the left mouse button and ctrl to select individual files or shift to select a range.  
#*Highlight IMA, choose "Move To" and "Tape".  Press "Start...".   
#*When the backup is complete press "Dismount" to eject the tape.  
#*If the tape auto-ejected without pressing "Dismount" then the tape is full (see [[Scanco_Administration#Full_Tape|'''Full Tape''']]).
#:[[File:Uct_backup_pic06.jpg|500px]]


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

====Use 'Script...' button====
Usually, you will start the move/copy by clicking on <code>'Start...'</code> button. The <code>'Script...'</code> button is for advanced users.

*Use of the 'Script...' button will generate a script <code>sys$scratch:archive.com</code>, that you may submit it in batch mode later (e.g. over night) by typing: <pre>$ scanco_submit_command sys$scratch:archive.com/after=23:59</pre>
*In a multi-computer cluster setup, you may want to specify the exact queue name of the computer that has the tape hooked up by giving e.g. <code>/que=sceval_fast</code>.
*Insert a tape, but do NOT mount the tape in the normal program. If necessary: if it's a new tape, [[Scanco_Administration#Initialize_a_New_Tape|'''initialize''']] it as usual. 
*The batch job will be started one minute before midnight in the example above. <code>$ show entry</code> will show you that it is holding until then.
*See <code>$ help submit /after</code> and <code>$ help dcl_tips date_time example</code> for more help on this.
*Sample script file (archive.com) restoring the RSQs of measurements 6452 and 6580:
<pre>
$ MOUNT/FOREIGN TP0:
$ UCT_BACKUP_BATCH
ALL
RAW
COPY
DISK
! Meas: SB_BUIE_EX_CTRL_PH_01 (6452)
MEAS
6452
EXECUTE
! Meas: SB_BUIE_EX_CTRL_PH_01 (6580)
MEAS
6580
EXECUTE
EXIT
$ DISMOUNT TP0:
$ EXIT 
</pre>


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

====Database Backup====

The database (DB) backup should be performed for each user on the system. It should not be performed as user 'calibration' or some derivative. In the case of the XtremeCT2 and XtremeCT cluster, both the 'microct' and 'xtremect2' user accounts must be used to backup their respective DB. 

By performing the DB backup, the warning dialog that appears when logging into the system should go away.  


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

====Operating System (OS) Backup====
If the following error-message appears on the screen then you can click OK to continue your work. 

     MESSAGE: No recent OS Backup found!
     Please perform OS backup (DISK0) in privileged account!
     %RMS-W-FNF file not found.
     CODE: 268534416
     Facility RTL

This message means that no operating system (OS) backup has been performed within the last 6 months. Please perform an OS backup as soon as possible by following the steps below:

1. Make sure there are no scans in progress and that the que is halted from all activity.

2. Log in to the calibration account: Since we have two scanners on the same system, login as either "calib3401" or "calib3309", depending if you need to backup the XtremeCT2 or XtremeCT, respectively. For microCT clusters, (best to do this on SCEVA3) using the username calib5019 and the password (ask Steve for this).

3. Type in the DECterm window:
          $ set proc/priv=bypass
Or Set priviledge to bypass by <code>$ spb</code>
          $ r um:uct_b     Or $ uct_backup

4. You will now see 2 additional buttons on the bottom left that is not seen when logged in as microct user. Push either the button "OS Backup to Disk DK0" or mount the specific OS backup tape and push the "OS Backup to Tape" button.
* A system backup to tape and to DK0 should both be performed. 

5. Check the command line & queue to ensure that the backup is being carried out. If you submit the job as 'batch mode' the backup is submitted to SYS$BACKUP queue and allows you to close the backup program and 'end session' without interrupting a running backup. Check with 'show queue' to see the backup job on the queue.

6. Exit the Backup Program and log out of the calibration account.

After a successful OS backup the message above will not appear for the next six months.

Alternatively a system backup can be completed using the command line, without using the uct_backup program. The instructions from Scanco can be found here. The advantage to this method is that you will be able to name the specific backup save set.

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