summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulia Kreger <juliaashleykreger@gmail.com>2019-04-16 22:05:36 -0700
committerJulia Kreger <juliaashleykreger@gmail.com>2019-06-25 23:44:19 -0700
commit5f18e52b6443e0f624aaaa6f0b096e91bc34f796 (patch)
tree13f9ac9354bdfebf94a220f37e91433e9e58e73d /doc
parent7a718ee4de6bc04aa6a63c99899a2d6e4e130bb7 (diff)
downloadironic-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.rst2
-rw-r--r--doc/source/admin/drivers/cimc.rst93
-rw-r--r--doc/source/admin/drivers/ucs.rst92
-rw-r--r--doc/source/admin/upgrade-to-hardware-types.rst4
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::