Setting Up a Local Cluster

You might find it easier to isolate cluster-related issues by creating a cluster of instances on a single machine. The following steps describe how you can create a simple two-node cluster on a single machine. This assumes you have a license that supports more than one node in a cluster.

1. Install the platform using the default settings.
2. Use the apprm command to remove the application you've installed, which installed it into the root ("/") context.

   apprm sbs

3. Use the appadd command to add two new application instances that will make up your cluster.
   1. You can add the first instance with default settings, specifying a context path:

      appadd --context-path=/cluster1 cluster1

   2. Add the second instance with the following suggested settings:

      [joe@targetmachine]$ appadd --ajp-port=9004 --server-port=9005 --http-port=9006 --cluster-port=9007 --context-path=/cluster2 cluster2

4. Restart the jive-httpd service. For more information see Jive HTTPD (Linux) or Jive HTTPD (Solaris)
5. Start the first instance with the appstart command.

   appstart cluster1

6. With a browser, navigate to the setup tool (usually at http://<hostname>/cluster1, where hostname is the DNS resolvable name of the server where the package was installed) to configure the instance.
   Note: Be sure to use a license that supports more than one node in a cluster.
7. Stop the first instance with the appstop command.

   appstop cluster1

8. Change the APP_CLUSTER_PORT in the /usr/local/jive/applications/cluster2/bin/instance file to be the same as cluster1's cluster port. For more on making this change, see Changing the Configuration of an Existing Instance.
   Note: In version 3.0.0, to support clustering you'll need to change configuration to override a default setting. Changing the Configuration of an Existing Instance for the instance to add the following (where <addr> is a unique address -- 224.224.224.224 might work.):

   export CUSTOM_OPTS="-Dtangosol.coherence.clusteraddress=<addr>

9. Start the second instance.

   appstart cluster2

10. Use the setup tool to configure the instance (http://<hostname>/cluster2). When configuring the database, choose "external database," then use settings for the database from cluster1.
11. Stop the second instance.

    appstop cluster2

12. Start both instances.

    appstart

13. Use the admin console to turn on clustering on both instances. You'll find that setting at System > Settings > Caches.