Novell JVM 1.4.1 for NetWare Readme January 23, 2003 Table of Contents 1.0 Introduction 2.0 What's New 2.1 New in NJVM 1.4.1 SP6 2.2 New in NJVM 1.4.1 SP5 2.3 New in NJVM 1.4.1 SP4 2.4 New in NJVM 1.4.1 SP3 2.5 New in NJVM 1.4.1 SP2 2.6 New in NJVM 1.4.1 SP1 3.0 System Requirements 4.0 Known Issues 4.1 Starting Console Commands from the NetWare GUI (NetWare 6.0 SP3) 4.2 AWT Internationalization Limitations 5.0 Recommendations 5.1 Video Card Driver 5.2 Classes and Libraries 6.0 Internationalization 6.1 Russian Keyboard Activation 6.2 AWT Limitations 6.3 Adding Fonts with font.properties.allfonts 7.0 NJVM 1.4.1 Product Support 7.1 Products Supported on NJVM 1.4.1 7.2 Products Currently Being Tested on NJVM 1.4.1 7.3 Products Not Supported on NJVM 1.4.1 8.0 NJVM 1.4.1 Installation 8.1 NetWare Dependencies 8.2 Installing NJVM 1.4.1 9.0 Documentation and Support 10.0 Documentation Conventions 11.0 Legal Notices 1.0 Introduction This release of Novell JVM for NetWare is version 1.4.1 Support Pack 6. In this document, Novell JVM 1.4.1 for NetWare is referred to as NJVM 1.4.1. NJVM 1.4.1 is based on Sun's* J2SE 1.4.1_06. 2.0 What's New 2.1 New in NJVM 1.4.1 SP6 - Updated to Sun's* J2SE 1.4.1_06 code base. - Fixed a defect in the File Browser to allow the utility to properly handle long volume names. For more information, see TID 10088895. 2.2 New in NJVM 1.4.1 SP5 - Updated to Sun's J2SE 1.4.1_05 code base. 2.3 New in NJVM 1.4.1 SP4 - Added enhancements to the NJVM installation process. These enhancements provide the option to automatically connect to target servers and to unload Java from these servers. - Added a fix to java.nio that eliminates the following exception: "java.lang.Error: POLLNVAL detected". - Decreased the loading time for graphical Java applications. - Changed the Terminate Application button in the Java Application Information section of NetWare Remote Manager to call shutdown hooks before terminating the application. 2.4 New in NJVM 1.4.1 SP3 - Provides a fix for an occasional Installation hang when installing NetWare 6.5 onto the VMware ESX product. 2.5 New in NJVM 1.4.1 SP2 - Increased scalability. - Enhanced keyboard functionality including dead key support. - Improved multiprocessor support. - Several internationalization (i18n) changes. For information on these changes, see section 5.0, Internationalization. 2.6 New in NJVM 1.4.1 SP1 - Updated to Sun's 1.4.1_02a code base. - Overall performance is improved. - The Window Manager is updated to use a C-based taskbar and provides additional functionality. - The NetWare GUI has been decoupled from Java*. Running startx no longer loads Java; however, the NetWare GUI is loaded when you start a graphical Java application (if the NetWare GUI has not already been loaded). Also, unloading Java does not unload the NetWare GUI. NJVM 1.4.1 has a stopx command that lets you close the NetWare GUI from the system console. - The GUI Server Console utility is now C-based and does not require Java to be loaded. Multiple instances of the Server Console utility can be loaded. This lets you view multiple server screens simultaneously from the NetWare GUI. - The Menu Editor lets you add toolbar buttons to the GUI taskbar and assign hot keys for starting GUI applications. 3.0 System Requirements NJVM 1.4.1 requires one of the following: - NetWare 6 with Support Pack 3 or later - NetWare 6.5 (FCS only) 4.0 Known Issues 4.1 Starting Console Commands from the NetWare GUI (NetWare 6.0 SP3) Console commands that prompt for a key press to continue, (such as config or modules), must not be started from the taskbar menu or the Run dialog. However, you can run these commands from the Server Console utility. This limitation exists only in NetWare 6.0 SP3. 4.2 AWT Internationalization Limitations There are some internationalization (i18n) limitations associated with AWT components. For information about these limitations, see Section 6.2, AWT Limitations. 5.0 Recommendations 5.1 Video Card Driver When selecting a video driver, we recommend using the standard XVesa driver. 5.2 Classes and Libraries When writing graphical Java applications to run on NetWare, we recommend using the Swing classes from Sun Microsystems*. 6.0 Internationalization 6.1 Russian Keyboard Activation The Russian keyboard now toggles between standard and Russian characters in the same manner as is done by keyb.nlm. To toggle between modes, press the left and right shift keys together. The mode on startup is standard characters. The Russian keyboard must be selected in the GUI setup utility, or the server must be installed as a Russian server. 6.2 AWT Limitations Dead keys are not supported in AWT components. AWT can display characters only from the current locale that is selected with the console's language command or the locale that the server was installed with. AWT currently cannot display Japanese, Chinese, and Korean. Keyboard entry of Russian characters in AWT is available only if the Language 13 command is issued or the server was installed as a Russian server. 6.3 Adding Fonts with font.properties.allfonts The font.properties file with no extension is the default file for Latin character languages. Files with additional endings are provided for Russian, Japanese, Chinese, and Korean servers. No configuration is necessary beyond setting the server language during installation because NJVM automatically selects the appropriate font.properties. file for the language setting. However, some servers might require systems or other resources located on different language platforms. To enable full character support, back up the font.properties file, then rename the provided file font.properties.allfonts to font.properties. This initially slows the application startup due to the additional characters that need to load. 7.0 NJVM 1.4.1 Product Support NJVM 1.4.1 is a fully certified Java virtual machine. This release of NJVM 1.4.1 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.1 at this time. Extensive testing occurs for all major NetWare releases and Consolidated Support Pack releases. This section lists the NJVM 1.4.1 support status for Java-based Novell products. This section will be updated in future releases of NJVM 1.4.1 as Novell products add support for NJVM 1.4.1. 7.1 Products Supported on NJVM 1.4.1 - eGuide 2.11 - ConsoleOne 1.3.6 - iManager - NetStorage - NetWare Remote Manager - Novell Installation Services (NIS) - Portal Services (Novell exteNd Director) - Tomcat - Web Search - ZENworks for Servers 3 7.2 Products Currently Being Tested on NJVM 1.4.1 The following products have an undetermined support status on NJVM 1.4.1. Full testing of these products with NJVM 1.4.1 has not been completed. Use caution when using these products with NJVM 1.4.1 in a production environment: - BorderManager - DirXML 1.1a - eDirectory - FTP Server Web Management - GroupWise Monitor - GroupWise Web Access - i-Login - UCS - ZENworks for Desktops - ZENworks OnDemand Services 7.3 Products Not Supported on NJVM 1.4.1 - ConsoleOne 1.3.5 8.0 NJVM 1.4.1 Installation 8.1 NetWare Dependencies NJVM 1.4.1 requires one of the following: - NetWare 6 with Support Pack 3 or later - NetWare 6.5 (FCS only) 8.2 Installing NJVM 1.4.1 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 3 of the installation process. 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 2. Run the NJVM self-extracting executable file (jvm141sp6.exe) on the client workstation. This expands the archive and launches the InstallShield installation script. 3. Follow the steps in the InstallShield. On the Select Options screen, select one, both, or none of the following installation 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. 4. Reboot your servers if necessary. If any problems occur with the GUI after you upgrade to NJVM 1.4.1, 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.1 for NetWare Administration Guide" (http://www.novell.com/documentation/lg/jvm141/index.html). 9.0 Documentation and Support For the most recent documentation on setting up and configuring JVM, see the "Novell JVM 1.4.1 for NetWare Administration Guide" (http://www.novell.com/documentation/lg/jvm141/index.html). Support for NJVM is provided by Novell Developer Services through the Developer newsgroup (news:developer-forums.novell.com/novell.devsup.jvm). 10.0 Documentation Conventions A trademark symbol (®, TM, etc.) denotes a Novell trademark; an asterisk (*) denotes a third-party trademark. 11.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 is a registered trademark of Novell, Inc. in the United States and other countries. All third-party products are the property of their respective owners. 012304