Documentation Issues and Updates for Unwired Platform Runtime

See the Sybase Unwired Platform 2.2 SP04 documentation set for any other documentation requirements, which are all applicable to Sybase Unwired Platform 2.2 SP05.

The Changing DBA Passwords for SQLAnywhere Databases in a Single-Node Installation topic in the Sybase Unwired Platform 2.2 SP04 Security Guide incorrectly describes how to change the DBA password. Before you can update the DBA password for the SQLAnywhere database, you must first start the Unwired Server that hosts the database.

Workaround: Before updating any properties, start the Unwired Server (cacheDB service) that hosts the database.

In REST SDK Components - General Description, in the Developer Guide: OData SDK, it should state that Sybase Unwired Platform REST services can be consumed with pure HTTP/HTTPS connectivity, not only HTTPS.

There are changes to steps in Developer Guide: Hybrid Apps. See Using Multiple Hybrid Web Containers on the Same BlackBerry Device.

Disregard the steps referring to SAP Note 1250795 in Creating and Assigning a Security Configuration That Uses SSO2 Tokens in the Security guide. It is a simple demo application that should not be used.

See Enabling MBS Performance Testing with LoadRunner.

Corrected text: That topic includes the BeginOnlineLogin method in Action.cs. An update to this content is that it is better to call BeginOnlineLogin in vuser_init.cs, rather than in Action.cs. A client application should not need to login more than once, even if the Action is to be repeated multiple times during a benchmark run.

Applies to System Administration.

In Developer Guide: REST API Applications > Developing the Application > Accessing a Service through a Proxy URL, we clarified that you can access an OData service or an external non-OData service.

In the Installation Guide for Runtime, step 7 in the Preparing to Upgrade topic states that all services with names that begin with "Sybase Unwired..." should be shut down. You should also shut down the Windows service Advantage Database Server.

In the Developer Guide: REST API Applications, the Rest Services Applications topic has been corrected and revised. See REST Services Applications.

In the Developer Guide: REST API Applications, the Client Libraries topic states that you should not include certain libraries The reason is that Sybase Unwired Platform proxy libraries from the OData SDK and other native Sybase Unwired Platform libraries negatively affect pure REST-based applications.

In iOS, if you use SSL for data synchronization, you must embed the certificate in the application and reference it. To set up end-to-end encryption or HTTP for synchronization with the Mobilink server, see Synchronization Profile. This updated topic should be included in the Developer Guide: iOS Object API Applications.

There is now a note in the System Administration guide about iPhone restrictions for Syncrhonization Server Stream Parameters. See Connection Properties.

There are changes to the sample code in the Creating a Gallery View and Creating Categorized Views topics in the Developer Guide: Hybrid Apps. Change HybridAppDb.getInvocableHybridApps() to HybridAppDb.getInvocableHybridApps(false).

See Using Multiple Hybrid Web Containers on the Same iOS Device.

The security module is configured with the technical user and password. When this is done in the SUP log instead of SUP server using the client user ID and certificate to authenticate, it uses the technical user.

Workaround: Keep the login and password fields blank in the connection pool to the back-end SAP.

See Troubleshoot APNS Notification Errors to learn how to troubleshoot errors that are logged in the Messaging Server APNSProvider module log.

We have included the topic in this release bulletin: see Asynchronous Operation Replay. The topic belongs in Customizing the Application Using the Object API > Initially Starting an Application > Setting Up Callback Handlers.

We have included the topic in this release bulletin: see Enabling Single and Mutual SSL Authentication. The topic belongs in Developing Android Applications > Development Task Flow Using REST SDK (HTTP Channel) after Enabling Network Edge for HTTP.

The first four paragraphs in the Troubleshooting guide No Workflow Message is Sent for Hybrid App DCN failures should read:

no workflow message is sent because no device is found to send the notification

{"id":"dcntest_test_001","success":false,"statusMessage":
"no workflow message is sent because no device is found to send the notification","result":
[{"id":"dcntest_test_data_1","success":true,"statusMessage":""}]}

The other text in the topic is correct.

In the System Administration topic Deploying the Provisioning File, step 1 states that BlackBerry devices use BES push but that is not the case for the provisioning file. BES push is used for other forms of notifications.

The topic does not mention a requirement to configure anonymous access when creating multiple proxy connections.

Whenever you create multiple proxy connections in the connection pool with the same proxy endpoint, set Allow Anonymous Access to True in all of those proxy connections. This configuration ensures that the endpoint is whitelisted only once in the connection pool.

The topic describes three possible values for the push Notification Mode that determines the way in which the notifications are delivered to the device.

• Only native notifications
• Only online/payload push
• Online/payload push with native notification

When selecting the push notification mode, devices registered by the HTTP REST API support only the Only native notifications mode. REST API applications do not have access to the client libraries required to allow them to receive notifications in the other two modes. For this reason, neither the Only online/payload push mode nor the Online/payload push with native notification mode are supported for devices registered by the REST API.

Missing password information for PreconfiguredUserLoginModule

Incorrect Sample Code Example for Start Security Configuration Management API

The code sample for the Start Security Configuration Management API in Developer Guide: Unwired Server Runtime contains an error: serverContext.getSecurityContext should be clusterContext.getSecurityContext.

//Start administration on one of the security configurations
securityContext = serverContext.getSecurityContext("<security configuration name>");
SUPSecurityConfiguration supSecConf = SUPObjectFactory.getSUPSecurityConfiguration(securityContext);

//Start administration on one of the security configurations
securityContext = clusterContext.getSecurityContext("<security configuration name>");
SUPSecurityConfiguration supSecConf = SUPObjectFactory.getSUPSecurityConfiguration(securityContext);

Incorrect Sample Code Line in Custom.js File

Custom.js File in Developer Guide: Hybrid Apps was updated to fix an incorrect line of code in the sample. See below for the updated topic.

Incorrect Sample Code for Retrieve Application Connections API.

The code sample for the Retrieve Application Connections API in Developer Guide: Unwired Server Runtime contains an unsupported filter. Only the following filters are supported for this API: APPLICATION_ID, APPLICATION_CONNECTION_ID, NUMERIC_ID, SECURITY_CONF and USER_ID.

Generally, the maximum concurrency on the Gateway system is limited by the number of available dialog processes (kernel parameter rdisp/wp_no_dia). Therefore, the Gateway system rejects connections when there are no resources available. Ensure that enough work processes exist in both the Gateway system and in any SAP EIS systems (for example, SAP ERP or CRM) to handle the peak load. 

You can throttle the number of connections used by setting a proxy connection pool size on each Unwired Server node. Generally, Sybase recommends that you limit this value to be less than 70% of backend concurrent working processes for the Gateway. For example, if the Gateway uses the maximum of 25, then set this value to 10 or 12.

For details on how to create a Proxy connection in the client, see Creating a Proxy Connection (Whitelisting) in Developer Guide: REST API Applications and for configuring a Proxy connection the server, see Configuring Unwired Server to Securely Communicate With an HTTP Proxy and Proxy Properties in Sybase Control Center Online Help.