High Quality JMS & AMQP Messaging.

Step 4: Run the HA Wizard

The HA Wizard turns any configuration into High Availability. You can

To start the HA Wizard, go to directory scripts/win32 (Windows) or scripts/unix and execute

    ./hawizard

The HA Wizard displays its Welcome screen:

Click "Next". It will ask you to import an existing configuration or not:

Select "Yes" if you want to

Select "No" if you want to convert a local configured configuration from step 3 into HA.

Click "Next". If you have selected "Yes" you can specify the name of the routerconfig.xml you want to import. If you want to import a local configured configuration from step 3 and use a different persistent store (e.g. JDBC Store), select config/replicated/instance1/routerconfig.xml:

Click "Next". The Wizard now ask you to select the store type:

Select the persistent store you want to use and click "Next".

If you have selected "Shared File Store", the Wizard will ask you about the absolute path of the shared store directory:

The path must be the path from the target HA instance and must point to the store's root directory (the directories below are db, log, durable, swap).

If you have selected "Shared JDBC Store", the Wizard will ask you about JDBC driver class, connection factory, URL etc:

Next step is to specify the router name plus the DNS host names of both HA instances:

The Wizard now gathers information about the replication channel between the 2 HA instances. One instance has a network listener, thus listens on a port, the other will have the connector. Is doesn't matter which instances has listener or connector. The only requiredment is that the port is free. Is is highly recommended (but not mandatory) that you use a dedicated network channel over a dedicated network card. If you use such a dedicated channel, please specify the bind address of this network card on the listener HA instance.

Next step is the configuration of the JMS listener(s). The Wizard uses the defined listeners from the configuration file. You can modify port, connect- and bind addresses for both HA instances. If you use connect-/bind address keep in mind that you specify the IP addresses of the particular HA instance.

Final step is the configuration of the routing listeners:

Clicking "Next" brings you to the Finishing screen:

The Wizard creates detailed instructions about how to deploy the HA instances and how to configure your JMS clients. Click on "View Description..." to view and save it:

Click on "Finish" to end the HA Wizard. It will save the configuration in the config directory. The location depends on your selected store type: