How to get started with the complete installation of the Atomia Platform.
The installation is done by following a predefined number of steps in the Atomia installation GUI. Each step will deploy a server or prompt you for setting configuration variables.
The first step on the top left of the application describes the requirements to be able to install the Atomia Platform. The next step in the installation process is displayed in the top left of the application. You can get a complete list of tasks by clicking List all tasks.
Before you begin
Atomia requires a working OpenStack setup with the following components:
- OpenStack Compute (Nova)
- OpenStack Block Storage (Cinder)
- OpenStack Networking (Neutron)
- OpenStack Image Service (Glance)
- OpenStack Identity (Keystone)
- OpenStack Telemetry (Ceilometer)
- KVM as hypervisor (we are currently only actively testing with KVM)
- Neutron should be configured with an external network as described here.
The deployment of the installation GUI should be done on a server running Ubuntu 14.04.
Recommended server specification:
- 2+ vcpus
- 1024 MB RAM
- 50 GB disk space
The deployment is currently done by executing a script provided with the following repository:
wget https://raw.githubusercontent.com/atomia/puppetmaster-gui/master/install.sh && chmod +x install.sh ./install.sh
Now you can access the GUI at the servers ip address on port 3000.
The prerequisites are listed in the pre requirement page of the GUI application that you just installed. You need to do the following:
- Create the required servers. You can do this at the start or as you go.
- Decide what domain name you want for your Atomia applications and order a wildcard SSL certificate, if you do not already have one.
Follow the steps described in this section to install each server.
Each server is assigned a separate role. This is configured by clicking on the current task in the Installation tasks box, or by choosing the role in the List all tasks menu item.
- Current task shows the current task to perform. The installation should be performed in a linear fashion.
- Firewall table (incoming traffic) shows the recommended firewall configuration that should be carried out prior to installation.
- In Server information you enter all the server information. You may choose to use a password or an SSH key, which is added in a previous step.
- When all fields are filled in correctly, press the Validate server button. The system then performs some basic checks to make sure your server is reachable from the Puppet master.
When the server has passed validation, you are able to add and modify configuration variables needed for the software to be installed correctly.
- The Basic configuration field is always required to be filled in.
- Clicking Hide advanced configuration options will reveal Advanced configuration, which contains additional (non required) variables that can be modified. It is recommended to always check the advanced configuration options.
- When everything is filled in, click the Bootstrap server button to install and configure puppet agent and give the server the configured role.
When the bootstrapping action has finished, you are presented with a Provisioning finished successfully! message as above. If not, check for error messages and retry.
When bootstrapping has finished successfully, a first puppet run is done. Please note that on some roles this might take a few minutes. You can reload the page until the result of the provisioning is shown.
- The Provision now button will immediately start a new provisioning run and show the result. This is useful in order to retry a failed provisioning run, or to execute an updated configuration if you changed any configuration variables.
- A list of all the provisioning steps done in the most recent run. Any errors will be marked in red. If you want the raw output from the server logs, press the Show raw output link.
- When all provisioning has finished successfully (no errors are shown), you can proceed by clicking Next step.