Manage | Install | Playbooks#

Install EclecticIQ Intelligence Center using these Ansible playbooks to set up an IC distributed installation for up to 11 nodes.

Ansible is an agentless infrastructure configuration tool. Ansible playbooks are run on a control node, which in turn performs playbook tasks on managed nodes.

Supported operating systems#

  • Control node: See control node requirements for Ansible 6.5.

  • Managed node(s):

    EclecticIQ Intelligence Center

    Supported operating systems

    Version 3.x

    • Rocky Linux 8 or 9

    • RHEL 8 or 9

    Version 2.12 - 2.14

    • CentOS 7.9

    • RHEL 7.9

    Upgrade operating system

    When upgrading an EclecticIQ Intelligence Center (EIQ IC) instance on hosts running older operating systems (such as CentOS 7 or RHEL 7), you must upgrade the operating system to Rocky Linux 8 or 9, or RHEL 8 or 9 before attempting to upgrade to EIQ IC 3.0 and newer.

    See:

Deployment architecture guidance#

See Manage | Install | Deployment architecture guidance.

Download playbook packages#

Download the latest EclecticIQ Intelligence Center installation playbooks from https://downloads.eclecticiq.com/platform/ansible/:

Tip

You may need to navigate to https://downloads.eclecticiq.com/ on your browser and log in before attempting to open the URLs below.

Save and version your playbook configuration#

Save and version control your playbook configuration. Playbook configurations document your deployment, and can be used to administer and upgrade your EclecticIQ Intelligence Center instance.

Warning

Do not store credentials in version control.

Use the installation playbooks#

For EclecticIQ Intelligence Center 3.x:

  1. Start here: Prepare nodes. Follow instructions here to prepare your control node and managed nodes to install EclecticIQ Intelligence Center.

  2. Run installation playbooks. New installations. Use the installation playbooks to perform a new install of EclecticIQ Intelligence Center.

  3. Upgrade EclecticIQ Intelligence Center (2.14 to 3.0, 3.x only). Upgrade and existing deployment EclecticIQ Intelligence Center 2.14 to 3.0, or within 3.x.

For EclecticIQ Intelligence Center 2.x:

  1. Start here: Prepare nodes. Follow instructions here to prepare your control node and managed nodes to install EclecticIQ Intelligence Center.

  2. Run installation playbooks. New installations. Use the installation playbooks to perform a new install of EclecticIQ Intelligence Center.

  3. Upgrade EclecticIQ Intelligence Center (2.x only). Upgrade and existing deployment EclecticIQ Intelligence Center 2.12 and 2.13 to 2.14.

How do playbooks work?#

Playbooks are run from a control node, which then executes tasks that configure one or more managed nodes.

Run playbooks on control node to execute tasks on managed nodes.

Run playbooks on control node to execute tasks on managed nodes. #