Top
ETERNUS SF Express V15.3/ Storage Cruiser V15.3/ AdvancedCopy Manager V15.3 Migration Guide
ETERNUS

7.4.2 Upgrading clustered systems

The section describes the upgrade of clustered systems.

Note

If Cluster Unsetup is executed after upgrading from Version 15.0B to this version, the cluster resources and scripts created by the old version's commands starting with "stgclset" will not be deleted.


7.4.2.1 Preparing for the upgrade

The operational environment must be prepared prior to upgrading the AdvancedCopy Manager's agent, as described below.

  1. Check that Managed Server transactions are stopped on the secondary node.

    If not stopped, stop them on the secondary node.
    If multiple Managed Server transactions exist, perform this procedure on each secondary node for Managed Server transactions.

  2. Stop the Managed Server transaction on the primary node.

    Stop the Managed Server transactions by referring to the relevant cluster software manuals.
    However, the shared disk for shared data of Managed Server transactions must be mounted.
    If multiple Managed Server transactions exist, perform this procedure on each primary node for Managed Server transaction.

  3. Execute the following command to stop the local transactions on all the nodes.

    # /opt/swstorage/bin/stopacm
  4. Back up the environment and data.

    • On the primary and secondary nodes, back up the operating system.

    • On the primary node, back up the shared disk for shared data of Managed Server transactions.

    • If multiple Managed Server transactions exist, back up the shared disk for shared data of Managed Server transactions on each the primary node for Managed Server transactions.

    Point

    If a failure occurs during the upgrade, you cannot restore the environment to the pre-installation status (rollback). Therefore, it is recommended to back up the following before performing the upgrade.

    • Operating system

    • Shared disk for shared data of Managed Server transactions

    If a failure occurs during the upgrade and you want to restore the environment to the pre-installation status, restore the system from the backup.

7.4.2.2 Performing the upgrade (Primary node)

The following describes the upgrade procedure for the primary node.

  1. Log in to the server as a superuser.

  2. Insert the DVD-ROM "ETERNUS SF SC/ACM/Express Mediapack (Agent Program and Manual)" for this version into the DVD-ROM drive and mount the DVD-ROM.

  3. Mount the DVD-ROM.

    • Example for Solaris:

      # mount -F hsfs -o ro /dev/dsk/c0t4d0s0 dvdromMountPoint

      The device name for the DVD-ROM drive may be different for your particular device. In this example, the device name of the DVD-ROM drive is mounted as /dev/dsk/c0t4d0s0.

    • Example for RHEL5/RHEL6 and SUSE Linux Enterprise Server 11:

      # mount /dev/cdrom dvdromMountPoint

      The device name for the DVD-ROM drive may be different for your particular device. In this example, the device name of the DVD-ROM drive is mounted as /dev/cdrom.

  4. Install the AdvancedCopy Manager's agent.

    Execute the following commands to install the AdvancedCopy Manager's agent.

    # cd environmentDir
    # ./swsetup

    The environmentDir is as follows:

    OS type

    Directory

    Solaris

    dvdromMountPoint/Agent_unix/AdvancedCopy_Manager/Solaris

    Red Hat Enterprise Linux 5 (for x86)

    dvdromMountPoint/Agent_unix/AdvancedCopy_Manager/rhel5_x86

    Red Hat Enterprise Linux 5 (for Intel64), using the Symfoware linkage function

    Red Hat Enterprise Linux 5 (for Intel64), not using the Symfoware linkage function

    dvdromMountPoint/Agent_unix/AdvancedCopy_Manager/rhel5_x64

    Red Hat Enterprise Linux 6 (for x86)
    Red Hat Enterprise Linux 6 (for Intel64)

    dvdromMountPoint/Agent_unix/AdvancedCopy_Manager/rhel6_x86

    SUSE Linux Enterprise Server 11 for x86
    SUSE Linux Enterprise Server 11 for EM64T

    dvdromMountPoint/Agent_unix/AdvancedCopy_Manager/sles11_x86

  5. The installation information is displayed.

    swsetup: Installer is preparing for installation...
    
    +-----------------------------------------------------------+
    |              ETERNUS SF AdvancedCopy Manager              |
    |                           15.3                            |
    |                  Copyright FUJITSU LIMITED 2012-2013      |
    +-----------------------------------------------------------+
    
    
    Welcome to Setup.
    This program will install "AdvancedCopy Manager" on your system.
    
    
    Agent setup...
  6. A confirmation message will be displayed before uninstalling the previous version. To uninstall the previous version and proceed with the new installation, enter "y". To cancel the installation, enter "q". Press Enter.

    An old version is installed in this system.
    Do you want to upgrade ? [y,q]:
  7. If "y" was entered for step 6, the upgrade will continue.

    If the upgrade completes successfully, the following message is displayed.

    swsetup: AdvancedCopy Manager was installed successfully.
  8. Execute the following commands, and then eject the DVD-ROM:

    # cd /
    # umount <DVD-ROM mount point>

Point

If the upgrade was terminated abnormally, refer to "Corrective actions to be taken when any error occurs in version upgrade from 15.x (for Solaris, Linux)" in the Software Release Guide, recover the system to the normal status.

7.4.2.3 Tasks to be performed after the upgrade (Primary node)

When the upgrade has been completed, the tasks below need to be performed:

  1. When the AdvancedCopy Manager's agent upgrade has been completed for the primary node, perform the following procedure:

    If multiple Managed Server transactions exist, perform this procedure on each primary node for Managed Server transaction.

    Edit the following environment setting files for Managed Server transaction on the shared disk for shared data:

    • <Mount point of shared disk for shared data of Managed Server transaction>/etc/opt/swstorage/clsetup.ini

    • <Mount point of shared disk for shared data of Managed Server transaction>/etc/opt/swstorage/swstg.ini

    Change the version information within each file, as follows:

    Upgrade patterns

    Descriptive contents of the version information

    Before

    After

    Version 15.0B to 15.3

    Version=V15.0

    Version=V15.3

    Version 15.1 to 15.3

    Version=V15.1

    Version 15.2 to 15.3

    Version=V15.2

    Note

    Do not change anything other than the version information.

  2. For the ETERNUS SF Manager Version 15.0B installed environment, perform the following procedure.

    Edit the line starting with "System=" in /opt/FJSVswstf/cluster/swcluster.ini as follows:

    System=GEN

    Note

    Do not change anything other than the line starting with "System=".

7.4.2.4 Performing the upgrade (Secondary node)

Perform the upgrade for the secondary node.

The upgrade procedure is the same as that for the primary node. Refer to "7.4.2.2 Performing the upgrade (Primary node)".

7.4.2.5 Tasks to be performed after the upgrade (Secondary node)

For the ETERNUS SF Manager Version 15.0B installed environment, perform the following procedure.

Edit the line starting with "System=" in /opt/FJSVswstf/cluster/swcluster.ini as follows:

System=GEN

Note

Do not change anything other than the line starting with "System=".

7.4.2.6 Starting the Managed Server transactions

After the upgrade, perform the following procedure:

  1. Start the Managed Server transactions on the primary node.

    Refer to the relevant cluster software manuals to start the Managed Server transactions.
    If multiple Managed Server transactions exist, perform this procedure for each Managed Server transaction.

  2. Perform the following command to start the local transactions on all the nodes.

    # /opt/swstorage/bin/startacm
  3. Change the server information for Managed Server transactions.

    To ensure data consistency, execute the stgxfwcmmodsrv command to change the server information.
    When executing the stgxfwcmmodsrv command, specify the Managed Server name for the -n option.
    This command should be performed on the Management Server.
    If multiple Managed Server transactions exist, perform this procedure for each Managed Server transaction.

    In addition, if there is any node that is running local transactions, perform this procedure on the relevant node.

    Note

    For changing the server information, start a new window for command execution, and then perform the procedure on the window.

    See

    Refer to "stgxfwcmmodsrv (Server information change command)" in the ETERNUS SF AdvancedCopy Manager Operation Guide relevant to the OS of the Management Server for information on the command.

  4. Reload the server information using the Web Console.

    See

    Refer to "Reload the server configuration information" in the ETERNUS SF Web Console Guide for this version for information on reloading server information.