Message Queue System
This is a backend server in a distributed system, it provides the message queue functionality. You setup this profile if you want a dedicated server providing message queue functionality.
This profile is used in the Distributed Backend Distributed Frontend and Distributed Backend Hybrid Frontend topologies.
Automated Configuration
Baruwa Enterprise Edition >= 2.0.7 uses an automated wizard based utility called baruwa-setup to configure, update and manage the system. On the first run this utility collects configuration information from the user, performs any required software updates and then configures the system based on the profile selected and the configuration data collected. This simplifies the whole setup and management process so the user does not have to manually edit any configuration files.
The baruwa-setup command is idempotent, meaning it safe to run multiple times and will only make changes if they are required. All future updates and configuration changes to the system should be done using the baruwa-setup command. The utility has a man page that documents all the options available.
A pass phrase is required to secure the authentication information that is collected.
Make sure you choose a strong pass phrase which is easy for you to remember but difficult to guess for others, a long sentence describing a personal experience is a good pass phrase.
To start the configuration process login to the server with the username root and
the password you set during installation.
Then issue the baruwa-setup command at the command prompt:
baruwa-setup
The program will ask you to set a passphrase, enter the passphrase and press enter re-enter the same passphrase again to confirm. If the passphrase is accepted the System settings screen below will be displayed.
Warning
Do not loose this passphrase, there is no way to recover it. A reinstallation will be required if you loose the passphrase.
Note
In a cluster the passphrase should be the same on all the cluster members.
System Settings
This screen configures the basic system settings. The description of the options is as follows:
| Option | Description |
|---|---|
| System Type | Set this to Message Queue |
| FQDN Hostname | This is the Fully qualified domain name This cannot be set to localhost |
| IP Address | The system IP address usually detected |
| Activation Key | Baruwa Enterprise Edition Activation Key |
| Timezone | The system timezone, detected from the system configuration. |
| Enable clustering | Check/Uncheck this to enable or disable backend segment Clustering |
| Enable Monitoring | Check this to enable the Monitoring |
Admin Settings
This screen sets backend segment cluster settings. The description of the options is as follows:
| Option | Description |
|---|---|
| Cluster Master Token | The cluster’s master token, you can get it by running
baruwa-setup -e master_token on the |
| Bootstrap server | The IP address of the Bootstrap server
|
| Enable SNMP Agent | Enables the SNMP Agent which makes the system status
available via SNMP. This option is ineffective if
monitoring has not been enabled.
|
| Enable Backups | Enables or disabled the backup system [Baruwa Backups]
|
Setup Running
The baruwa-setup program will now ran the setup processes to configure
the system. The processes include updating all the packages on the system.
If a newer version of baruwa-setup is downloaded and installed, the
process will reload the baruwa-setup command. When this happens a
notification message with a 30 second countdown timer will be displayed
and the baruwa-setup command will reload and display the initial
(System Settings) screen. If this happens simply press the next
button or the F12 key until you get to the Setup Running screen
again.
At this point there is nothing left for you to do until the setup is complete.
The program will update the screen with status information as well as logging
it to /var/log/messages. If an error occurs the error information will be
displayed until you press the enter button and the program will exit.
Warning
If an error occurs while running setup, DO NOT REINSTALL the system copy
the error and contact support.
Setup Complete
When the setup is complete the following screen will be displayed simply press enter and the program will exit
To ensure that all the settings are correctly applied reboot the server
from the command line using the command:
reboot