EPP Server Installation

Use Ansible to automatically install EPP server on multiple servers.

Note

Ansible is a tool that enables installation and deletion of multiple servers at a time. In other words, it can install 100 servers at the same time. By default, Ansible runs the same task in 5 hosts in parallel, but the file transfer and command execution speed is slow.

Use Ansible to Automatically Install EPP Server on Multiple Servers

To use Ansible to install EPP server on multiple servers:

Send the installation file (epp_installer.tar) to only one of the machines to install the file.
Use root privileges to decompress the file on the machine that received the file. When the file is decompressed, epp_installer folder will be created.
Check the following file list in the epp_installer folder.

File	Description
ansible	Ansible files
epp-hosts	Installation Host machine informaton file
epp_external_installer-1.0.2.1-67.x86_64.rpm	Contains additional OS package, Docker binary and Open Source package. (* When CentOS Linux Minimal version is installed on the Host machine, minimal OS package must be installed)
epp_installer-1.0.2.1-67.x86_64.rpm	EPP Server Installation file (contains Docker image, container and other scripts)

Modify the Host machine file (epp-hosts) information. Open the epp-hosts file with vim and modify the information.

Change the epp-hosts file's sample host to the server IP address and root password to install.
The password must be enclosed in double quotes ( " " ).

[eppserver]

192.168.100.1 ansible_user=root ansible_ssh_pass="qwe123"

192.168.100.2 ansible_user=root ansible_ssh_pass="qwe123"

192.168.100.3 ansible_user=root ansible_ssh_pass="qwe123"

[all:vars]

ansible_port=22 // Modify if ssh port number is not 22.

epp_space=/opt // Modify when permanent data storage path is different. (* Usually not modified.)

tmp_dir=/opt/tmp // Do not modify.

os_type=centos // Modify if the OS is Ubuntu and not CentOS. (* Usually not modified.)

cli_auto=no // Change to no if cli is not set automatically.

# When installing, enter cli_auto=no, and manually set cli after installation by connecting to all the servers.

Warning

If installation/update/deletion is completed using Ansible, the account information in plaintext in epp-hosts must be deleted.

Execute the installation script (eppinstall.sh). When the installation script (eppinstall.sh) is executed, the following 3 menus will be displayed. If one of the target servers fails to connect to ssh, the installation process will be terminated. Installation is executed in multiple steps, and the installation process will continue to the next step only when a process is completed in all hosts.

Process	Description
INSTALL	Install the EPP server. * The installation will be terminated when already installed on one of the servers. Use the REMOVE menu to remove the EPP server and INSTALL again. (Installation condition: Installation is terminated when EPP rpm version is already installed, or /opt/space path exists.)
UPDATE	Update the EPP server.
REMOVE	Remove the EPP server. (Server to remove: All EPP rpm and EPP docker versions, including EPP 1.0.1.)

Start installing with INSTALL menu. The Ansible package is always automatically installed on the server when you start installation.

Check the current time of each server. The current time of each server is displayed before installation. You can synchronize the time using ntp, but it is recommended that you modify the time if there is a server with a time that is different from the current time before starting installation.

Change the current date date -s 2019-04-08

Change the current time date -s 15:25:46

# After changing the time, you must record it on the system as well. /usr/sbin/hwclock -wu

During the installation, error messages could appear. The installation will be terminated in the following cases:

8-1) The EPP server is already installed, so installation cannot proceed: Remove it and install it again.

When the EPP server is already installed and installation cannot proceed, the following message will appear: Check installer rpm already installed.

When the rpm version is installed and installation cannot proceed, the following message will appear: Check previous rpm already installed.

8-2) ssh key does not exist: There is no ssh key for servers that have not logged in to ssh, so log in to ssh first.

The following error occurs when there is no ssh key file. Log in to ssh in advance.

The following log occurs when there is no ssh key.

Check the installation.

When docker ps -a command is used, there must be the following containers.

When Ansible is completed, it will be terminated with failed=0.

Check mgr watchdog is running properly.
Check epp-mg container's Up status.
Refer to /opt/ahnfs/opt/ahnlab/epp/stat/eppmgr.stat.log.

Check the log path.

Log	Host Machine	Container
install log	/opt/tmp/epp_install	-
update log	/opt/ahnfs/tmp/epp_install	/tmp/epp_install
management log	/opt/ahnfs/opt/ahnlab/epp/log	/opt/ahnlab/epp/log

Manually set the cli. When cli_auto=no is selected from the epp-hosts file, the cli must be manually set. When cli_auto=yes is selected, the cli will be set automatically during installation.

CLI manual settings: EPP Server Settings

The EPP server is installed. When the cli is manually set, the web console URL will appear. Open the web console and specify Web Console Initial Settings.

Reference