Solaris 7 Sun Hardware Platform Guide

Preserving Local Modifications

During an upgrade, the suninstall utility attempts to preserve local modifications to the server whenever possible; however, local modifications might make an upgrade fail or perform differently than you would expect.


Caution - Caution -

AP 2.0 and 2.1 are not supported by Solaris 7. If you have either version of AP on the domain, you must deconfigure the software and remove the packages before you perform the upgrade.


The following table includes tasks you should perform before you upgrade the domain.

Table 6-7 Upgrading Tasks

What to Do Before Upgrading 

How to 

Why 

Preserve symbolic links 

Replace symbolic links that use absolute paths with symbolic links that use relative paths.  

 

For example, if /usr/openwin is a symbolic link to

 

/export/openwin

 

change the symbolic link to 

 

../export/openwin

 

During an upgrade, the suninstall utility cannot reference symbolic links that use absolute paths because the Solaris installation program mounts the root (/) file system at /a. For example, a symbolic link to /export/openwin would fail because during an upgrade, /export/openwin is really /a/export/openwin.

 

When the suninstall utility cannot reference a symbolic link, it will overwrite the symbolic link and install the software (the installation program doesn't think the software exists). As a result, duplicate software will be installed, and the upgrade may fail because of insufficient disk space.

Preserve symbolic links to automounted file systems 

Remove packages (by using Software Manager or the pkgrm(1M) command) that will create files or directories currently automounted.

 

 

The automounter is not active during an upgrade, so the suninstall utility installs any package's files or directories that are symbolic links to automounted file systems. If a symbolic link is overwritten, the upgrade may fail because of insufficient disk space.

 

(If you cannot remove a package, you can replace the symbolic link after the upgrade is completed.) 

 

Note: The /var/mail and /var/news directories, which usually reside on an automounted file system, are not affected by an upgrade.

Prevent unneeded file systems from being mounted 

In the /etc/vfstab file, comment out file systems that you do not want mounted during the upgrade.

During an upgrade, the suninstall utility attempts to mount all of the file systems listed in the /etc/vfstab file on the root file system being upgraded. If the Solaris installation program cannot mount a file system, it reports the failure and exits.