C H A P T E R 4 |
Preparing to Upgrade Sun Ray Server Software |
This chapter describes the preparations for upgrading from earlier versions of Sun Ray Server Software.
Topics in this chapter include:
You can upgrade your current Sun Ray Server Software if you have purchased a new Sun Ray Server Software 4.1 Right-to-Use license or have a Sun Ray Server Software service contract that entitles you to upgrades.
To upgrade from the earlier versions of Sun Ray Server Software, first determine whether you need to upgrade your operating system release, and perform the operating environment upgrade if necessary. See Upgrading the Operating System.
The following table summarizes your upgrade requirements.
1. Preserve the configuration. Upgrading from previous releases of Sun Ray Server Software requires you to preserve the existing Sun Ray configuration manually. See Preserving Configuration Data. |
2. Run utadm -l and note the configuration for all existing Sun Ray subnetworks, then run utadm -r to unconfigure all active Sun Ray interfaces and remove all Sun Ray entries from the configuration data store. |
3. Upgrade the operating system. See Upgrade the Operating System. |
4. Upgrade Sun Ray Server Software. See Upgrading the Sun Ray Server. |
Note - It is not necessary to uninstall the current Sun Ray Server Software to perform the upgrade if you are not upgrading the operating system release. |
By configuring two or more Sun Ray servers in a failover group, you can reduce interruption of new service availability in the event that one server fails. If you plan to combine existing Sun Ray servers into a failover group, or to upgrade an existing failover group, please consider the following:
Tip - If it is not convenient to upgrade all servers in a large configuration at once, upgrade one or two servers at a time until the entire configuration is complete. |
Note - Even if you upgrade one or two servers per week, you must wait until all servers in the group are upgraded before you update their firmware. |
Note - See Configure the Sun Ray Server Hierarchy for instructions and Chapter 11 in the Sun Ray Server Software 4.1 Administrator’s Guide for a more general discussion of failover groups, including diagrams of failover topologies. |
Disconnect the Sun Ray Server From the Interconnect |
Caution - This procedure disconnects users from their sessions on the Sun Ray server. Make sure your users terminate their sessions before you continue. |
1. As superuser, open a shell window on the Sun Ray server.
2. Disconnect the Sun Ray server from the Sun Ray interconnect:
Tip - If you issue the signal <CTRL>C while performing utadm configuration, the Admin GUI may not function correctly the next time you invoke it. To correct this condition, type: dhtadm -R. |
3. Perform one of the following tasks:
You must preserve your existing configuration before running the utinstall script if:
If neither condition applies, go to Upgrading the Sun Ray Server.
The utpreserve script in the Sun Ray Server Software image directory preserves:
Note - The utpreserve script does not save all configuration files, so you must configure the Sun Ray interconnect interface and Sun Ray administration server after upgrading Sun Ray Server Software. |
Preserve the Sun Ray Server Configuration |
If you have already mounted the Sun Ray Server Software 4.1 CD-ROM locally or from a remote server, or if you have extracted the ESD files to an image directory, begin at Step 3.
Depending on the size of your configuration, this procedure, including the operating system software upgrade, may take anywhere from five minutes to several hours or even more to complete.
1. As superuser, open a shell window on the Sun Ray server.
2. Insert the Sun Ray Server Software 4.1 CD-ROM.
If a file manager window opens, close it. It is not necessary for installation.
3. Change to the image directory. For example:
4. Preserve the Sun Ray configuration:
The utpreserve script warns that it will stop all Sun Ray services, consequently terminating all user sessions, and asks if it should continue.
Caution - Answering y terminates all user sessions, both active and disconnected. |
Tip - Be sure to check this log file for errors that are frequently overlooked. |
6. Use NFS, FTP, or other means to copy the /var/tmp/SUNWut.upgrade/preserve_version.tar.gz
file to a safe location on another server.
7. Make a tape backup of the Sun Ray server’s file systems.
To continue using an existing CAM configuration after upgrading to the latest Sun Ray Server Software, you must migrate the old CAM configuration data so that it can be used by the new Sun Ray Kiosk Mode. This requires you to preserve available CAM prototype data manually, as shown below, before upgrading. The data can then be restored once the upgrade is complete. See Migrating from Controlled Access Mode (CAM) to Kiosk Mode.
To preserve CAM prototype data, execute the following commands:
Tip - Copy the file /var/tmp/prototypes.tar to a safe location, such as on another host, before any upgrade. |
To restore CAM prototype data, execute the following commands:
To upgrade Sun Ray Server Software, you must first remove the replication configuration, then unconfigure the Sun Ray server.
Unconfigure Sun Ray Server Software |
1. As superuser, open a shell window on the Sun Ray server.
2. Remove the replication configuration:
3. Unconfigure Sun Ray Server Software:
4. Answer y to all the prompts.
5. Perform one of the following tasks:
Note - The following procedures are not required for installation or upgrade. |
Remove Sun Ray Server Software |
To remove Sun Ray Server Software in its entirety, follow this procedure.
1. Log in as the superuser of the Sun Ray server.
2. Open a shell window and change to the following directory:
3. If you are removing Sun Ray Server Software from a server in a failover group, follow steps a and b. Otherwise, skip to Step 4.
a. Disable Sun Ray DTU firmware downloads:
i. For a private interconnect, use this syntax:
ii. For a LAN configuration, use this syntax:
b. Remove the replication configuration:
4. Remove the Sun Ray network interface(s):
5. Unconfigure the Sun Ray software:
Answer y to all of the prompts.
6. Uninstall Sun Ray Server Software:
Answer y to all of the prompts.
7. Repeat the steps in this subsection for all remaining Sun Ray servers.
Copyright © 2008 Sun Microsystems, Inc. All Rights Reserved.