abc77b1567
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
116 lines
4.0 KiB
ReStructuredText
116 lines
4.0 KiB
ReStructuredText
.. _SeaMicro:
|
|
|
|
===============
|
|
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-seamicroclient`` [1]_ 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 :ref:`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
|
|
.. [2] DiskImage-Builder - http://docs.openstack.org/developer/diskimage-builder/
|