Define DIB_LOCAL_IMAGE as the downloaded image:

$ export DIB_LOCAL_IMAGE=rhel-server-7.4-x86_64-kvm.qcow2

Set your registration information. If you use Red Hat Customer Portal, you must configure the following information:

$ export REG_USER='USER_NAME'
$ export REG_PASSWORD='PASSWORD'
$ export REG_AUTO_ATTACH=true
$ export REG_METHOD=portal
$ export https_proxy='IP_address:port' (if applicable)
$ export http_proxy='IP_address:port' (if applicable)

If you use Red Hat Satellite, you must configure the following information:

$ export REG_USER='USER_NAME'
$ export REG_PASSWORD='PASSWORD'
$ export REG_SAT_URL='<SATELLITE URL>'
$ export REG_ORG='<SATELLITE ORG>'
$ export REG_ENV='<SATELLITE ENV>'
$ export REG_METHOD=<METHOD>

If you have any offline repositories, you can define DIB_YUM_REPO_CONF as local repository configuration:

$ export DIB_YUM_REPO_CONF=<path-to-local-repository-config-file>

Create the user images using the diskimage-builder tool:

$ disk-image-create rhel7 baremetal -o rhel-image

This extracts the kernel as rhel-image.vmlinuz and initial ramdisk as rhel-image.initrd.

Upload the images to the Image service:

$ KERNEL_ID=$(openstack image create \
  --file rhel-image.vmlinuz --public \
  --container-format aki --disk-format aki \
  -f value -c id rhel-image.vmlinuz)
$ RAMDISK_ID=$(openstack image create \
  --file rhel-image.initrd --public \
  --container-format ari --disk-format ari \
  -f value -c id rhel-image.initrd)
$ openstack image create \
  --file rhel-image.qcow2   --public \
  --container-format bare \
  --disk-format qcow2 \
  --property kernel_id=$KERNEL_ID \
  --property ramdisk_id=$RAMDISK_ID \
  rhel-image

Create a file overcloud-nodes.yaml, including the node details. Multiple nodes can be enrolled with one file.

nodes:
    - name: node0
      driver: pxe_ipmitool
      driver_info:
        ipmi_address: <IPMI_IP>
        ipmi_username: <USER>
        ipmi_password: <PASSWORD>
      properties:
        cpus: <CPU_COUNT>
        cpu_arch: <CPU_ARCHITECTURE>
        memory_mb: <MEMORY>
        local_gb: <ROOT_DISK>
        root_device:
            serial: <SERIAL>
      ports:
        - address: <PXE_NIC_MAC>

Replace the following values:

Set up the shell to use Identity as the administrative user:

$ source ~/overcloudrc

Import the inventory file into ironic:

$ openstack baremetal create overcloud-nodes.yaml

The nodes are now in the enroll state. Make them available by specifying the deploy kernel and deploy ramdisk on each node:

$ openstack baremetal node set NODE_UUID \
  --driver-info deploy_kernel=KERNEL_UUID \
  --driver-info deploy_ramdisk=INITRAMFS_UUID

Replace the following values:

Check that the nodes were successfully enrolled:

$ openstack baremetal node list

There may be a delay between enrolling a node and its state being shown.

Set up the shell to use Identity as the administrative user:

$ source ~/overcloudrc

Add a new node:

$ openstack baremetal node create --driver pxe_impitool --name NAME

To create a node you must specify the driver name. This example uses pxe_impitool. To use a different driver, you must enable it by setting the IronicEnabledDrivers parameter. For more information on supported drivers, see Appendix A, Bare Metal Drivers.

Update the node driver information to allow the Bare Metal service to manage the node:

$ openstack baremetal node set NODE_UUID \
  --driver_info PROPERTY=VALUE \
  --driver_info PROPERTY=VALUE

Replace the following values:

Specify the deploy kernel and deploy ramdisk for the node driver:

$ openstack baremetal node set NODE_UUID \
  --driver-info deploy_kernel=KERNEL_UUID \
  --driver-info deploy_ramdisk=INITRAMFS_UUID

Replace the following values:

Update the node’s properties to match the hardware specifications on the node:

$ openstack baremetal node set NODE_UUID \
  --property cpus=CPU \
  --property memory_mb=RAM_MB \
  --property local_gb=DISK_GB \
  --property cpu_arch=ARCH

Replace the following values:

OPTIONAL: Configure the node to reboot after initial deployment from a local boot loader installed on the node’s disk, instead of using PXE from ironic-conductor. The local boot capability must also be set on the flavor used to provision the node. To enable local boot, the image used to deploy the node must contain grub2. Configure local boot:

$ openstack baremetal node set NODE_UUID \
  --property capabilities="boot_option:local"

Replace NODE_UUID with the unique identifier for the node. Alternatively, use the node’s logical name.

Inform the Bare Metal service of the node’s network card by creating a port with the MAC address of the NIC on the provisioning network:

$ openstack baremetal port create --node NODE_UUID MAC_ADDRESS

Replace NODE_UUID with the unique identifier for the node. Replace MAC_ADDRESS with the MAC address of the NIC used to PXE boot.

If you have multiple disks, set the root device hints. This informs the deploy ramdisk which disk it should use for deployment.

$ openstack baremetal node set NODE_UUID \
  --property root_device={"PROPERTY": "VALUE"}

Replace with the following values:

Validate the node’s setup:

$ openstack baremetal node validate NODE_UUID
+------------+--------+---------------------------------------------+
| Interface  | Result | Reason                                      |
+------------+--------+---------------------------------------------+
| boot       | False  | Cannot validate image information for node  |
|            |        | a02178db-1550-4244-a2b7-d7035c743a9b        |
|            |        | because one or more parameters are missing  |
|            |        | from its instance_info. Missing are:        |
|            |        | ['ramdisk', 'kernel', 'image_source']       |
| console    | None   | not supported                               |
| deploy     | False  | Cannot validate image information for node  |
|            |        | a02178db-1550-4244-a2b7-d7035c743a9b        |
|            |        | because one or more parameters are missing  |
|            |        | from its instance_info. Missing are:        |
|            |        | ['ramdisk', 'kernel', 'image_source']       |
| inspect    | None   | not supported                               |
| management | True   |                                             |
| network    | True   |                                             |
| power      | True   |                                             |
| raid       | True   |                                             |
| storage    | True   |                                             |
+------------+--------+---------------------------------------------+

Replace NODE_UUID with the unique identifier for the node. Alternatively, use the node’s logical name. The output of the command above should report either True or None for each interface. Interfaces marked None are those that you have not configured, or those that are not supported for your driver.