Chapter 6. Resource Management

Procedure 6.1. To Define a New Gear Profile:

1. Edit the /etc/openshift/resource_limits.conf file on the node host and modify its parameters to your desired specifications. See the file's commented lines for information on available parameters.
2. Modify the node_profile parameter to set a new name for the gear profile, if desired.
3. Restart the ruby193-mcollective service on the node host:

   # service ruby193-mcollective restart

   Copy to Clipboard Toggle word wrap
4. If Traffic Control is enabled in the /etc/openshift/node.conf file, run the following command to apply any bandwidth setting changes:

   # oo-admin-ctl-tc restart

   Copy to Clipboard Toggle word wrap
5. If gears already exist on the node host, run the following commands to ensure the resource limits for the new gear profile are applied to the existing gears:

   # oo-cgroup-enable --with-all-containers
   # oo-pam-enable --with-all-containers

   Copy to Clipboard Toggle word wrap

Procedure 6.2. To Update the List of Valid Gear Sizes:

1. Edit the /etc/openshift/broker.conf file on the broker host and modify the comma-separated list in the VALID_GEAR_SIZES parameter to include the new gear profile.
2. Consider adding the new gear profile to the comma-separated list in the DEFAULT_GEAR_CAPABILITIES parameter as well, which determines the default available gear sizes for new users.
3. Restart the broker service:

   # service openshift-broker restart

   Copy to Clipboard Toggle word wrap
4. For existing users, you must grant their accounts access to the new gear size before they can create gears of that size. Run the following command on the broker host for the relevant user name and gear size:

   # oo-admin-ctl-user -l Username --addgearsize Gear_Sizeoo-admin-ctl-user -l Username --addgearsize Gear_Sizeoo-admin-ctl-user -l Username --addgearsize Gear_Sizeoo-admin-ctl-user -l Username --addgearsize Gear_Size

   Copy to Clipboard Toggle word wrap
5. See Section 6.3.2, “Creating and Populating Districts” for more information on how to create and populate a district, which are required for gear deployment, using the new gear profile.