Procedure to Restore Files on EPICS Host Computer

09DEC99

P. Sichta

 

Table of Contents

1.0 Introduction

2.0 References

3.0 Procedure

1.0 Introduction

This procedure provides an introduction to file restoration. A file may need to be restored as part of a configuration change backout or to recover files which have been corrupted. Two methods will be described. For most situations the xbp/Netserver utility can be used. An alternate method is to restore files from backup tapes (incremental and full) using the tape drive on the epicsrv computers.

 

 

2.0 References

    1. xbp/Netserver Manuals (Veritas Software Corporation).
    2. Unix man pages for the 'tar' command

 

3.0 Procedure

3.1 xbp :

xbp uses the Netserver system to keep backup copies of all files on the epicsrv computers. This program has an x-window GUI and can restore files over the network. The program is in the /bin directory. Backups are performed each day, shortly after midnight.

To start the program :

epicsrv1% xbp

 

To restore a file :

    1. The program has online help and is fairly intuitive to operate, so only basic directions will be given here.
    2. Use the "File" pull-down to select "Browse backups".
    3. Type in the "Directory to Search".
    4. Type in the "Range of Dates".
    5. Type in a "Filename Filter", if desired.
    6. In the "Files" window, select the file(s) or directory(s) to restore.
    7. If it is desired to initially restore the file to an alternate path, use the "Restore" pull-down to select "Specify Alternate Path...". xbp will create the directory if it does not exist.
    8. Use the "Restore" pull-down to select "Restore selected files and directories". Note that the user performing the restoration must have write-privileges for the target directory.
    9. A new window (xbp_confirm) will appear asking if it is "OK to resore these files?". Poke the "OK" box to continue the restoration. You may first want to select the "Overwrite existing files" box.

      10.  

    10. Use the "Restore" pull-down to select "Report progress of restore...".
    11. A new window (xbp_progress) will appear. Select the most recent log file and poke the "Automatic refresh" box to view progress. The restoration typically takes 5 - 10 minutes. The log file will indicate completion.

 

    1. From Tape:

There are two tapes that are used for backing up the System. The first tape does a full save of the system and is called a Level 0 backup using the ufsdump utility. The second tape does an incremental save(Level 1 backup) of the system namely the things that have changed since the Level 0 backup was done. The Level 1 incremental backups are done at 3AM each day. To restore a file determine which Tape you want to restore the file from. Follow the below steps:

1) Insert Tape

2) Become SU

3) Determine which partition/directory you want to get file from

Tape File# Directory

1 / (root)

2 /usr

3 /var

4 /data

5 /epics

6 /export

7 /opt

4) Determine if you want the file restored in its original directory location or in a different directory location

For the original directory location, cd to the root directory then

Enter ufsrestore ivs n where n is the Tape File #

For a different directory location, cd to the desired directory then

Enter ufsrestore ivms n where n is the Tape File #

This command will restore the file with an inode filename instead of the original filename. This can be useful if you wish to restore the file back to the original directory location without overwriting the existing file.

 

5) cd to the directory where the desired file is then

Enter add desired_filename(you can add more than 1 file)

Enter extract(will ask for volume#, Enter 1)

6) ufsrestore will then ask for what type of mode/protection you want for the restored file; typically answer yes when restoring to the original directory and no when restoring to a different directory.

7) Enter quit to exit program