How to Replace Your System with OpenEuler and OpenGauss: A Step‑by‑Step Guide

System Localization Replacement: OpenEuler + OpenGauss

Company policy requires replacing all systems with domestically produced alternatives, so this guide explores using the openEuler Linux distribution together with the openGauss database.

Prerequisites

One server or a virtual machine is needed; the author used a VMware VM.

1. Download ISO

Obtain the latest openEuler ISO from the official site (e.g., openEuler 24.03 LTS) and choose the appropriate architecture.

2. Install openEuler

Tip: Run VMware as administrator to avoid installation failures.

Follow the on‑screen prompts to complete the installation, then log in with the root account.

2.1 Configure yum repository

sed -i 's|http://repo.openeuler.org/|https://mirrors.huaweicloud.com/openeuler/|g' /etc/yum.repos.d/openEuler.repo

cat /etc/yum.repos.d/openEuler.repo

Refresh the repository cache and install common tools:

yum clean all
yum makecache
yum -y update

yum -y install gcc gcc-c++ pcre pcre-devel gd-devel openssl openssl-devel zlib zlib-devel

Disable the firewall:

sudo systemctl stop firewalld
sudo systemctl disable firewalld

3. Install openGauss

If openGauss was not selected during the openEuler installation, install it manually: yum -y install opengauss After installation, verify the service is running.

3.1 Configure openGauss

Switch to the openGauss user and check the process:

su - opengauss
ps ux | grep gaussdb

Edit postgresql.conf to set listening address and port (default 7654):

listen_addresses = '*'
port = 7654  # modify as needed

Edit pg_hba.conf to add a line allowing password authentication, then save.

Restart the database:

cd /usr/local/opengauss/bin
gs_ctl restart

Change the default password: ALTER ROLE opengauss PASSWORD 'your_password'; Create a new user and grant privileges:

CREATE USER testuser WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES TO testuser;

4. Verify Connection

Check the server IP and confirm the port (7654). Use a client such as Data Studio to connect to openGauss.

Ensure JDK 1.8+ is installed for the client.

5. Common Issues

5.1 Ping Differences

Adjust network scripts if ping to external sites fails: cd /etc/sysconfig/network-scripts/ Add ONBOOT=yes to the appropriate interface configuration.

5.2 Static IP on Internal Servers

Configure a static IP address in the network‑scripts directory as needed.