When you choose an upgrade, the utsetup script automatically preserves your existing configuration information. You must preserve your existing configuration before running the utsetup script only in the following situations:
You are upgrading the operating system on an existing Sun Ray server that requires you to reformat the server's disk.
You are replacing an existing Sun Ray server hardware with a new server.
You are upgrading the Oracle Linux operating system on the Sun Ray server as part of the Sun Ray Software upgrade.
In all of these cases, you will need to add the
/var/tmp/SUNWut.upgrade/preserve_
backup file to the newly installed server before you start the utsetup
program. The utsetup program automatically restores the configuration
data in the
version.tar.gz/var/tmp/SUNWut.upgrade/preserve_
after it installs the Sun Ray Software. version.tar.gz
The utpreserve script in the Sun Ray Software image directory preserves the following information:
X user settings
Sun Ray data store
Authentication Manager configuration files
utslaunch properties
Failover group information
Kiosk mode configuration
Group name used by the Windows connector
The utpreserve script does not preserve the following information:
The Sun Ray server's network and DHCP configuration settings (utadm configuration information). You must reconfigure those settings after upgrading the Sun Ray Server Software.
The /etc/pam.conf is not saved. You
need to back up and restore this file manually.
Depending on the size of your configuration, this procedure, including the operating system software upgrade, might take anywhere from five minutes to several hours or even more to complete.
Running the utpreserve script stops all Sun Ray daemons and services, including the Sun Ray data store, causing users to lose all of their sessions, both active and disconnected. Make sure to inform them of your plans.
Change directory to the downloaded media pack directory.
Preserve the Sun Ray configuration:
# ./utpreserve
The utpreserve script warns that it will stop all Sun Ray services, consequently terminating all user sessions, and asks whether it should continue.
If you answer y, the
utpreserve script:
Stops the Sun Ray services and the Sun Ray data store daemon.
Lists the files that are saved.
Tars and compresses the entire list of files as the
/var/tmp/SUNWut.upgrade/preserve_
file, where version.tar.gzversion is the
currently installed version of Sun Ray Software.
Indicates that a log file containing notices of errors is available at
/var/adm/log/utpreserve.
year_month_date_hour:minute:second.log
where year,
month, and so on are
represented by numeric values reflecting the time
utpreserve was started.
Recommends that the
/var/tmp/SUNWut.upgrade/preserve_
file be moved to a safe location. version.tar.gz
If you have modified the /etc/pam.conf
in a previous version of Sun Ray Software, your changes
might be lost when Sun Ray Software is upgraded. To avoid
losing your modifications, be sure to save a copy before
performing the update, then use the saved copy to restore
your earlier modifications.