Installation playbooks 3.x#

Install EclecticIQ Intelligence Center 3.x.

Tip

EclecticIQ Intelligence Center 2.x uses a different playbook configuration. See Installation playbooks 2.x.

Upgrading from CentOS 7/RHEL 7

If you are upgarding an EcelcticIQ Intelligence Center instance on managed nodes that are running on CentOS 7 or RHEL 7, you must upgrade the operating system to Rocky Linux 8 or RHEL 8 before following the instructions here.

See:

In this section:

Start here: Prepare nodes. Follow instructions here to prepare your control node and managed nodes to install EclecticIQ Intelligence Center.
Run installation playbooks. New installations. Use the installation playbooks to perform a new install of EclecticIQ Intelligence Center.
Upgrade EclecticIQ Intelligence Center (2.14 to 3.0, 3.x only). Upgrade EclecticIQ Intelligence Center 2.14 to 3.0, or within 3.x.

Deployment architecture guidance#

See Deployment architecture guidance.

List of playbook files#

Playbook	Description
`pb-backup_config.yml`	Back up configuration files across all nodes in the specified inventory file. Change where configuration file backups are written to by editing the `config_backup_dest_folder` parameter in `group_vars/backup.yml`.
`pb-pre_requisites.yml`	Prepares managed nodes.
`pb-install_intelligence_center.yml`	Installs EclecticIQ Intelligence Center.
`pb-start_services.yml`	Starts all IC services.
`pb-stop_services.yml`	Stops all IC services.
`pb-post.yml`	Upgrades OS packages as post-installation step. You must reboot managed nodes after running this playbook.
`pb-elasticsearch_fix_ic_config_multinode.yml`	Configures EclecticIQ Intelligence Center and Elasticsearch to allow Elasticsearch nodes to correctly operate as data nodes on the cluster.
`pb-elasticsearch_destroy_cluster.yml`	Remove all data files from Elasticsearch nodes and restart the cluster. Required for configuration set by `pb-elasticsearch_fix_ic_config_multinode.yml` to take effect. Warning Only run this the first time you install EclecticIQ Intelligence Center, or when intentionally rebuilding your Elasticsearch cluster. This completely removes all data and configuration from existing Elasticsearch clusters.
`pb-pg_start_replication.yml`	Initialize PostgreSQL replication for deployments with more than one PostgreSQL node. Danger This purges data from all PostgreSQL nodes set in your inventory file with the property: `eiq_ic_pg_replication__node_role: replica`
`pb-migrate_databases.yml`	Runs IC post-install database migration tasks.