3    Installation Notes

The notes in this chapter discuss the following topics:

Do not attempt to install the operating system without first reading the notes in this chapter and in Chapter 4 that are appropriate to your processor. Failure to read these notes can result in installation problems. Also, before you start your installation process, be sure to review the hardware documentation that came with your system.

3.1    General Information About Installation

The following notes apply to the installation process in general.

3.1.1    Disk Space Requirements

The minimum disk size requirement for single-disk installations is now 1 GB. It is possible to perform single-disk installations on disks with less than 1 GB of disk space, however, performance may be degraded and it is not recommended. If you attempt a single-disk installation on a disk smaller than 1 GB, you will receive a warning message.

Although the minimum disk space for installing the operating system is a 1 GB disk, we recommend that systems have at least two 2 GB disks to ensure sufficient disk space for swap, patches, and storage.

For more information about disk space requirements, see Appendix A, which lists the size requirements for each subset.

3.1.2    Firmware Revision

The proper firmware for your system is included on the Alpha Systems Firmware Update CD-ROM that came with your kit. The Release Notes Overview included with the firmware CD-ROM provides all the information you need to install the proper firmware.

Alternatively, you can obtain this information from the Internet by using the following URL with a web browser:

http://ftp.digital.com/pub/Digital/Alpha/firmware/readme.html You can also obtain this information from the Internet by using the following address to access the firmware using FTP: 

ftp.digital.com/pub/Digital/Alpha/firmware

On most systems, you can determine the current level of the firmware entering the following command: 

# consvar -v -l | grep "Firmware Rev"

If this command is not supported on your system, you can use the following command: 

# uerf | grep "Firmware revision:" | tail -1

3.1.2.1    HSZ Firmware Requirements

The following list provides the minimum firmware requirements for HSZ controllers:

You cannot put the HSZ40A controller on a multi-initiator bus in a cluster or multi-initiator from the same host. You must put these controllers on a bus with a single-host adapter. If you need to put them on a shared bus, you can upgrade them to HSZ40B, HSZ40C, or HSZ50 controllers and then put them on a shared SCSI bus.

3.1.3    Install Hangs If Disk Has Disk Label Generated by Linux

Do not attempt to install Tru64 UNIX Version 5.1A onto a disk that has a disk label written by a Linux system.

3.1.4    Nonconfigured Subsets and the setld Menu Restriction

The setld -D command manages software in an alternate root directory. You can use this feature to install software onto a disk and then move the disk to a different system. When you use the -D option, the software is loaded onto the disk; however, it is not configured. The software is configured later by using setld -c command.

If you use the setld -D command, name the subsets to load on the setld command line. Do not use the interactive software selection menu provided with setld to choose the subsets. If you use the software selection menu to choose the subsets, failures similar to the following can occur: 

5 OSFJAVADEV510 Java 1.1.8-7 Development Environment
cannot be installed as one of the required subsets is not available.
PLEASE BEGIN YOUR SELECTIONS AGAIN.

3.1.5    Reloading Subsets with setld

Some layered product subsets check when they are installed to see if the subsets are already on the system. If they are, they prevent you from reinstalling them. This introduces an error into the software management database after which the setld -i command reports that the subset is not installed, even though all of its files are present on the system.

To avoid this problem, use the setld -d command to delete a subset before using the setld -l command to reinstall it.

If you accidentally have the situation where you want to delete a subset but you cannot, you can correct the problem by using the touch command and then the setld -d command. For example, if the situation occurred with the DFARTL388 subset, you would do the following: 

# touch /usr/.smdb./DFARTL388.lk
# setld -d DFARTL388
 

Afterwards, you can reinstall the subset using the setld -l command.

3.1.6    IMAP and POP

In order to use the Internet Message Access Protocol (IMAP) and Post Office Protocol (POP) servers after performing an update installation or installing the OSFINET (Additional Networking Services) subset, you need to do the following:

  1. Make sure that the /etc/passwd file (local, yp, or NIS) contains entries for the IMAP and POP users. If it does not, create them. For example: 

    pop:*:13:6:POP Mail Service Account:/:
imap:*:14:6:IMAP Mail Service Account:/:

    Substitute the values 13 and 14 with a user ID that is appropriate for your system. For more information, see passwd(4). Also, substitute the value 6 with the group ID of the mail group on your system; see group(4).

  2. Enter the following command as root so that the IMAP and POP files and directories have the correct permission, owner, and group: 

    # setld -c OSFINET500 MAILSERVERSETUP

3.1.7    Initial sendmail Warning Message

The first time you boot the system after a full installation, the following warning message is displayed as a result of starting sendmail: 

warning: local host name (hostname) is not qualified;
fix $j in config file.

This indicates that the system does not have a qualified name because neither DNS (BIND) nor mail has been configured. However, sendmail will continue to operate.

3.1.8    The autopush Message Displayed During Boot

The following message is displayed on the console while booting: 

/usr/sbin/autopush: Can't push requested modules on STREAM for entry 39
/usr/sbin/autopush: Device (6,-1) already configured

You can ignore this message.

3.1.9    I/O Error Message

After the installation process has completed installing all of the requested subsets, you might see the following benign error message: 

I/O error (errno 5) for block ( xxx , xxx ) on device xxx , x

You can ignore this message. The installation will complete successfully.

3.1.10    Ignore the error writing output file Message

During the installation of software subsets, ignore the error writing output file message. The error is harmless.

3.1.11    Persistent Reservation Errors

Under certain circumstances, you can encounter persistent reservation errors. If this problem occurs, see Appendix B.

3.2    Layered Product Considerations

The following notes apply to layered products for Tru64 UNIX.

3.2.1    Mounting the Associated Products CD-ROM

You can mount the Associated Products CD-ROMs (APCDs) with the mount command on Tru64 UNIX systems running Version 4.0E or higher, as follows: 

# mount -r /dev/disk/cdrom0c /mnt

On releases prior to Version 4.0E, you must mount the APCDs with the following options: 

# mount -r -t cdfs -o rrip /dev/rz4c /mnt

On versions prior to Version 4.0D, you might receive the following error message, indicating that compact disc file system (CDFS) support is not built in to the kernel that is currently running: 

# mount -r -t cdfs -o rrip /dev/rz4c /mnt
/dev/rz4c on /mnt: No valid filesystem exists on this partition

If you receive this error, you need to build your kernel with the following option: 

ISO 9660 Compact Disc File System (CDFS)

3.3    Full Installation

To perform a full installation on your system, see the instructions in the Installation Guide.

3.4    Update Installation

Version 5.1A supports update installations from Versions 5.0A and Version 5.1.

To update your operating system software to Version 5.1A, you must use the installupdate utility or the full installation procedure as described in the Installation Guide.

The -i flag for the installupdate command will be retired in a future version of the operating system. See Section 2.2.8 for more information.

The installupdate procedure checks to see if there is enough space on the disk you have selected to do the installation. If there are any conflicts, the installupdate procedure enables you to remove unecessary files to create space. For more information, see the Installation Guide.

The following sections apply to the update installation procedure.

3.4.1    Update Installation of UFS File System on LSM Volumes Will Fail

Due to a problem setting the FSTYPE of LSM volumes on Version 4.0 systems, systems with UFS file systems on LSM volumes might experience problems during the update installation process when booting Version 5.0 and higher. If the /usr or /var file system is an encapsulated LSM volume, then the system will not come up to multiuser mode. Two workarounds exist for this problem, depending on whether you determine if there are any LSM volumes containing UFS file systems on your system before or after performing an update installation process.

To determine if any of the LSM volumes on your system contain UFS file systems, run the following command: 

# mount -t ufs | grep /dev/vol/
 
 

If you determine prior to the update installation that one or more LSM volumes contain UFS file systems, run the following command to work around the problem: 

# voledit set fstype=4.2BSD UFSVOLUMES
 
 

The UFSVOLUMES variable is the list of LSM volumes containing UFS file systems. For example, suppose the mount -t ufs | grep /dev/vol/ command returns the following information: 

# mount -t ufs | grep /dev/vol/
/dev/vol/rootdg/rootvol on / type ufs (rw)
/dev/vol/rootdg/vol-rz8g on /usr type ufs (rw)
/dev/vol/rootdg/vol-rz8h on /var type ufs (rw)
/dev/vol/rootdg/vol-rz9c on /mnt type ufs (rw)

You would issue the following voledit command: 

# voledit set fstype=4.2BSD rootvol vol-rz8g vol-rz8h vol-rz9c
 
 

If you cannot determine prior to the update installation that one or more LSM volumes contain UFS file systems, or if you have already performed the update installation, do the following:

  1. Boot the system to single-user mode, as follows: 

    >>> boot -fl s

  2. Mount the root directory as read/write: 

    # mount -u /

  3. Restart LSM: 

    # vold -k

  4. Manually set the volume file system types (fstype): 

    # voledit set fstype=4.2BSD UFSVOLUMES
 
 

    The UFSVOLUMES variable is the list of LSM volumes containing UFS file systems.

  5. Either continue to bring the system up to multiuser mode or reboot the system as normal.

3.4.2    Update Installation Might Exit While Removing the System V Environment (SVE)

If the update installation procedure detects that the System V Environment (SVE) product is installed on the system, it asks for that product to be removed. If the SVEADM subset is installed, the update installation process terminates while attempting to remove the SVEADM subset. The cause of this is an init command present in the SVEADM subset control program (.scp file).

To avoid this problem, remove the SVEADM subset prior to running the update installation by performing the following steps:

  1. Determine the exact subset name by issuing the following command: 

    # setld -i | grep SVEADM | grep installed

  2. Remove the subset by using the setld -d command and the name of the subset.

3.4.3    Reconfigure Mail After an Update Installation

After performing an update installation on any system running an earlier version of the operating system, you must reconfigure mail by using either /usr/sbin/mailconfig or /usr/sbin/mailsetup. The new sendmail configuration ensures that all mail leaving your system has a fully qualified return address and your mail configuration is cluster-ready.

When you reconfigure mail, you must use the application that was used to create the current sendmail.cf file; otherwise, you will lose your previously saved configuration.

If you use the /usr/sbin/mailsetup program, the following message might be displayed:

An m4 configuration file has been found and it is different from the default produced by mailsetup. Mailsetup does not support a /var/adm/sendmail/sendmail.m4 file which has been modified. Use this file at your own risk. Do you wish to use this file (y/[n]) ?

If you want sendmail to fully qualify the return address when leaving the system, and to be cluster-ready, answer no. If you do not want these features, answer yes.

3.4.5    Restriction to Using the Graphical Update Installation Interface

This release of the operating system contains a restriction that interferes with the ability to use the update installation's graphical user interface (GUI). The restriction only applies if the system you are updating is running Tru64 UNIX Version 5.0A, the system has the Worldwide Language Support (WLS) subsets installed, and you are performing the update from a CD-ROM.

If you use the update installation GUI under these circumstances, the text-based interface will be displayed instead of the GUI.

3.4.6    Additional Disk Space Needed

If your system does not have enough free disk space to complete the update installation, you are presented with a list of three options for recovering disk space.

If you remove software subsets belonging to the Operating System (OSF) or Worldwide Language Support (WLS) products to recover disk space, the update installation process must recalculate the disk space amount listed in the Total Needed category. Allow the update to continue so it can recalculate the disk space based upon the currently installed software subsets.

3.5    RIS Installation

This following notes pertain to Remote Installation Services (RIS).

3.5.1    Time Zone Restriction

New time zones were added in Version 5.1 of the operating system. Therefore, servers that might have indicated the US-Eastern time zone while running an earlier version of the operating system now indicate a time zone such as America-New York.

When you install a prior version of the operating system on a client from a RIS server running Version 5.1 or higher, the prior version of the operating system does not recognize the time zone and does not automatically set the time zone during the installation procedure. This occurs because the new time zones do not match those in the prior versions. Therefore, you must set the time zone manually after the installation.

3.5.2    Serving the Worldwide Language Support Product from a RIS Server

You cannot extract the Worldwide Language Support (WLS) product into a RIS area. Therefore, if you need to serve WLS to your RIS clients, create a symlink for this product into the RIS area. For more information on this procedure, see the Sharing Software on a Local Area Network manual.

3.5.3    Future Location of Unsupported Kernel Object Subsets

The following kernel object subsets will be moved to the Tru64 UNIX Retired product directory on the Associated Products CD-ROM in a future release of the operating system.

OSFBINOBJECT520 Main kernel objects
OSFHWBINOBJECT520 Hardware kernel objects
OSFADVFSOBJECT520 AdvFS kernel objects
OSFLSMOBJECT520 LSM kernel objects
OSFATMOBJECT520 ATM kernel objects

3.6    Dataless Server Installation

The following note pertains to Dataless Server installations.

3.6.1    Restriction Using TruCluster Server

TruCluster Server Version 5.0A or higher does not support Dataless Management Services (DMS).