Before you run the ansible package, lets quickly run through our checklist and make sure we have everything done.
- Servers have been created with the minimum requirements
- Required base packages have been installed
- Hostnames have been configured, and are a single-word without a domain.
- You have verified connectivity between the servers
- Domains have been identified, and;
- their DNS records have been set
- You’ve generated passwords: backups key, prometheus, and loki
- Domain names have been added
- License Key is added, and active
- Default Admin account is defined
- All servers and their respective public/private IP addresses have been added
- The Floating IP Address has been defined (if applicable)
- You’ve added your ip addresses to the
Now that your
inventory.yml file has been configured, and all servers are prepared, you may now run the ansible bootstrap script.
ansible-playbook -u root -i inventory.yml main.yml --tags "bootstrap"
Depending on how many servers you’re provisioning, this process may take up to an hour.
The very last step of the ansible package is to reboot all the servers. Once they come back online, you can run the following command, which performs a series of sanity checks to make sure everything is running.
ansible-playbook -u root -i inventory.yml main.yml --tags "validate"
Next Step: Finalize Installation
Occasionally a task may fail during the bootstrap process due to various reasons, such as:
- Temporary network or dns issue
- hardware issue with the server
This can cause complications for your bootstrap process, depending on where it failed. Many of our roles have checks in the
roles/<role-name>/tasks/main.yml to see if a process has run already to avoid re-running it. This is done by checking for either configuration files present on the system, or if the service is running. If the process failed after a particular configuration file was created, but before all the steps have been completed, the ansible task may skip over the rest thinking it’s already done.
In order to get around this, you may need to comment out those checks in the
main.yml file for that task, and re-run the bootstrap command. Additionally, you may want to comment out tasks that have already run in the main
main.yml file at the root of the ansible repo to speed up the process.