pre-introspection
=================

.. _pre-introspection_check-network-gateway:

check-network-gateway
---------------------

Check network_gateway on the provisioning network.

If `gateway` in `undercloud.conf` is different from `local_ip`,
verify that the gateway exists and is reachable.


- **hosts**: undercloud
- **groups**: pre-introspection
- **parameters**:
- **roles**: check_network_gateway

Role documentation

.. toctree::

   roles/role-check_network_gateway

.. _pre-introspection_ctlplane-ip-range:

ctlplane-ip-range
-----------------

Check the number of IP addresses available for the overcloud nodes.

Verify that the number of IP addresses defined in `dhcp_start` and
`dhcp_end` fields in `undercloud.conf` is not too low.


- **hosts**: undercloud
- **groups**: pre-introspection
- **parameters**:

  - **ctlplane_iprange_min_size**: 20
- **roles**: ctlplane_ip_range

Role documentation

.. toctree::

   roles/role-ctlplane_ip_range

.. _pre-introspection_dhcp-introspection:

dhcp-introspection
------------------

DHCP on the Introspection Network.

An unexpected DHCP server on the network used for node
introspection can cause some nodes to not be inspected.

This validations checks for the DHCP responses on the
interface specified in ironic-inspector.conf.


- **hosts**: undercloud
- **groups**: pre-introspection
- **parameters**:
- **roles**: dhcp_validations

Role documentation

.. toctree::

   roles/role-dhcp_validations

.. _pre-introspection_undercloud-disk-space:

undercloud-disk-space
---------------------

Verify undercloud fits the disk space requirements.

Make sure that the root partition on the undercloud node has enough
free space.

http://tripleo.org/install/environments/baremetal.html#minimum-system-requirements


- **hosts**: undercloud
- **groups**: prep, pre-introspection
- **parameters**:

  - **volumes**: [{'mount': '/var/lib/docker', 'min_size': 10}, {'mount': '/var/lib/config-data', 'min_size': 3}, {'mount': '/var/log', 'min_size': 3}, {'mount': '/usr', 'min_size': 5}, {'mount': '/var', 'min_size': 20}, {'mount': '/', 'min_size': 25}]
- **roles**: undercloud_disk_space

Role documentation

.. toctree::

   roles/role-undercloud_disk_space

.. _pre-introspection_undercloud-neutron-sanity-check:

undercloud-neutron-sanity-check
-------------------------------

Undercloud Neutron Sanity Check.

Run `neutron-sanity-check` on the undercloud node to find out
potential issues with Neutron's configuration.

The tool expects all the configuration files that are passed
to the Neutron services.


- **hosts**: undercloud
- **groups**: pre-introspection
- **parameters**:

  - **configs**: ['/etc/neutron/neutron.conf', '/usr/share/neutron/neutron-dist.conf', '/etc/neutron/metadata_agent.ini', '/etc/neutron/dhcp_agent.ini', '/etc/neutron/plugins/ml2/openvswitch_agent.ini', '/etc/neutron/l3_agent.ini']
- **roles**: neutron_sanity_check

Role documentation

.. toctree::

   roles/role-neutron_sanity_check