Running the Installer

    1. Ensure that is set to true in your inventory file under the [OSEv3:vars] section:

    2. Choose which playbook to run depending on whether OKD is already provisioned:

      1. If you want to install ManageIQ at the same time you install your OKD cluster, call the standard config.yml playbook as described in Running the Installation Playbooks to begin the OKD cluster and ManageIQ installation.

      2. If you want to install ManageIQ on an already provisioned OKD cluster, change to the playbook directory and call the ManageIQ playbook directly to begin the installation:

        1. $ cd /usr/share/ansible/openshift-ansible
        2. $ ansible-playbook -v [-i /path/to/inventory] \
        3.     playbooks/openshift-management/config.yml

    The following sections show example snippets of inventory files showing various configurations of ManageIQ on OKD that can help you get started.

    This is as the previous example, except that instead of using local NFS services in the cluster, it uses an existing, external NFS server (such as a storage appliance). Note the two new parameters:

    1. [OSEv3:vars]
    2. openshift_management_app_template=miq-template
    3. openshift_management_storage_class=nfs_external (1)

    If the external NFS host exports directories under a different parent directory, such as /exports/hosted/prod, add the following additional variable:

    This example overrides the persistent volume (PV) sizes. PV sizes must be set via openshift_management_template_parameters, which ensures that the application and database are able to make claims on created PVs without interfering with each other:

    1. [OSEv3:vars]
    2. openshift_management_app_template=miq-template
    3. openshift_management_template_parameters={'APPLICATION_VOLUME_CAPACITY': '10Gi', 'DATABASE_VOLUME_CAPACITY': '25Gi'}

    In a test or proof-of-concept installation, you may need to reduce the application and database memory requirements to fit within your capacity. Note that reducing memory limits can result in reduced performance or a complete failure to initialize the application:

    This example instructs the installer to process the application template with the parameter APPLICATION_MEM_REQ set to 3000Mi, POSTGRESQL_MEM_REQ set to , and ANSIBLE_MEM_REQ set to 512Mi.

    These parameters can be combined with the parameters displayed in the previous example .

    To use an external database, you must change the openshift_management_app_template parameter value to miq-template-ext-db.

    1. [OSEv3:vars]
    2. openshift_management_app_template=miq-template-ext-db
    3. openshift_management_template_parameters={'DATABASE_USER': 'root', 'DATABASE_PASSWORD': 'mypassword', 'DATABASE_IP': '10.10.10.10', 'DATABASE_PORT': '5432', 'DATABASE_NAME': 'cfme'}

    In addition to the procedures in this guide, the upstream project manageiq/manageiq-pods contains additional resources useful for managing and operating your ManageIQ} installation, including: