3.7 Preparing a Separate Master Node

A master node is a host from which you deploy Oracle OpenStack for Oracle Linux to the target nodes using the kollacli deploy command. Typically, you use a controller node as a master node, which is prepared as described in Section 3.5, “Preparing Oracle Linux Nodes”. However, if you prefer, you can use a separate host as a master node. Because a separate master node is not part of an OpenStack deployment, you do not have to install and configure Docker on the node. You simply install the openstack-kollacli package and configure the users that can run the kollacli command. Only configure a one node as a master node.

See Section 3.1, “System Requirements”, for the minimum requirements for a separate master node

In order to recover from a failure, you should ensure that you have backups of the /etc/kolla and /usr/share/kolla directories.

To prepare a separate master node:

Enable the required ULN channels or Yum repositories.
You only need to perform this step if you are not using a controller node as a master node.
To enable the required ULN channels:
1. Log in to http://linux.oracle.com with your ULN user name and password.
2. On the Systems tab, click the link named for the system in the list of registered machines.
3. On the System Details page, click Manage Subscriptions.
4. On the System Summary page, use the left and right arrows to move channels to and from the list of subscribed channels.
  Subscribe the system to the following channels:
  - ol7_x86_64_UEKR4 - Unbreakable Enterprise Kernel Release 4 for Oracle Linux 7 (x86_64)
  - ol7_x86_64_addons - Oracle Linux 7 Addons (x86_64)
  - ol7_x86_64_openstack30 - Oracle OpenStack 3.0 (x86_64)
  - ol7_x86_64_latest - Oracle Linux 7 Latest (x86_64)
  - (Optional) ol7_x86_64_UEKR4_OFED - OFED supporting tool packages for Unbreakable Enterprise Kernel Release 4 on Oracle Linux 7 (x86_64)
    Subscribe to this channel if you are using the OFED (OpenFabrics Enterprise Distribution) packages provided by Oracle. UEK R4 requires a different set of OFED packages to UEK R3.
  Unsubscribe the system from the following channels:
  - ol7_x86_64_UEKR3 - Unbreakable Enterprise Kernel Release 3 for Oracle Linux 7 (x86_64) - Latest
  - ol7_x86_64_UEKR3_OFED20 - OFED supporting tool packages for Unbreakable Enterprise Kernel Release 3 on Oracle Linux 7 (x86_64)
  - ol7_x86_64_openstack20 - Oracle OpenStack 2.0 (x86_64)
  - ol7_x86_64_openstack21 - Oracle OpenStack 2.1 (x86_64)
5. Click Save Subscriptions.
To enable the required Yum repositories:
1. Check that you have the latest Oracle Linux Yum Server repository file.
  Check that the /etc/yum.repos.d/public-yum-ol7.repo file contains an [ol7_UEKR4] section. If it does not, you do not have the most up-to-date version of the repository file.
  To download the latest copy of the repository file:
```
# curl -L -o /etc/yum.repos.d/public-yum-ol7.repo \
    http://yum.oracle.com/public-yum-ol7.repo
```
2. Edit the /etc/yum.repos.d/public-yum-ol7.repo file.
  Enable the following repositories by setting enabled=1 in the following sections:
  - [ol7_UEKR4]
  - [ol7_addons]
  - [ol7_openstack30]
  - [ol7_latest]
  - (Optional) [ol7_UEKR4_OFED]
    Subscribe to this repository only if you have InfiniBand-capable devices and you are using the OFED (OpenFabrics Enterprise Distribution) packages provided by Oracle. UEK R4 requires a different set of OFED packages to UEK R3.
  Disable the following repositories by setting enabled=0 in the following sections:
  - [ol7_UEKR3]
  - [ol7_UEKR3_OFED20]
  - [ol7_openstack20]
  - [ol7_openstack21]
Install the OpenStack Kolla CLI (kollacli).
If you are preparing a master node for a new OpenStack deployment:
```
# yum install openstack-kollacli
```
If you are updating a master node for a new release of Oracle OpenStack for Oracle Linux:
```
# yum update openstack-kollacli
```
Add a user to the kolla group.
To add an existing user to the kolla group:
```
# usermod -aG kolla username
```
The user must log out and in again for the group setting to take effect.
Important
For security reasons, always run kollacli commands as this user. Never use root or the kolla user.