install_and_configure_without_ha.md

Install and configure Extra Large without HA

• TODO: add this doc as a section to basic_usage.md instead?

Please see the basic_usage.md document for reference; this document will avoid repeating the information covered there. The install, configure, and upgrade plans covered in the basic_usage.md document can also set up the Extra Large environment without HA by omitting the optional settings master_replica_host and puppetdb_database_replica_host in the params.json file (see the example below).

Basic usage instructions

1. Ensure the hostname of each system is set correctly, to the same value that will be used to connect to the system, and refer to the system as. If the hostname is not set as expected the installation plan will refuse to continue.
2. Install Bolt on a jumphost. This can be the master, or any other system.
3. Download or git clone the peadm module and put it somewhere on the jumphost, e.g. ~/modules/peadm.
4. Create an inventory file with connection information. An example is included below.
5. Create a parameters file. An example is included below. Note the omission of the master_replica_host and puppetdb_database_replica_host parameters.
6. Run the peadm plan with the inputs created. Example:

        bolt plan run peadm::provision \
          --inventory nodes.yaml \
          --modulepath ~/modules \
          --params @params.json 

Example nodes.yaml Bolt inventory file

---
groups:
  - name: peadm_nodes
    config:
      transport: ssh
      ssh:
        host-key-check: false
        user: centos
        run-as: root
        tty: true
    nodes:
      - pe-xl-core-0.lab1.puppet.vm
      - pe-xl-core-1.lab1.puppet.vm
      - pe-xl-compiler-0.lab1.puppet.vm
      - pe-xl-compiler-1.lab1.puppet.vm

Example params.json Bolt parameters file

{
  "master_host": "pe-xl-core-0.lab1.puppet.vm",
  "puppetdb_database_host": "pe-xl-core-1.lab1.puppet.vm",
  "compiler_hosts": [
    "pe-xl-compiler-0.lab1.puppet.vm",
    "pe-xl-compiler-1.lab1.puppet.vm"
  ],

  "console_password": "puppetlabs",
  "dns_alt_names": [ "puppet", "puppet.lab1.puppet.vm" ],
  "compiler_pool_address": "puppet.lab1.puppet.vm",
  "version": "2019.1.1"
}