Documentation Issues and Updates for Unwired Platform Runtime 2.1 ESD #3

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

Issue NumberDescription
SMPONP-5570
Increase -nc value for ML if connections hang

If you see connections hanging and an HTTP 400 error during testing with a relay server, increase the value for the -nc mlsrv12 option to a higher number, for example, 10000. The -nc option for ML specifies the maximum number of concurrent network connections to ML. See the MobiLink - Server Administration guide for more information.

SMPONP-6923
Changes to procedure for making multiple hybrid apps co-exist

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

SMPONP-5946
Security x.509 does not work correctly

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.

SMPONP-5638
New topic for troubleshooting APNS notification errors

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

SMPONP-5646
SUPDT is not a full qualified host name

The full qualified host name or network name should be SUPDT.example.com and the example should be hostname.example.com. Applies to Selecting Installation Options in the Installation Guide for Runtime

CR 738781

Current versions of Afaria do not support any management via Sybase Control Center

The topic Launching Afaria from Sybase Control Center in System Administration is invalid and should be removed. The current versions of Afaria do not support management via Sybase Control Center.

CR 736342
Documentation specifies the wrong directory for database driver files

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

Workaround: The drivers should be saved to these locations:
JDBC driver for: Action
Oracle Place the JDBC driver, for example ojdbc14.jar, in:

SUP_HOME\MobileSDK<Version>\MobileWorkSpace\mobile\eclipse\plugins\com.sybase.uep.com.oracle_<version>.<plugin version number>\lib

DB2 Unzip the db2JdbcJars.zip file and copy the JAR files to:

SUP_HOME\MobileSDK<Version>\MobileWorkSpace\mobile\eclipse\plugins\com.sybase.uep.com.db2_<version>.<plugin version number>\lib

SQL Server JDBC driver 3.0 Copy sqljdbc4.jar to:

SUP_HOME\MobileSDK<Version>\MobileWorkSpace\mobile\eclipse\plugins\com.sybase.uep.com.sqlserver_<version>.<plugin version number>\lib

CR 735927
Best practice for exporting domains

An internal integer ID is auto-generated and assigned to a new domain when it is created and that ID is not recycled/re-used when the domain is deleted.

Applies to Sybase Control Center for Sybase Unwired Platform 2.1 ESD#3 > Deploy > MBO Packages > Deploying MBO Packages > Deploying with Export and Import > Import Export Best Practices.

n/a

URL suffix property value

In the Installation Guide for Runtime topic Creating a Quick Configuration the value you would use for IIS is /ias_relay_server/server/rs_server.dll.

n/a

Proxy settings

In the Installation Guide for Runtime topic Creating a Quick Configuration:

  • The proxy settings apply to all tiers, not only Online Data Proxy deployments.
  • If you have a proxy configured for connections from the internal networks (where the RSOE runs) out into the DMZ or internet (where RelayServer runs) then the four properties allow the RSOE to go through that proxy to connect successfully.
n/a

Updates to the Troubleshooting guide were made.

The topic Messaging Installer Completed with Errors in Troubleshooting > Troubleshoot the System > Troubleshoot the Postinstallation Configuration was updated to eliminate the step directing users to run the tracemigrator -i command. Tracemigrator is a tool for importing a TraceConfig.xml configuration document into the database. It is not relevant for troubleshooting database upgrade errors.

n/a
Protocol setting for iOS added to topic.

The protocol setting is available for iOS. You can set the protocol to either HTTP or HTTPS. See Provisioning Settings.

n/a
Clarification on menu options.

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.

n/a
Defining Certificates for SSL Encryption

In Security > Server Security > Encrypting Other Listeners for Unwired Server Defining Certificates for SSL Encryption, the note at the end of the task needs further information

CR 717541
Firewall/IDS systems require configuration

The Troubleshooting guide should include the following statement:

If you are running a firewall/IDS system, configure it to allow SUP components to communicate on their configured ports.

CR 717016
Install Relay Server on IIS

QuickSetup relay server installation scripts are provided in Interactively Installing Relay Server on IIS with Scripts.

CR 710989
Topic contained incorrect information on application registration for 2.1.3: Registering Applications, Devices, and Users in the Security documentation was not correctly updated to reflect current behavior for this release.

Review the Registering Applications, Devices, and Users topic in the Release Bulletin for current registration information.

CR 709894
New connection template and usage restriction A new application connection template named $diagtool is automatically added by the installer in the available templates list in Sybase Control Center. However, this template was not documented in Sybase Control Center online help.

The template is a required template exclusively used for the diagtool.bat diagnostics utility. It is read only and cannot be deleted. Do not use it for any Unwired Platform device applications.Ā 

CR 707294
Unwired Server port inaccessible from a remote machine.

A port in the Sybase Unwired Platform environment is inaccessible from a remote machine, which may indicate the machine is configured with more than one Ethernet adapter and IP address. Consequently, a service port on Unwired Server may be configured with an IP address that is inaccessible from the remote machine.

See Unwired Server Port Is Not Accessible from a Remote Machine.

CR 706677
Enabling and Configuring a Password Policy for Data Vault Logins

Administrators can create a password policy for device application logins in a new or existing application connection template.

CR 705731
Mutual Authentication for Messaging and Unwired Server Communications on IIOPS Ports

You can no longer configure mutual authentication for messaging and Unwired Server communication over IIOPS, because Sybase Control Center and Public Administration APIs have been modified to prevent administrators from configuring the IIOPS management port with a profile that uses mutual_auth.

CR 704382
Administration Workbook contains topics that use OpenDS as an example of an LDAP directory.

Ignore references to OpenDS as Unwired Platform no longer includes this LDAP directory. Instead of using OpenDS to perform workbook activities, Sybase recommends using Microsoft Active Directory.

CR 698525 and CR 698515
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.
CR 697403
Resetting the supAdmin Password.

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.

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

This occurs only if an EAServer installation and a Sybase Unwired Platform installation coexist on the same machine. The exception is caused by different versions of the com.sybase.iiop.net.dll file on the system.

Ensure that your environment path includes only the Sybase Unwired Platform com.sybase.iiop.net.dll assembly. For example, if you have EAServer installed on the same machine as Sybase Unwired Platform:
  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).
CR 697230
Client application cannot register to Unwired Server through Relay Server.

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

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.

CR 697226
Configuring IIS 7.5 for Relay Server

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

Follow the steps in Configuring IIS 7 for Relay Server in Installation Guide for Runtime (the Deploying an Enterprise System section). In step 6 (Add Relay Server locations to the default Web site), add the following information:
<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>