APAR status
Closed as program error.
Error description
In a multiple NIC environment WebSphere PORTs are not binding
to specific IP address
Local fix
Abstract: Fix to enable multiple WAS instances on Dual NIC
configuration with default ports.
Description/symptom of problem: This fix will enable running
multiple WAS instances on Dual NIC configuration with default
ports.
Steps to follow before applying the fix:
*****************************************
From the adminconsole make the following config changes:
Application Servers > server1 > Process Definition > Generic JVM
Arguments
Add "-Dcom.ibm.CORBA.LocalHost=xxxx.xx.xx.xx
-Dcom.ibm.websphere.network.useMultiHome=false
-Dcom.ibm.CORBA.ServerSocketQueueDepth=50"
Application Servers > server1 > Web Container > HTTP Transports
> 9088
update the Host name for all HTTP transports.
Application Servers > server1 > Message Listener Service >
Listener Ports > SamplePtoPListenerPort
Update the Initial state to "stopped"
Application Servers > server1 > Message Listener Service >
Listener Ports > SamplePubSubListenerPort
Update the Initial state to "stopped"
ND Environment, in addition to above changes for each appserver,
make the following changes, and make sure the nodes are in sync.
Deployment Manager > Process Definition > Java Virtual Machine >
Generic JVM Arguments
Add "-Dcom.ibm.CORBA.LocalHost=xxxx.xx.xx.xx
-Dcom.ibm.websphere.network.useMultiHome=false
-Dcom.ibm.CORBA.ServerSocketQueueDepth=50"
Node agents > NodeAgent Server > Process Definition > Java
Virtual Machine > Generic JVM Arguments
Add "-Dcom.ibm.CORBA.LocalHost=xxxx.xx.xx.xx
-Dcom.ibm.websphere.network.useMultiHome=false
-Dcom.ibm.CORBA.ServerSocketQueueDepth=50"
JMS Servers > JMSServer > Initial State - stopped
Apply PQ83628 on all servers and Deployment Manager
******************************************
Assumptions / Requirements / Limitations
=========================================
com.ibm.CORBA.LocalHost property value should resolve to a
valid hostname or IP address and not to localhost or loopback
address (127.0.0.1). The logic does not do any validations prior
to passing the localhost value to Transport layer and it is USER
responsibility to make sure the localhost is valid and not a
loopback address or loopback hostname.
***********************************************
Problem summary
****************************************************************
* USERS AFFECTED: WebSphere Application Server Users with *
* either single host, single WebSphere *
* instance with multiple NIC cards or single *
* host with multiple WebSphere installations *
* with multiple NIC Cards. *
****************************************************************
* PROBLEM DESCRIPTION: WebSphere ORB logic would bind the *
* server side listeners to all NIC *
* cards by default. This results in *
* port bind clashes for customers. *
****************************************************************
* RECOMMENDATION: WebSphere's ORB needs to bind the server *
* side listeners to the NIC card specified *
* by the customer or the default NIC card. *
****************************************************************
Customers with single or multiple instances of WebSphere in
multiple NIC card scenarios would experience port binding
failures.
Problem conclusion
WebSphere ORB logic required upgrading for multiple NIC card
support. With the enhanced logic customers would specify which
NIC card is to be used by which WebSphere installation. This
voids customers getting port binding errors.
Temporary fix
ZE fix error
PQ88152 04/07/16
Comments
APAR information |
APAR number |
PQ83628 |
Reported component name |
WAS BASE 5.0 |
Reported component ID |
5630A3600 |
Reported release |
10S |
Status |
CLOSED PER |
PE |
NoPE |
HIPER |
NoHIPER |
Special Attention |
NoSpecatt |
Submitted date |
2004-01-22 |
Closed date |
2004-04-30 |
Last modified date |
2004-09-13 |
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
Publications Referenced
Applicable component levels |
R003 PSY |
UP |
R00A PSY |
UP |
R00H PSY |
UP |
R00I PSY |
UP |
R00P PSY |
UP |
R00S PSY |
UP |
R00W PSY |
UP |
R103 PSY |
UP |
R10A PSY |
UP |
R10H PSY |
UP |
R10I PSY |
UP |
R10P PSY |
UP |
R10S PSY |
UP |
R10W PSY |
UP |
|