10 Performing a Worldwide Update Installation

This chapter describes how to update a system running Digital UNIX Version 4.0 or 4.0A worldwide support software to the latest version of the worldwide software.

Refer to Chapter 2 for information about performing an update installation of the Digital UNIX base operating system.

10.1 What Is an Update Installation of Worldwide Support Software?

An update installation means you are updating a system that is running Digital UNIX Version 4.0 or 4.0A with worldwide support software to Digital UNIX Version 4.0B. An update installation preserves disk partitions, file systems, file customizations, your print and network configuration, user accounts, user files, and any other system setup you may have done on a system already running the Digital UNIX operating system.

An update installation of worldwide support does the following:

Checks the current system status and saves system files.
Deletes Digital UNIX Version 4.0 or 4.0A worldwide support subsets.
Invokes the base system update installation command, /sbin/installupdate to update the base system from Digital UNIX Version 4.0 or 4.0A to Digital UNIX Version 4.0B.
Installs worldwide support subsets and merges the saved system files.

10.2 Preparing for the Worldwide Update Installation

Before you begin a worldwide update installation, make sure you have the following:

If you are performing the worldwide update installation from CD-ROM, make sure you have the CD-ROM labeled Digital UNIX V4.0B Operating System Volume 1. During the worldwide update installation, you will be prompted to insert this CD-ROM into the drive. Also make sure you have the CD-ROM labeled Digital UNIX V4.0B Associated Products Volume 1 because that CD-ROM contains the Version 4.0B worldwide support software subsets.
If you are performing the worldwide update installation from a remote installation services (RIS) server or network file system (NFS) server, make sure you have the Digital UNIX Version 4.0B base operating system kit available on the RIS or NFS server.

10.3 System Files Affected in an Update Installation of Worldwide Support

System files that are saved by an update installation of worldwide support subsets have the extension .IOSUPD_sav. Some of these files are merged back to the new system files automatically by the update installation procedure. User intervention is not needed for these merges. However, some system files cannot be merged automatically and must be merged back into the system manually.

The following system files are saved and merged automatically:

/etc/utxd.conf
/sys/conf/SYSTEM_NAME
/var/i18n/sys/config.file
/var/i18n/sys/stanza.loadable

The following system files are saved, but must be merged manually:

Application default files of X11/DECwindows applications

10.4 System Backup

Digital recommends that you back up your operating system before beginning an update installation of worldwide support. If there are any interruptions (including pressing Ctrl/c) after the update installation has started, it is unlikely that the update will complete successfully. Should this happen, restore the original version of the Digital UNIX base system and the worldwide support that was previously installed on your system before you attempt another update installation.

10.5 If You Encounter Problems During the Update Installation of the Base System

If you encounter problems during the update installation of the base system such as file type conflicts or the existence of certain layered products that are not compatible with the new version of the operating system, the update installation of the base system is aborted. In this case, fix any file conflicts and then invoke the installupdate script manually again to continue the update install of the base system.

Do not reboot the machine or switch it to multiuser mode or delete files in /tmp and the /usr/tmp directories. This corrupts the system and the update installation cannot be continued.

10.6 Required Disk Space

Your system needs about 100 MB of free disk space to perform an update installation of worldwide support software. Warning messages are displayed if there is less than 100 MB of free disk space in the /usr/i18n directory. Use the df command to check your current disk usage. If the update installation fails due to insufficient disk space, your system is in an indeterminate state. You must restore the original versions of the Digital UNIX software to your system before attempting another update installation.

10.7 Running wwinstallupdate from CD-ROM Media

Read this section if you are using CD-ROM media to perform an update installation of the worldwide support subsets:

Make sure that you backed up your system and that your system has sufficient disk space to perform an update installation.
Boot to single-user mode or shut down your system as follows:
```
# shutdown +30 Please log out
```
In this example, +30 shuts down the system in thirty minutes and sends the message Please log out to all users. Refer to the shutdown(8) reference page for more information about the shutdown command.
Mount the local file systems:
```
# /sbin/bcheckrc
```
If your CD-ROM drive requires you to put the CD-ROM in a caddy, ensure that the CD-ROM labeled Digital UNIX V4.0B Associated Products Volume 1 is loaded in the caddy and drive as described in Appendix B. Insert the CD-ROM into the CD-ROM drive.
If you do not know the CD-ROM device name, use the file command specifying the raw device to find it. CD-ROM devices are prefixed with the letters RRD. Using the | (pipe) command to filter the output of the file command to the grep command to search for RRD ensures that only your CD-ROM devices are output in the result of the command. Enter a command similar to the following:
```
# file /dev/rrz*c | grep RRD
/dev/rrz4c: character special (8/4098) SCSI #0 RRD44 disk #32 \
(SCSI ID #4)
```
In the previous example, the CD-ROM device is RRD44 on device /dev/rz4c. The backslashes in the previous example indicate line continuations and are not in the actual display. If you have more than one RRD device connected to your system, specify the device where the CD-ROM will be mounted. Standard device names begin with rz for the block special file and rrz for the raw (character) special file. The result of the file command displays the raw device name, but you must specify the block special file when mounting the CD-ROM device.
Mount the CD-ROM device. For example, if your CD-ROM device is device number 4 and you are mounting the CD-ROM on /mnt, enter a command similar to the following:
```
# mkdir /mnt

# mount -rd /dev/rz4c /mnt
```
Invoke the wwinstallupdate script to perform an update installation of worldwide support software:
```
# /mnt/ALPHA/WORLDWIDE/wwinstallupdate /mnt
```
Insert the CD-ROM labeled Digital UNIX V4.0B Operating System Volume 1 into your CD-ROM drive as instructed by the following prompt:
```
Please insert the CD-ROM labeled Digital UNIX 
Operating System Volume 1 into the CD-ROM drive.
Press <Return> to continue....
```
If you do not have the CD-ROM, just press the Return key to continue and you will be prompted to enter a RIS or NFS server name as shown in the last step in Section 10.8.

Go to Section 10.9 to continue the worldwide update installation.

10.8 Running wwinstallupdate from an NFS Server System

Read this section if you are using NFS mounted media to perform an update installation of the worldwide support subsets.

The following steps assume that there is a CD-ROM mounted on an NFS server system nfs_server with mount point /oskits. The /oskits entry is added to the /etc/exports file of the NFS server system for other client systems to mount it for normal or update installations.

Ensure that you backed up your system and that your system has sufficient disk space for an update installation.
Ensure that the network is configured and that your system can communicate with the NFS server. Use the following command to test the network connection to the server:
```
# ping -c2 nfs_server
```
Substitute nfs_server with the host name of your NFS server system.
Boot to single-user mode or shut down your system as shown in the following:
```
# shutdown +30 preparing to update the system
```
In this example, +30 shuts down the system in 30 minutes and sends the message preparing to update the system to all users. Refer to the shutdown(8) reference page for more information about the shutdown command.
Mount the local file systems:
```
# /sbin/bcheckrc
```

Start the network and NFS services:

# /sbin/init.d/inet start

# /sbin/init.d/route start

# /sbin/init.d/gateway start

# /sbin/init.d/nis start

# /sbin/init.d/named start

# /sbin/init.d/nfs start

Mount the NFS server's mount point:
```
# mount nfs_server:/oskit /mnt
```
Enter the following command to invoke the wwinstallupdate script:
```
# /mnt/ALPHA/WORLDWIDE/wwinstallupdate /mnt
```
At the following prompt, enter the mount point of the Digital UNIX Version 4.0B base operating system kit or the RIS server name:
```
Please input local or remote mount point, device name or
RIS server name for the base kit of Digital UNIX
Operating System or press <return> to retry :
```
If you enter a RIS server name in response to the previous prompt, the RIS server name must be appended with a colon (:).

Go to Section 10.9 to continue the worldwide update installation.

10.9 What Happens During the Worldwide Update Installation

After you invoke the wwinstallupdate program, a screen similar to the following is displayed:

Update installation of Worldwide Language Support from
Version 4,0 or later of Digital UNIX

Digital Equipment Corporation recommends that you perform complete
system software backups before proceeding.

Messages of Update Installation of Worldwide Language Support are
recorded in /var/adm/smlogs/wwupdate.log and /var/adm/smlogs/it.log

-----------------------------------------------------------------------

Make sure that you have the base kit of Digital UNIX Operating
System which is either in
- CD-ROM labeled Digital UNIX Operating System Volume 1, or
- Network file system (NFS) server, or
- Remote installation service (RIS) server

-----------------------------------------------------------------------

Press <RETURN> to review message again.
Do you want to continue the update installation? (y/n) []:

If you enter n, the worldwide update installation procedure stops, and your system is in single-user mode at the root system prompt (#).
If you enter y, system files are saved and worldwide support subsets are deleted. Then, the update installation procedure of the base operating system begins. Software subset configuration and the kernel build begin after all base operating system software subsets are updated. Refer to Chapter 2 for more information about the base operating system update installation.

If you invoked the worldwide update installation from CD-ROM, when the update installation of the base system is complete, the following message appears to prompt you to insert the CD-ROM of the worldwide kit into the CD-ROM drive:

Please insert the CD-ROM labeled Digital UNIX Associated
Products Volume 1 into the CD-ROM drive.
Press <Return> to continue.

If the base operating system kit for Digital UNIX Version 4.0B is in a network file system (NFS) server or remote installation service (RIS) server, the following message displays:

Base kit not found or read error.
Please input local or remote mount point, device name or
RIS server name for the base kit of Digital UNIX Operating
System or press <return> to retry :

Enter the mount point of the base kit or the name of the RIS server appended with a colon (:).

Messages from the update installation for worldwide support are recorded in the files /var/adm/smlogs/wwupdate.log and /var/adm/smlogs/it.log.

10.10 Installing Worldwide Subsets and Building the Asian Kernel

The last step in the update installation process is the kernel build. After the kernel build, the worldwide support subsets are installed. Finally, the Asian kernel is built, if necessary, and the system reboots.