| Expand | ||
|---|---|---|
| ||
|
Configuring HA in a FioranoMQ Server basically involves configuration of the modules below:
...
- Click on the Profile Manager pane and right-click the Profiles node. Select Open Profile from the pop-up menu and select the required profile. Click the Open button (%SELECTED_HA_PROFILE%) for offline editing, using the Profile Manager.
- Configure self HA port: This port refers to the port number on which the HA Layer accepts a connection from its Peer Server. The HA port of the default HA profiles configured for the Primary Server is 2000 while that of the Secondary Server is 3000. In order to modify these values, navigate to the node mentioned below, and change the port number in the PropertiesOf FioranoHAConnectionManager pane.
%SELECTED_HA_PROFILE%>Fiorano>HA->HAConnectionManager -> PROFILE% > Fiorano > HA > HAConnectionManager > FioranoHAConnectionManager
| Note |
|---|
The screen-shot above shows the path for the HAConnectionManager node in Replication mode. The same path can be found when configuring the Connection Manager in Shared HA mode. |
3. Configure the IP and HA port of the remote server: HA layer of a FioranoMQ Server connects to the Backup Server's HA layer. In order to configure the Backup Server's IP and its port, navigate to the node specified below, and set the values of BackupHAIPAddress and BackupHAPort displayed in the Properties of FioranoHAKRPCProvider pane.
%SELECTED_HA_PROFILE%- > Fiorano - > HA ->HAKRPCProvider - > HAKRPCProvider > FioranoHAKRPCObject
| Note |
|---|
The screen-shot above shows the path for the HAKRPCProvider node in the Replication mode. The same path can be found while configuring HAKRPCProvider in the Shared HA mode. |
4. Configure Gateway Server: HA Layer pings the gateway machine to determine the status of the network connectivity. The default profiles have Gateway configured to localhost and should be changed to a third independent reliable machine (preferably to the physical router machine on the network). In order to configure Gateway Server, navigate to the node specified below, and modify the value of GatewayServerIPAddress and GatewayServerPort in the Propertiesof Properties of FioranoHAManager pane.
%SELECTED_HA_PROFILE%>Fiorano>HA>FioranoHAManagerPROFILE% > Fiorano > HA > FioranoHAManager
| Note |
|---|
The screen-shot above shows the path for the FioranoHAManager node in the Replication mode. This path can be found when configuring FioranoHAManager in the Shared HA mode. |
5. Configure isPrimary: Set isPrimary to 'yes for ' for the Primary FioranoMQ Server and 'no for ' for the Backup Server by modifying its value, as shown in the properties pane, by clicking on the node specified below:
%SELECTED_HA_PROFILE%>Fiorano>HA>HAManager -> PROFILE% > Fiorano > HA > HAManager > FioranoHAManager
| Note |
|---|
The screen-shot screenshot above shows the path for the FioranoHAManager node in the Replication mode. This path can be found when configuring FioranoHAManager in the Shared HA mode. |
6. Common Configuration: HA requires enabling Durable Connections, Pinging and Auto Revalidation support in the FioranoMQ Server. This can be done by navigating to and modifying the parameters specified below, located in the properties pane.
%SELECTED_HA_PROFILE%- > Fiorano ->etc - > etc > FMQConfigLoader
- Set AllowDurableConnections property to 'yes'.
- Set PingEnabled to 'yes'.
- Set EnableAutoRevalidation to 'yes'.
| Note |
|---|
The screen-shot above shows the path for HAManager node in the Replication mode. This path can be found when configuring HAManager in the Shared HA mode. Pre-created profiles are set to this configuration, and require no change when working with them. |
7. Configure the Backup Server's IP and Port: Specify the BackUpServerIP and BackupServerPort used by clients in the event of a connection failure. This IP Port should refer to the backup FioranoMQ Server's IP Address and to the Port on which it accepts client connections. This is done by navigating to the node specified below, and modifying the Backup Server's IP address and the Backup Server's port parameters within the Properties of the MQDefObjCreator MQDefObjCreater pane.
%SELECTED_HA_PROFILE%>Fiorano>etc>MQDefObjCreatorPROFILE% > Fiorano > etc > MQDefObjCreater
8. The FioranoMQ Server uses these parameters to set a Backup Server URL in the default connection factories. For client connections to fail-over, it is important that the Backup Server URL is properly configured. If the configuration is changed for the default connection factories, the database should be recreated, or a self-created connection factories database with correct URLs should be used.
...
| Note |
|---|
The screenshot above shows the path for the MQDefObjCreatorMQDefObjCreater node in the Replication mode. This path can be found when configuring HAManager in the Shared HA mode. |
9. Right-click on the %SELECTED_HA_PROFILE% root, and select the Save option from the pop-up menu to save this configuration.
...
Parameter | Primary Server | Backup Server |
|
|---|---|---|---|
URL | http://164.164.129.128:1856 | http://164.164.129.108:1956 |
|
HAKRPCProvider | |||
BackupHAIPAddress | 164.164.129.108 | 164.164.129.128 |
|
BackupHAPort | 3000 | 2000 |
|
HAConnectionManager |
|
| |
Port | 2000 | 3000 |
|
Common Config | |||
Backup IP Address | 164.164.129.108 | 164.164.129.128 |
|
Port | 1956 | 1856 |
|
EnableDurableConnections | Yes | yes |
|
PingEnabled | Yes | yes |
|
HAManager | |||
isPrimary | Yes | no |
|
Gateway IP Address | 164.164.129.225 | 164.164.129.225 | |
10. After changing the HA Layer's configuration, clear the server's existing database prior to re-starting the server. The existing Data Store can be cleared by executing the ClearDB script in fmq/bin folder of the installation directory, with the profile name as an argument.
...
- To use Replicated HA, open FioranoMQ_HA_rpl/HAPrimary, and open the FioranoMQ_HA_rpl/HASecondary profile in the Studio Profile Manager. Right-click on the profile, and select FMQ Replicated HA. The FMQ Replicated HA wizard appears.
- All required values can be configured using the wizard. After configuration, right-click on the node, and select the Save option from the pop-up menu.
The properties listed below are available in the FMQ Replicated HA wizard.
...
For example, if the HA Primary Server is running on a machine with IP Address 192.169.1.157., and the HA Secondary Server, on a machine with IP Address 192.169.1.159., the Gateway server address is given as 192.169.1.159. After configuration, the HA Primary Server the wizard should display the values, as shown in the figure below:
After configuration of the HA Secondary Server, the wizard should display the values, as shown in the figure below:
9.2.2.2 Configuring FMQ Shared HA
- If a Shared HA needs to be used, open the FioranoMQ_HA_shared/HAPrimary and the FioranoMQ_HA_shared/HASecondary profiles in the Studio Profile Manager. Right-click on the profile, and click on FMQ Shared HA to display the FMQ Shared HA wizard.
- All required values can be configured using the wizard. Upon completing configuration, right-click the node, and select the Save option from the pop-up menu.
The following properties are available in the FMQ HA Replicated wizard.
...
For example in running the HA Primary Server on a machine with IP Address: 192.169.1.157 and the HA Secondary Server on a machine with IP Address: 192.169.1.159, the Gateway Server is given as 192.169.1.159 which is present in the network. After configuration, the HAPrimary wizard looks as shown below:
The HA Secondary wizard displays:
9.2.3 Step 3: Configuring Admin Store
...