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

.. _pre-introspection_undercloud-tokenflush:

undercloud-tokenflush
---------------------

Verify token_flush is enabled in keystone users crontab.

Without a token_flush crontab enabled for the keystone user, the keystone database can grow very large.  This validation checks that the keystone token_flush crontab has been set up.


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

  - **cron_check**: keystone-manage token_flush
- **roles**: undercloud_tokenflush

Role documentation

.. toctree::

   roles/role-undercloud_tokenflush
