This section describes the things you must know and do before upgrading.
Upgrades to, or upgrades from, Early Access Program (EAP) software releases of SGD are not supported. EAP software releases must always be a fresh installation.
The supported upgrade paths to this version of SGD are listed in the Oracle Secure Global Desktop 4.6 Platform Support and Release Notes available at http://docs.sun.com/app/docs/doc/821-1928.
If you want to upgrade from any other version of SGD contact Oracle Support.
If you are sure you want to perform an unsupported upgrade, you must create an empty file /opt/tarantella/var/UPGRADE before installing the new version of the software. Your SGD installation might not be upgraded correctly.
When you upgrade on Solaris Operating System (Solaris OS) platforms, the pkgadd command performs several checks and asks you to confirm the changes before installing the package. You can create an administration file that instructs pkgadd to bypass these checks and install the package without user confirmation.
To avoid user interaction, the administration file must contain the following lines:
When you upgrade SGD, use the pkgadd -a adminfile command to specify the administration file.
If you do not specify an administration file when you upgrade, the SGD installation program creates one for you and gives you the option to quit the installation so that you can run the pkgadd command again with the -a adminfile option.
When you upgrade, the following changes are applied to your existing configuration:
Your existing Enterprise Naming System (ENS) database is preserved and backed up.
The ENS database is the storage area for all the objects in your SGD organizational hierarchy.
The /opt/tarantella/var/ens directory is backed up to the /opt/tarantella/var/ens.oldversion directory.
The backup is not changed. The existing ENS database might be changed if changes are needed to enable it work with the new version of SGD.
The SGD server configuration and the SGD global configuration are preserved but not backed up.
This configuration is stored in the /opt/tarantella/var/serverconfig directory.
This configuration is changed only if new properties files need to be added or new attributes need to be added to existing properties.
All the server resources files in the /opt/tarantella/var/serverresources directory are replaced.
These files are not normally edited as they control how SGD works.
Your SGD login scripts are preserved and backed up.
The /opt/tarantella/var/serverresources/expect directory is backed up to /opt/tarantella/var/serverresources/expect.oldversion.
Your customized SGD files are backed up but they are not upgraded.
You can customize SGD by changing the files found in a standard installation, for example webtop themes, or by adding your own files, for example login scripts.
You have to upgrade these files manually.
When you install the new version of SGD, the installation program warns you if files exist that might need to be upgraded manually. See Upgrading a Customized SGD Installation for advice on how to upgrade these files.
Following an upgrade, if you want to use audio for X applications you must also upgrade the SGD Enhancement Module on your UNIX or Linux platform application servers. See How to Upgrade the SGD Enhancement Module for UNIX and Linux Platforms for upgrade instructions.
UNIX audio services might not work correctly if the versions of SGD and SGD Enhancement Module are different.