Upgrading To Solaris 10

This document describes the installation and configuration of Solaris 10 hosts at ECN.

Dumping Existing Filesystems

It may be necessary to save off certain parts of an existing host's filesystem(s). Save anything unique to that machine such as:

• Home partitions (/export/home/a, /export/home/b, etc.)
• Mailboxes (/var/mail)

Also, check to see if there is software unique to the machine, or local file storage. Places to check include:

• /opt for packages not rdisted,
• /var for paths not rdisted,
• And especially, /var/local

A sample command to save and restore files of a home partition to a scratch space on Shop440 would be:

ufsdump 0f - /export/home/a | \
gzip | \
ssh username@shop440 'cat >/export/home/b/scratch/hostname.dump.gz'

cd /export/home/a
ssh username@shop440 -n 'cat /export/home/b/scratch/hostname.dump.gz' | \
gunzip | \
ufsrestore rf -

Stop Backups

If backup services are enabled on the host, be sure to inform the backup staff of the operating system change. Have them stop backups, perhaps doing a full backup before upgrading.

Updating Igor

Update igor settings. In particular, made the following changes to a host:

If APACHE is set, remove the definition and replace it with LEGACY_REDIRECT, a simple redirector script. The value needs to be a comma-separated set of colon-separated values. For most cases, this will be something like:

@define LEGACY_REDIRECT "80:-"

Which means to redirect port 80 to the legacy web server with no entity. A more complicated value is Pasture's 80:-,14010:GraSim, which redirects port 80 to the new server, plus port 14010 to an entity named "GraSim".

Comment out the definition USECACHEFS. CacheFS is not used on Solaris 10.

Comment out the definition CONDOR. Condor does not have a working model for Solaris 10.

If the host is a home server, sharing filesystems in /etc/dfs/dfstab, be sure to add filesystem shares to /usr/share/adm/config/os/SunOS/5.10/dfstab.

Updating rdist

Update rdist settings for the host by removing it from the SUN_OS59 variable, and placing it in the matching SUN_OS510 variable.

If this is the first machine at a site for an OS rdist type (for example, the first Solaris 10 machine), the harbor:/var/rdist/lib/masters.txt file must be updated to add an rdist master for that OS type at that site (it is not enough to update the appropriate "site" file in harbor:/var/rdist/hosts.)

Save Files

Update the system's "solsave" files.

On the host, as root, do the following command:

/usr/local/etc/ecn/savefiles.sh

Then, on Harbor, as root, do the following command:

~solsave/bin/savefiles.cron

Check that the file updated by checking the date on the file ~solsave/hostname.tar.gz.

Ethers

Add the host's MAC address to /etc/ethers. Use the /usr/sbin/ifconfig -a command to get MAC addresses.

/var/local/install_10/clients

Create the boot files for the host. Go to the directory /var/local/install_10/clients, then do the following two commands:

./make-files hostname arch
./make-prep hostname

The value for "arch" will normally be sun4u, unless the host is a Sun with the UltraSPARC T1 processor, then use sun4v.

Double check the partitioning layout for the new boot disk by examining the hostname/config file. For standalone systems, the layout will be:

filesys rootdisk.s0 8192 /
filesys rootdisk.s1 2048 swap
filesys rootdisk.s4 free /var

For homeservers, the layout will be:

filesys rootdisk.s0 8192 /
filesys rootdisk.s1 2048 swap
filesys rootdisk.s4 2048 /var
filesys rootdisk.s7 free /export/home/a

Layouts may have to change more depending on the size of the root disk. A minimum of 15GB root disk will be required for Solaris 10.

Other Examples

Jumpstart with disk mirror (such as replicant). Replicant has four disks. The first two will be mirrored. The second two will be mirrored.

metadb c0t0d0s7 size 8192 count 2
metadb c0t1d0s7 size 8192 count 2
metadb c0t2d0s7 size 8192 count 2
metadb c0t3d0s7 size 8192 count 2
filesys mirror:d0 c0t1d0s0 c0t0d0s0 8192 /
filesys mirror:d1 c0t1d0s1 c0t0d0s1 2048 swap
filesys mirror:d4 c0t1d0s4 c0t0d0s4 free /var
filesys mirror:d20 c0t3d0s6 c0t2d0s6 free /var/local/data

On Charlotte, we are using hardware raid control on the first two disks, but we want to have space available for use by MetaDB later when we add or replace the disks two and three. I used this:

metadb c1t0d0s7 size 8192 count 2
metadb c1t2d0s7 size 8192 count 2
filesys c1t0d0s0 8192 /
filesys c1t0d0s1 2048 swap
filesys c1t0d0s4 free /var
filesys c1t2d0s6 free /web

ACMaint

Fix the host in ACMaint. A special set of system accounts will be needed in order to work with Solaris 10.

Before upgrading the system, do the following "ah" commands:

modify host hostname state d
sol10fix hostname
purge queue hostname

Here is the source code to "sol10fix"

Upgrade

Do the upgrade. Stop the host and boot with the following command:

boot net - install

The system should boot and install, then reboot. The system will install packages for about 1 hour, then reboot. After the second reboot, continue with the following post installation fixes.

Be sure to wait! There "should" be mail that goes to the software queue that says when the system is rebooting the second time. Once the second reboot is complete (watch the CSW for errors), then proceed.

ACMaint

After the upgrade is complete, update all of the accounts on the host by pushing out an ACMaint "build password files" command:

purge queue hostname
buildPasswdFiles hostname
modify host hostname state u

Be sure to wait for changes to complete! Watch the log file at /var/adm/log/transd_log. All ACMaint packets must go through before proceeding to the next step.

Igor

Igor files were installed as part of the installation. Now redistribute the igor files from Harbor. On Harbor, create an rdist file that looks like this:

(
/usr/share/adm/config
/usr/share/adm/igor
) -> (
hostname.ecn.purdue.edu
)
install -R;
except_pat(/RCS\$);

And execute the command:

/usr/local/etc/rdist -M8 -t45 -onumchkowner,numchkgroup -f rdistfile

Patches

Process all patches by running the following commands:

# cd /package/patches/pca
# ./pcheck -l

If the -l (list) shows patches, then install them with:

# ./pcheck -i

If asked to reboot, reboot. Repeat this process of listing and installing until there are no more patches listed.

Start Backups

If backup services were stopped above, be sure to inform the backup staff to restart backups and do a full backup. Be sure to indicate any filesystem changes made during the upgrade.

Set monitor

If the host has a monitor and will be running X Windows, it may need to have the monitor resolution set. As an example, on the SunBlade 2500 with the 23" monitor, try setting:

/usr/lib/fbconfig/SUNWjfb_config -res 1920x1200x60

Remove Tombs

If the system was a migration of Solaris 8 or Solaris 9, and was a HOMESERVER, then there will be left over Tomb directories. From the top of every filesystem (such as /export/home/a), erase the Tomb directory. Otherwise, these directories will be wasting space.