diskimage-builder

History

Gary Duan 398494568a Contains the directory name of /sys and /proc When a ubuntu/IPA ramdisk is used to boot a baremetal machine with ironic agent-ilo driver, it fails at the point of mounting /proc and /sys. After the vmlinuz(kernel) is started and it tries to load the partitions on ramdisk. It need the directory of "/sys" and "/proc" to mount the corresponding filesystems. In order to fix this issue, the directories of "sys" and "proc" are retained but the subdirectories or files under them are empty. With this change, the directories of "/sys" and "/proc" shows up in the ramdisk and kernel will mount sys and proc filesystems on them respectively. Closes-Bug: #1488445 Change-Id: Iad5d62f373b73789118f23db4c932ea6e9a784c3 Signed-off-by: Gary Duan <duanlg@live.cn>		2015-09-25 16:51:44 +08:00
..
cleanup.d	Contains the directory name of /sys and /proc	2015-09-25 16:51:44 +08:00
finalise.d	Reduce the size of the ironic-agent ramdisk	2015-08-06 16:34:30 +01:00
install.d	Install ironic-agent dependencies via package-installs	2015-09-21 13:10:30 +02:00
post-install.d	Remove dnf workaround in ironic-agent	2015-09-21 13:13:19 +02:00
element-deps	[ironic-agent] Use svc-map for enabling agent	2015-09-01 07:12:52 -04:00
element-provides	Add element for building ramdisk with ironic-python-agent	2014-11-13 19:30:44 +02:00
package-installs.yaml	Merge "Remove dnf workaround in ironic-agent"	2015-09-24 11:01:30 +00:00
pkg-map	Install ironic-agent dependencies via package-installs	2015-09-21 13:10:30 +02:00
README.rst	ironic-agent element to output a .kernel file	2015-09-23 19:02:54 -04:00
source-repository-ironic-agent	Add packages required for iscsi extension in agent	2015-05-04 00:16:19 -07:00
svc-map	[ironic-agent] Use svc-map for enabling agent	2015-09-01 07:12:52 -04:00

README.rst

============
ironic-agent
============
Builds a ramdisk with ironic-python-agent.  More information can be found at:
    https://git.openstack.org/cgit/openstack/ironic-python-agent/

Beyond installing the ironic-python-agent, this element does the following:

* Installs the ``dhcp-all-interfaces`` so the node, upon booting, attempts to
  obtain an IP address on all available network interfaces.
* Disables the ``iptables`` service on SysV and systemd based systems.
* Disables the ``ufw`` service on Upstart based systems.
* Installs packages required for the operation of the ironic-python-agent::
    ``qemu-utils`` ``parted`` ``hdparm`` ``util-linux`` ``genisoimage``
* When installing from source, ``python-dev`` and ``gcc`` are also installed
  in order to support source based installation of ironic-python-agent and its
  dependencies.

This element outputs three files:

- ``$IMAGE-NAME.initramfs``: The deploy ramdisk file containing the
  ironic-python-agent (IPA) service.
- ``$IMAGE-NAME.kernel``: The kernel binary file.
- ``$IMAGE-NAME.vmlinuz``: A hard link pointing to the ``$IMAGE-NAME.kernel``
  file; this is just a backward compatibility layer, please do not rely
  on this file.

.. note::
   The package based install currently only enables the service when using the
   systemd init system. This can easily be changed if there is an agent
   package which includes upstart or sysv packaging.

.. note::
   Using the ramdisk will require at least 1.5GB of ram