Adding an Unwired Server Node to a Cluster

Perform a fresh Unwired Server installation using the Unwired Platform version 2.1 installer, then upgrade using the Unwired Platform version 2.1 ESD #3 script.

  1. Make sure you have the information required to connect the new node to the existing cluster:
    • License file or path to license server for cluster
    • UNC path to the file system that houses the cluster's data tier database files
    • Windows account under which existing nodes in cluster have been installed
    • Information that Unwired Server needs to connect to the cluster's data tier
      • Name of data tier host

        If the data tier is installed in a failover cluster, enter the network name of the cluster resource that acts as a "virtual host" for the data tier services.

      • For each configurable database in the data tier:
        • Database name
        • Port number
        • Login
        • Password
    • (Optional) To configure Unwired Platform communication ports, the port numbers to be used for server administration, data change notification, messaging, and replication
    • Password for supAdmin user for the cluster
  2. Confirm that the installation target system meets all the requirements for Unwired Platform version 2.1 ESD #3.
    See Supported Hardware and Software.
  3. Verify that you have Administrator privileges on the installation target host.
  4. If the JAVA_TOOL_OPTIONS environment variable is set, remove it before you start Unwired Platform installation.
    Check for the JAVA_TOOL_OPTIONS environment variable in both User variables and System variables panes of the Environment Variables dialog.
    1. Right-click My Computer and select Properties.
    2. Select the Advanced tab, then click Environment Variables.
    3. Select JAVA_TOOL_OPTIONS and click Delete.
    4. Click OK to exit all dialogs.
  5. Shut down all Sybase software, Sybase processes, and associated third-party processes running on the installation target host. This includes any database servers, Sybase Control Center, and if Sybase SAP® DOE Connector is present in an upgrade installation, SAP Data Orchestration Engine. To verify that services are stopped, open the Services panel from Windows Control Panel.
  6. Start the Sybase Unwired Platform Runtime installer using one of these methods:
    • Insert the Sybase Unwired Platform Runtime installation media.
    • Install from a Web download. Extract all the archive files to the same temporary directory on a local disk, not a shared drive.
    • Install from an image on the network. You must access the installation image from a mapped drive, not a UNC path.
    Browse to the location of the setup.exe file, and:
    • On Windows 7 and Windows Server 2008 R2, right-click the setup.exe file and select Run as Administrator.
    • On other, earlier supported versions of Windows, double-click the setup.exe file.
  7. On the installer welcome page, click Next.
  8. On the end-user license agreement page, select your country, accept the terms of the license agreement and click Next.
  9. On the license details page, select your license product edition and license type.
    (Enterprise Server edition only) Enter the number of client licenses.

    Click Next.

  10. Enter the location of your license file.
    • If you selected Unserved (local) license, enter the absolute path to the license file on the installation target host, using only ASCII characters
    • If you selected Served (remote) license, enter the host name and TCP port of the license server.
    Click Next.

    If you get an error, such as Failed to check out license, click OK, then click Back to confirm the license model (served or unserved), license product edition, and license type.

  11. Specify the absolute path to the installation location, which must reside in a local drive on the target host.

    The total length of the path must be 43 characters or less.

    Directory names in the path can contain only:
    • ASCII alphanumeric characters
    • Underscore ( _ ) or hyphen ( - ) characters
  12. On the installation option page, select Unwired Platform Runtime and click Next.
  13. On the installation type page, select Cluster and click Next.
  14. On the cluster installation step page, select Install an additional server node and connect it to the data tier and click Next.
  15. If a page appears, indicating that the installer detected missing third-party software, click:
    • Next to install the required software.
    • Back to select components to install that do not require the third-party software.
    • Cancel to stop the current installation.
  16. On the additional installation options panel:
    • (Optional) Select Configure Unwired Platform communication ports to change default ports.
    • De select Set Sybase Unwired Platform services to start automatically to start services automatically when Windows starts.

      If you set Unwired Platform services to start automatically, the new Unwired Server node may fail to sync with the cluster.

    • (Optional) Select Set Sybase Unwired Server name to specify a name other than the server name designated in the file system.

  17. Enter cluster configuration information that the installer needs to access the data tier.
    1. Enter the Unwired Platform cluster configuration password.
      The cluster configuration password is specified when the data tier is installed.
    2. Enter the UNC path to the file system that houses the data tier database files.

      The UNC path must use a fully qualified host name or network name (name.domain). For example, if the data tier node is installed in C:\Sybase, the data folder is C:\Sybase\UnwiredPlatform\Data. If the machine is named SUPDT, the UNC path to the data folder is \\SUPDT.example.com\Data.

      Note: If the data tier is installed in a failover cluster, the UNC path must point to the Network Name resource associated with either a file share resource group or a Client Access Point.
  18. (Optional) If you selected Set Sybase Unwired Server name, enter a name for this Unwired Server instance. The name must be unique on the network segment.
  19. Enter information for the Windows account under which Unwired Server services will run.
    The user ID (account name) must:
    • Be a Windows domain user ID, preceded by a Windows domain.
    • Be a member of the local Administrator's group on the installation target host.
    • Have read/write access to the file system that houses the data tier database files.
    Note: You must enter identical Windows account information for each node in the Unwired Server cluster.
  20. Enter information that Unwired Server needs to connect to the data tier.
    1. Enter the name of the data tier host.
    2. Enter the following for each configurable database listed:
      • Database Name
      • Port Number
      • Login
      • Password

      In a typical new installation, you need not change any pre-populated value, just enter "sql" as the default password for each database.

      In an upgrade installation, if the password fields are filled, do not change them. If they are not filled, enter the current the password for each database.

  21. (Optional) If you selected Configure Unwired Platform communication ports, change the default port numbers as needed.
    • General ports:
      • Server administration
      • Data change notification
    • Synchronization ports:
      • Messaging
      • Replication
  22. Enter the password for the supAdmin user and click Next.
    The password must:
    • Be at least 8 characters.
    • Contain only ASCII alphanumeric characters.
  23. On the summary information page, verify the installation features and click Install.
  24. (Optional) Click View Release Bulletin.
  25. Click Finish.
  26. Verify that Unwired Platform services are shut down before proceeding.
  27. Run the installebf.bat script for the Unwired Platform version 2.1 ESD #3 upgrade.
    1. Extract the patch archive file to a temporary location.
    2. Logging in with administrator privileges, Open a Windows Command Prompt (cmd.exe)—on Windows 2008 R2, right-click the menu item and select Run as Administrator—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 though you specified that services for the server are to be manually started.
    6. Before proceeding, verify that the upgraded server is started.
  28. Verify that you can start the following services manually. Open the Services panel from Windows Control Panel verify that services are started:
    • Sybase Control Center
    • Sybase Unwired SampleDB (not applicable to Enterprise Server Edition)
    • Sybase Unwired Server
  29. From Windows, select Start > (All) Programs > Sybase > Sybase Control Center to log in to Sybase Control Center.
  30. Verify that you can connect to the Unwired Server you just installed.
  31. Verify that you can connect to the data tier.
  32. Verify that you can connect to all the Unwired Server instances you have previously installed.
Parent topic: Release Bulletin 2.1 ESD #3