Index > Server-side > Options
Options
mkroute
Purpose
bin/mkroute is a command which make routing information files of ROMA.
Syntax
$ bin/mkroute [options] [nodeIDs]
Specify the list of ROMA processes ID which configure ROMA to nodeIDs.
ROMA processes ID is a pair a port number with a hostname or IP address where ROMA processes start up.
The delimiter which is between the hostname and the port number is "-".
Options
| Name | Description | Default | Required |
| -h, --hash [bits] | Specify number of bits for ROMA Hash table.
Example: -h 32 (The range in this case is from 0 to 2^32.) | 32 | No |
| -d, --divide [bits] | Specify number of bits for ROMA divide by. ########### .
Example: -d 9 | 9 | No |
| -r, --redundant [num] | Specify number of redundancy.
Example: -r 1 (The redundancy is 1.) | 2 | No |
| --enabled_repeathost | Specify this option if some processes start up in same host.
If some processes start up in some hosts, it should be not specified. | | No |
Examples
- 2 servers ( 192.168.10.01 and 192.168.10.02 ) start up each 2 processes.
In this case, ROMA has 4 ROMA processes.
$ bin/mkroute 192.168.10.01_11211 192.168.10.01_11212 192.168.10.02_11211 192.168.10.02_11212
- 1 server ( localhost ) starts up 2 processes. In this case, ROMA has 2 ROMA pcocesses.
Note: --enabled_repeathost option is necessary in ROMA, if some ROMA processes start up in single server.
$ bin/mkroute --enabled_repeathost localhost_11211 localhost_11212
romad
Purpose
romad is a command which starts up ROMA.
Syntax
$ romad [options] address
Options
| Name | Description | Default | Required |
| -d, --daemon | Specify whether ROMA which starts up become daemon process. | | No |
| -j, --join [address_port] | Specify this option if ROMA process will join an active ROMA dynamically. | | No |
| -p, --port [PORT] | Specify the port number which ROMA process will receive client requests. | | No |
| --start_with_failover | | | |
| --verbose | Display detailed logs. | | No |
| -n, --name [name] | Modify name of ROMA(Services). | | No |
| --enabled_repeathost | Specify this option if some ROMA processes start up in single server. | | No |
| -h, --help | Display help. | | No |
| -v, --version | Output version information. | | No |
| --disabled_cmd_protect | | | |
| --config | Specify the configuration file if you want. | lib/roma/config.rb | No |
Examples
- In this case, ROMA process starts up using 11211 port in localhost.
$ bin/romad localhost -p 11211 -d
- In this case, ROMA process starts up using 11211 port in localhost.
In addition, localhost will start up 2 ROMA processes.
Note: --enabled_repeathost option is necessary in ROMA, if some ROMA processes start up in single server.
$ bin/romad --enabled_repeathost localhost -p 11211 -d
- You can add new server to an active ROMA dynamically due to increasing data size of ROMA.
The additional data size is amount of data in which new server can store.
It is required at least one online ROMA process information.
An example follow; - There are ROMA which ROMA process (roma01_11211) takes part in.
In this case, there is a sample of a command that you add new ROMA process (roma03_11211) to this ROMA.
In the command, roma03 -p 11211 is information of adding new server.
And, -j roma01_11211 is information of the online ROMA processes.
$ bin/romad roma03 -p 11211 -j roma01_11211 -d