Cacheonix provides an extensive list of command line parameters that can be used to override various configuration options defined in cacheonix-config.xml. The parameters are set at JVM startup using a standard syntax for setting Java properties from the command line. The example below demonstrates overriding multicast TTL using property cacheonix.multicast.ttl while starting Cacheonix in a standalone mode:
| Example java -cp cacheonix.jar -Dcacheonix.multicast.ttl=1 cacheonix.Server |
Cacheonix provides the following properties that can be set from the command line:
| Property name | Description | Example |
|---|---|---|
| cacheonix.multicast.ttl | ||
| cacheonix.multicast.address | ||
| cacheonix.multicast.port | ||
| cacheonix.tcp.port | ||
| cacheonix.machine.name | Sets machine's name. A machine name is a name that uniquely identifies a machine that Cacheonix is running on. It is possible to run multiple Cacheonix instances on a single machine. While this configuration helps to reduce the latency caused by garbage collection by running more JVMs with smaller heaps, it also creates a possibility Cacheonix assigning one or more backup copies to the same hardware box thus reducing availability of data in presence of the hardware failures. If the machine name is set, Cacheonix uses it to ensure safety of backup copies by trying to assign them to machines with different names. If the machine name is not set with cacheonix.machine.name, Cacheonix uses an IP address of the host as machine name. | |
| cacheonix.rack.name | Sets rack's name. In a production environment it is common for machines running Cacheonix to be organized into racks. A rack name is a name that uniquely identifies a rack. All machines in a rack may represent a single point of failure because each rack often has its own power and network feed. If the rack name is set, Cacheonix uses it to ensure safety of partition backup copies by trying to assign them to machines in racks with different names. | -Dcacheonix.rack.name=rack_1 -Dcacheonix.rack.name=rack_2 |
| cacheonix.location.name | Sets location's name. For purpose of disaster survival and recovery, Cacheonix infrastructure may consist of a set of geographically distributed data cetenters (locations) connected by a high speed virtual private network. A location name is a name that uniquely identifies a location. If the location name is set, Cacheonix uses it to ensure safety of partition backup copies by trying to assign them to machines at locations with different names. | -Dcacheonix.location.name=Denver "-Dcacheonix.location.name=San Francisco" |
