HP-UX SDK, for the Java™ 2 platform SDK version 1.4.1.01 with
HotSpot server 1.4.1.01 JVM
These Release Notes are provided in the software and as a standalone file on this website. The web version has the most up-to-date information regarding defect fixes.
The HP-UX SDK, for the Java 2 Platform Version 1.4.1 release provides
the tools for developing and deploying Java applications on HP-UX 11.0 and
11.11 PA-RISC and HP-UX 11.22 or later Itanium-based systems. (HP-UX 11.20
is not supported.)
table of contents
features
installation
usage documentation
problem fixes and known issues
features
SDK Version 1.4.1.01 with Server HotSpot 1.4.1.01 JVM
The HP-UX SDK for the Java 2 Platform version 1.4.1.01 provides
the tools for developing and deploying Java applications on HP systems
with HP-UX 11.0 and 11.11 (11i) PA-RISC and HP-UX 11.22 Itanium.
This is the first 1.4.1 SDK supported on Itanium.
HP's SDK 1.4.1.01 includes Sun Microsystems' 1.4.1_00 and 1.4.1_01 builds, defects fixed in our SDK 1.3.1 and previous 1.4 releases, as well as an additional enhancement described in the "Problems Fixed" section. Please note that on occasion HP backports a defect fix from a Sun release that has not yet been merged into our current sources. Therefore a Sun defect may be fixed in an HP release even though the Sun release that contains the fix is not part of the HP release.
The 1.4.1.01 SDK runs in 32-bit or 64-bit mode on both PA-RISC and
Itanium-based systems.
The SDK 1.4.1.01 includes the HotSpot 1.4.1.01 server JVM; it does not
include the Classic JVM.
Java Web Start 1.2 is now bundled with the SDK and RTE.
HotSpot 1.4.1 JVM
The HotSpot 1.4.1 Server JVM for HP-UX 11.0 and 11.11 PA-RISC and HP-UX
11.22 or later Itanium systems is suitable for both client and server workloads.
We invoke the Server VM with configuration options that suit client-side
applications.
All -X options that were in earlier HotSpot JVMs are included in HotSpot 1.4.1
Performance, tool support, tool enhancements, and features are documented at: http://java.sun.com/j2se/1.4.1/docs/.
The SDK 1.4.1 HotSpot 1.4.1 Edition supports the APIs core to the Java 2
platform: Java Foundation Classes (JFC), Security, Java IDL, JDBC™,
JavaBeans™, Remote Method Invocation (RMI), Java 2D,
and the Collections Framework, and a new set of nonblocking I/O APIs.
The Java 2 Platform version 1.4.1 API Specification is available at: http://java.sun.com/j2se/1.4.1/docs/api/.
The HotSpot 1.4.1 Server JVM provides:
Improved performance
Nonblocking I/O APIs
IPv6 support (PA-RISC and Itanium)
Full implementation of Java VM Debugging Interface (JVMDI)
and Java Platform Debugger Architecture (JPDA)
Java VM Profiling Interface (JVMPI)
IPv6 support (HP-UX 11.11 PA-RISC, and HP-UX 11.23 Itanium when released)
Support for HP's debugger WDB 3.0.01 for Java stack unwind
-Xeprof option for HPjmeter
-Xrs option to reduce use of OS signals
3GB heap size
64-bit mode
Bundled Java Web Start
Support for Java 3D
New garbage collectors: parallel and concurrent mark and sweep
A new set of nonblocking I/O APIs are now part of the
Java system libraries under the package java.nio. An improved
I/O multiplexing mechanism based on /dev/poll has been integrated
in the same nio framework. The previous implementation of I/O multiplexing
using the class com.hp.io.Poll is still being included
for backward compatibility. We encourage you to upgrade and use
the features provided through the new java.nio package.
IPv6 (Internet Protocol version 6) is a set of Internet Protocol specifications
designed to provide enhancements over the capabilities of the existing IPv4
service in terms of scalability, security, mobility, ease-of-configuration,
and real-time traffic handling.
For more information, refer to Sun Microsystems' "Networking IPv6 User
Guide for J2SDK/JRE 1.4" at http://java.sun.com/j2se/1.4/docs/guide/net/ipv6_guide/
HP-UX 11.11 (11i v1) PA-RISC and 11.23 (11i v2) Itanium support dual
protocol stacks IPv4 and IPv6. IPv6 is not currently supported on
HP-UX 11.0 or 11.22 (11i v1.5). In this SDK release, the IPv4 protocol
stack is the default. To support IPv6, HP-UX 11.11 (11i v1) requires
patches; HP-UX 11.23 (11i v2) does not.
To turn on IPv6 support, in addition to installing patches for HP-UX
11.11, you need to set the system property as follows:
java.net.preferIPv4Stack=false
Or at the Java command line you can use the option
-Djava.net.preferIPv4Stack="false"
For the availability of patches required for IPv6 support on HP-UX 11.11, please refer to
JVMDI: Full implementation of JVMDI and JPDA allows you to run
HotSpot with numerous tools such as TogetherSoft Control Center,
Code Warrior, Oracle JDeveloper, IBM Visual Age, Netbeans, JDE, MetaMata,
Tek. Tools, Elixier IDE, BlueJ, JIG, JSwat Project, Swing Debugger, and
the sample debugger jdb that ships with the SDK 1.4. For more information
on JVMDI and JPDA, go to:
http://java.sun.com/j2se/1.3/docs/guide/jpda/architecture.html
JPDA: Architecture and components are documented at:
http://java.sun.com/products/jpda/ and
http://java.sun.com/docs/index.html.
The jdb for HP-UX is similar to the Solaris implementation.
For usage information, see "Sun VM Invocation Options" at http://java.sun.com/products/jpda/doc/conninv.html.
JVMPI: Support for JVMPI means that you can profile java code with the
HotSpot 1.4 VM. Therefore, you can extract more accurate runtime profiles.
Some of the tools based on JVMPI include: hprof (-Xrunhprof), JProbe,
JUM, and OptimizeIt.
(Note: Although -hprof provides some stack trace
information not found in -Xeprof, the latter can sometimes be more useful
for performance tuning.)
HP WDB: You can now use HP's debugger WDB 3.0.01 to examine backtraces containing
mixed language frames (Java and C/C++) in Java thread stacks. This will
simplify debugging the VM and Java mixed-language applications. For more information, see the
"Usage Documentation" in these release notes.
-Xeprof option: Generates profile data for HPjmeter. See the section "HP Specific Options and Features" in these release notes for details.
-Xrs option: Reduces the use of operating-system signals by the Java virtual
machine (JVM). See the section "Additional HotSpot Option Information" in these release notes for more information.
3GB heap size: In this release, heaps up to 3GB are supported on HP-UX 11i
with the installation of patches. Please see the section "Large Java Heap Sizes" in these release notes for details.
64-bit mode (interpreter and compiler): Supported by using the option -d64. For further information, see "Additional HotSpot Option Information" in these release notes.
Java Web Start 1.2 is bundled with the SDK and RTE. For more information,
see the Java Web Start release notes in javaws-1_2_0_00-hpux-PA_RISC.tar.Z and javaws-1_2_0_00-hpux-PA_RISC.tar.Z. The Java Web Start 1.2 release notes are also available on the web at: Java™ Web Start Downloads and Documentation.
New garbage collectors: parallel, and concurrent mark and sweep.
See "New Garbage Collectors: Parallel and Concurrent Mark
and Sweep" in these release notes for more information.
installation
patches
Operating system patches should be installed before you install the software.
To determine which patches have been installed on your machine,
login as root and check your machine with:
/usr/sbin/swlist -l product
For the most up-to-date list of required and recommended patches,
and instructions on where to obtain them,
go to the Java Required Patches page at:
http://h18012.www1.hp.com/java/patches/index.html
NOTE: Please install ALL dependency patches as well. These will
be listed on the IT Resource Center web page from where you download the patch.
minimum system recommendation
HP-UX PA-RISC systems: HP server series rp5400, rp7400, rp8400, and Superdome,
and PA-based workstations. The recommended minimum system for running Java
applications is a PA-RISC 2.0 system.
HP-UX Itanium-based systems: HP rx4610, rx5670, and rx9610
servers and the HP i2000 workstation.
installation instructions
You need a total of approximately 160MB of disk space to download and install the .depot file. After installing the software, you can remove the
.depot file.
The HP-UX SDK, for the Java 2 Platform installs under /opt/java1.4.
As root user, use the SD-UX swinstall command to install the software:
/usr/sbin/swinstall
It will lead you through the installation. Change Source Depot Type
to "Local Directory" and Source Depot Path to /tmp/<filename>.
(If you used a directory other than /tmp in the previous step,
replace /tmp with that directory name.) We recommend you select
the "Reinstall filesets" and unselect the "Mount filesystems"
option from the options menu.
WARNING: Do not unarchive rt.jar, charsets.jar, jpda.jar, tools.jar,
jce.jar, and jsse.jar. These files are needed by the SDK tools and
the runtime environment.
Add the directory /opt/java1.4/bin to your PATH.
Note: To install the software into an alternate location, see
"Installing into an alternate location".
For information on setting important system parameters required for correct execution of Java programs refer to the Programmer's Guide which can be found at Programmer's Guide for Java™ 2.
Installing into an alternate location
To install the software into an alternate location, add @/<alternatedirectory> to the end of the swinstall line, and add the alternate directory to your PATH.
For example:
/usr/sbin/swinstall -s <download> \* @/<alternatedirectory>
Java prepends <alternatedirectory> to the default product path. Java will
therefore install in /<alternatedirectory>/opt/java1.4.
If you want your Java home directory in <alternatedirectory> without the /opt/java1.4 directories, you need to install into a temporary directory, and then move the directories to where you want them.
For example:
swinstall -s <download> \* @/<temporarydirectory>
mv <temporarydirectory>/opt/java*/* <finalalternatedirectory>
Or you can install and link to the directories.
For example:
swinstall -s <download> \* @/<actualdirectory>
ln -s <finalalternatedirectory> /<actualdirectory>/opt/java*
You will notice that the two files, <alternatedirectory>/etc and <alternatedirectory>/var are created. These may be purged, because they do not apply to a product installed in an alternate location.
Note that we are testing another method of installing into an alternate location using <tag>. When we are confident that this method works with software depot install, we will post instructions here.
file structure
The diagram below displays an abbreviated form of the file structure:
java1.4
|
___|_____________________________________________________
| | | | | |
bin lib jre src.zip demo include
| | javaws files*
java tools.jar |
javac dt.jar |
javadoc ir.idl |
javah orb.idl |
javap |
jdb |
___|_____________________________
| |
bin lib
| |
________________________________________________ |
java PA_RISC PA_RISC2 PA_RISC2.0W IA64N IA64W |
|
|
__________________________________________________________________
| | | | | | | |
rt.jar zi security PA_RISC PA_RISC2.0 PA_RISC2.0W IA64N IA64W
charsets.jar |________|___________|___________|________|___
jce.jar | | | | |
jsse.jar server server server server server
* The files javaws-1_2_0_00-hpux-PA_RISC.tar.Z and javaws-1_2_0_00-hpux-PA_RISC.tar.Z are in the JRE directory, and contain Java Web Start technology 1.2. Web Start release notes are included in the tar.Z files. To extract a .tar.Z file, enter the command:
zcat <filename> |tar -xvf
The tools install under opt/java1.4/bin and the libraries install under
opt/java1.4/lib. The tools.jar file contains the classes for supporting
the tools and utilities. The file dt.jar contains the DesignTime
archive of BeanInfo files.
The jre directory includes the runtime environment. The file rt.jar contains
the runtime classes for the core API. The file charsets.jar contains the
internationalization and localization classes and files. The security
directory contains security management files. The PA_RISC and PA_RISC2.0,
and PA_RISC2.0W directories contain the shared libraries used by the HP-UX
platform. The file src.zip contains an archive of source files for the core
API for informational purposes. To extract the files, enter the command:
$ unzip src.zip
The include directory contains the header files for supporting JNI and
JVMDI.
usage documentation
The HP-UX Programmer's Guide for Java 2 provides additional information. It is available at http://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?productNumber=HPUXJAVAHOME, under "information library".
The Java 2 Platform, Standard Edition, v 1.4 API Specification is
provided at http://java.sun.com/products/jdk/1.4/docs/api/index.html.
Below are the following additional documentation notes:
supported tools and options
To run a tool on HP-UX, either use the full path name or add the path
to the startup file. For example, for javac, on the command line you
could enter: /opt/java1.4/bin/javac yourfile.java. You could alternatively
add /opt/java1.4/bin to your PATH statement and on the command line enter:
javac yourfile.java
The HotSpot technology accepts all of the standard tools and options.
The standard tools and the standard documentation references are noted below:
The appletviewer tool is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/appletviewer.html
CLASSPATH is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/classpath.html
The extcheck tool is documented at:
http://java.sun.com/reference/docs/index.html
The idlj tool is documented at:
http://java.sun.com/docs/index.html
The jar tool is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/jar.html
The jarsigner tool is documented at:
http://java.sun.com/docs/index.html
The java tool is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/java.html
The javac tool is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/javac.html
The javadoc tool is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/javadoc.html
The javah tool is documented at:
http://www.java.sun.com/products/jdk/1.4/docs/tooldocs/solaris/javah.html
The javap tool is documented at:
http://java.sun.com/docs/index.html
The jdb (JPDA) tool is documented at:
http://java.sun.com/docs/index.html
The keytool tool is documented at:
http://java.sun.com/reference/docs/index.html
The native2ascii tool is documented at:
http://java.sun.com/reference/docs/index.html
The orbd tool is documented at:
http://java.sun.com/j2se/1.4/docs/guide/idl/orbd.html
The policytool tool is documented at:
http://java.sun.com/reference/docs/index.html
The rmic tool is documented at:
http://java.sun.com/reference/docs/index.html
The rmid tool is documented at:
http://java.sun.com/reference/docs/index.html
The rmiregistry tool is documented at:
http://java.sun.com/reference/docs/index.html
The serialver tool is documented at:
http://java.sun.com/reference/docs/index.html
The servertool is documented at:
http://java.sun.com/j2se/1.4/docs/guide/idl/servertool.html
The tnameserv tool is documented at:
http://java.sun.com/reference/docs/index.html
additional HotSpot option information
The HotSpot technology accepts all of the standard options as
well as the following partial list of non-standard -X options.
Non-standard options are subject to change in future releases.
-d64
Runs Java in 64-bit mode. See the section "64-bit support" under
Known Issues in these release notes for more information
on patches required.
-X
Prints out a brief usage message describing the non-standard options.
-Xbatch
Disables background compilation. If compilation of a large method
is taking a long time, the performance engine will revert to
interpreting the method. It will compile the method as a background
task, running the method in interpreter mode until the background
compilation is finished. The -Xbatch flag disables background
compilation so that compilation of all methods proceeds as a
foreground task until completed, regardless of how long the
compilation takes. This flag is provided for users who desire
more deterministic behavior of method compilation for purposes such
as benchmarking.
-Xbootclasspath: <bootclasspath>
Specify a colon-separated list of directories, JAR archives,
and ZIP archives to search for boot class files. The specified boot
class libraries will be used instead of the boot class files in the
jre/lib/rt.jar archive normally used by the Java 2 software.
-Xincgc
Enable the incremental garbage collector. The incremental garbage
collector, which is off by default, will eliminate occasional
garbage-collection pauses during program execution. However,
it can lead to a roughly 10% decrease in overall performance. Note that -Xincgc is not supported on 32-bit PA-RISC in this release. Support will be available in a future SDK release.
-Xint
Operate in interpreted-only mode. Compilation to native code is
disabled, and all bytecodes are executed by the interpreter.
The performance benefits offered by the Java HotSpot adaptive compiler
will not be present in this mode.
-Xmn
Set the Java new generation heap size (for example: -Xmn64m). The
"new generation" is the first generation in HotSpot's generational
garbage collector. This option replaces the option -XX:NewSize=N.
-Xms<size>
Specify the initial size, in bytes, of the memory allocation pool.
This value must be a multiple of 1024 greater than 1MB. Append the
letter k or K to indicate kilobytes, or m or M to indicate megabytes.
The default value is 5248KB. Examples:
-Xms4194304
-Xms4096k
-Xms4m
-Xmx
Specify the maximum size, in bytes, of the memory allocation pool.
This value must be a multiple of 1024 greater than 2MB. Append the
letter k or K to indicate kilobytes, or m or M to indicate megabytes.
The default value is 64MB. Examples:
-Xmx83886080
-Xmx81920k
-Xmx80m
-Xnoclassgc
Disables class garbage collection.
-Xprof (Excerpt below from Sun Microsystems' documentation.)
Profiles the running program, and sends profiling data to standard output.
This option is provided as a utility that is useful in program development
and is not intended to be be used in production systems.
-Xrs (beginning with SDK 1.3.1)
Reduces use of operating-system signals by the Java virtual machine (JVM),
allowing for orderly shutdown of a Java application. Allows user cleanup code
(such as closing database connections) to run at shutdown, even if the
JVM terminates abruptly. For more information, see Javasoft's documentation at:
http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/java.html.
-Xss<size>
Specify the size of stack for each new Java thread. The default
Java thread stack size is 512KB. This flag is appropriate for programs
that have small thread stack size requirements and/or create several
thousand threads, potentially running out of virtual memory. Program
threads that overflow the allocated stack will receive java.lang.StackOverFlowException.
| Defaults: | -Xss512k (Java 1.3 and 1.4 32-bit mode)
|
| | -X1m (Java 1.4 64-bit mode)
|
|