Preparing for Installation

This section describes how to prepare and configure an environment for simplified MogDB installation. The simplified installation can be performed on a single node or on primary/standby nodes. Read this section carefully before installation. If the configuration in this section has been completed, skip this section.

Obtaining the Installation Package

You can obtain the installation package from the MogDB website.

MogDB website: https://www.mogdb.io/en/downloads/mogdb/

Procedure

This section takes the openEuler OS as an example to describe how to obtain the target installation package.

1. Upload the downloaded standard installation package and decompress it to obtain the single-node installation package.

   tar -xvf MogDB-x.x.x-openEuler-arm_64.tar

   Note:

   • The MogDB website provides the standard installation package MogDB-x.x.x-openEuler-arm_64.tar. You need to decompress it to obtain the single-node installation package MogDB-x.x.x-openEuler-64bit.tar.bz2.

   • In environments that allow access to external networks, the standard installation package can be downloaded directly via the wget command.

     wget -c https://cdn-mogdb.enmotech.com/mogdb-media/2.1.1/MogDB-2.1.1-openEuler-arm_64.tar

     Then you can run the tar command to decompress it.

2. Check the installation package.

   Decompress the installation package and check whether the installation directory and files are complete. Run the following commands in the directory where the installation package is stored:

   tar -jxf MogDB-x.x.x-openEuler-64bit.tar.bz2
   ls -1b

   Run the ls command to display information similar to the following:

   total 90296
   drwx------ 3 root root     4096 Mar 31 21:18 bin
   drwx------ 3 root root     4096 Mar 31 21:18 etc
   drwx------ 3 root root     4096 Mar 31 21:18 include
   drwx------ 4 root root     4096 Mar 31 21:18 jre
   drwx------ 5 root root     4096 Mar 31 21:18 lib
   -rw------- 1 root root 92427499 Apr  1 09:43 MogDB-x.x.x-openEuler-64bit.tar.bz2
   drwx------ 5 root root     4096 Mar 31 21:18 share
   drwx------ 2 root root     4096 Mar 31 21:18 simpleInstall
   -rw------- 1 root root       32 Mar 31 21:18 version.cfg

Preparing the Software and Hardware Installation Environment

This section describes the preparations for installation. It is recommended that servers to be deployed on MogDB have the same software and hardware configurations.

Hardware Requirements

Table 1 lists the minimum hardware requirements of the MogDB server. When planning the hardware configuration of a product, consider the data scale and expected database response speed. Plan hardware as required.

Table 1 Hardware requirements

Software Requirements

Table 2 Software requirements

Operating System Requirements

This release supports the following OS and CPU architecture combinations:

Table 3 Operating System Requirements

Software Dependency Requirements

Table 4 describes the MogDB software dependency requirements.

You are advised to use the default installation packages of the following dependent software in the listed OS installation CD-ROMs or sources. If the following software does not exist, refer to the recommended versions of the software.

Table 4 Software dependency requirements

Modifying OS Configuration

Disabling the OS Firewall

To ensure that MogDB can work properly when the firewall is enabled, MogDB-related services, protocols, IP addresses, and ports need to be added to the firewall whitelist of the MogDB host.

Take openEuler OS as an example. Assume that the MogDB information is listed in Table 5.

Table 5 MogDB information

Currently, the installation can be performed only when the firewall is disabled.

1. Modify the SELinux operating mode to temporarily disable the firewall.

   setenforce 0

2. Set the value of SELINUX in the /etc/selinux/config file to disabled.

   a. Run the vim command to open the config file.

   vim /etc/selinux/config

   b. Change the value of SELINUX to disabled and run the :wq command to save the change and exit.

   SELINUX=disabled

3. (Optional)Restart the OS.

   reboot

   Perform the following operations to permanently disable the firewall.

4. Check whether the firewall is disabled.

   systemctl status firewalld

   If the firewall status is active (running), the firewall is not disabled. Go to step 5.

   If the firewall status is inactive (dead), you do not need to disable the firewall.

5. Disable the firewall service.

   systemctl disable firewalld.service
   systemctl stop firewalld.service

6. Repeat steps [1](#config file) to 5 on other hosts.

Setting Character Set Parameters

Set the same character set for all database nodes. You can add export LANG=Unicode to the /etc/profile file.

vim /etc/profile

Setting the Time Zone and Time

Ensure that the time zone and time on each database node are consistent.

1. Run the following command to check whether the time and time zone of each database node are consistent: If the time and time zone of each database node are inconsistent, perform steps 2 to 3.

   date

2. Run the following command to copy the /etc/localtime file to the /usr/share/zoneinfo/ directory of each database node:

   cp /usr/share/zoneinfo/$Locale/$Time zone /etc/localtime

   NOTE: $Locale/$Time zone indicates the locale and time zone to be set, for example, Asia/Shanghai.

3. Run the date -s command to set the time of each database node to the same time. For example:

   date -s "Sat Sep 27 16:00:07 CST 2020"

(Optional) Disabling the Swap Memory

NOTE: Disabling the swap memory ensures the access performance of the database and prevents the buffer memory of the database from being evicted to the disk. If the server memory is small and the memory is overloaded, you can enable the swap memory to ensure normal running.

Run the swapoff -a command on each database node to disable the swap memory.

swapoff -a

Disabling RemoveIPC

On each database node, disable RemoveIPC. For CentOS, skip this step.

1. Change the value of RemoveIPC in the /etc/systemd/logind.conf file to no. .

   a. Run the vim command to open the logind.conf file.

   vim  /etc/systemd/logind.conf

   b. Change the value of RemoveIPC to no.

   RemoveIPC=no

2. Change the value of RemoveIPC in the /usr/lib/systemd/system/systemd-logind.service file to no.

   a. Run the vim command to open the systemd-logind.service file.

   vim /usr/lib/systemd/system/systemd-logind.service

   b. Change the value of RemoveIPC to no.

   RemoveIPC=no

3. Reload configuration parameters.

   systemctl daemon-reload
   systemctl restart systemd-logind

4. Check whether the modification takes effect.

   loginctl show-session | grep RemoveIPC
   systemctl show systemd-logind | grep RemoveIPC

5. Open the limits.conf and sysctl.conf configuration files and add the following content to the corresponding files, respectively.

   vim /etc/security/limits.conf
   #Add the following content to the limits.conf configuration file：
   omm            soft    nofile          1000000
   omm            hard    nofile          1000000
   vim /etc/sysctl.conf
   #Add the following content to the sysctl.conf configuration file：
   kernel.sem = 250 32000 100 999

6. Repeat steps 1 to 5 on other hosts.