Documentation Issues and Updates for Runtime

Read about updates, corrections, and clarifications to the documentation released with Sybase Unwired Platform Runtime.

CR #Description
732372
Running the Pack Tool Utility

As part of a regular administrative procedure, run the packtool.exe utility to keep the system in the proper running state and to compress the ADS data file (QUEUED_MESSAGES.adm) for increased messaging client performance.

Important: In a clustered environment, you must use the latest version of the packtool.exe utility. Contact Technical Support, or use the utility shipped with Sybase Unwired Platform 2.1 ESD #2 or later.
723144
Corrections to the truststore and keystore file paths are provided.

The file paths for the keystore and truststore previously included in Changing Keystore and Truststore Passwords have been modified to include the Security directory:

  1. The command window location is changed to <UnwiredPlatform_InstallDir>\UnwiredPlatform\Servers\UnwiredServer\Repository\Security.
  2. The commands to change the keystore and truststore passwords are changed to:
    • For the keystore password, use: keytool -storepasswd -new NewPwd -keystore Security\keystore.jks
    • For the truststore password, use: keytool -storepasswd -new NewPwd -truststore Security\truststore.jks
    • For private key entries in keystore, use: keytool -keypasswd -alias Name -new NewPwd -keystore Security\keystore.jks
696989
Changing Unwired Server Host Name

In Changing Unwired Server Host Name in both Troubleshooting and System Administration, step 5 is only required for upgrading from Sybase Unwired Platform 2.0 to Sybase Unwired Platform 2.1 ESD #1.

Workaround: You can disregard this step for upgrades from version 2.1.

696314
Troubleshooting: Exception During Upgrade if EA Server and Sybase Unwired Platform Are Installed on Same Machine

When upgrading, an unhandled exception ('System.MissingMethodException') occurred in JMSBridge.exe [8320] is received.

This only occurs if an EA Server installation and a Sybase Unwired Platform installation coexist on the same machine. If there are different versions of the com.sybase.iiop.net.dll files on the system, it causes the exception.

Workaround: Ensure that your environment path includes only the Sybase Unwired Platform com.sybase.iiop.net.dll assembly, if you have EA Server installed on the same machine:
  1. Use a strings command (using UNIX tools for Windows) to check if SetTrustAllCertificates exists on the assembly file that jmsbridge.exe loaded. From a command prompt, enter: 
    >strings -a com.sybase.iiop.net.dll | grep SetTrustAllCertificates

    The command reports back with SetTrustAllCertificates if it exists within the assembly.

  2. Remove the EAServer installed com.sybase.iiop.net.dll from the global assembly cache (GAC).
695982
Clarification Regarding Default SUP Roles

While five roles are available by default for the 'admin' security configuration, only three roles are necessary for enabling role-based access to administrative and DCN interfaces.

Default roles include:
  • SUP Administrator – The platform administrator for the runtime and mobile artifacts. A required role for the "admin" security configuration. See SUP Administrator and SUP Domain Administrator.
  • SUP Domain Administrator – The administrator assigned to a domain. A required role for the "admin" security configuration. See SUP Administrator and SUP Domain Administrator.
  • SUP DCN User – The administrative user for DCNs. A required role for the "admin" security configuration. This role must be mapped in *every* security configuration assigned to deployed MBO packages that receive DCN requests. See SUP DCN User Role.
  • SUP User, SUP Developer – Sample logical roles that have no impact on administration. Do not map these roles or you may expose administration privileges inadvertently to non-administration users.

Workaround: None.

674889
Apple Push Notification Service (APNS) Works on iPad Devices.
These topics incorrectly state that APNS cannot be used with iPad devices:
  • iOS Provisioning with APNS in System Administration
  • Apple Push Notification Service Configuration in OData SDK Developer Guide