Ironic is an OpenStack<\/a> project which provisions bare metal (as opposed to virtual) machines. It may be used independently or as part of an OpenStack Cloud, and integrates with the OpenStack Identity (keystone), Compute (nova), Network (neutron), Image (glance), and Object (swift) services.<\/p>\n The Bare Metal service manages hardware through both common (eg. PXE<\/a> and IPMI<\/a>) and vendor- specific remote management protocols. It provides the cloud operator with a unified interface to a heterogeneous fleet of servers while also providing the Compute service with an interface that allows physical servers to be managed as though they were virtual machines.<\/p>\n This documentation is continually updated and may not represent the state of the project at any specific prior release. To access documentation for a previous release of ironic, append the OpenStack release name to the URL; for example, the ocata release is available at https:\/\/docs.openstack.org\/ironic\/ocata\/<\/a>.<\/p>\n 2.1 Bare Metal Service Installation Guide <\/b><\/p>\n The Bare Metal service is a collection of components that provides support to manage and provision physical machines. This chapter assumes a working setup of OpenStack following the OpenStack Installation Guides. It contains the following sections:<\/p>\n 2.1.1 Bare Metal service overview\u00a0<\/b><\/p>\n The Bare Metal service, codenamed ironic, is a collection of components that provides support to manage and provision physical machines.<\/p>\n Bare Metal service components<\/b><\/p>\n The Bare Metal service includes the following components:<\/p>\n ironic-api\u00a0<\/b>A RESTful API that processes application requests by sending them to the ironic-conductor over remote procedure call (RPC)<\/a>. Can be run through WSGI<\/a> or as a separate process.<\/p>\n ironic-conductor\u00a0<\/b>Adds\/edits\/deletes nodes; powers on\/off nodes with IPMI or other vendor-specific\u00a0protocol; provisions\/deploys\/cleans bare metal nodes. ironic-conductor uses\u00a0drivers\u00a0<\/i>to execute operations on hardware.<\/p>\n ironic-python-agent\u00a0<\/b>A python service which is run in a temporary ramdisk to provide ironic-conductor and ironic-inspector services with remote access, in-band hardware control, and hardware introspection.<\/p>\n Additionally, the Bare Metal service has certain external dependencies, which are very similar to other OpenStack services:<\/p>\n Deployment architecture<\/b><\/p>\n The Bare Metal RESTful API service is used to enroll hardware that the Bare Metal service will manage. A cloud administrator usually registers it, specifying their attributes such as MAC addresses and IPMI credentials. There can be multiple instances of the API service.<\/p>\n The\u00a0ironic-conductor\u00a0<\/i>process does the bulk of the work. For security reasons, it is advisable to place it on an isolated host, since it is the only service that requires access to both the data plane and IPMI control plane.<\/p>\n There can be multiple instances of the conductor service to support various class of drivers and also to manage fail over. Instances of the conductor service should be on separate nodes. Each conductor can itself run many drivers to operate heterogeneous hardware. This is depicted in the following figure.<\/p>\n The API exposes a list of supported drivers and the names of conductor hosts servicing them.<\/p>\n Interaction with OpenStack components<\/b><\/p>\n The Bare Metal service may, depending upon configuration, interact with several other OpenStack ser- vices. This includes:<\/p>\nChapter Two – Installation Guide<\/b><\/h2>\n
\n
\n