Last Updated: June 28, 2000
For the most current product information, see Accessing the Product Web Site.
Welcome to IBM WebSphere Application Server 3.0.2 Advanced Edition for NetWare. 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 was not included in the product documentation.
Carefully read this document and then refer to the Getting Started Guide for important installation and configuration information (see Installing and Configuring WebSphere Application Server).
For installation and configuration instructions, refer to the Getting Started Guide, located on the World Wide Web or in the Documentation Center on your NetWare server.
The latest WebSphere documentation is available on the World Wide Web. Refer to the following table for information about where to go to find the information you need.
| Installing, configuring, or maintaining WebSphere Application Server | Review this readme and then
visit the WebSphere for NetWare Web site at http://www.novell.com/websphere
or http://www.ibm.com/software/webservers/appserv/
for the most current Getting Started Guide, Release Notes and related documentation. |
| Programming for WebSphere | Visit the Novell WebSphere developer Web site at http://developer.novell.com/websphere. |
If you chose to include documentation during installation, the Documentation Center was installed on your NetWare server. The Documentation Center is a collection of programming documentation, the Getting Started Guide, Administrative Console Help, JavaDoc, and other resources.
If you chose to install the documentation, you can access it from a Web browser running on a client computer in your network.
To access the Documentation Center:
Your Web browser must support HTML 4, cascading style sheets (CSS), and Java applets. Compatible browsers include Netscape Navigator 4.07 and Microsoft Internet Explorer 4.01 or higher.
http://domain_name_or_IP_address/IBMWebAS/doc/begin_here/
You can also map a drive from a client in your network to your NetWare server and open the following path using a compatible Web browser:
as_root\web\doc\begin_here\index.html
The Administrative Console is the primary interface for the WebSphere Application Server. The help includes a tutorial on how to perform primary tasks and also includes context-sensitive help.
To access the help, you need a Web browser that supports HTML 4, Cascading Stylesheets (CSS), and Java applets. Examples of such browsers are Netscape Navigator 4.07 and Microsoft Internet Explorer 4.01 and higher.
To access the help outside of the Administrative Console, follow the same procedure outlined above for accessing the Documentation Center, but use the following path:
as_root\web\help\helpcon.htm
See Accessing the Product Web Site for information about documentation updates, the product Release Notes, and other Web resources.
The WebSphere Application Server Web site includes:
Visit the IBM WebSphere Application Server for NetWare Web site on Novell.com at:
You can also visit the IBM WebSphere Application Server Web site at:
The following issues were discovered after the product shipped.
To work around the problem, you must edit DEFAULT.SERVLET_ENGINE stored in the as_root\APPSERVER\PROPERTIES directory before starting the third or higher WebSphere server in a centralized database configuration. The <transport> tag in this file should include the following argument:
<arg name="queueName" value="queue3"></arg>
where queue3 is a unique queue name for each WebSphere Application Server in the centralized configuration.
NOTE: If the configuration has already failed because the queueName was not updated before adding the third or higher WebSphere node, the following steps must be completed:
- The node must be removed from the centralized configuration.
- The admin.config file must be edited and install.initial.config set to True (e.g. install.initial.config=true).
- Restart the WebSphere Application Server.
try ws_open_inet_client_sockst - connect: connection refused
The NetWare Enterprise Web server factory default threads setting is 48.
If you need to increase the thread count for your Enterprise Web server, we strongly recommend that you increase WebSphere's thread count in equal proportion to the Web server. For example, if you increase the Web Server thread count to 96, set WebSphere's thread count to 96, as well.
For information about increasing the thread counts for the NetWare Enterprise Web Server and WebSphere, refer to Troubleshooting on the WebSphere Advanced Edition product page (see http://www.novell.com/websphere).
The following issues were discovered before the product shipped.
Use one of the following solutions:
- Keep your server name and hostname the same.
- If you're already past the point of naming, put the name of the server into the HOSTS file on the client with the server's IP number.
If DNS resolution is slow (timing out), WebSphere on NetWare may not initialize or run correctly. You may see a slow initializing of the Java process server and a slow Administrative Console response. In some cases, a null attribute exception will occur.
WebSphere uses RMI/IIOP to communicate both internally in the Java process server and externally from the Administrative Console to the Java process server. When DNS is not working, a long timeout occurs which causes WebSphere to slow down, possibly timing out and generating null pointer exceptions.
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, type 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.
- hostnames in the server's host table (typically found in SYS:\ETC\HOSTS)
- PLUGINCONFIG.NCF (located in as_root\bin)
- IIOPREDIRECTOR.XML (located in as_root\properties)
NOTE: If you are using a centralized database configuration using two or more WebSphere servers, make sure that all WebSphere nodes are also included in the server's host table.
Init fn="load-modules" funcs="init_exit,auth_exit,service_exit,term_exit" shlib="SYS:/WebSphere/AppServer/bin/ns35.nlm"
Init fn="init_exit" bootstrap.properties="SYS:/WebSphere/AppServer/properties/bootstrap.properties"
NameTrans fn="pfx2dir" from="/IBMWebAS" dir="SYS:/WebSphere/AppServer/web"
PathCheck fn="auth_exit"
Service fn="service_exit"NOTE: If you copy these lines for use in your OBJ.CONF file, change the paths to reflect the correct location where you installed WebSphere (for example, SYS:/WebSphere/AppServer/).
After installation, when NetWare Web Manager is accessed for the first time, the following warning is given:
"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."If you do not click Apply, the WebSphere configuration will be lost and WebSphere will not respond to any requests.
The trace file is found in the as_root/LOGS/TRACEFILE and can be viewed on the server by typing the following command at the console prompt:
type SYS:\WebSphere\AppServer\logs\tracefile
Edit this file and add or modify the following line
OPEN_CURSORS=200
For the change to be effective, the database must be stopped, unloaded and then restarted (e.g. orastop, oraunld, oraload and orastart).
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) 2000 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.
NetWare is a registered trademark of Novell, Inc. in the United States and other countries.
Windows and Windows NT are registered trademarks of Microsoft Corporation in the United States and other countries.
IBM, OS/2, and WebSphere are trademarks of IBM Corporation.
Other company, product, and service names may be trademarks or service marks of others.
[ Back to Top ]