Symantec logo
Upgrading SF Oracle RAC to 5.0

When you run installsfrac program on cluster systems that currently run SF 4.1 or 4.1 MP1 for Oracle RAC, the program guides you through an upgrade procedure. The example upgrade demonstrates how to upgrade SF 4.1 for Oracle RAC to SF 5.0 for Oracle RAC on nodes galaxy and nebula using installsfrac program.

Upgrade tasks include:

Preparing to upgrade SF Oracle RAC

Perform the following preparatory tasks before upgrading SF Oracle RAC to version 5.0.

 To prepare to upgrade SF Oracle RAC

  1. Log in as superuser to one of the nodes in the cluster and make a backup of the VCS configuration file, main.cf.

    # cp /etc/VRTSvcs/conf/config/main.cf \

    /etc/VRTSvcs/conf/config/main.cf.41

  2. Make sure that the required VxFS or VxVM patches for 5.0 are installed on the systems.

    See Required HP patches

  3. If you are using Oracle9i, stop GSD daemon.

    As oracle user, stop gsd processes on each node.

  4. Take the resources offline.
  5. Stop all applications that use the CFS mounts that are not under VCS control.

    To stop the processes using the CFS mount point, use the application-specific commands.

  6. Unmount Cluster File Systems.

    On each node, unmount any CFS file systems that are not under VCS control.

  7. Make sure VCS is running.
  8. If Oracle service group's autostart property is set in VCS, then remove it. Do one of the following:
Upgrading SF Oracle RAC

Invoke the installsfrac program to upgrade to SF 5.0 for Oracle RAC.

 To upgrade SF Oracle RAC

  1. Mount the software disc.

    See Mounting the product disc

  2. Make sure you performed other pre-installation tasks before you upgrade SF Oracle RAC.

    See Preparing to install SF 5.0 for Oracle RAC

  3. On the node where the disk is mounted, browse to the directory containing the installer program.
  4. Start the product upgrade.

    # ./installsfrac

    After viewing a copyright notice, review the report after the program examines the configuration files and discovers the existing cluster configuration.

  5. To upgrade to SF 5.0 for Oracle RAC, press Enter.

    Do you want to upgrade to version 5.0 on these systems using the current configuration? [y,n,q,?] (y) y

  6. Confirm that you want to continue with the installation at the installer prompt. Note that the installation program will replace any previous version of VxVM that was bundled with HP-UX with VxVM 5.0.
  7. Review the output as the program performs the following:
  8. Confirm that you want to upgrade SF Oracle RAC. Note that the installer will stop all the currently running SF Oracle RAC processes.
  9. Review the output as the installer stops the CVM and CFS agents, and updates the gabtab files on each node in the cluster.
  10. Confirm that you are ready to upgrade SF Oracle RAC. Note that the installation program makes configuration updates and stops the cluster to upgrade the SF Oracle RAC depots.
  11. Review the output as the program does the following:
  12. Review the output as the program stops SF Oracle RAC processes and shuts down SF Oracle RAC on all nodes in the cluster.
  13. Review the output as the program uninstalls the depots from the previous version of SF Oracle RAC.
  14. Review the output as the program installs SF 5.0 for Oracle RAC depots.
  15. Note the location of the summary and log files for future reference.
  16. When the installer prompts you to reboot the nodes before configuring SF Oracle RAC, review the installer output and follow the instructions.

    Execute the /usr/sbin/shutdown -r now command to reboot the nodes.

  17. If VxVM 3.x was previously installed, the default disk group will be set to rootdg during the reboot.

    You can configure the default disk group using the vxdctl defaultdg command. Review the vxdctl(1M) manual page for more information.

Configuring SF Oracle RAC after upgrading to 5.0

After upgrading SF Oracle RAC to version 5.0, you can now choose to use the previous configuration of SF Oracle RAC. Note that, if you want to take advantage of the new features in SF 5.0 for Oracle RAC, you must reconfigure SF Oracle RAC using the configuration program.

 To configure SF Oracle RAC after upgrading to version 5.0

  1. Confirm that the product disc is mounted and that you are logged in as the superuser.
  2. Start the configuration program.

    The program specifies the directory where the logs are created and begins with a copyright message.

  3. Enter the names of the nodes where you want to configure the software.

    Enter the system names separated by spaces on which to configure SFRAC: galaxy nebula

  4. Review the output as the program checks that the local node running the script can communicate with remote nodes and checks whether SF 5.0 for Oracle RAC is installed successfully.
  5. Confirm that you want to use the previous configuration of SF Oracle RAC as the installer prompts.
  6. Review the output as the program checks the system licensing.
  7. Select Configure SFRAC > Configure VCS, CVM, and CFS and confirm at the installer prompt that you want to continue with the configuration.
  8. Review the output as the program stops various SF Oracle RAC processes on each node.
  9. If you want the database administrators (DBAs) to access SF Oracle RAC components, then you must set the required permissions.

    The default settings allows only the superuser to access the /opt/VRTSdbed folder.

    See Setting permissions for database administration

  10. Confirm the fully qualified host names of the nodes in the cluster as the installer prompts you.
  11. Review the output as the installer verifies communication with the nodes in the cluster.
  12. If you want to configure the management console for Storage Foundation, you can do that now.

    See Configuring standalone hosts for Storage Foundation

  13. Review the output as the installer starts the SF Oracle RAC processes.
  14. Review the output as the installer starts the VxVM daemons, unfreezes rge service groups, and brings the service group online.
  15. Note the location of the upgrade log files and summary files.
Performing post-upgrade tasks

After reconfiguring the upgraded SF Oracle RAC, you must perform the following post-upgrade tasks.


  Caution   Failing to set the environment variable IPC_LIB_PATH before relinking SF Oracle RAC libraries to Oracle can result in improper linking.


 To perform post-upgrade tasks

  1. Verify the output of the gabconfig -a command to ensure that SF Oracle RAC is configured correctly.

    See Verifying the SF Oracle RAC configuration

  2. Before you link the SF Oracle RAC libraries to Oracle, set the environment variable IPC_LIB_PATH to the following:
  3. Link the SF Oracle RAC libraries to Oracle.
  4. If you are using Oracle9i, start the GSD daemon.

    As oracle user, start the GSD processes on each node.

  5. Make sure that the installer brought all VCS resources online, except the ones for which AutoStart is set to 0.
  6. Import any VxVM disk groups that are not under VCS control.
  7. Mount any VxFS file systems that are not under VCS control.
  8. Reset the autostart property of the Oracle and any other parallel applications that you removed before upgrading SF 5.0 for Oracle RAC.

    Do one of the following:

  9. Bring the Oracle resources online using the following command:

    # hares -online resource -sys systemname

  10. Verify all VCS groups are now online and the database instances are up and running.