# Novell JVM 1.4.2 for NetWare

1.0 Introduction
2.0 What's New
2.1 New in NJVM 1.4.2 SP3
2.2 New in NJVM 1.4.2 SP2
2.3 New in NJVM 1.4.2 SP1
3.0 System Requirements
4.0 Known Issues
4.1 Security Alert Dialog Appears When Accessing NetWare Remote Manager (NRM) in the NetWare Server Browser
4.2 XML Parsing Issue
5.0 NJVM 1.4.2 Product Support
5.1 Products Supported on NJVM 1.4.2
5.2 Products Currently Being Tested on NJVM 1.4.2
5.3 Products Not Supported on NJVM 1.4.2
6.0 NJVM 1.4.2 Installation
7.0 Documentation and Support
8.0 Legal Notices

## 1.0 Introduction

This release of Novell® JVM* for NetWare® is version 1.4.2 SP3.

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

NJVM 1.4.2 SP3 is based on the Sun's* J2SE 1.4.2_04.

## 2.0 What's New

### 2.1 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.

### 2.2 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.

### 2.3 New in NJVM 1.4.2 SP1

- Updated to Sun's J2SE 1.4.2_03.

## 3.0 System Requirements

NJVM 1.4.2 requires one of the following versions of NetWare:

- NetWare 6 with Support Pack 4 or later
- NetWare 6.5 with Support Pack 1 or later

## 4.0 Known Issues

### 4.1 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 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® exteNdTM DirectorTM 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

## 5.0 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.

### 5.1 Products Supported on NJVM 1.4.2

- eGuide 2.11 or later
- ConsoleOne 1.3.6
- eDirectoryTM
- iManager
- NetStorage 2.05
- Novell Installation Services (NIS)
- Portal Services (Novell exteNdTM DirectorTM) 1.4 or later
- Tomcat 3.3 or later
- Virtual Office 1.1
- Web Search
- ZENworks® for Servers 3

### 5.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 ServicesTM 6 Web Self Service

### 5.3 Products Not Supported on NJVM 1.4.2

- ConsoleOne® 1.3.5

## 6.0 NJVM 1.4.2 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:

1. (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.

2. Run the NJVM 1.4.2 self-extracting executable file (jvm142sp3.exe) on a Windows* workstation.

   This expands the archive and launches the InstallShield installation script.

3. 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.

4. 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.

5. 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.

## 7.0 Documentation and Support

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

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

## 8.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 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 and Separate Limited Warranty, which can be found in the license.txt file provided in this download.

Copyright © 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.