Configure catalog servers
Home | Previous | Next


Configure catalog servers


The catalog server...

  1. Manages the placement of partitions
  2. Allows clients to connect to the grid

By default, the catalog server runs in the deployment manager of the cell.

For resilience configure at least two or three catalog servers on node agent and application servers running on separate physical servers.

For this example created a catalog service domain by configuring catalog servers to run on...

  • The deployment manager
  • A single node agent

When we define a catalog service domain of catalog service endpoints we are doing two things:

  • Declaring where we want the catalog services to run
  • Providing the configuration to which WXS grids and clients can connect


Catalog server ports

Catalog service port numbers include...

For catalog servers hosted in WAS, the listener and JMX ports are the same, and are equivalent to the bootstrap port of application server. Defaults are...

9809 deployment manager
2809 node agent

The client port is used for WXS internal communication and needs to be unique.


Procedure

  1. In the WebSphere administrative console, go to...

    System Administration | WebSphere eXtreme Scale | Catalog service domains | New

  2. Enter a name of the choice for the catalog server domain, for example:

    Name: Clustered Catalog Servers

  3. Select...

    Enable this catalog service domain as the default

  4. Add the catalog servers to the catalog service domain, determining the ports.

    • Add a catalog server to the deployment manager:

      • A Catalog Service Endpoint will already exist. Select the deployment manager in the Existing application server drop down.

      • Enter a client port value: 6600

      • Enter a JMX port value: 9809

      When hosting WXS catalog servers in WAS, this port is the server's bootstrap address, which is 9809 by default on the deployment manager.

    • Add a catalog server to a node agent:

      • Click New.

      • Select a node agent from the list in the Existing application server drop down.

      • Enter a Client Port value: 6601

        In the sample environment, the node agent is on the same hardware as the deployment manager, which means we need separate ports to make them unique

      • Enter a JMX Port value: 2809

    • Click Apply.

      At this point the Listener Port field is disabled when adding existing servers. This is because WebSphere assumes the bootstrap port for the servers we are configuring, and so cannot change them.

      At the time of writing, however, if you are not using the default bootstrap ports (9809 for deployment managers and 2809 for node agents), these need to be added to the Listener Port field. Otherwise the grid will attempt to use the defaults. Even if you are using the defaults, you might choose to do this to add clarity in the configuration.

    • On the new Catalog service domain, select the two catalog server entries and click Edit.

    • Type in the listener port values appropriate to the environment. For example...

      dmgr 9809
      nodeagent Port = 2809

  5. Save the changes to the master configuration.

  6. After changing catalog server settings, restart the servers that are to host the catalog servers: the deployment manager and node agent.

    Verify the catalog server started correctly by checking SystemOut.log for the dmgr and node agent. You should see...

    [10/21/10 14:24:52:296 CDT] 0000000c ServerImpl I CWOBJ2518I: Launching ObjectGrid catalog service: thinkCell01\thinkNode02\nodeagent.

    After both the deployment manager and node agent are started, they will form a catalog service cluster (one master catalog and one standby) and we will see a message similar to...

    [10/21/10 14:25:37:343 CDT] 00000012 CatalogServer I CWOBJ8109I: Updated catalog service cluster CatalogCluster[thinkCell01, 1 master: 1 standbys] from server thinkCell01\thinkNode02\nodeagent with entry CatalogServerEntry...

    Because the deployment manager now hosts a catalog server, it is an important part of the runtime infrastructure. Prior to use with WXS, you could stop and start the deployment manager at will because it was not needed for the application servers. Stopping the deployment manager will now reduce catalog server availability, and therefore site availability.


Separate cells considerations

Because we are running Commerce Server and WXS in the same Network Deployment cell, we only need to set up one catalog service domain.

For topologies where Commerce and WXS exist in separate cells, perform these steps twice...

  1. Create a catalog service domain on the WXS cell.

  2. Create a catalog service domain on the Commerce cell.

    Instead of referring to existing servers in the drop down list, provide the following information for each catalog server defined in the WXS Catalog service domain:

      Remote server host name of the remote catalog server.
      Listener port bootstrap port of the remote catalog server.
      JMX port JMX port number defined on the remote catalog server. When hosting the catalog server in WebSphere application servers, this value will be the same as the bootstrap port.

    The administrative console doesn't need to know the client port for remote processes, so it doesn't prompt for it.


Stand-alone

We have described the steps to set up and communicate with catalog servers running inside WebSphere processes. It is also feasible to run WXS stand-alone, outside WebSphere processes. This is functionally identical to hosting the grid in WebSphere. The difference is that manage the stand-alone WXS processes manually.

The catalog service domain in WebSphere Commerce needs to be configured as we have outlined for connecting to a remote cell.

To connect to a remote stand-alone catalog server cluster, start that cluster beforehand using the startOgServer scripts. It should at minimum include the following parameters in order to configure the catalog service domain in the administrative console:

-listenerPort The catalog server bootstrap.
-JMXServicePort The port to access JMX MBeans. This defaults to 1099 if not specified.
-domain If you are using more than one catalog service domain, specify a domain name for the catalog server cluster. Make this name the same as the name of the catalog service domain in the administrative console.

We can now create a WXS grid to hold our dynamic cache data and subsequently configure Commerce to use it.


+

Search Tips   |   Advanced Search