Sybase DC38029-01-0500-01 User Manual

Release Bulletin
EAServer 5.0 for HP-UX
Document ID: DC38029-01-0500-01
Last revised: Fe bruary 27, 2004
Topic Page
1. Accessing current release bulletin information 2
2. Product summary 2
3. Special installation instructions 3
4. Changed functionality in this version 3
5. Known problems 4
5.1 EAServer Manager server configuration wizard 4
5.2 Systems Management 4
5.3 SSL certificates after upgrading 5
5.4 HTTP 1.1 support 5
5.5 Web services toolkit issues 5
5.6 Silent installer issues 7
6. Product compatibilities 7
6.1 PowerBuilder 7
6.2 PowerDynamo 9
6.3 Application Integrator 9
6.4 Earlier EAServer (Jaguar CTS) versions 9
7. Documentation updates and clarifications 9
7.1 Corrections to the EAServer System Administration Guide 10
7.2 Corrections to the Web Services Toolkit User’s Guide 10
8. Technical support 10
9. Other sources of information 10
Copyright 1997-2004 by Sybase, Inc. All rights reserved. Sybase, the Sybase lo go, AccelaTrade, ADA Workbench, Adapta ble Windowing Environment, Adaptive Component Architecture, Adaptive Server, Adaptive Server Any­where, Adaptive Server Enterprise , A daptive Server Enterprise Monitor, Adaptive Server Enterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive W arehouse, Anywhere Studio, Applicatio n Manager, AppModeler, APT Workbe nch, APT -Buil d, APT -Edit , APT-E xec ute, APT-T r ansla to r , APT- Lib rary, Avan tGo , A v ant Go Appl icat i on Alert s, AvantGo Mobi le Deli ver y, Avant Go Mobi le Docu me nt V i ewe r , AvantGo Mobile Insp ec tion, AvantGo Mo bile Marketing Channel, Avan tGo Mobile Pharma, AvantGo Mobile Sales, AvantGo Pylon, AvantGo Py lon Application Se rver, AvantGo Pylon Conduit, Av antGo Pylon PIM Ser ver, AvantGo Pylon Pro, Backup Server, BizTracker, ClearConnect, Client-Library, Client Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpr es s, Data Ser ver, DataWindow, DB-Library, dbQueue, Developers Workbench, Direct Connect Anywher e, Dir ect Connect, Distribution Director, e-ADK, E-Anywhere, e-Biz Integrator, E-Whatever, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, Em bedded SQL, EMS, Enterpri se Appli­cation Studio, Ent erpr is e Clie nt/S er ver , Enter pr ise Co nne ct, En te rpri se Da ta S tu di o, Ent erp rise Mana ger, Enterprise SQL Ser ver M anager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcure­ment Accelerator, EWA, Financial Fusion, Financial Fusion Server, Gateway Manager, GlobalFIX, iAnywhere, ImpactNow, Industry Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnec t, InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, Mail Anywhere Studio, Mainfra m eConnect, Maintenance Express, Mana ge A nywhere Studio, M- Business Channel, M-Business Network, M-Business Server, MDI Access Server, MDI Database Gateway, media.splash, MetaW orks, My AvantGo, My AvantGo Media Channel, My AvantGo Mobile Marketing, MySupport, Net-Gateway, N et-Library , New Era of Networks, Object­Connect, ObjectCycl e, OmniConn ect, OmniSQL Access M odule, OmniSQL Toolkit, Op en Biz, Open Clie nt, Open Clien tConnect , Open Cl ien t/Serv er , Ope n Cli ent/S erver I nter faces, Open Gatewa y , Op en Serv er , Open Serve rConne ct, Open Solutions, Optima++, Orchestration Studio, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, PocketBuilder, Pocket PowerBuilder, Power++, power.stop, PowerAMC , PowerBuilder, PowerBuilder Foundation Clas s Library, PowerDesigner , PowerDi mensions , PowerDy namo, PowerJ, PowerScri pt, Powe rSite, PowerSocke t, Powerso ft, PowerS tage, PowerStudio, PowerT ips , Power soft Port fol io, Powe rsof t Pr ofess io nal, Power Ware Desktop, Pow­erWare Enterprise, Process Analyst, Rapport, RepConnector, Rep lication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Report-Execute, Report Workbench, Resource Manager, RW­DisplayLib, RW-Library , S-De signo r, SDF, Sec ur e SQL Ser ver , Se cure SQL Toolset, Secu ri ty Guardi an , SKI LS, s mart . part ner s, s mart. par ts, smar t.s crip t, SQ L Advan ta ge, SQ L A nywh ere, SQL Any wher e St ud io, SQL Code Che cker, SQL Debug, SQL Edit, SQ L Edi t/TPU, SQL Ever ywh ere, SQ L Model er , SQL Remote, SQL Server , SQL Serv er Manager , SQL SMAR T , SQL T ools et, SQL Ser ver/CFT , SQL Server/DBM, SQL Server SN MP SubAgent , SQL Stat ion, SQLJ, STEP, SupportNow, S.W.I .F.T. Message Format Libraries, Sybase Ce ntral, Sybase Clien t/Server Interface s, Sybase Financial Server, Syba se Gateways, Sybase MPP, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench, SybaseWare, Syber Financial, SyberAssist, SyBooks, System 10, System 11, System XI (logo), SystemTools, Tabular Data Stream, TotalFix, TradeForce, Transact-SQL, Translation Toolkit, UltraLite, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, V i sualW rit er , VQL, WarehouseArchit ect, Warehouse Contr ol Cent er , Warehouse Stu dio, Warehouse WORKS, Watcom, W at ­com SQL, Watcom SQ L Server, Web Deployment Kit, Web.PB, Web.SQL, WebSi ghts, WebViewer, WorkGroup SQL Server, XA-Library, XA-Server and XP Server are trademarks of Sybase, Inc. 07/03
1. Accessing current release bulletin information EAServer 5.0
Topic Page
9.1 Sybase certifications on the Web 11
9.2 Sybase EBFs and software maintenance 12
10. Accessibility features 12

1. Accessing current release bulletin information

A more recent version of this r elease bulletin may be av ailable on th e Web. To check for critical product or document infor mation added after the release of the product CD, use the Sybase Technical Library Product Manuals Web site.
Accessing release bulletins at the Technical Library Product Manuals
Web site
1Go to Product Manuals at http://www.sybase.com/support/manuals/. 2 Follow the links to the appropriate Sybase product. 3 Select the Release Bulletins link. 4 Select the Sybase product version from the Release Bulletins list. 5 From the list of individual documents, select the link to the release bulletin
for your platform. You can either download the PDF vers ion or browse the document online.

2. Product summary

Enclosed is Sybase EAServer version 5.0, build HP50054. You may have a later build number if you have installed ESD patches for this release. If so, the cover letters provided with each patch contain the build number and additional documentation.
2.1 System requirements
This EAServer release is compatible with the following platform and operating system configurations:
HP-UX 11.0 on HP 9000 workstation with PA_RISC 2.0 architecture PA RISC 1.x and other architectures are not supported.
2
Release Bulletin for HP-UX
EAServer 5.0 3. Special installation instructions
2.2 Required system patches
Before installing EAServer on HP-UX 11.0, verify that you have the
March ‘03 quality pack installed, as well as the required HP patches for JDK
1.3 and JDK 1.4. EAServer will not function properly if all required patches and kernel settings are not present to support JDK 1.3 and JDK 1.4. For more information, see the following Web pages:
HP-UX 11.00 patches required for Java 1.3 at http://www.hp.com/products1/unix/java/patches/g-11.00-1.3-1100.0303.html
HP-UX 11.00 patches required for Java 1.4 at
http://www.hp.com/products1/unix/java/patches/g-11.00-1.4-1100.0303.html
You must run the HP HPjconfig tool to verify if all required patches have been installed on your machine. as the kernel settings required for Java. You can download
HP Web site at http://www.hp.com/products1/unix/java/java2/hpjconfig/index.html
HPjconfig reports what patches are required as well
HPjconfig from the
.
For more general information on HP-UX patch levels, see the
http://www.hp.com/products1/unix/java/infolibrary/patches.html#11

3. Special installation instructions

The Installation Guide describes how to install the software.
3.1 Mounting the CD
You must manually mount the CD. T o d o so, use the HP SAM utility. See your HP documentation for more information.

4. Changed functionality in this version

What’s New in EAServer describes features added in this release. Y ou can view this book on the
http://sybooks.sybase.com/eag.html
Documentation) collection, then select this title. This manual is also available in HTML format in your installation and in PDF (Acrobat) and DynaText (SGML) format on the Technical Library CD included with your software.
Sybase Product Manuals Web site at
. Browse to the EAServer 5.0 (Core
HP Web site at
.
Release Bulletin for HP-UX 3
5. Known problems EAServer 5.0

5. Known problems

This section describes known problems in this EAServer version.
5.1 EAServer Manager server configuration wizard
(CR #334665) In some cases, the restart option is disabled in the server configuration wizard when it is valid to restart the server; that is, you are connected to the server that you are configuring. You can restart the server after finishing the wizard by highlighting the server icon and choosing File | Shutdown and Start.
5.2 Systems Management
5.2.1 Net-SNMP functionality not supported
(CR # 343670) The Net-SNMP functionality is not supported in version 5.0 of EAServer Systems Management, but is scheduled to be supported in a future version. To view information about system components, you can use the Web console.
5.2.2 Web console and Netscape 7.x
(CR #342578) When you run the sample Systems Management Web console, you may be unable to connect from Netscape 7.x browsers running on Solaris. To work around the problem:
Change the server HTTP listener to use an IP addr ess rather than the ho st name, restart the server , and use the IP addres s in the URL to co nnect, for example:
http://123.456.0.1:8080/WebConsole
If you still get “Document contains no data” errors, change the Netscape preferences by choosing Edit | Preferences | Advanced | Cache and select “Never.”
4
Release Bulletin for HP-UX
EAServer 5.0 5. Known problems
5.3 SSL certificates after upgrading
(CR #341222) When you upgrade from an earlier version of EAServer, the installer upgrades the sample test certificates and installs new versions of the Verisign CA certificates. The upgrade may leave obsolete copies of the Sample1 Test ID and Sample2 Test ID certificates. You can delete these manually using EAServer Manager or Security Manager. Delete the older version of each certificate.
5.4 HTTP 1.1 support
(CR #343480) EAServer generates HTTP 405 “method not allowed” errors when an HTTP request contains an absolute URI in the request-URI header.
5.5 Web services toolkit issues
The following are known issues in the EAServer 5.0 Web services toolkit.
5.5.1 Expired VeriSign root certificate
(CR #345070) The VeriSign root certi ficate has expired i n the JDK 1.3 and 1.4 installations used by EAServer. As a result, publishing to the Microsoft UDDI Registry throws a certificate expired exception. For more information on how this problem may affect your applications, see
http://sunsolve.sun.com/pub-cgi/retrieve.pl?doc=fsalert/57436
this issue:
Sun alert notification 57436 at
. To workaround
1 Shut down EAServer. 2 Download the most recent V erisign PCA root certificates from
Web site at http://www.verisign.com/support/roots.html
the V eriSign
3 Unzip the files to a temporary location, for example, /tmp. 4 Change to the bin directory in the JDK 1.4 installation used by EAServer.
Import the new certificates with the
keytool command. For example (all on
one line):
keytool -import -v -keystore $JAGUAR_JDK14/jre/lib/security/cacerts ­alias verisignclass3ca2028 -file "/tmp/VeriSign - Thawte Combined Roots/VeriSign_Roots/PCA3ss_v4.509"
When prompted, enter the JDK key store password. The default is
changeit. When prompted, accept the new certificate.
Release Bulletin for HP-UX 5
5. Known problems EAServer 5.0
5 Repeat the previous step to update the VeriSign root certificate in the JDK
1.3 installation used by EAServer.
For additonal HP-UX specific information see the
http://www.hp.com/products1/unix/java/infolibrary/verisign.html
expiration notice, posted at
5.5.2 Eclipse runs out of memory when handling large return values
In Eclipse, when testing W eb service calls to components that return very large values (say greater than 1 million bytes), the Java VM that runs Eclipse can run out of memory. To solve this problem, modify the
starteclipse.sh script file.
Change the line:
eclipse -vm jdk-path/jre/bin/java
—add the -Xmx option to increase the Java VM heap size from the default. For example:
eclipse -vm jdk-path/jre/bin/java -vmargs -Xmx512m
This example sets the Java VM heap size to 51 2 Megabytes, specified by 512m. Y ou can adjust the size up or down as needed to prevent out-of- memory errors. For information on the syntax of the
documentation at http://java.sun.com/j2se/
-Xmx option, see the Java command line
.
5.5.3 Errors in Eclipse when importing the sample applications
When installing the EAServer Web services samples into Eclipse, you may see errors related to the following issues.
(CR #341509) You will see several errors caused by the lack of Web service client classes that must be generated after importing. This is expected, since the client classes must be generated for each sample project according to the readme files that accompany each sample.
(CR #341533) You see errors for unresolved
javax.ejb dependencies when
importing the EJBSample. This sample is not intended to be built or used in Eclipse, but is rather meant to be compiled manually and then deployed to EAServer using EAServer Manager. EJBSample contains the source code for an EJB and requires classes that Eclipse does not have, such as
javax.ejb.*. To
eliminate error messages caused by the unresolved dependencies, right click on the EJBSample node, choose the Pro perties menu item, choose Java Build Path on the left pane of the res ulting dialog, select the Lib raries tab on the right pane, click the Add External JARs button and choose $JAGUAR/java/lib/easj2ee.jar, which will add in the
javax.ejb.* classes into
the path for that project.
6
Release Bulletin for HP-UX
EAServer 5.0 6. Product compatibilities
5.5.4 Using the XML-Security package
(CR #323094) Chapter 4, “Web Services Administration,” in the Web Services T oolkit User’s Guide describes how to use the Apache XML-Security package
to provide digital signatures and encryption for the SOAP messages sent to and from the Web services container in EAServer. To use this feature, you must replace the file xalan.jar in the EAServer java/classes directory with the version that is included with the Apache XML-Security package. Follow the instructions to add the other JAR files to the EAServer CLASSPATH setting.
5.5.5 Deleting UDDI registry entries
(CR #339099) When you delete a business, tmodel, or service from the local jUDDI registry using the Web services Web console, a spurious ClassCastException error is thrown in the server log file when the item is successfully deleted. You can ignore this error.
5.6 Silent installer issues
(CR #346937) When upgrading from EAServer version 4.2.2 to version 5.0 using the silent installer, the files SilentUninstall.sh and SilentUninstall.txt are not copied to the _uninstall2 su bdirectory. Y ou must manuall y copy thes e files from the EAServer 5.0 _uninstall subdirectory to the upgraded _uninstall2 subdirectory to use the SilentUninstall feature.

6. Product compatibilities

This section contains information about other Sybase products that are compatible with this version of EAServer.
6.1 PowerBuilder
This version of EAServer includes the following PowerBuilder virtual machines (PBVMs):
PowerBuilder 8.0. 4 – build 105 01
Note PowerBuild er 7.x components and version 7.x PBVMs are not supported
in EAServer 5.0.
Release Bulletin for HP-UX 7
6. Product compatibilities EAServer 5.0
If you previously received a private PowerBuilder EBF version containing newer file versions, do not install the PowerBuilder support files included in this version.
If you choose to install the PowerBuilder support files contained in this version:
Before installing this version, back up your existing PowerBuilder files by copying them to another location. Back up the following:
lib/*pb*
html/classes/pbjdbc12.jar
In the setup program, on the Select Products to Install window, click Customize for Sybase EAServer features, and choose the PowerBuilder Support features.
After the installation completes, ensure that the corresponding PowerBuilder version is installed on PowerBuilder client machines. To run PowerBuilder component s in EAServer, the runtime dynamic shared libraries for the version of PowerBuilder in which the components were developed must be available on the server. The Power Builder runtime files on the client and the server must be at the same build level. Using different build levels on client and server machines may result in unpredictable behavior or data corruption.
6.1.1 Known issues
8
Release Bulletin for HP-UX
You can download the corresponding PowerBuilder Windows client software from the
site at http://downloads.sybase.com
PowerBuilder downloads page of the Sybase downloads
.
Use the Library Painter to perform a full rebui ld of your PowerBuilder application to ensure that all descendant objects are synchronized with their ancestors and to incorporate any compiler fixes in your code.
(CR #344244) In order to use remot e debugging, t he file pbjag80.sl must exist in the EAServer lib subdirectory as a symbolic link to libpbjag80x.sl. On some machines, the installer may create pbjag80.sl as a regular file or not install it at all. If pbjag80.sl is a regular file, remove it. Create pbjag80.sl as a symbolic link to libpbjag80x.sl. For example:
ln -s libpbjag80x.sl pbjag80.sl
EAServer 5.0 7. Documentation updates and clarifications
6.2 PowerDynamo
EAServer 5.0 does not i nclude Powe rDynamo, thoug h you can us e an existing PowerDynamo installation with this EAServer version. Sybase recommends that you do not use PowerDynamo for new application development. Instead, use the J2EE-standard Java servlet an d JSP technolo gies. Support for PowerDynamo will be removed from later versions of EAServer.
EAServer 5.0 includes the sites into JSP-based J2EE Web applications. Sybase recommends that you migrate your PowerDyna mo Web sites to the J2EE model. F or infor mation o n using the PDynamo2JSP directory of the installation.
Note The Dyn2JSP utility converts static-file or dynam ic- fi le bas e d si tes. If
your site is stored in a da tabase, export it t o a dynam ic-file site bef ore runni ng the conversion.
Dyn2JSP utility, see the HTML documentation included in the
Dyn2JSP utility to convert PowerDynamo™ Web
6.3 Application Integrator
Application Integrator for CICS and Application Integrator for Stored Procedures are no longer included with EAServer. These products will be made available as open source on the
http://easerver.codexchange.sybase.com/
EAServer CodeXchange pages at
6.4 Earlier EAServer (Jaguar CTS) versions
Clients using IIOP and earlier versions of the EAServer (or Jaguar CTS®) client runtime files can connect to EAServer 5.0. T o manage EAServer 5.0, you should use a 5.0 installation to run EAServer Manager, calls the EAServer management APIs.
.
jagtool, or a client that

7. Documentation updates and clarifications

This section contains updates and clarifications for the EAServer product manuals.
Release Bulletin for HP-UX 9
8. Technical supp o rt EAServer 5.0
7.1 Corrections to the EAServer System Administration Guide
Chapter 13, Using Systems Management The section “SNMP
functionality” describes t he Sybase Systems Management f ramework support for SNMP, which allows SNMP clients to view information about underlying system status using standard SNMP protocols. This functionality is not available in EAServer version 5.0, but is scheduled to be in a future version.
Also in Chapter 13, the section “R unning the JMX agent” instructs you to start SybSNMP before you run the JMX agent. Since SNMP functionality is not included in this version, this step is not required.
7.2 Corrections to the Web Services Toolkit User’s Guide
Chapter 1, Overview of Web Services in EAServer The section “JAXM
1.0” describes the Java API for XML messaging. JAXM is not implemented in
EAServer. Instead, the messaging API is implemented using the SOAP with Attachments API for Java 1.1 (SAAJ) protocol.
See the
http://wwws.sun.com/software/communitysource/jaxm_saaj/
information.
JAXM/SAAJ Web page at

8. Technical support

Each Sybase installati on that has purchased a su pport contract ha s 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.

9. Other sources of information

Use the Sybase Getting Started CD, th e Sybase Technical Library CD, and the T echnical Libr ary Pr oduct Manuals Web site to learn more about your produ ct:
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 Technical Library CD. It is included with your software. T o read or print documents on the Getting S tarted CD, you need Adobe Acrobat Reader (downloadable at no charge from the Adobe Web site, using a link provided on the CD).
for more
10
Release Bulletin for HP-UX
EAServer 5.0 9. Other sources of information
The T echnical Library CD contai ns product manuals and is incl uded wit h
your software. The DynaText reader (included on the Technical Library CD) allows you to access technical information about your product in an easy-to-use format.
Refer to the Technical Library Installation Guide in your documentation package for instructions on installing and starting the Technical Library.
The Technical Library Product Manuals Web site is an HTML version of
the Technical Library CD that you can access using a standard Web browser. In addition to product manuals, you will find links to EBFs/Updates, Technical Documents, Case Management, Solved Cases, newsgroups, and the Sybase Developer Network.
T o access the Technical Library Product Manuals Web site, go to
Manuals at http://www.sybase.com/support/manuals/
9.1 Sybase certifications on the Web
Technical documentation at the Sybase Web site is updated frequently.
Finding the latest information on product certifications
1 Point your Web browser to Technical Documents at
http://www.sybase.com/support/techdocs/
2 Select Products from the navigation bar on the left. 3 Select a product name from the product list and click Go. 4 Select the Certification Report filter, specify a time frame, and click Go. 5 Click a Certification Report title to display the report.
Creating a personalized view of the Sybase Web site (including support
pages)
Set up a MySybase profile. MySybase is a free service that allows you to cr eate a personali zed view of Sybase Web pages.
1 Point your Web browser to
http://www.sybase.com/support/techdocs/
Product
.
.
Technical Documents at
.
2 Click MySybase and create a MySybase profile.
Release Bulletin for HP-UX 11
10. Accessibility features EAServer 5.0
9.2 Sybase EBFs and software maintenance
Finding the latest information on EBFs and software maintenance
1 Point your Web browser to the Sybase Support Page at
http://www.sybase.com/support
2 Select EBFs/Maintenance. Enter user name and password information, if
prompted (for existing Web accounts) or create a new account (a free service).
3 Select a product. 4 Specify a time frame and click Go. 5 Click the Info icon to display the EBF/Maintenance report, or click the
product description to download the software.
.

10. Accessibility features

EAServer 5.0 has been tested for compliance with U.S. government Section 508 Accessibility requirements. The online help for this product is also provided in HTML, JavaHelp, and Eclipse help formats, which you can navigate using a screen reader.
12
EAServer Manager supports working without a mouse. For more information, see Chapter 2, “Sybase Central Overview,” in the EAServer System Administration Guide.
The WST plug-in for Eclipse supports accessibility features for those that cannot use a mouse, are visually impaired or have other special needs. For information about these features refer to Eclipse help:
1 Start Eclipse 2 Select Help | Help Contents 3 Enter Accessibility in the Search dialog box 4 Select Accessible user interfaces or Accessibility features for Eclipse
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.
Release Bulletin for HP-UX
EAServer 5.0 10. Accessibility features
For additional information about how Sybase supports accessibility, see
Sybase Accessibility at http://www.sybase.com/accessibility. The Sybase
Accessibility site includes links to information on Sectio n 508 and W3C standards.
Release Bulletin for HP-UX 13
10. Accessibility features EAServer 5.0
14
Release Bulletin for HP-UX
Loading...