diff options
author | Julia Kreger <juliaashleykreger@gmail.com> | 2019-04-16 22:05:36 -0700 |
---|---|---|
committer | Julia Kreger <juliaashleykreger@gmail.com> | 2019-06-25 23:44:19 -0700 |
commit | 5f18e52b6443e0f624aaaa6f0b096e91bc34f796 (patch) | |
tree | 13f9ac9354bdfebf94a220f37e91433e9e58e73d /doc | |
parent | 7a718ee4de6bc04aa6a63c99899a2d6e4e130bb7 (diff) | |
download | ironic-5f18e52b6443e0f624aaaa6f0b096e91bc34f796.tar.gz |
Remove CIMC/UCS drivers
Cisco's Third-Party CI was taken down as a result of the
CTO's office being restructured. Numerous attempts to
re-engage with Cisco directly and address the various
known issues in their drivers have not proven to be
fruitful.
Additionally, the drivers are not Python3 compatible,
and some reports have indicated that the CIMC driver is
no longer compatible with newer versions.
As such, the ironic community has little choice but to
to remove the Cisco UCS/CIMC hardware types and driver
interface code.
Story: 2005033
Task: 29522
Change-Id: Ie12eaf7572ce4d66f6a68025b7fe2d294185ce28
Diffstat (limited to 'doc')
-rw-r--r-- | doc/source/admin/drivers.rst | 2 | ||||
-rw-r--r-- | doc/source/admin/drivers/cimc.rst | 93 | ||||
-rw-r--r-- | doc/source/admin/drivers/ucs.rst | 92 | ||||
-rw-r--r-- | doc/source/admin/upgrade-to-hardware-types.rst | 4 |
4 files changed, 0 insertions, 191 deletions
diff --git a/doc/source/admin/drivers.rst b/doc/source/admin/drivers.rst index 9f4563101..eca79ecb3 100644 --- a/doc/source/admin/drivers.rst +++ b/doc/source/admin/drivers.rst @@ -17,7 +17,6 @@ Hardware Types .. toctree:: :maxdepth: 1 - drivers/cimc drivers/ibmc drivers/idrac drivers/ilo @@ -25,7 +24,6 @@ Hardware Types drivers/irmc drivers/redfish drivers/snmp - drivers/ucs drivers/xclarity Changing Hardware Types and Interfaces diff --git a/doc/source/admin/drivers/cimc.rst b/doc/source/admin/drivers/cimc.rst deleted file mode 100644 index 413fe179b..000000000 --- a/doc/source/admin/drivers/cimc.rst +++ /dev/null @@ -1,93 +0,0 @@ -.. _CIMC: - -=========== -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 <https://docs.openstack.org/ironic-inspector/latest>`_. - -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 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -1. Add ``cisco-ucs-standalone`` to ``enabled_hardware_types`` in - ``/etc/ironic/ironic.conf``. For example:: - - enabled_hardware_types = ipmi,cisco-ucs-standalone - -2. 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 :ref:`enrollment` in the install guide. diff --git a/doc/source/admin/drivers/ucs.rst b/doc/source/admin/drivers/ucs.rst deleted file mode 100644 index 1ae4e62a7..000000000 --- a/doc/source/admin/drivers/ucs.rst +++ /dev/null @@ -1,92 +0,0 @@ -.. _UCS: - -========== -UCS driver -========== - -Overview -======== - -The UCS driver is targeted for UCS Manager managed Cisco UCS B/C series -servers. The ``cisco-ucs-managed`` hardware type enables you to take advantage -of UCS Manager by using the python SDK. - -The UCS hardware type can use the Ironic Inspector service for in-band -inspection of equipment. For more information see the `Ironic Inspector -documentation <https://docs.openstack.org/ironic-inspector/latest>`_. - -Prerequisites -============= - -* ``UcsSdk`` is a python package version of XML API sdk available to - manage Cisco UCS Managed B/C-series servers. - - Install ``UcsSdk`` [1]_ module on the Ironic conductor node. - Required version is 0.8.2.2:: - - $ pip install "UcsSdk==0.8.2.2" - -Tested Platforms -~~~~~~~~~~~~~~~~ -This driver works on Cisco UCS Manager Managed B/C-series servers. -It has been tested with the following servers: - -UCS Manager version: 2.2(1b), 2.2(3d). - -* UCS B22M, B200M3 -* UCS C220M3. - -All the Cisco UCS B/C-series servers managed by UCSM 2.1 or later are supported -by this driver. - -Configuring and Enabling the driver -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -1. Add ``cisco-ucs-managed`` to the ``enabled_hardware_types`` in - ``/etc/ironic/ironic.conf``. For example:: - - enabled_hardware_types = ipmi,cisco-ucs-managed - -2. Restart the Ironic conductor service:: - - service ironic-conductor restart - -Registering UCS node in Ironic -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Nodes configured for UCS driver should have the ``driver`` property set to -``cisco-ucs-managed``. The following configuration values are also required in -``driver_info``: - -- ``ucs_address``: IP address or hostname of the UCS Manager -- ``ucs_username``: UCS Manager login user name with administrator or - server_profile privileges. -- ``ucs_password``: UCS Manager login password for the above UCS Manager user. -- ``deploy_kernel``: The Glance UUID of the deployment kernel. -- ``deploy_ramdisk``: The Glance UUID of the deployment ramdisk. -- ``ucs_service_profile``: Distinguished name(DN) of service_profile being enrolled. - -The following sequence of commands can be used to enroll a UCS node. - -* Create Node:: - - openstack baremetal node create --driver cisco-ucs-managed \ - --driver-info ucs_address=<UCS Manager hostname/ip-address> \ - --driver-info ucs_username=<ucsm_username> \ - --driver-info ucs_password=<ucsm_password> \ - --driver-info ucs_service_profile=<service_profile_dn_being_enrolled> \ - --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> - -References -========== -.. [1] UcsSdk - https://pypi.org/project/UcsSdk diff --git a/doc/source/admin/upgrade-to-hardware-types.rst b/doc/source/admin/upgrade-to-hardware-types.rst index fb1c90955..511128864 100644 --- a/doc/source/admin/upgrade-to-hardware-types.rst +++ b/doc/source/admin/upgrade-to-hardware-types.rst @@ -22,19 +22,15 @@ agent_ilo ilo ilo-virtual-media direct agent_ipmitool ipmi pxe direct inspector ipmitool ipmitool agent_ipmitool_socat ipmi pxe direct inspector ipmitool ipmitool agent_irmc irmc irmc-virtual-media direct irmc irmc irmc -agent_ucs cisco-ucs-managed pxe direct inspector ucsm ucsm iscsi_ilo ilo ilo-virtual-media iscsi ilo ilo ilo iscsi_irmc irmc irmc-virtual-media iscsi irmc irmc irmc -pxe_agent_cimc cisco-ucs-standalone pxe direct inspector cimc cimc pxe_drac idrac pxe iscsi idrac idrac idrac pxe_drac_inspector idrac pxe iscsi inspector idrac idrac pxe_ilo ilo ilo-pxe iscsi ilo ilo ilo pxe_ipmitool ipmi pxe iscsi inspector ipmitool ipmitool pxe_ipmitool_socat ipmi pxe iscsi inspector ipmitool ipmitool -pxe_iscsi_cimc cisco-ucs-standalone pxe iscsi inspector cimc cimc pxe_irmc irmc irmc-pxe iscsi irmc irmc irmc pxe_snmp snmp pxe iscsi no-inspect fake snmp -pxe_ucs cisco-ucs-managed pxe iscsi inspector ucsm ucsm ===================== ==================== ==================== ============== ========== ========== ========= .. note:: |