Documentation Issues and Updates for Runtime

In Sybase Unwired WorkSpace - Mobile Business Object Development, the documentation specifies the wrong directories for the JDBC drivers.

Ignore references to TraceConfig.xml in Developer Guide: iOS Object API Applications .

Workaround: Perform Trace Logging using the Sybase Control Center. See http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01704.0212/doc/html/mqu1323381963853.html.

Duplication linking issues in Sybase Control Center for Sybase Unwired Platform

Some menu options mentioned in the Sybase Control Center online help, System Administration and Security, appear only if functionality is installed or enabled. For example, the Advanced Search and Security Configuration tabs are visible only if clusters are installed. The documentation does not state this explicitly for each topic.

If documentation refers to a tab that is not visible, the feature is not installed or enabled.

Running the Pack Tool Utility

This change applies to Application ID Guidelines in System Administration 2.1 ESD #2.

Add this statement to the following paragraph: For Android native MBO applications, this recommendation applies starting with Unwired Platform version 2.1.1.

Application ID Guidelines: If the current version – (recommended) use the automatically created application connection template for the application. Otherwise, ensure you register application connection with correct template by verifying that application ID matches, and that the correct security configuration and domain are selected. Also, if using replication synchronization, set other template properties (such as synchronization-related properties in Connection category) as required.

If you are running a firewall/IDS system, configure it to allow SUP components to communicate on their configured ports. See Handling Intrusion Detection/Prevention Software.

Interactively Installing Relay Server on IIS with Scripts

This change applies to Configuring State Manager as a Service in Installation Guide for Runtime 2.1.

Failed to attach to Relay Server state store

From a Linux command shell, make sure the State Manager service runs under the same user credentials as the Apache service.

This change applies to Data Tier Ports in Installation Guide for Runtime 2.1.

Port 6262 must be open for both TCP and UDP protocols when using the Windows Filtering Platform (WFP) or other firewall software on the data tier host for Sybase Unwired Platform 2.1. Ensure that Windows Filtering or other firewall software has this port opened for TCP/UDP network traffic.

In the Sybase Control Center documentation, this behavior is not documented.

This change applies to Single Sign-on Authentication in Security 2.1 ESD #2.

Problem: The help states: "Encrypt the communication channel between Unwired Server and the SAP EIS for security reasons" and that for "JCo connections you must configure the SNC properties." This is unclear.

Explanation: To encrypt the data communication channel, use SNC. If you do not want to encrypt the communication channel for internal communication between Unwired Platform and the EIS, then you do not need to use SCN.

SAP strongly recommends you use SCN when using single sign-on (SSO) between JCo clients. Without SCN, the RFC communication between a JCo client and the SAP system is unencrypted.

With SNC enabled, Unwired Platform has an X.509 certificate for the technical user, and SAP is configured to "trust" this certificate and only allow SSO impersonization of other SAP users if the connection is made with this certificate from the trusted technical user. Additionally, RFC network traffic is encrypted, making it much more difficult to intercept someone's SSO2 ticket. Even a stolen ticket cannot be used without the private keys of the technical user's certificate.

The Unwired Platform keystore and truststore locations are protected by a password. Replace default passwords in production environments.

See Changing Keystore and Truststore Passwords.

To ensure Unwired Server runs properly, run the Pack Tool utility to defragment and reclaim unused space within tables and memo files that the Advantage Database Server® (ADS) data file uses. Run this utility as part of an ongoing maintenance program.

See Running the Pack Tool Utility.

Manually reset the supAdmin password if you forget it. Contact your IT department or administrator before changing or resetting the password. Only the person who has the correct permission to change the configuration files should perform the procedure.

See Resetting the supAdmin Password.

This troubleshooting topic applies to the Installation Guide for Runtime 2.1.

Problem: The Sybase Unwired Platform client application cannot register to the Unwired Server through the Relay Server, and the client displays an error such as:

HTTP_TPSendRequest - returning error code -106 -- HTTP error -- header is: HTTP/1.1 404 Not Found Content-Type: text/html.

Explanation: The Relay Server cannot find the language resource file (dblgen12.dll). Make sure the language resource is within the system search path and that the Web server worker has permission to read it.

Update the system PATH variable on the IIS host to include the ias_relay_server \Server\ directory.

The Release Bulletin for Runtime 2.1 explains how to configure IIS 7 for Relay Server. If you are configuring IIS 7.5, extra settings are needed.

<location path="Default Web Site/rs">
    <system.webServer>
        <security>
            <authentication>
                <anonymousAuthentication userName="" />
            </authentication>
<requestFiltering>
    <requestLimits maxAllowedContentLength="2147483647" />
</requestFiltering>
          </security>
          <handlers accessPolicy="Execute, Script" />
      </system.webServer>
  </location>

You can disregard this step for upgrades from version 2.1.

This occurs only if an EAServer installation and an 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.

In Sybase Control Center, on Applications > Application Connection, selecting a device and clicking Refresh causes the entire list to refresh rather than only the selection.

Use Go to refresh the selected device, and Refresh to refresh the entire list of devices.

In Step 4, no examples are included for the command:

dbengsqlAnywhere version.

Examples:

Sybase Unwired Platform 2.0.x comes with SQL Anywhere 11, so the command line would look like this: dbeng11

Sybase Unwired Platform 2.1 comes with SQL Anywhere 12, so the command would look like this: dbeng12