PM53803: Do not override server properties with the default domain if you run eXtreme Scale in an embedded WebSphere

APAR status

• Closed as program error.

Error description

• When you set up multiple catalog domains in a single cell
  eXtreme Scale installation, containers use the default
  catalog domain.
  

Local fix

• Start the
  container manually in the application module (servlet init or
  startup bean).
  
  // Retrieve the ServerProperties.  This has already been
  filled-in using the default domain's parameters.
  ServerProperties sp = ServerFactory.getServerProperties();
  
  // Override the catalog service host:port,host:port to the
  domain you want to connect to.
  sp.setCatalogServiceBootstrap(desiredDomainEndpoints);
  
  // Initialize the XS server, which will use your overridden
  bootstrap endpoints to the correct domain.
  Server s = ServerFactory.getInstance();
  
  // Start your container
  s.createContainer(...);
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of WebSphere eXtreme Scale        *
  *                  running in an embedded WebSphere            *
  *                  Application Server installation.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: Startup of the container                *
  *                      fails with the following error:         *
  *                      "CWOBJ7300W: This server failed to      *
  *                      bootstrap to a catalog server at the    *
  *                      following address(es): <host>:<port>"   *
  *                      even though one specified in the        *
  *                      catalogServiceEndPoints property.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Stop overriding the server properties with the default domain,
  when you run WebSphere eXtreme Scale in an embedded WebSphere
  Application Server installation.
  When you force a WebSphere Application Server-hosted container
  server to register with a specific catalog service, the
  container is started with the -Dobjectgrid.server.props
  property, which references a property file that contains the
  catalogServiceEndPoints property. Container startup fails with
  the following error:
  "CWOBJ7300W: This server failed to bootstrap to a catalog
  server at the following address(es): <host>:<port>"
  In this error message, <host>:<port> is the host name and
  bootstrap port of the default catalog service domain member,
  not the one specified in the catalogServiceEndPoints property.
  

Problem conclusion

• The catalogServiceEndPoints property is valid if
  specified in the objectGridServer.properties file. The default
  catalog domain is used if nothing is specified.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  XD EXTREME SCAL

• Fixed component ID

  5724J3402

Applicable component levels

• R710 PSY

     UP