Feature TOP Usage

Details

CHMPX Options

The options of the CHMPX program are summarized below.

You can see configration files in directory for sample(the file formatted by INI/YAML/JSON, and string of JSON).
If you do not specify both -conf and -json option, CHMPX checks CHMCONFFILE or CHMJSONCONF environments.
If there is not any option and environment for configuration, you can not run CHMPX program with error.

Start CHMPX program

To start the CHMPX program, do as follows.

chmpx [-conf <file> | -json <json>] [-ctlport <port>] [-d [slient|err|wan|msg|dump]] [-dfile <debug file path>]

The following is an example.

chmpx -conf server.ini -ctlport 8021 -d err -dfile /tmp/chmpx.log

Configuration

The configuration that the CHMPX program and CHMPX library loads are described in.
When the configuration is specified as a file, the setting is reloaded when the configuration file itself is updated.

GLOBAL Section([GLOBAL] is used for INI file)

This section specifies common configuration and default setting values of CHMPX configuration.

SVRNODE Section([SVRNODE] is used for INI file)

In this section, it is the setting of the server node of the cluster.
Please specify the following items as an array in the SVRNODE section for each server node.
Only the INI formatted file is special, multiple [SVRNODE] sections can be described in one configuration file.

SLVNODE Section([SLVNODE] is used for INI file)

In this section, it is the setting of the slave node of the cluster.
Please specify the following items as an array in the SLVNODE section for each server node.
Only the INI formatted file is special, multiple [SLVNODE] sections can be described in one configuration file.

About other descriptive section(for INI file)

Notes on communication

Communication between CHMPXs in one cluster can only communicate with servers described in SVRNODE, SLVNODE specified in the configuration.
Communication from hosts that do not exist will be rejected.

Notes on Posix MQ

Posix MQ is used for IPC communication between CHMPX program and server/client program.
Depending on the system environment, the MQ number and size of the specified configuration may be small.
The CHMPX program can not be started when the number of MQs and the size is small.
In such a case, increase one or both of the following MQ related settings.

# echo 1024 > /proc/sys/fs/mqueue/queues_max

or

# echo 1024 > /proc/sys/fs/mqueue/msg_max

(1024 number value is sample)

If CHMPX fails to start due to lack of MQ resources, a message to that effect is output.
This message can be output with the -d option specified.
The message tells you to increase one of the above values that you need.
You can use the chmconftest tool in advance to load the configuration and check the required MQ resources.

Feature TOP Usage