Document ID: DC10036-01-0520-01
Last revised: March 2007
Accessing current release bulletin information
A more recent version of this release bulletin may be available on the Web. To check for critical product or document information added after the product release, use the Sybase Product Manuals Web site.Accessing release bulletins at the Sybase Product Manuals Web site
Go to Product Manuals.
Select a product and language and click Go.
Select a product version from the Document Set list.
Select the Release Bulletins link.
From the list of individual documents, select the link to the release bulletin for your platform. You can either download the PDF version or browse the document online.
This release bulletin provides information on the Unwired Orchestrator Production Edition. For information about issues concerning Sybase WorkSpace, the tooling for Unwired Orchestrator, see the Release Bulletin for Sybase WorkSpace 1.7.
Special installation instructions
Before installing the Unwired Orchestrator Production Edition, review the following information.
Installing Sybase IQ with Unwired Orchestrator
CRs #393025, 424141
Description: When installing Sybase IQ with Unwired Orchestrator on Windows or Solaris, if you first install Unwired Orchestrator and then install Sybase IQ, the EAServer plug-in may not be registered in Sybase Central™ 4.3.
Workaround: To resolve this issue, use the following procedure.Installing Sybase IQ with Unwired Orchestrator
Before you install Sybase IQ, back up the .scRepository file located in the <install_dir>\DevRuntime\Shared\Sybase Central 4.3 directory, where <install_dir> is the directory in which you have installed Sybase WorkSpace.
Install Sybase IQ.
Add the contents of the backed-up .scRepository file to the new .scRepository file.
Setting up the Oracle JDBC driver
To use the Oracle JDBC™ Driver for database services, you must set up the Oracle JDBC driver.Setting up the Oracle JDBC driver
Add the Oracle JDBC driver JAR file to the following directory:
Unzip and extract the files to:
Changed functionality in this version
For information on changed functionality and new features, see the What’s New guide on the Sybase WorkSpace online bookshelf.
Unwired Orchestrator issues
The following issues are known for the Unwired Orchestrator Production Edition.
Cursors in Oracle stored procedures not supported
The use of cursors as parameters in an Oracle database stored procedure is not supported for Unwired Orchestrator. If you attempt to discover a result set for an Oracle stored procedure that uses cursors as parameters, you may encounter errors.
Java exception when starting or stopping Unwired Orchestrator
Description: The following Java Remote Method Protocol (JRMP) exception may appear in a DOS window when you try to start or stop Unwired Orchestrator 5.2:
This exception results from a difference in default port numbers between the SybAgent port used by Unwired Orchestrator and the Sybase IQ Agent port, which is 1099.
Workaround: To resolve this issue, do one of the following:
Start the Sybase IQ Agent on a port number different from the default 1099 using the DASIQPORT parameter:
Here, <portnum> is the desired port number. For more information, see the Sybase IQ System Administration Guide.
Start SybAgent on a different port number. To do this, you must change your SybAgent port configuration.
Open the boot.xml file at <install_dir>\Orch-5_2\EAServer\SysMgmt, where <install_dir> is the directory in which you have installed Unwired Orchestrator.
Edit the boot.xml file as follows:
Insert the following attribute on line 55:
Where xxxx is the port value you want to use.
Replace the port number in line 78 to the same port you used in line 55, for example:
<param type="java.lang.Object">rmi://banglor:xxxx </param>
Open the StopSybAgent.bat file at <install_dir>\Orch-5_2\EAServer\SysMgmt\bin.
Edit the StopSybAgent.bat file. Replace the port number on line 24 with the port number you used in the boot.xml file.
For more information on managing ports, see the topic “Managing Ports,” which is in the Sybase WorkSpace Server Administration collection.
Log Viewer does not automatically update
Description: Newly generated logging information for Unwired Orchestrator is not updated in the Log Viewer component of the Profiling and Logging perspective.
Workaround: To ensure that logging information is shown in the Log Viewer, use the following procedure:Setting up the Unwired Orchestrator logging agent
Download the TPTP Agent Controller and Generic Log Adapter from the Eclipse downloads Web site.
Configure the Agent Controller. Instructions are available in the getting_started.html document available with the Agent Controller download or on the Eclipse Web site.
Launch the Agent Controller.
Configure the Generic Log Adapter according to the instructions given in <gla_install>/bin/gla.bat, where gla_install is the installation directory for your Generic Log Adapter.
In <uo_home>/templates/runUOLogAdapter.bat, where <uo_home> is the location of your Unwired Orchestrator installation, replace AC_HOME with the root directory of your Agent Controller installation and GLA_HOME with the root directory of your Generic Log Adapter installation.
In <uo_home>/templates/UOLogRuleParser.adapter, change the following lines to match the location of the log file on your machine:
<pu:Property propertyName="directory" propertyValue="."/> <pu:Property propertyName="fileName"propertyValue="Unwired.log.0"/> <sensor:SingleFileSensor directory="." fileName="Unwired.log.0"/>
For example, if <jaguar> indicates the root directory of your EAServer installation, change the lines to the following:
<pu:Property propertyName="directory" propertyValue="<jaguar>\bin"/> <pu:Property propertyName="fileName"propertyValue="Unwired.log.0"/> <sensor:SingleFileSensor directory="<jaguar>\bin" fileName="Unwired.log.0"/>
Start the Generic Log Adapter with the following command:
Here, <uo_home> indicates the root directory of your Sybase WorkSpace installation.
In Eclipse, open the preferences page at Windows | Preferences | Profiling and Logging. Make sure the Enable logging option is selected.
In Eclipse, select Run | Profile, and select Attach - Java Process from the Profile wizard. Click New.
Click the Host tab, and specify the host for your Agent Controller.
Click the Agents tab, and specify UOLogAgentOutputter.
Click Apply, Profile, and Close.
If you need to start profiling, right-click the log entry in the Profiling and Logging perspective, and choose Start Profiling. To refresh the log, right-click the log entry in the Profiling and Logging perspective, and select Refresh Views.
Service package deployment fails
Description: An attempt to deploy a service package fails with the following:
The server log file reports the following error:
javax.naming.NamingException: <details of error> Root exception is org.omg.CORBA.OBJECT_NOT_EXIST
The agent.log file reports the following warning:
WARN com.sybase.management.jmx.system.XMLLoader-processServiceNode: Failure starting the service
<RMIRegistry>: java.rmi.server.ExportException: Port already in user:1099;
nested exception is: java.net.BindException: Address already in use: JVM_Bind
The SybAgent console reports the following exception:
Error shutting remote Agent down: javax.naming.NameNotFoundException.jrmp
Workaround: This problem occurs when an attempt is made to start the Unwired Orchestrator runtime while a process other than SybAgent is already listening on the default TCP/IP port 1099. See “Resolving an EAServer RMI Registry Port Conflict” in the Sybase WorkSpace Server Administration collection for instructions on resolving this conflict.
EAServer shutdown script fails
CR # 403927
Description: On Sun Solaris, running the or51rtimeEAS_stop.sh shutdown script may not shut down EAServer on the first try.
Workaround: Run the or51rtimeEAS_stop.sh script until EAServer stops.
Unwired Orchestrator errors occur for long PATH variable
CR # 429745
Description: Long global PATH variables cause the following problems:
The UOCache.props file is missing at <install_dir>\Orch-5_2\EAServer\Repository\ConnCache, where <install_dir> is the directory in which you have installed Unwired Orchestrator.
The config_eas.log file at <install_dir>\Orch-5_2\ismpeLogs may contain the following error:
---------------------------------------------------------------------- ---- Configuring EAServer Message Service.. ---------------------------------------------------------------------- 1 file(s) copied. Install Message Service to EAServer Error: ERROR: Failed to Install Message Service to EAServer
The config.stderr file at <install_dir>\Orch-5_2\ismpeLogs may contain repeated entries of the following errors:
'"D:\Orch-5_2\EAServer\bin\jagtool"' is not recognized as an internal or external command,
operable program or batch file. The system cannot find the file specified.
This file may also contain the following error:
The input line is too long. :CALL_JAVA was unexpected at this time.
The jagtool executable does not run from the command line.
The EAServer Message Service is not configured.
EAServer is missing Unwired Orchestrator-related applications, such as JavaMailDriver, IAnywhereDriver, AlertManager, and JMXDriver.
The ECCGlobal package is not installed into EAServer.
Workaround: To recover from these errors, use the following procedure:Recovering from long PATH errors
Stop all servers.
Modify your system PATH to reduce its length.
Run the configurator to reconfigure Unwired Orchestrator modules in EAServer.
Start Unwired Orchestrator.
Design and deploy services.
Documentation updates and clarifications
Security vulnerability in RSA signature verification
This release contains important JDK and EAServer security fixes. You can find more information on security vulnerability in RSA signature verificationhttp://www.sybase.com/detail?id=1047991
Support for Daylight Savings Time
Sybase products support Daylight Savings Time. You can find informationhttp://www.sybase.com/detail?id=1048699
Daylight Savings Time issue in Sun JDK/JRE
A problem has been identified in the JDK/JRE releases from Sun intended to fix the Daylight Savings Time functions in the JDK/JRE to comply with the new US Daylight Savings Time rules that were initiated in 2007.
You can find more information on this issue http://www.sybase.com/detail?id=1050663
Performance and tuning recommendations
See the Business Process Service Performance Tuning for Production Environments technical white paper at http://www.sybase.com/support/techdocs for more information on optimizing performance of a business process service.
Runtime Management Console online help
Description: In the Using LDAP Runtime Security topic, the note currently reads:
Note: See the CSI 2.5.1 Java LDAP Provider technical white paper located http://www.sybase.com/techdocs for a description of each property.
Workaround: The note should read:
Note: See the CSI 2.5.1 Java LDAP Provider technical note located http://www.sybase.com/techdocs for a description of each property.
Each Sybase installation that has purchased a support contract has one or more designated people who are authorized to contact Sybase Technical Support. If you have any questions about this installation or if you need assistance during the installation process, ask the designated person to contact Sybase Technical Support or the Sybase subsidiary in your area.
Other sources of information
Use the Sybase Getting Started CD, the SyBooks™ CD, and the Sybase Product Manuals Web site to learn more about your product:
The Getting Started CD contains release bulletins and installation guides in PDF format, and may also contain other documents or updated information not included on the SyBooks CD. It is included with your software. To read or print documents on the Getting Started CD, you need Adobe Acrobat Reader, which you can download at no charge from the Adobe Web site using a link provided on the CD.
The SyBooks CD contains product manuals and is included with your software. The Eclipse-based SyBooks browser allows you to access the manuals in an easy-to-use, HTML-based format.
Some documentation may be provided in PDF format, which you can access through the PDF directory on the SyBooks CD. To read or print the PDF files, you need Adobe Acrobat Reader.
Refer to the SyBooks Installation Guide on the Getting Started CD, or the README.txt file on the SyBooks CD for instructions on installing and starting SyBooks.
The Sybase Product Manuals Web site is an online version of the SyBooks CD that you can access using a standard Web browser. In addition to product manuals, you will find links to EBFs/Maintenance, Technical Documents, Case Management, Solved Cases, newsgroups, and the Sybase Developer Network.
To access the Sybase Product Manuals Web site, go to Product Manuals.
Sybase certifications on the Web
Technical documentation at the Sybase Web site is updated frequently.Finding the latest information on product certifications
Point your Web browser to Technical Documents.
Click Certification Report.
In the Certification Report filter select a product, platform, and timeframe and then click Go.
Click a Certification Report title to display the report.
Point your Web browser to Availability and Certification Reports.
Either select the product family and product under Search by Base Product; or select the platform and product under Search by Platform.
Select Search to display the availability and certification report for the selection.
Set up a MySybase profile. MySybase is a free service that allows you to create a personalized view of Sybase Web pages.
Point your Web browser to Technical Documents.
Click MySybase and create a MySybase profile.
Sybase EBFs and software maintenanceFinding the latest information on EBFs and software maintenance
Point your Web browser to the Sybase Support Page.
Select EBFs/Maintenance. If prompted, enter your MySybase user name and password.
Select a product.
Specify a time frame and click Go. A list of EBF/Maintenance releases is displayed.
Padlock icons indicate that you do not have download authorization for certain EBF/Maintenance releases because you are not registered as a Technical Support Contact. If you have not registered, but have valid information provided by your Sybase representative or through your support contract, click Edit Roles to add the “Technical Support Contact” role to your MySybase profile.
Click the Info icon to display the EBF/Maintenance report, or click the product description to download the software.
To access Eclipse 3.1 documentation on the Web, point your Web browser to the Eclipse SDK help page.
This document is available in PDF format through which you can navigate using a screen reader.
You can get additional information about Sybase accessibility http://www.sybase.com/accessibility. The Sybase Accessibility site includes links to information on Section 508 and W3C standards.
Note:You might need to configure your accessibility tool for optimal use. Some screen readers pronounce text based on its case; for example, they pronounce ALL UPPERCASE TEXT as initials, and MixedCase Text as words. You might find it helpful to configure your tool to announce syntax conventions. Consult the documentation for your tool.