Dao Cong Tien 080f6566dd Small change of doc title for the drivers

As some drivers such as ilo, irmc, oneview were changed from
term "drivers" to singular. This patch updates the remaining
drivers.

Change-Id: If9ec87743d29bb36e19452bdbf969b57a7c0464e

2018-07-02 11:15:43 +07:00

2.9 KiB

Raw Blame History

CIMC driver

Overview

The cisco-ucs-standalone hardware type targets standalone Cisco UCS C series servers. It enables you to take advantage of CIMC by using the python SDK.

The CIMC hardware type can use the Ironic Inspector service for in-band inspection of equipment. For more information see the Ironic Inspector documentation.

Prerequisites

ImcSdk is a python SDK for the CIMC HTTP/HTTPS XML API used to control CIMC.

Install the `ImcSdk` module

Note

Install the ImcSdk module on the Ironic conductor node. Required version is 0.7.2.

Install it:
```
$ pip install "ImcSdk>=0.7.2"
```

Tested Platforms

This driver works with UCS C-Series servers and has been tested with:

UCS C240M3S

Configuring and Enabling the driver

Add cisco-ucs-standalone to enabled_hardware_types in /etc/ironic/ironic.conf. For example:
```
enabled_hardware_types = ipmi,cisco-ucs-standalone
```

Restart the Ironic conductor service:

For Ubuntu/Debian systems:

$ sudo service ironic-conductor restart

or for RHEL/CentOS/Fedora:

$ sudo systemctl restart openstack-ironic-conductor

Registering CIMC Managed UCS node in Ironic

Nodes configured for CIMC driver should have the driver property set to cisco-ucs-standalone. The following configuration values are also required in driver_info:

cimc_address: IP address or hostname for CIMC
cimc_username: CIMC login user name
cimc_password: CIMC login password for the above CIMC user.
deploy_kernel: Identifier for the deployment kernel e.g. a Glance UUID
deploy_ramdisk: Identifier for the deployment ramdisk e.g. a Glance UUID

The following sequence of commands can be used to enroll a UCS Standalone node.

Create Node:

openstack baremetal node create --driver cisco-ucs-standalone \
  --driver-info cimc_address=<CIMC hostname OR ip-address> \
  --driver-info cimc_username=<cimc_username> \
  --driver-info cimc_password=<cimc_password> \
  --driver-info deploy_kernel=<glance_uuid_of_deploy_kernel> \
  --driver-info deploy_ramdisk=<glance_uuid_of_deploy_ramdisk> \
  --property cpus=<number_of_cpus> \
  --property memory_mb=<memory_size_in_MB> \
  --property local_gb=<local_disk_size_in_GB> \
  --property cpu_arch=<cpu_arch>

The above command 'openstack baremetal node create' will return UUID of the node, which is the value of $NODE in the following command.

Associate port with the node created:

openstack baremetal port create --node $NODE <MAC_address_of_Ucs_server's_NIC>

For more information about enrolling nodes see enrollment in the install guide.

2.9 KiB Raw Blame History