Server Installation

Once CentOS 7 is installed, you can use the Docker image to install the CPP server.

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.

Using Ansible to Install CPP Server

To use Ansible to install CPP server on multiple servers, complete the following steps.

Send the installation file (cpp_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, cpp_installer folder will be created.
Check the following file list in the cpp_installer folder.

File	Description
ansible	File related to Ansible
cpp-hosts	File containing host machine information
cpp_external_installer-1.0.2.1-67.x86_64.rpm	File containing additional OS package, Docker binary and open source package (* The install example assumes that CentOS Linux Minimal version is installed.)
cpp_installer-1.0.2.1-67.x86_64.rpm	File for CPP server installation containing docker image, container and other scripts

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

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

[cppserver]

172.21.30.178 ansible_user=root ansible_ssh_pass="qwe123"

172.21.30.179 ansible_user=root ansible_ssh_pass="qwe123"

172.21.30.180 ansible_user=root ansible_ssh_pass="qwe123"

[all:vars]

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

cpp_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 cpp-hosts must be deleted.

Execute the installation script (cppinstall.sh). When the installation script (cppinstall.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 CPP server. * The installation will be canceled if it is already installed on any one of the servers. Use the REMOVE menu to remove the CPP server and INSTALL again. (Installation is canceled when CPP rpm version is already installed, or /opt/space path exists.)
UPDATE	Update the CPP server.
UPDATE_HOST	Update the package version and kernel settings of the host OS only. (Note that UPDATE_HOST does not work for updates via file uploads.)
REMOVE	Remove the CPP server. (All CPP rpm and CPP docker versions, including CPP 1.0.1 will be removed)

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:

When the CPP server is already installed and installation cannot proceed, you must REMOVE and INSTALL again./
When the ssh key value dos not exist you must log in to ssh first

1) The following error is shown when the ssh key value does not exist

2) The following log message is generated when the ssh key value does not exist.

Check the installation.

1) Log in to the server and check the installation with docker images command. The cpp-platform image must be loaded.

2) Check that the following containers exists using the docker ps -a command.

3) When Ansible is completed, check that it is terminated with failed=0.

4) Check that mgr wats

Check the Up status of epp-mg container.
Check /opt/ahnfs/opt/ahnlab/epp/stat/eppmgr.stat.log logs.

Check the installation.

Log	Host Device	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 cli. When cli_auto=no is selected from the cpp-hosts file, the cli must be manually set. When cli_auto=yes is selected, the cli will be set automatically during installation. For more information, please refer to CPP Server Settings.
CPP server installation is complete. Follow the link guided on the screen to set up the admin console. For more information about initial setup, please refer to Initial Setup.