---

10    Performing a Worldwide Update Installation

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 of worldwide support does the following:

1. Checks the current system status and saves system files.

2. Deletes Digital UNIX Version 4.0 or 4.0A worldwide support subsets.

3. 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.

4. Installs worldwide support subsets and merges the saved system files.

---

10.2    Preparing for the Worldwide Update Installation

• 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

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

---

10.5    If You Encounter Problems During the Update Installation 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

---

10.7    Running wwinstallupdate from CD-ROM Media

1. Make sure that you backed up your system and that your system has sufficient disk space to perform an update installation.

2. 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.

3. Mount the local file systems:

   # /sbin/bcheckrc

4. 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.

5. 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.

6. 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

7. Invoke the wwinstallupdate script to perform an update installation of worldwide support software:

   # /mnt/ALPHA/WORLDWIDE/wwinstallupdate /mnt

8. 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

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.

1. Ensure that you backed up your system and that your system has sufficient disk space for an update installation.

2. 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.

3. 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.

4. Mount the local file systems:

   # /sbin/bcheckrc

5. 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

6. Mount the NFS server's mount point:

   # mount nfs_server:/oskit /mnt

7. Enter the following command to invoke the wwinstallupdate script:

   # /mnt/ALPHA/WORLDWIDE/wwinstallupdate /mnt

8. 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 (:).

---

10.9    What Happens During the Worldwide Update Installation

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 :

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