Getting Started with Personium using Ansible
Overview
The purpose of this document is to explain high level specification for constructing Personium unit using ansible. If you're curious about ansible, please also read the HOW ANSIBLE WORKS page.
Personium unit structure
Personium unit is configurable based on different purpose of usages like evaluation, development, verification, production etc.. Personium is provisioning the unit setup tool, for the easiness of the developer to construct Personium unit automatically based on their needs.
Although you may construct the Personium unit without using the setup tool, but it is recommended to use the setup tool for constructing the Personium unit easily.
Server architecture for Personium unit
Personium unit construction requires to assign the combination of following 7 roles on a single or multiple interconnected servers properly.
| Role | Usage | definition |
|---|---|---|
| Web | Required | Reverse proxy server, contains Global IP and also should be accessible to the internet. |
| AP | Required | Application server, where Personium will be executed. |
| ES | Required | server to operate ElasticSearch. |
| MQ | Required | server to operate ActiveMQ. |
| NFS | Required | server to operate Network File System (NFS). |
| Bastion | Optional | Bastion server. Used to execute ansible and to connect other servers by ssh. |
Personium setup tool
This setup tool will install middleware and configure the OS and its network on your machine (linux server or virtual machine on windows/mac) before installing Personium module.
There are different patterns of setup tools to construct the Personium unit. Please select the setup tool based on you purpose.
Pattern-1 : 1 Server
- Machine environment : Linux
- The number of Personium unit servers : 1 Server
- Server-1 elements : Bastion, Web, AP, ES, MQ
- Setup time : 1 hour
- Setup tool: ansible/1-server_unit
- Note
If you are more curious about Personium and want to develop some simple applications or to test this system, you can select this pattern. You will get Personium unit on a single server.
* By using Vagrant it is possible to easily build a virtual machine in the local machine environment and check the operation of Personium.
For the setting procedure, please refer to setup-vagrant.
Pattern-2 : 3 Servers
- Machine environment : Linux
- The number of Personium unit servers : 3 Servers
- Server-1 elements : Bastion,Web
- Server-2 elements : AP, MQ, NFS
- Server-3 elements : ES
- Setup time : 2 hours
- Setup tool: ansible/3-server_unit
- Note
If you are devoted to Personium and want to release some marvelous applications with it, you should try this pattern! You will get Personium unit with 3 servers, which will meet practical performance.
This document introduced pattern based initial requirements to construct the Personium unit. Please choose the right pattern that suits your purpose.
Please go thru with other documents to learn about the process to construct the Personium unit.