Upgrading a Microsoft Cluster

A Microsoft cluster consists of two data tier nodes and multiple Unwired Server nodes, with failover between data tier nodes managed by Microsoft Cluster Service, also called Failover Clustering.

  1. Shut down the nodes in this order:
    1. Secondary Unwired Servers – shut down these services in this order:
      1. Sybase Unwired Server
      2. Sybase Control Center
      3. Sybase Unwired SampleDB (not applicable to Enterprise Edition)
    2. Primary Unwired Servers – shut down these services in this order:
      1. Sybase Unwired Server
      2. Sybase Control Center
      3. Sybase Unwired SampleDB (not applicable to Enterprise Edition)
  2. On the active data tier node, launch the MS Cluster Administrator and make sure the following active Unwired Platform resources are offline:
    • Advantage Database Server service
    • Afaria Database Service (available with Unwired Platform version 1.5.2 or earlier)
    • Sybase Unwired CacheDB service
    • Sybase Unwired ClusterDB service (available with Unwired Platform version 2.0 or later new installations)
    • Sybase Unwired LogDataDB service (available with Unwired Platform version 2.0 or later new installations)
  3. Install the upgrade on the active data tier node:
    1. Extract the patch archive file to a temporary location.
    2. Logging in with administrator privileges, open a Windows Command Prompt (cmd.exe) and change to the folder where you extracted the upgrade files.
    3. Run installebf.bat.

      The script runs an initial validation check on the files extracted from the upgrade package. If files are corrupted, delete the corrupted archive and download another copy of the upgrade package.

      If the script detects environment issues, you see an error message and the upgrade process stops. Follow the instructions provided and restart the upgrade. If you cannot correct the issue, contact Sybase Technical Support.

      The script does not detect locked files in the installation directory tree. The error message that appears when the script encounters locked files varies.

      If the installer stops with an unexpected error message, look for locked files in the installation directory tree. Unlock any locked files you find and re-run the upgrade script.

    4. Press Y, then Enter to install the upgrade.
    5. When the upgrade finishes, review the text on your screen for error messages.
      On successful completion of the upgrade, the services for the upgraded server are started, even if you have specified that services for the server are to be manually started.
      Note: After upgrading the data tier, the first Unwired Server may take as long as an hour to restart.
    6. Before proceeding, verify that the upgraded server is started.
  4. Validate the upgrade on this node by bringing the stopped Microsoft cluster resources online and ensuring they are restarted.
  5. Make the passive node active and ensure all database services are offline.
    1. Launch Microsoft Cluster Administrator.
    2. Fail over the active node to the passive node.
      The node that was passive is now active.
  6. Install the upgrade on the new active data tier node:
    1. Extract the patch archive file to a temporary location.
    2. Logging in with administrator privileges, open a Windows Command Prompt (cmd.exe) and change to the folder where you extracted the upgrade files.
    3. Run installebf.bat.

      The script runs an initial validation check on the files extracted from the upgrade package. If files are corrupted, delete the corrupted archive and download another copy of the upgrade package.

      If the script detects environment issues, you see an error message and the upgrade process stops. Follow the instructions provided and restart the upgrade. If you cannot correct the issue, contact Sybase Technical Support.

      The script does not detect locked files in the installation directory tree. The error message that appears when the script encounters locked files varies.

      If the installer stops with an unexpected error message, look for locked files in the installation directory tree. Unlock any locked files you find and re-run the upgrade script.

    4. Press Y, then Enter to install the upgrade.
    5. When the upgrade finishes, review the text on your screen for error messages.
      On successful completion of the upgrade, the services for the upgraded server are started, even if you have specified that services for the server are to be manually started.
      Note: After upgrading the data tier, the first Unwired Server may take as long as an hour to restart.
    6. Before proceeding, verify that the upgraded server is started.
  7. Install the upgrade on the Unwired Server nodes, in this sequence:
    • Primary Unwired Server – shut down services in this order:
      1. Sybase Unwired Server
      2. Sybase Control Center
      3. Sybase Unwired SampleDB (not applicable to Enterprise Server Edition)
    • Secondary Unwired Servers – shut down same services in same order as for the primary Unwired Server.
    Note: Do not begin upgrading any secondary servers until the primary server has completely restarted all its services after being upgraded.
    1. Extract the patch archive file to a temporary location.
    2. Logging in with Administrator privileges, open a Windows Command Prompt (cmd.exe) and change to the folder where you extracted the upgrade files.
    3. Run installebf.bat.

      The script runs an initial validation check on the files extracted from the upgrade package. If files are corrupted, delete the corrupted archive and download another package.

      If the script detects environment issues, you see an error message and the upgrade process stops. Follow the instructions provided and restart the upgrade. If you cannot correct the issue, contact Sybase Technical Support.

      The script does not detect locked files in the installation directory tree. The error message that appears when the script encounters locked files is unpredictable.

      If the installer stops with an unexpected error message, look for locked files in the installation directory tree. Unlock any locked files you find and re-run the upgrade script.

    4. Press Y, then Enter to install the upgrade.
    5. Enter the Windows service account name and password.
    6. When the upgrade finishes, review the text on your screen for error messages.
      On successful completion of the upgrade, the services for the upgraded server are started, even if you have specified that services for the server are to be manually started.
      Note: After upgrading the data tier, the first Unwired Server may take as long as an hour to restart.
    7. Before proceeding, verify that the upgraded server is started.