PQ75703: WEBSPHERE V4.0.5 IF ANY GENERIC SERVERS DEFINED IN A NODE, XMLCONFIG IS UNABLE TO CREATE OR UPDATE APPLICATION SERVERS.

 A fix is available

4.0.7: WebSphere Application Server Version 4.0 Fix Pack 7



APAR status
Closed as program error.

Error description
Problem: XMLConfig -import is unable to create or update any
Application Servers once a Generic Server is defined in a node.

If the Generic Server(s) are subsequently removed, the problem
goes away. Similarly, if there are both Application Server and
Generic Server definitions within a single XML file, the Generic
Server definitions needs to be put after the Application Server
definitions, or XMLConfig will not be able to create the
Application Server(s).

This is the procedure to recreate the problem:

First attempt to import the Application Server first, then the
Generic Server.This should work OK, its just to demonstrate that
the order is significant and that the XML files are good:

> XMLConfig.sh -import MyAppServer.xml -adminNodeName wsapptst02
[6/3/03 16:55:11:891 CEST]   439a2d NodeConfig    A XMLC0053I:
Importing Node : wsapptst02
6/3/03 16:55:12:553 CEST]   439a2d ApplicationSe A XMLC0053I:
Importing ApplicationServer : MyAppServer

> XMLConfig.sh -import MyGenericServer.xml -adminNodeName
wsapptst02 [6/3/03 16:55:26:550 CEST]   439a2d NodeConfig    A
XMLC0053I: Importing Node : wsapptst02
[6/3/03 16:55:27:103 CEST]   439a2d GenericServer A XMLC0053I:
Importing GenericServer : MyGenericServer

Fine, now clean up:

> XMLConfig.sh -import Cleanup.xml -adminNodeName wsapptst02
[6/3/03 16:55:40:379 CEST]   439a2d NodeConfig    A XMLC0053I:
Importing Node : wsapptst02
[6/3/03 16:55:40:898 CEST]   439a2d GenericServer A XMLC0053I:
Importing GenericServer : MyGenericServer
[6/3/03 16:55:41:352 CEST]   439a2d ApplicationSe A XMLC0053I:
Importing ApplicationServer : MyAppServer

Now attempt to create the Generic Server first, then the
Application Server. This will FAIL! The problem is actually that
using the XMLConfig command line tool to import an Application
Server always fails if the node has a Generic Server definition.
The GUI admin client and wscp's XML command does not have this
problem.

> XMLConfig.sh -import MyGenericServer.xml -adminNodeName
wsapptst02
[6/3/03 16:56:02:561 CEST]   439a2d NodeConfig    A XMLC0053I:
Importing Node : wsapptst02
[6/3/03 16:56:03:103 CEST]   439a2d GenericServer A XMLC0053I:
Importing GenericServer : MyGenericServer

> XMLConfig.sh -import MyAppServer.xml -adminNodeName wsapptst02
[6/3/03 16:56:14:647 CEST]   439a2d NodeConfig    A XMLC0053I:
Importing Node : wsapptst02
[6/3/03 16:56:15:240 CEST]   439a2d ApplicationSe A XMLC0053I:
Importing ApplicationServer : MyAppServer
[6/3/03 16:56:15:618 CEST]   439a2d ApplicationSe X XMLC0007E:
Failure
to create ApplicationServer : MyAppServerEnding Child
Processing.
Exception: com.ibm.ejs.sm.exception.RemoteOpException:
ADMR2338E: Errors occurred during duplicate port check

Problem is in the Server code, where duplicatePort Checking is
failing. The GUI is ignoring these exceptions and is creating
the AppServer, whereas XMLConfig just fails to continue.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: WebSphere Application Server Users running   *
*                 Generic Servers and managing them with       *
*                 XMLConfig.                                   *
****************************************************************
* PROBLEM DESCRIPTION: XMLConfig is unable to create or update *
*                      application servers if a generic server *
*                      is defined in the node.                 *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
XMLConfig is unable to create or update applications servers if
a generic server is defined in the node.
The error thrown is:
[6/3/03 16:56:15:618 CEST]   439a2d ApplicationSe X XMLC0007E:
Failure to create ApplicationServer : MyAppServerEnding Child
Processing.
Exception: com.ibm.ejs.sm.exception.RemoteOpException:
ADMR2338E: Errors occurred during duplicate port check

The GUI is ignoring these exceptions and is creating
the application server, whereas XMLConfig fails to continue.
Problem conclusion
The Server code was modified to ignore the duplicate port check
on Generic Servers, which do not contain Web container
properties.
Temporary fix
Fix provided to customer, waiting for feedback..
Comments
APAR information
APAR number PQ75703
Reported component name WEBSPHERE AE SO
Reported component ID 5630A2202
Reported release 400
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2003-06-26
Closed date 2003-07-30
Last modified date 2004-06-14

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
AdminSvr          

SRLS

Fix information

Applicable component levels
R400 PSY    UP


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s):
Software version: 400
Software edition:
Reference #: PQ75703
IBM Group: Software Group
Modified date: Jun 14, 2004