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 Anywhere, 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 Application 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, eProcurement 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, ObjectConnect, 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, PowerWare Enterprise, Process Analyst, Rapport, RepConnector, Rep lication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Report-Execute, Report Workbench, Resource Manager, RWDisplayLib, 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...