# Bootstrap node

A temporary bootstrap node is required for OpenShift cluster creation. This section assumes that a VMware vSphere host is present within the deployment environment and is associated with a VMware vCenter server. The host should be configured with appropriate storage and networking configuration.

# Playbooks for creating the bootstrap node

  1. inputs.yml: This file contains input variables to create the bootstrap VM. Some of the variables pertaining to the VM configuration are provided with default values as per the Red Hat guidelines. It is expected that the installation user updates the values to suit their installation environment.

    • datacenter_name: Name of the VMware data center.

    • cluster_name: Name of the VMware cluster.

    • datastore_name: Name of the VMware datastore.

    • network_name: Name of the network associated with the vSphere host.

    • bootstrap_disk: Disk size for the bootstrap node.

    • bootstrap_cpu: Number of vCPUs for the bootstrap node.

    • bootstrap_name: Custom name of the bootstrap node.

  2. secret.yml: This is an Ansible vault file that contains sensitive information such as the VMware vCenter server IP address and credentials.

  3. playbooks/deploy_vm.yml: This playbook is used to create the bootstrap VM.

  4. roles/deploy_vm.yml: This is the Ansible role file that is required to create the bootstrap VM. Each role is associated with a set of tasks to accomplish the expected output and they are present in the tasks directory within the role.

Follow these steps to create the bootstrap node:

  1. Login to the installer VM.

  2. Use the following command to change the directory.

    > cd /opt/hpe/solutions/ocp/hpe-solutions-openshift/DL/scalable/infrastructure
    
  3. Update the secret.yml to provide the details of the VMware vCenter server using the following command. A sample input is provided and it is expected that the installation user updates the configuration to suit the deployment environment.

    > ansible-vault edit secret.yml
    
    # vcenter hostname/ip address and credentials
    vcenter_hostname: <vcenter hostname>;
    vcenter_username: <vcenter username>;
    vcenter_password: <vcenter password>;
    
  4. Update the input.yml file with the data center, cluster, and datastore information that will be used within the VMware vCenter server. This file provides default configuration information for the bootstrap node, if required. The configuration can be updated to suit the environment needs.

    # Variables for creating the bootstrap VM, as per the vSphere host configuration within the vCenter
    datacenter_name: <name of data center within vcenter>;
    cluster_name: name of cluster within vcenter>;
    datastore_name: name of datastore within vcenter>;
    network_name: <name of the network within vcenter>;
    
    # Default values for creating the bootstrap VM
    bootstrap_disk: 150
    bootstrap_cpu: 4
    bootstrap_memory: 16400
    bootstrap_name: Bootstrap
    
  5. After the input.yml and secret.yml files are updated with appropriate values, execute the playbook with the following command to create the bootstrap VM.

    > ansible-playbook –i hosts playbooks/deploy_vm.yml –ask-vault-pass
    

    NOTE

    It is essential that all the nodes within the deployment environment are synchronized for time using an NTP server. Failure to do so will result in an installation failure due to mismatch in certificates or other files with time dependencies.