Index of /pub/mirrors/ftp.novell.com/forge/jvm

 Name                               Last modified      Size  Description
 Parent Directory                                        -   
 CHANGELOG.html                     18-Feb-2005 09:29  6.0K  
 DEPENDENCIES.html                  18-Feb-2005 16:22  3.7K  
 DOCUMENTATION.html                 24-Jan-2005 00:00  132   
 LICENSE.txt                        16-Nov-2004 00:00   11K  
 README.html                        17-Dec-2004 00:00   43K  
 builds/                            27-Aug-2008 01:55    -

Novell JVM for NetWare

1.0 Introduction

2.0 NJVM 1.1.7b

2.1 New in NJVM 1.1.7b

2.2 NJVM 1.1.7b Recommendations

2.2.1 Video Cards

2.2.2 Classes and Libraries

2.3 NJVM 1.1.7b NetWare Platform Dependencies

2.3.1 NetWare 5.0 Dependencies

2.3.2 NetWare 5.1 Dependencies

2.4 Installing the JDK for NetWare

2.5 NJVM 1.1.7b Known Issues

2.5.1 NJVM Security Flaw

2.6 NJVM 1.1.7b Performance Tuning

2.7 Using Java Native Interface (JNI)

2.8 JVM File Descriptions

3.0 NJVM 1.3.1

3.1 New in NJVM 1.3.1

3.1.1 New in NJVM 1.3.1 SP9

3.1.2 New in NJVM 1.3.1 SP8

3.1.3 New in NJVM 1.3.1 SP7

3.1.4 New in NJVM 1.3.1 SP6

3.1.5 New in NJVM 1.3.1 SP5

3.1.6 New in NJVM 1.3.1 SP4

3.1.7 New in NJVM 1.3.1 SP3

3.2 NJVM 1.3.1 System Requirements

3.3 NJVM 1.3.1 Recommendations

3.3.1 Video Card

3.3.2 Classes and Libraries

3.4 NJVM 1.3.1 Known Issues

3.5 NJVM 1.3.1 Installation

4.0 NJVM 1.4.2

4.1 New in NJVM 1.4.2

4.1.1 New in NJVM 1.4.2 SP4

4.1.2 New in NJVM 1.4.2 SP3

4.1.3 New in NJVM 1.4.2 SP2

4.1.4 New in NJVM 1.4.2 SP1

4.1.5 System Requirements

4.2 Known Issues

4.2.1 Forward Slash (/) Might Cause Error in Java Applications on all Platforms

4.2.2 Security Alert Dialog Appears When Accessing NetWare Remote Manager (NRM) in the NetWare Server Browser

4.2.3 XML Parsing Issue

4.3 NJVM 1.4.2 Product Support

4.3.1 Products Supported on NJVM 1.4.2

4.3.2 Products Currently Being Tested on NJVM 1.4.2

4.3.3 Products Not Supported on NJVM 1.4.2

4.4 NJVM 1.4.2 Installation

5.0 Documentation and Support

6.0 Legal Notices

1.0 Introduction

This Readme document for Novell JVM for NetWare covers versions 1.1.7b, 1.3.1, and 1.4.2.

In this document, Novell JVM for NetWare is referred to as NJVM.

2.0 NJVM 1.1.7b

2.1 New in NJVM 1.1.7b

The following items are new in NJVM 1.1.7b:

An XSetup utility is provided for configuring the GUI environment. It is used to configure standard VGA, super VGA and Accelerated-X servers on NetWare. It allows you to select the video board, keyboard, mouse, and monitor for these video controllers from a set of predefined hardware devices that are supported by the XSetup utility.
XFree86 SVGA is the new default XServer, and Xi Graphic's Accelerated-X XServer is available as an alternative. XFree86 supports VESA 1.2 through 3.0. Support is limited to 640x480 16 colors for VGA and 256 colors for VESA compliant video controllers. Accelerated-X supports over 540 specific video cards; however the accelerated video controllers are limited to 256 colors.

A configurable desktop menu with options for adding, modifying and removing menu items. You can also install a program into the menu, and set taskbar properties.

Support for the euro character in a Java GUI screen, to insert this character, press the Ctrl+Alt+E keys together. For keyboards with an Alt+Gr key, you can also insert the euro character by pressing the Alt+Gr+e. To display the euro character in a Java GUI screen, use the 0x20AC (Hex) Unicode character.
NOTE: The euro character is available only in the Java GUI, this does not print to the server console.
An upgraded JIT resolves previous a issue where some applications did not run with the JIT, requiring that the JIT be disabled. The JIT no longer needs to be disabled, but rather it should be enabled because it is now disabled by default (see 8.0 Enabling the JIT).
The default code page used on an English NetWare server has traditionally been 437. This default remains the same; however, if your instantiation of the JVM needs a different code page, it can be changed via the JAVA_CODEPAGE environment variable. The following are examples of the code page usage:
```
envset JAVA_CODEPAGE=Cp1252 
envset JAVA_CODEPAGE=Cp437 
envset JAVA_CODEPAGE=ISO8859_1 
 
Or 
java -envJAVA_CODEPAGE=Cp1252 yourClassName 
java -envJAVA_CODEPAGE=ISO8859_1 yourClassName 
Or 
java -Dfile.encoding=ISO8859_1 yourClassName 
java -Dfile.encoding=Cp1252 yourClassName
```
These are only examples and do not represent all the code pages that are supported. To view other possible values, specify the following URL in your browser:

http://java.sun.com/products/jdk/1.2/docs/guide/internat/encoding.doc.html

2.2 NJVM 1.1.7b Recommendations

2.2.1 Video Cards

If you are purchasing a new video card, VESA 2.0 support with linear frame buffer access is preferred. Some early cards may not be VESA 2.0 compatible, so make sure that the documentation states whether your card is compliant. The PCI and AGP bus types are the preferred types because they are the fastest. The NetWare GUI performs at the same speed with PCI and AGP.

The following are recommended video cards:

Matrox Mystique
Matrox Millennium
TI 3d Rage Pro

2.2.2 Classes and Libraries

When writing Java applications to run on NetWare, we recommend using the Java Foundation class (JFC) libraries from Sun Microsystems.

2.3 NJVM 1.1.7b NetWare Platform Dependencies

2.3.1 NetWare 5.0 Dependencies

For NetWare 5.0 you need to install Support Pack 3 before installing this version of the Novell JVM for NetWare. You can download the current Support Packs from http://support.novell.com/misc/patlst.htm#nw

2.3.2 NetWare 5.1 Dependencies

For NetWare 5.1 you need to install Support Pack 2A before installing this version of the Novell JVM for NetWare.

You can download the current Support Packs from http://support.novell.com/misc/patlst.htm#nw

2.4 Installing the JDK for NetWare

Use the following instructions to install the JDK for NetWare:

Unload NJVM for NetWare (if loaded).
Map a drive or attach to the server where you want to install the JDK files. (You must have administrator rights to the server.)
Run jvm.exe on your workstation.
Follow the rest of the InstallShield instruction to complete the installation.
Reboot your server.

2.5 NJVM 1.1.7b Known Issues

2.5.1 NJVM Security Flaw

In March, 1999 a serious security flaw was found in the Java 2 Virtual Machine (VM). The flaw exploits the VMs Verifier security component. This verifier bug allows unverified code to be executed. This problem has been fixed in this release of the NJVM 1.1.7b.

2.6 NJVM 1.1.7b Performance Tuning

If you have a Java-based server program on the NetWare server and it handles a large amount of traffic, you might need to increase the maximum number of packet receive buffers on the server to prevent packets from getting dropped. Dropped packets slow performance because client programs have to time out and retransmit. To increase packet receive buffers, you can issue a NetWare console command such as:

set maximum packet receive buffers = 1000 You can add this command to autoexec.ncf so it is always set when the server comes up.The default native (C) stack size for Java threads on NetWare is 48 KB. For applications that create many threads and do not require such a large stack size, the -ss Java command parameter can be used to specify the stack size. (See JavaSoft's documentation for the Java Interpreter for an explanation of the Java command options.) To specify the amount of virtual memory available to Java applications for non-heap allocations, use the -vm Java command option. The default is 32 MB. The -vm Java command option is unique toNetWare and is not supported by JavaSoft. The following is the syntax for this option:

java -vm size in bytes MyClass

2.7 Using Java Native Interface (JNI)

Included in the java\bin directory is a file named jni.tar which, when extracted, demonstrates simple native method examples for Java 1.1. This package is intended as an example of how to write native methods for the Java 1.1.7b Virtual Machine on NetWare, and is not intended as a comprehensive tutorial on writing native methods.The Invocation APIs are not currently supported in JVM 1.1.7b, but might be supported in a future JVM release. The following are the specific calls that are not supported:

JNI_GetDefaultJavaVMInitArgs
JNI_GetCreatedJavaVMs
JNI_CreateJavaVM
DestroyJavaVM
AttachCurrentThread
DetachCurrentThread.

2.8 JVM File Descriptions

Sys:\Java\Lib 
    classes.zip - Standard Java classes for NetWare 
 
Sys:\Java\Bin  
    agent.nlm - Debug agent java.nlm - Novell JVM for NetWare 
    javah.nlm - Creates C header and source files  
    jdbc.nlm - Java Database Connectivity NLM 
    jnet.nlm - Java.net classes support 
    jni.tar - Simple native method examples 
    jpeg.nlm - JPEG image support 
    math.nlm - Math support 
    mmedia.nlm - Multimedia support 
    sysres.nlm - System resources 
    aip.nlm - Java compression library  
 
Sys:\Java\NWGFX 
    aiops2.nlm - Mouse driver for PS/2 mouse  
    def_rsp.ncf - Script for setting up GUI to VGA 16 (Default) 
    nwwm.nlm - Window manager for GUI 
    STARTX.NCF - Starts graphical user interface  
    SuperPro.nlm - Utility for creating configuration and  
    startup files  
    nawt.nlm - Java native methods  
    vesa_rsp.ncf - Script for setting up GUI to SVGA 256 colors 
    xf86conf - Configuration file for GUI 
    xfsvga.nlm - Driver for Super VGA 256-color cards  
    xfvga16.nlm - Driver for VGA 16-color cards  
    xlib.nlm - Display mechanism for GUIe 
    xmodmap.nlm - International Keyboard Support NLM  
 
Sys:\Java\NWGFX\Fonts - Fonts for displaying characters in an AWT windowSys:\Java\NWGFX\Locale - Locale specific files such as xmodmap.* and keyboard mapping files.Sys:\Java\nwgfx\Pixmap *.xpm - XPM format files used for background pattern.Sys:\System aio.nlm - Asynchronous I/O driver, which allows aiocomx.nlm to function as a mouse driver; aiocomx.nlm - Protocol for serial mice.

3.0 NJVM 1.3.1

3.1 New in NJVM 1.3.1

3.1.1 New in NJVM 1.3.1 SP9

NJVM 1.3.1 SP9 is based on Sun's* J2SE 1.3.1_10.

3.1.2 New in NJVM 1.3.1 SP8

Updated to a new version of the NetWare server browser.

3.1.3 New in NJVM 1.3.1 SP7

Updated to Sun's J2SE 1.3.1_10.

3.1.4 New in NJVM 1.3.1 SP6

Updated to Sun's J2SE 1.3.1_08.

3.1.5 New in NJVM 1.3.1 SP5

Updated to Sun's J2SE 1.3.1_07.
Fixed high CPU utilization in JSock when a thread is killed while reading from a socket.
Fixed a problem with accessing files where ./ is used at the start of relative paths.
Fixed a WAN link socket connection problem. For more information, see TID 10084599.

3.1.6 New in NJVM 1.3.1 SP4

Updated NJVM 1.3.1 installation to change only the CLASSPATH and JAVA_COMPILER variables in java.cfg. For more information, see TID 10079861.
Fixed page fault in ZENworks import. For more information, see TID 10080649.

3.1.7 New in NJVM 1.3.1 SP3

Updated to Sun's J2SE 1.3.1_06.
Added multi-server installation capabilities.
Fixed abend while processing SP1 of ZENworks for Servers 3.0. For more information, see TID 10078122.

3.2 NJVM 1.3.1 System Requirements

NJVM 1.3.1 requires NetWare 5.1 with SP6 or later, or NetWare 6 with SP3 or later.

3.3 NJVM 1.3.1 Recommendations

3.3.1 Video Card

If you are purchasing a new video card, VESA 2.0 or later support with linear frame buffer access is preferred. Some early cards might not be VESA 2.0 compliant. The PCI and AGP bus types are the preferred types because they are the fastest. The NetWare GUI performs at the same speed with PCI and AGP.

The cards must also support 256 Colors. (NJVM 1.3.1 does not support 16 colors.)

3.3.2 Classes and Libraries

When writing graphical Java applications to run on NetWare, we recommend using the Swing classes from Sun Microsystems*.

3.4 NJVM 1.3.1 Known Issues

If you are using ZENworks for Desktops version 3, you must install ZfD 3 SP1 or later.
During an upgrade, sometimes the xlib.nlm does not unload. If this occurs, we recommend restarting the server or you can manually unload xlib.nlm.
If any errors occur during the installation, see the Installation section of the JVM 1.3.1 Administration Guide.
ZENworks for Servers: Tiered Electronic Distribution uses security certificates to allow subscribers to verify that the distribution they are receiving is from a trusted source. This feature will not work in a mixed JVM 1.1.7b and JVM 1.3.1 environment. For example, you have some TED components running on servers with 1.1.7b and other TED components running on servers with JVM 1.3.1. If you choose to run TED in this environment, you need to turn off the use of the security certificate. For details, see TID 10060307.
If you use OnDemand v1.5 with JVM 1.3.1, edit the file sys:\system\usageserver.ncf and change the following line:
java -ns -classpath$USAGCLASSPATH UsageServer
to read

Java -ns -Xbootclasspath $USAGECLASSPATH UsageServer

3.5 NJVM 1.3.1 Installation

IMPORTANT: During the installation, you need to connect to the servers you want to install to. You also need to close the NetWare GUI, shut down NJVM, and unload xlib.nlm. You can do these tasks manually or have the installation process do them automatically. You select the options you want in step 4 of the installation process.

We recommend that you complete the installation process during off-peak production times.

To install NJVM:

(Optional) Create a text file with a list of the servers that you want the installation process to connect to.

This file must have only one server per line. For example:

MyServer1

MyServer2.mydomain.com

10.0.0.3

Myserver4

NOTE: We recommend using IP addresses when connecting to servers over a WAN.
Run the NJVM 1.3.1 self-extracting executable file (jvm131sp9.exe) on a Windows* workstation.

This expands the archive and launches the InstallShield installation script.
On the Installation Options screen, select one of the following options:
- Typical installation. Use this installation type to do a normal install.
- Modem or Slow WAN installation. Use this installation type if you have a slow network connection and you have an alternate method of distributing the java.zip file to all the servers you want to install to.
- Unpack Java. Use this option to unpack java.zip to a directory of your choice. Copy java.zip to SYS:\ on each target server prior to running the Modem or Slow WAN installation.
- View Readme.
On the Select Options screen, select one, both, or neither of the following options:
- Connect to the servers listed in a text file. If you select this option, the installation process will connect to each server listed in the text file you created in step 1. If you do not select this option, you must manually connect to each target server.
- Unload Java from target servers. If you select this option, the installation process unloads java.nlm, closes the GUI, and unloads xlib.nlm from the target servers. If you do not select this option, you must do these tasks manually on each target server.
Reboot your servers if necessary.

NOTE: If any problems occur with the GUI after you upgrade to NJVM 1.3.1, enter stopx at the system console and run VESA_RSP. This resets the GUI to the default settings.

4.0 NJVM 1.4.2

4.1 New in NJVM 1.4.2

4.1.1 New in NJVM 1.4.2 SP4

Upgraded to Sun's J2SE 1.4.2_06
Fixed an abend in the exteNd application server caused by a timing issue in jsock.

4.1.2 New in NJVM 1.4.2 SP3

Updated to a new version of the NetWare server browser.
Removed the restriction on the number of arguments that can be entered on the command line when launching a Java application.

4.1.3 New in NJVM 1.4.2 SP2

Updated to Sun's J2SE 1.4.2_04.
Fixed an issue where Zen for Servers would hang during the shutdown routine.
Changed the FileChannel lock to be non-blocking, which eliminates the following exception: java.io.IOE exception: Lock failed.
Changed File.renameTo() to properly handle file names with a leading slash, such as /SYS:/example.txt.
Updated the NetWare GUI to allow proper functionality of a VNC server on NetWare.
Fixed the Xserver to properly handle hot-plugging a USB mouse.
Added modem or slow WAN connection installation option. For installation instructions, see section 6.0 of this Readme.
Fixed ArkManager shutdown issue.
Fixed an issue where Tomcat would hang after running for several days.

4.1.4 New in NJVM 1.4.2 SP1

Updated to Sun's J2SE 1.4.2_03.

4.1.5 System Requirements

NJVM 1.4.2 requires one of the following versions of NetWare:

NetWare 6 with SP4 or later
NetWare 6.5 with SP1 or later

4.2 Known Issues

4.2.1 Forward Slash (/) Might Cause Error in Java Applications on all Platforms

Sun's J2SE 1.4.2_05 and later, requires that you use a period (.) instead of a forward slash (/) when specifying a class name. This requirement affects the following functions:

java.lang.ClassLoader.loadClass()
java.lang.ClassLoader.defineClass()
java.lang.ClassLoader.findClass()
java.lang.ClassLoader.findSystemClass()
java.lang.ClassLoader.resolveClass()

IMPORTANT: This parameter does not affect class names in native JNI methods. In JNI, you must use the forward slash (/) in class names.

4.2.2 Security Alert Dialog Appears When Accessing NetWare Remote Manager (NRM) in the NetWare Server Browser

A security dialog box might appear when you access a secure site such as NetWare Remote Manager (NRM) using the NetWare server browser in the NetWare GUI. This dialog box displays a security certificate, which is a file sent from the secure site asserting the site's identity. By accepting the certificate, you indicate that you trust the content coming from the server.

The following are the certificate options:

Once: The certificate is valid for one session and you agree to receive content for only that session.
Always: The certificate is valid for all sessions meaning you agree to always receive content from the server.
No: You do not accept the certificate. This cancels your session.

4.2.3 XML Parsing Issue

The XML parsing interfaces in NJVM 1.4.2 differ from those in 1.4.1. The changes can cause failures in some existing Java* applications such as Novell^® exteNd^TM Director^TM 4.0 on NetWare 6.0.

In exteNd Director, the error WrappedRuntimeException might occur.

To prevent this failure, open /webapps/nps/win-inf/lib and delete the following files:

xerces.jar
xercesimpl.jar
xalan.jar

4.3 NJVM 1.4.2 Product Support

NJVM 1.4.2 is a fully certified Java virtual machine. This release of NJVM 1.4.2 has passed all of the tests in Sun's Java Conformance Kit. Novell thoroughly tests NJVM releases before making them available to the public. All Novell software products might not be compatible with NJVM 1.4.2 at this time. Extensive testing occurs for all major NetWare releases and Consolidated Support Pack releases.

This section lists the NJVM 1.4.2 support status for Java-based Novell products. This section will be updated in future releases of NJVM 1.4.2 as Novell products add support for NJVM 1.4.2.

4.3.1 Products Supported on NJVM 1.4.2

eGuide 2.11 or later
ConsoleOne 1.3.6
eDirectory^TM
iManager
NetStorage 2.05
Novell Installation Services (NIS)
Portal Services (Novell exteNd^TM Director^TM) 1.4 or later
Tomcat 3.3 or later
Virtual Office 1.1
Web Search
ZENworks^® for Servers 3

4.3.2 Products Currently Being Tested on NJVM 1.4.2

The following products have an undetermined support status on NJVM 1.4.2. Full testing of these products with NJVM 1.4.2 has not been completed. Use caution when using these products with NJVM 1.4.2 in a production environment:

BorderManager^® 3.8
DirXML^® 1.1a
GroupWise Monitor 6.5 SP1
UCS
ZENworks for Desktops 3.2 SP3 and 4 SP1
ZENworks OnDemand Services^TM 6 Web Self Service

4.3.3 Products Not Supported on NJVM 1.4.2

ConsoleOne^® 1.3.5

4.4 NJVM 1.4.2 Installation

We recommend that you complete the installation process during off-peak production times.

To install NJVM:

(Optional) Create a text file with a list of the servers that you want the installation process to connect to.

This file must have only one server per line. For example:

MyServer1

MyServer2.mydomain.com

10.0.0.3

Myserver4

NOTE: We recommend using IP addresses when connecting to servers over a WAN.
Run the NJVM 1.4.2 self-extracting executable file (jvm142sp4.exe) on a Windows* workstation.

This expands the archive and launches the InstallShield installation script.
On the Installation Options screen, select one of the following options:
- Typical installation. Use this installation type to do a normal install.
- Modem or Slow WAN installation. Use this installation type if you have a slow network connection and you have an alternate method of distributing the java.zip file to all the servers you want to install to.
- Unpack Java. Use this option to unpack java.zip to a directory of your choice. Copy java.zip to SYS:\ on each target server prior to running the Modem or Slow WAN installation.
- View Readme.
On the Select Options screen, select one, both, or neither of the following options:
- Connect to the servers listed in a text file. If you select this option, the installation process will connect to each server listed in the text file you created in step 1. If you do not select this option, you must manually connect to each target server.
- Unload Java from target servers. If you select this option, the installation process unloads java.nlm, closes the GUI, and unloads xlib.nlm from the target servers. If you do not select this option, you must do these tasks manually on each target server.
Reboot your servers if necessary.

NOTE: If any problems occur with the GUI after you upgrade to NJVM 1.4.2, enter stopx at the system console and run VESA_RSP. This resets the GUI to the default settings.

For detailed information about the installation process, see the Novell JVM 1.4.2 for NetWare Administration Guide.

5.0 Documentation and Support

For the most recent documentation on setting up and configuring JVM, see the Novell JVM for NetWare Installation and Administration Guide for your version of NJVM.

Support for NJVM is provided by Novell Developer Services through the Developer newsgroup.

6.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not use, export, or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

All files provided in this release are subject to the Novell Developer Kit License Agreement, which can be found in the license.txt file provided in this download.

Copyright ^© 1999 - 2004 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell and NetWare are registered trademarks of Novell, Inc. in the United States and other countries.

All third-party products are the property of their respective owners