Known Issues with Installing, Uninstalling, and Upgrading

Learn about known runtime installation, uninstallation, and upgrade issues and workarounds.

Issue #Description
N/A
When running the 2.2 SP02 upgrade from the command prompt window, ensure the path to which you upgrade contains an uppercase drive letter. For example: C:\Sybase\UnwiredPlatform.
RTC-360
Backing up the Sybase Unwired Platform Runtime installation fails because the Sybase Control Center path is too long.

Explanation: The path to the Embedded Web Container in the SCC-3_2 folder is too long for Windows to process.

Workaround: Before backing up the Sybase Unwired Platform Runtime installation, you must delete the contents of SUP_HOME\services\EmbeddedWebContainer\container\Jetty-6.1.22\work. You must delete the contents of this folder from the command prompt, and not from Windows Explorer.

RTC-359
Upgrade cannot proceed because GWC.war cannot be deployed.

When running the 2.1.3, 2.2 SP01 PL00 or 2.2 SP01 PL01 upgrade from a command prompt window with a path that has a lowercase drive letter, the update may produce an error that indicates that it was unable to undeploy GWC.war. This only affects the listed updates with the specific circumstance where the drive letter is lowercase.

Workaround: To recover, perform the following steps:
  1. Open a command prompt window with administrator privileges.
  2. Change directories to the SUP_HOME\Servers\UnwiredServer\bin, where SUP_HOME is the install location for Sybase Unwired Platform, typically C:\SAP\MobilePlatform. Make sure to specify the drive letter in uppercase. This is required.
  3. Undeploy GWC with the following command:

    undeploy.bat webapp-gwc

  4. If there are no errors, delete SUP_HOME\Servers\UnwiredServer\deploy\webapps\gwc, if it exists, with the following command:

    rmdir /S /QSUP_HOME\Servers\UnwiredServer\deploy\webapps\gwc

  5. Deploy the new GWC with the following command:

    deploy.bat SUP_HOME\Servers\UnwiredServer\temp\GWC.war

  6. Undeploy notifications with the following command:

    undeploy.bat webapp-notifications

  7. If there are no errors, delete SUP_HOME\Servers\UnwiredServer\deploy\webapps\notifications, if it exists, with the following command:

    rmdir /S /Q SUP_HOME\Servers\UnwiredServer\deploy\webapps\notifications

  8. Deploy the new notifications WAR file with the following command:

    deploy.bat SUP_HOME\Servers\UnwiredServer\temp\notifications.war

RTC-310
Client synchronization fails after upgrade and server log contains an error code 3000.

Explanation: During the Unwired Server runtime upgrade, it is possible for a package to transition into the disabled state if errors are found during the procedure. Errors can be caused by an unavailable EIS, for example. These errors are not logged during the upgrade.

Workaround: Manually verify all packages, after installation, in Sybase Control Center. If no other errors are found, enable the MBO package referenced by the client application Sybase Control Center.

If other errors are found, a more serious problem is usually the root cause and it may be necessary to contact Technical Support to resolve the root problem. In that case, Sybase does not recommend ignoring the reported errors and enabling the package.

RTC-303
Sybase Unwired Platform Messaging Server not successfully updated.

The following error may occur when upgrading Sybase Unwired Platform 2.2 to Sybase Unwired Platform 2.2 SP02.

Sybase Messaging Server was NOT successfully updated. Value 0x0 not found in Install Success registry entry.  

You can also find the following error in the system event log:

Database version check failed. Database version 'nnnnn' doesn't match expected version 'NNNNN'. This may be caused by an upgrade failure. Until this issue is fixed, the services will not start. 

Workaround: In most cases, the failure occurs due to issues in CDB connectivity. Re-running the messaging server installer as follows will fix the issue in most cases. 

If performing a cluster installation, run these steps in the primary node or the first Application Service Node to which the upgrade was applied: 
  1. Stop the Sybase Unwired Server services on all cluster nodes. 
  2. Start only the Sybase Unwired Server CacheDB service. 
  3. From a Windows command window, navigate to the location where the support pack install files are extracted. 
  4. Navigate to the MessagingServer subfolder.
  5. Run "setup.exe finishdbupdates=true" and wait for the setup to finish. 
  6. Start the Sybase Unwired Server service using the desktop shortcut. 
RTC-267
Upgrade process hangs when calling start-unwired-services.bat

The upgrade process hangs after upgrading the first server node if all nodes were not shut down before the upgrade.

Workaround: Online upgrade is not supported. You must stop all the Sybase Unwired Platform services, including the data tier, before running the upgrade installer.

RTC-263
Test package deployment is skipped when upgrading Unwired Server from 2.1.x to 2.2.

The Runtime installer requires the supAdmin user to exist in order for an upgrade installation to complete normally. If you removed the supAdmin user, the installer cannot perform the test package deployment that verifies that the upgraded Unwired Server is functioning properly. The installer displays this message:

 The Unwired Platform admin login information
        provided were not valid. Upgrade was completed but test deploying a package to server for
        verification was skipped.   

Workaround: Ignore the message. You can perform a manual package deployment if you wish to be sure that the upgraded server is function properly. See Creating new users in SQL Anywhere Server - Database Administration, available at http://infocenter.sybase.com/help/topic/com.sybase.help.sqlanywhere.12.0.0/dbadmin/umannew.html.

RTC-157
Error messages when adding a secondary node to a cluster.
In a cluster installation that involves Sybase Unwired Platform 2.2, if you add a new secondary node to the cluster using the Sybase Unwired Platform 2.2 installer after any of the existing Sybase Unwired Platform application server nodes have been upgraded to a patch level (for example Sybase Unwired Platform 2.2 SP02), the installation may report the following failure:
Sybase Messaging Server installation completed with errors.
**Error!!! Error!!!**
The Messaging installer completed with the following errors. These errors will have to be addressed before the services become functional.
Please refer to documentation for recovery process.
Database upgrade failed

Additionally, you can see the following message in the SUP_HOME\Servers\MessagingServer\Bin\Scripts\DBUpgraderTrace_xxxxxxxx.txt file.

-- Upgrade started at 11/6/2012 4:28:31 PM
Downgrading is not supported
-- Caught unexpected exception: Downgrading is not supported
Got global error [Downgrading is not supported]

This error occurs because the installer incorrectly tries to upgrade the database when it should not.

Workaround: If you see this error when adding a new secondary node, you can ignore it, and proceed with applying the patch. By running the patch installation (for example Sybase Unwired Platform 2.2 SP02), you can complete the installation.

RTC-34
Warning messages when installing secondary Unwired Server node.
When installing a secondary Unwired Server node before the primary server successfully installs, you see a warning similar to this in the server log:
2012-08-21 01:26:15.753 WARN MMS ScheduledTask:SynchronizeNode...

Workaround: Ignore this warning, or install the secondary Unwired Server node after the primary server installation completes.

CR-692901
Requirements for using SAP® JCO 3 on Windows XP.

SAP JCO 3 in Unwired WorkSpace running on Windows XP requires Microsoft Visual C++ 2005 Service Pack 1 Redistributable.

Note: This is not a requirement for Windows 7, or 64-bit Windows Server 2008 system.

Workaround: Obtain the Microsoft Visual C++ 2005 Service Pack 1 Redistributable from: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=14431.

CR-665409
The installation program cannot run in graphical mode.
If the HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags registry key contains an entry that is the path of the installer binary (for example, C:\setup.exe), you see this error, and the installation fails:
The installer is unable to run in graphical mode. Try running the installer with the 
-console or -silent flag.

Workaround: Remove the installer binary path from the HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags registry key.

CR-590885
Uninstaller might not run on Windows Vista.

Sometimes, the uninstaller does not launch on Windows Vista. This may be caused by the operating system changing the launch command for the Unwired Platform uninstaller, preventing it from using its own JVM to start itself.

Workaround: Launch the uninstaller:

<jdk_installdir>\java -Dtemp.dir=%TEMP% -jar C:\Sybase\UnwiredPlatform\Uninstallers\UnwiredPlatform\uninstall.jar

When you uninstall or cancel out of uninstalling Unwired Platform, the Program Compatibility Assistant shows:

This program might not have uninstalled correctly.

Select This program uninstalled correctly instead of Uninstall with recommended settings.