Chapter 8 - Updating BACKUP.UNET

Use the instructions in this chapter to apply upgrades/updates to your existing BACKUP.UNET system. Updates are generated periodically to fix bugs and/or to add features.

Installing the Update

Note: It is possible to run BACKUP.UNET hosts with different versions of the software.

When you update BACKUP.UNET on your network, the activation code and serial number are sent to each BACKUP.UNET host that has daemons up and running. If any BACKUP.UNET host's daemons are down when you perform the update on the initial host, you may have to install the activation code and serial number on that host manually.

The update process automatically checks the database for the presence of the activation code and serial number. If they are not present, you are prompted to enter them. If they are present, the update process continues automatically.

Note: You must run the update even on systems that have NFS-mounted binaries.

Updating the BACKUP.UNET

Note: If you are updating BACKUP.UNET on a host that imports or exports NFS file systems, see NFS Environment Requirements before proceeding further.

Create a temporary directory to prepare for unloading the BACKUP.UNET update software.
You need this temporary directory only for the duration of the update process, but the directory requires 20 to 30 Mbytes of disk space, so check your file system to determine where you should create the directory. (You also need an additional 20 to 30 Mbytes for the installation software.)
To create the temporary unload directory in the system temporary directory ('/tmp'), at the system prompt, enter:
```
mkdir /tmp/nbk.unload
```
To access the new directory, at the next system prompt, enter:
```
cd /tmp/nbk.unload
```
At the system prompt, become a superuser.
Unload the BACKUP.UNET update software from the distribution media to the temporary unload directory you created in step 1, using the UNIX tar or cpio command.

Note: Your unload device must be a rewind on close device. Check the label on the installation media for the correct format, prior to inserting it into the drive. To begin, enter one of the following commands: For cpio format, enter:
```
cpio -icvduBm < /dev/st0
```
For tar format, enter:
```
tar xvpf /dev/st0
```
Note: st0 represents the device from which you are unloading the software. Your device name may be different.
To begin the update program, change to the temporary unload directory and, at the system prompt, enter the following command:
```
./nbkupdate
```
The update program shows the following information:
```
# ./nbkupdate

MTI Technologies Product Update Procedure
=====================================
Beginning update of BACKUP.UNET x.x.x for Sun 4, SunOS 
4.1.2
This output is being logged to the file "./
update.log.X".
```
Note: x.x.x represents the BACKUP.UNET version number.
If the machine type (for example, Sun 4) or operating system level (for example, 4.1.2) is not compatible with what is listed, abort the installation process by pressing the <Ctrl><c> key combination or the equivalent interrupt key sequence on your system. Contact MTI Customer Service if you have any questions.
You are prompted to update either from an input file (the same file used by the installation procedure) or interactively:
```
If you want to drive the update process from an input 
file, enter the name of the input file now. If you 
want to do an interactive update, press <RETURN>:
```
Either enter the name of the input file, or press <Return>.
As the BACKUP.UNET update continues, the program provides you with a prompt for each step of the update procedure:
```
Do you want to update the BACKUP.UNET man pages? (y/n)
```
Enter to select to update the BACKUP.UNET man pages. Otherwise, enter .
You are prompted for the directory which will contain the BACKUP.UNET man pages:
```
Enter the fully-qualified directory path where the 
BACKUP.UNET man pages are kept, or press <RETURN> to 
accept the default of <man-dir>.
```
Either enter the fully-qualified directory path into which to keep the BACKUP.UNET man pages, or accept the default directory.
The display shows the prompt:
```
Enter name of system to update software on
```
Enter the name of the system (hostname) on which you are updating BACKUP.UNET.

Note: If you do not know the hostname, abort the update procedure (using the appropriate interrupt key sequence for your system), and enter the UNIX hostname (or equivalent) command. Then restart the update procedure. You are prompted for the name of the binary directory:
```
Enter the fully-qualified directory path where the 
BACKUP.UNET executables are kept.
```
Enter the full path name of the directory that contains the BACKUP.UNET executable programs, such as '/usr/local/BACKUP.UNET/bin'.
You are prompted for the name of the home directory:
```
Enter the BACKUP.UNET home directory path on host 
<hostname>.
```

Enter the full path name of the directory that contains the BACKUP.UNET configuration database, online catalog, and log file, such as '/usr/local/BACKUP.UNET/NBK'.

Figure 8-1 below shows the processing messages generated during the update process:

Figure 8.1


Copying initial binaries and commands to /usr/local/UNET/bin
Checking activation code
*** Activation Codes + Serial Number are OK ***

Attempting to bring down running daemon(s)
BRP accepts request for shutdown on completion
IOP accepts request for shutdown on completion

Attempt successful, installation continuing
Copying BACKUP.UNET binaries to /usr/local/UNET/bin
Updating files to BACKUP.UNET home directory /usr/local/UNET/bin
Activation Key:
Serial Number:
Duration:
Maximum Systems:
Updating network:
              .
              .
              .
Done

Starting daemon(s)
Start brp
Start iop
Update complete
%

The display shows the Update complete message as the update process finishes. BACKUP.UNET is now ready for use.

Chapter 8 - Updating BACKUP.UNET

Table of Contents

Installing the Update

Updating the BACKUP.UNET