Readme for IBM WebSphere Application Server 3.5
Advanced and Standard Editions for NetWare

January 8, 2001: For the most recent version of this document, visit http://www.novell.com/products/websphere/readme_print.html

Contents

Overview

Welcome to IBM* WebSphere* Application Server 3.5 for NetWare® , Advanced and Standard Editions. WebSphere Application Server is a Java*-based application environment for building, deploying, and managing Internet and intranet Web applications. This complete set of products expands to fit your Web application server needs, ranging from simple to advanced implementation of Web applications.

This Readme represents last-minute issues and information that were not included in the product documentation. Carefully read this document and then refer to the InfoCenter for important installation and configuration information.

Hardware and Software Requirements

These requirements are listed here for convenience. Please see the Prerequisites Web site for the most up-to-date software requirements on which IBM service and support are based.

The following are minimum hardware requirements for installing and operating WebSphere Application Server 3.5 for NetWare, Advanced and Standard Editions:

Hardware

Software

IMPORTANT: RAM requirements depend on how large your Web applications are and whether you are running your administration database from the same server or from another server in your network. By running your administration database from another server in your network, you can free up memory resources and thereby reduce RAM requirements.

Upgrading from 3.02

Before you can install WebSphere 3.5, you must first uninstall version 3.02 if it is currently on your server. Advanced Edition users can also find this upgrading information on their product CD by looking in MIGRATE302\MIGRATE302_README.TXT.

To uninstall WebSphere 3.02:

  1. From your NetWare server where WebSphere 3.02 is installed, start the graphical console. If it is not already running, enter STARTX at the system console.
  2. On the graphical console, click Novell > Install.
  3. Select IBM WebSphere Application Server from the list of installed products.
  4. Click Delete > OK.
  5. From a Windows client in your network, map a drive to the server and delete the WebSphere directory. The default WebSphere directory is SYS:\WebSphere\AppServer.

InfoCenter (Documentation)

The InfoCenter is a collection of installation, configuration, and programming information. It also includes Administrative Console Help, JavaDoc, WebSphere solutions development tips, product Release Notes, and a wealth of information about JSPs, XML, and related technologies. The InfoCenter is updated regularly with the latest product information.

The most recent InfoCenter for both Standard and Advanced editions can be found at the IBM Web site.

Known Issues

General Issues

There are two possible solutions:

If DNS resolution is slow (timing out), WebSphere might not initialize or run correctly. The Java process server might initialize more slowly and the Administrative Console might also respond more slowly. In some cases, a null attribute exception occurs.

To fix this issue, edit the SYS:\ETC\RESOLV.CFG file to remove any invalid DNS name servers. An invalid name server in this file causes DNS delays which, in turn, affect WebSphere.

To determine if DNS is operating correctly, enter PING InvalidHostAlias at the NetWare system console. InvalidHostAlias means any name that is not a valid hostname, such as FOOBAR.

If DNS is not working correctly, the response to the PING InvalidHostAlias request is slow--anywhere from 20 seconds to 2 minutes.

  1. Hostnames in the server's host table (typically found in SYS:\ETC\HOSTS)
  2. PLUGINCONFIG.NCF (located in as_root\bin)
  3. IIOPREDIRECTOR.XML (located in as_root\properties)

"Warning: Manual edit not loaded.
"Some configuration files have been edited by hand. Use the Apply button on the upper-right side of the screen to load the latest configuration files."

Click Apply to prevent this message from appearing again.

Managing Server Resources

To reduce memory overhead on your server, you can run the Administrative Console from a remote Windows* NT* workstation.

To run the Administrative Console from a remote NT workstation:

  1. At the NetWare server console, run SETUPCLIENTS.NCF to create IBMWebASv3_NT_AdminClient.JAR.

    NOTE: If the server has not been restarted recently, the class com.ibm.servlet.engine.webapp.AdminClientServlet might abort with an Insufficient server memory error. If this occurs, restart the server and run SETUPCLIENTS.NCF again.

  2. From a Windows NT client Web browser, point at http://Admin_Server_Host_Address/admin/install, where Admin_Server_Host_Address is the host address of the computer that is running the administration server.

  3. Click IBM JDK 1.2.2 for Windows NT and save IBMJDK122_NT.JAR to your client computer.

  4. Click IBM WebAS 3.5 AdminClient for NT and save IBMWebASv3_NT_AdminClient.JAR to your client computer.

  5. Change to the directory where you downloaded the .JAR files.

  6. Unjar IBMJDK122_NT.JAR.

  7. Set JAVA_HOME to the full path of the JDK directory by creating an environment variable JAVA_HOME and setting it to the full path of the JDK directory.

  8. Unjar IBMWebASv3_NT_AdminClient.JAR.

  9. Make certain that the administration server is started on the remote host by entering STARTWEBSPHERE at the server console.

  10. Change to the BIN directory from within the directory where you downloaded the administration client .JAR file.

  11. Enter the command ADMINCLIENT Admin_Server_Host_Address, where Admin_Server_Host_Address is the host address of the machine running the administration server.

  12. Wait until the systems management interface (EJSConsole) appears. Depending on your system capacity, this can take up to 15 minutes. Leave the command window open while EJSConsole is running. 

    If you need to stop the administration client, click Console > Exit.

IMPORTANT: The Grant Rights utility logs in to your tree_name using the admin_username and associated password. It then grants public inheritable compare rights to CN and Member objects. To view the exact steps taken by the Grant Rights utility, open WebSphere/appserver/bin/GRANTRIGHTS.NCF using a text editor. This utility only needs to be executed once and is needed if you have NetWare 5.1 Support Pack 2 installed.

Using Oracle8i as the Administration Database

Oracle is one of three optional databases you can use as the WebSphere administration database. If you choose to use Oracle, carefully read the following issues:

envset JAVA_OLD_OS_NAME=true

Legal Information

Disclaimer and Copyright

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.

Copyright (C) 2001 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.

Trademarks

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

Windows and Windows NT are registered trademarks of Microsoft Corporation.

IBM and OS/2 are registered trademarks and WebSphere is a trademark of IBM Corporation.

Other company, product, and service names may be trademarks or service marks of others.