6.2.5. Setting Node Parameters
When using the installation scripts, you can set a variety of parameters related to nodes. The following table highlights some important parameters used during installations of the node component:
| Parameter | Description |
|---|---|
domain | This sets the network domain under which DNS entries for applications are placed. |
hosts_domain | If specified and host DNS is to be created, this domain is created and used for creating host DNS records; application records are still placed in the domain specified with the domain parameter. |
hostname | This is used to configure the host's actual host name. |
node_hostname | This is used as a default for the hostname parameter when installing the node component. It is also used when adding DNS records, if the named_entries parameter is not specified. |
named_ip_addr | This is used by every host to configure its primary name server. It defaults to the current IP address if installing the named component, otherwise it defaults to the broker_ip_addr parameter. |
node_ip_addr | This is used by the node to provide a public IP address if different from one on its NIC. It defaults to the current IP address when installing the node component. |
broker_hostname | This is used by the node to record the host name of its broker, as the node must be able to contact the broker's REST API for actions such as scaling applications up or down. |
node_profile | This sets the name of the node profile, also known as a gear profile or gear size, to be used on the node being installed. The value must also be a member of the valid_gear_sizes parameter used by the broker. |
cartridges | This is a comma-separated list of cartridges to install on the node and defaults to standard, which installs all cartridges that do not require add-on subscriptions. See the commented notes in the header of the scripts for the full list of individual cartridges and more detailed usage. |
For example, the following command runs the
openshift.sh script and sets various node parameters, using default values for all unspecified parameters:
Example 6.8. Setting Node Parameters Using openshift.sh
$ sudo sh openshift.sh install_components=node domain=apps.example.com hosts_domain=hosts.example.com node_hostname=node1.hosts.example.com broker_ip_addr=192.168.0.1 broker_hostname=broker.hosts.example.com node_profile=medium cartridges=php,ruby,postgresql,haproxy,jenkins