Server Software Operator's Guide

It is a document for people who use Personium's server software to build Personium units, who build/deploy/configure Personium server programs, and who wish to provide / operate a PDS service environment using Personium.

Those who access the constructed/configured Personium unit using the unit user token and perform the main task of the unit administrator, that is, the creation/payout of the Cell, management of the dispensed Cell, etc., Please see Guide for unit administrator.

Unit configuration design

Personium has a scalable architecture. For evaluation and personal use, it is also possible to build a Personium unit packed all in one machine. Meanwhile, it is recommended to adopt the layer structure such as Web layer - AP layer - DB layer because non-function such as security and performance is required to construct units used by hundreds or thousands of people, You should take a minimum of 2-3 configurations. Furthermore, in order to construct a large-scale unit that tens of thousands to hundreds of thousands of people use every day, each layer is scaled out and it takes 10 to 20 units.

First of all, let's decide what kind of unit to make and design the necessary infrastructure.

Construction of unit

It is convenient to use Ansible to build units. If you are building in an Open Stack-based cloud environment, you can almost unit-build by using Heat Template. Of course, you can also build units using any cloud or physical/virtual machine without using these automatic construction tools. However, since we do not have the physical strength to prepare and maintain the document etc. for that, please build it with reference to the server infrastructure building procedure using Heat of Open Stack and the automatic unit building procedure using Ansible.

We are pleased to hear the story that the unit was built in various environments on the #infra channel of the community.

Automatic construction of server infrastructure

Automatic building of unit

Using Ansible, we are publishing guides for building a single unit for evaluation and a unit with three units for small-scale production use.

If you customize Ansible's Playbook introduced above, you can build units of various configurations.

Apply plugin

Unit settings

Once you have configured the unit, you need to set the unit properly. In Ansible, the basic configuration is set for automatic construction unit, but it is not complete. Please refer to the following and make appropriate settings.

Start/Stop unit

When setting is completed, the unit is activated. Please start each server in the following order.

Boot order Activation method
1 Memcached, ElasticSearch, ActiveMQ
2 Tomcat
3 Nginx

Please stop in the reverse order as above.

Operation of unit

In many cases Personium's unit will contain information on personal privacy and security measures are essential to establish a server on the Internet. Please do not leave the unit as it was initially constructed and apply security patches appropriately.

Related repositories