"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/source/admin/ramdisk-boot.rst" between
ironic-16.0.2.tar.gz and ironic-16.0.3.tar.gz

About: OpenStack Ironic (Optional Service: Bare-Metal Provisioning) aims to provision bare metal machines instead of virtual machines, forked from the Nova baremetal driver.
The "Victoria" series (latest release).

ramdisk-boot.rst  (ironic-16.0.2):ramdisk-boot.rst  (ironic-16.0.3)
skipping to change at line 47 skipping to change at line 47
openstack baremetal node set <NODE> --deploy-interface ramdisk openstack baremetal node set <NODE> --deploy-interface ramdisk
Using virtual media: Using virtual media:
.. code-block:: shell .. code-block:: shell
openstack baremetal node create --driver redfish \ openstack baremetal node create --driver redfish \
--deploy-interface ramdisk \ --deploy-interface ramdisk \
--boot-interface redfish-virtual-media --boot-interface redfish-virtual-media
.. TODO(dtantsur): document how exactly to create and boot a ramdisk Creating a ramdisk
------------------
A ramdisk can be created using the ``ironic-ramdisk-base`` element from
ironic-python-agent-builder_, e.g. with Debian:
.. code-block:: shell
export ELEMENTS_PATH=/opt/stack/ironic-python-agent-builder/dib
disk-image-create -o /output/ramdisk \
debian-minimal ironic-ramdisk-base openssh-server dhcp-all-interfaces
You should consider using the following elements:
* openssh-server_ to install the SSH server since it's not provided by default
by some minimal images.
* devuser_ or dynamic-login_ to provide SSH access.
* dhcp-all-interfaces_ or simple-init_ to configure networking.
The resulting files (``/output/ramdisk.kernel`` and
``/output/ramdisk.initramfs`` in this case) can then be used when `Booting a
ramdisk`_.
Booting a ramdisk
-----------------
Pass the kernel and ramdisk as normally, also providing the ramdisk as an image
source, for example,
.. code-block:: shell
baremetal node set <NODE> \
--instance-info kernel=http://path/to/ramdisk.kernel \
--instance-info ramdisk=http://path/to/ramdisk.initramfs \
--instance-info image_source=http://path/to/ramdisk.initramfs
baremetal node deploy <NODE>
.. note::
The requirement to pass ``image_source`` is artificial and will be fixed
in a future version of the Bare Metal service.
Booting an ISO Booting an ISO
-------------- --------------
The ``ramdisk`` deploy interface can also be used to boot an ISO image. The ``ramdisk`` deploy interface can also be used to boot an ISO image.
For example, For example,
.. code-block:: shell .. code-block:: shell
openstack baremetal node set <NODE> \ openstack baremetal node set <NODE> \
skipping to change at line 81 skipping to change at line 120
expect to leverage a metadata service, custom ramdisk images, or the expect to leverage a metadata service, custom ramdisk images, or the
``instance_info/ramdisk_kernel_arguments`` parameter to add options to ``instance_info/ramdisk_kernel_arguments`` parameter to add options to
the kernel boot command line. the kernel boot command line.
* When using PXE/iPXE boot, bare metal nodes must continue to have network * When using PXE/iPXE boot, bare metal nodes must continue to have network
access to PXE and iPXE network resources. This is contrary to most tenant access to PXE and iPXE network resources. This is contrary to most tenant
networking enabled configurations where this access is restricted to networking enabled configurations where this access is restricted to
the provisioning and cleaning networks the provisioning and cleaning networks
* As with all deployment interfaces, automatic cleaning of the node will * As with all deployment interfaces, automatic cleaning of the node will
still occur with the contents of any local storage being wiped between still occur with the contents of any local storage being wiped between
deployments. deployments.
.. _ironic-python-agent-builder: https://opendev.org/openstack/ironic-python-age
nt-builder
.. _openssh-server: https://docs.openstack.org/diskimage-builder/latest/elements
/openssh-server/README.html
.. _devuser: https://docs.openstack.org/diskimage-builder/latest/elements/devuse
r/README.html
.. _dynamic-login: https://docs.openstack.org/diskimage-builder/latest/elements/
dynamic-login/README.html
.. _dhcp-all-interfaces: https://docs.openstack.org/diskimage-builder/latest/ele
ments/dhcp-all-interfaces/README.html
.. _simple-init: https://docs.openstack.org/diskimage-builder/latest/elements/si
mple-init/README.html
 End of changes. 2 change blocks. 
1 lines changed or deleted 40 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)