Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Upgrade and Migration Guide

Upgrading Through the Wizard

The Upgrade wizard provides a graphical user interface (GUI). Using the wizard increases install time and space requirements. You can start the Upgrade wizard in GUI mode from the command line or from the desktop.

To start the wizard,

- On UNIX, change to the <install_dir>/bin directory and type asupgrade.

- On Windows, double-click the asupgrade icon in the <install_dir>/bin directory.

If the Upgrade checkbox was selected during the Application Server installation process, the Upgrade Wizard screen will automatically display after the installation completes.

From the Upgrade Wizard screen:

ProcedureTo Use the Upgrade Wizard

  1. In the Source Installation Directory field, enter the location of the existing installation from which to import the configuration.

    This installation can be Sun Java System Application Server 7 (formerly Sun ONE Application Server 7) or Sun Java System Application Server 8.x .

  2. In the Target Installation Directory field, enter the location of the Application Server installation to which to transfer the configuration.

    If the upgrade wizard was started from the installation (the Upgrade from Previous Version checkbox was checked during the Application Server installation), the default value for this field will be the directory to which the Application Server software was just installed.

  3. If you are upgrading Sun Java System Application Server 7.1 Enterprise Edition installation with clusters and no security certificates to Sun Java System Application Server 8.1 Enterprise Edition, press the Next button and continue with Upgrading Through the Wizard.

    All other upgrades without certificates continue with Upgrading Through the Wizard. Continue with Step 4 if security certificates need to be transferred.

  4. If the source installation has security certificates that must be transferred, check the Transfer Security Certificates checkbox, press the Next button, and the

    The Transfer Security Certificates screen displays.

  5. From the Transfer Security Certificates screen, press the Add Domain button to add domains with certificates to be transferred.

    The Add Domain dialog displays.

  6. From the Add Domain dialog, select the domain name that contains the security certificates to migrate and enter the appropriate passwords.

  7. Click the OK button when done.

    The Transfer Security Certificates screen will be displayed again.

  8. Repeat Upgrading Through the Wizard and Upgrading Through the Wizard until all the domains that have certificates to be transferred have been added.

  9. After all of the domains that contain certificates to be transferred have been added, press the Next button and

    Continue with Upgrading Through the Wizard or with Upgrading Through the Wizard if cluster configuration information needs to be transferred.

  10. If you are upgrading a Sun Java System Application Server 7.1 Enterprise Edition installation with clusters to Sun Java System Application Server 8.1 Enterprise Edition, the Transfer Cluster Configurations screen will be displayed. Press the Add Cluster button.

    The Select clinstance.conf file dialog box will be displayed. Choose clinstance.conf file and click the Open button. The clinstance.conf file will be added to the list.

  11. Enter the cluster file name, which contains the cluster configuration information to be migrated.

    Repeat this process until all the cluster configuration files that need to be migrated have been added, then press the Next button.

  12. The Upgrade Results screen displays, showing the status of the upgrade operation in the Results field.

  13. Click the Finish button to close the Upgrade Tool when the upgrade process is complete.