This chapter describes how to update a system running Worldwide Language Support (WLS) software to the latest version of the WLS software.
Refer to Chapter 2 for information about performing an update installation of the base operating system.
An update installation means you are updating a system that is running the previous version of the operating system with WLS software to the current version of the operating system. 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 the operating system.
An update installation of worldwide support does the following:
Checks the current system status and saves system files.
Deletes the WLS subsets for the previous version of the operating system.
Invokes the base system update installation command,
/sbin/installupdate
to update the base system from the previous version of the operating system
to the new version of the operating system.
Installs worldwide support subsets and merges the saved system files.
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 Operating System Volume 1 CD-ROM. During the worldwide update installation, you will be prompted to insert this CD-ROM into the drive. Also make sure you have the Associated Products Volume 1 CD-ROM, which contains the WLS software subsets for the new version of the operating system.
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 base operating system kit available on the RIS or NFS server.
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
You should 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 base operating system and the worldwide support that previously was installed
on your system before you attempt another update installation.
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 halted.
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.
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 operating system software to your system
before attempting another update installation.
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
Load the Associated Products Volume 1 CD-ROM into the CD-ROM drive. Refer to Appendix B if necessary.
If you do not know the system device name of your CD-ROM drive, log
in as
root
or use the
su
command to gain
root
privileges, and enter the following command:
#file /dev/rrz*c | grep RRD/dev/rrz4c: character special (8/4098) SCSI #0 RRD44 disk #32 (SCSI ID #4)
In
this example, the CD-ROM device is
RRD44
on device
/dev/rz4c.
If you have more than one
RRD
device connected to your
system, determine the device where you will mount the CD-ROM.
Note
You must have
rootprivileges to get this information with thefilecommand.
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.
In this
example, the displayed device name is
/dev/rrz4c, but you will
use
/dev/rz4c.
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 Operating System Volume 1 CD-ROM 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 12.8.
Go to Section 12.9 to continue the worldwide update installation.
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 -c2nfs_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 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 12.9 to continue 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) []:
One of the following takes place, depending upon your response:
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 this version of the operating system 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.
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.