openstack/ironic
Code Issues Proposed changes
fc4817d5b6
ironic/doc/source/drivers/seamicro.rst
Jim Rollenhagen abc77b1567 Remove links to github for OpenStack things 
Github is not the official reference for OpenStack code repositories,
and as such should not be used in documentation.

Update links that are meant to be links to a project as a whole with
links to the project's documentation.

Update links directly to code to git.openstack.org.

Remove link to tripleo-incubator script for DIB dependencies, as it does
way more than we need to, and the dependencies needed differ between DIB
elements. Instead we leave this as an exercise to the user (this is
documented in the DIB docs).

Change-Id: Iee09b6b86628e46dc5e9436bd0f98a40c50244b7
2016-05-31 11:51:17 -04:00

4.0 KiB
Raw Blame History

SeaMicro driver

Overview

The SeaMicro power driver enables you to take advantage of power cycle management of servers (nodes) within the SeaMicro chassis. The SeaMicro driver is targeted for SeaMicro Fabric Compute systems.

Prerequisites

  • python-seamicroclient is a python package which contains a set of modules for managing SeaMicro Fabric Compute systems.

    Install python-seamicroclient1 module on the Ironic conductor node. Minimum version required is 0.4.0.:

    $ pip install "python-seamicroclient>=0.4.0"

Drivers

pxe_seamicro driver

Overview

pxe_seamicro driver uses PXE/iSCSI (just like pxe_ipmitool driver) to deploy the image and uses SeaMicro to do all management operations on the baremetal node (instead of using IPMI).

Target Users

  • Users who want to use PXE/iSCSI for deployment in their environment.
  • Users who want to use SeaMicro Fabric Compute systems.

Tested Platforms

This driver works on SeaMicro Fabric Compute system. It has been tested with the following servers:

  • SeaMicro SM15000-XN
  • SeaMicro SM15000-OP

Requirements

None.

Configuring and Enabling the driver

  1. Build or download a deploy image, see BuildingDeployRamdisk

  2. Upload these images to Glance:

    glance image-create --name deploy-ramdisk.kernel --disk-format aki --container-format aki < deploy-ramdisk.kernel
glance image-create --name deploy-ramdisk.initramfs --disk-format ari --container-format ari < deploy-ramdisk.initramfs

  3. Add pxe_seamicro to the list of enabled_drivers in /etc/ironic/ironic.conf. For example:

    enabled_drivers = pxe_ipmitool,pxe_seamicro

  4. Restart the Ironic conductor service:

    service ironic-conductor restart

Registering SeaMicro node in Ironic

Nodes configured for SeaMicro driver should have the driver property set to pxe_seamicro. The following configuration values are also required in driver_info:

  • seamicro_api_endpoint: IP address or hostname of the SeaMicro with valid URL as http://<IP_address/hostname>/v2.0
  • seamicro_server_id: SeaMicro Server ID. Expected format is <int>/<int>
  • seamicro_username: SeaMicro Username with administrator privileges.
  • seamicro_password: Password for the above SeaMicro user.
  • deploy_kernel: The Glance UUID of the deployment kernel.
  • deploy_ramdisk: The Glance UUID of the deployment ramdisk.
  • seamicro_api_version: (optional) SeaMicro API Version defaults to "2".
  • seamicro_terminal_port: (optional) Node's UDP port for console access. Any unused port on the Ironic conductor node may be used.

The following sequence of commands can be used to enroll a SeaMicro node and boot an instance on it:

Create nova baremetal flavor corresponding to SeaMicro server's config:

nova flavor-create baremetal auto <memory_size_in_MB> <disk_size_in_GB> <number_of_cpus>

Create Node:

ironic node-create -d pxe_seamicro -i seamicro_api_endpoint=https://<seamicro_ip_address>/ -i seamicro_server_id=<seamicro_server_id> -i seamicro_username=<seamicro_username> -i seamicro_password=<seamicro_password> -i seamicro_api_version=<seamicro_api_version> -i seamicro_terminal_port=<seamicro_terminal_port> -i deploy_kernel=<glance_uuid_of_deploy_kernel> -i deploy_ramdisk=<glance_uuid_of_deploy_ramdisk> -p cpus=<number_of_cpus> -p memory_mb=<memory_size_in_MB> -p local_gb=<local_disk_size_in_GB> -p cpu_arch=<cpu_arch>

Associate port with the node created:

ironic port-create -n $NODE -a <MAC_address_of_SeaMicro_server's_NIC>

Associate properties with the flavor:

nova flavor-key baremetal set "cpu_arch"=<cpu_arch>

Boot the Instance:

nova boot --flavor baremetal --image test-image instance-1

References

  1. Python-seamicroclient - https://pypi.python.org/pypi/python-seamicroclient↩︎