In March 2022, both the openEuler 22.03 LTS version ISO installation package repository and the LTS official software repository will launch the openGauss 2.1.0 version installation package, providing the ability to install openGauss with one-click RPM, improving user ease of use.
The openGauss software package is used to provide user ease of use
The openGauss installation package and its dependent repositories involved in the openEuler 22.03 LTS version are as follows:
https://gitee.com/src-openeuler/opengauss-server
https://gitee.com/src-openeuler/opengauss-dcf
Overview of using the openGauss ISO package
Method 1: Check the database when installing the operating system
When using the openEuler 22.03 LTS ISO image to install the operating system, select openGauss Server in the package selection on the installation guide interface. After the operating system is installed, the openGauss database will be installed by default and the stand-alone database process will be started.
Method 2: After installing the operating system, use yum to install with one click
If you did not select the openGauss package when installing the operating system, you can also install the single-machine database instance of openGauss with one click after installing the system:
yum install opengauss -yInstructions for use:
The management user of the openGauss database process is opengauss, and common operations of the database can be performed by switching to this user.
su - opengaussLog in to the database and execute the sql statement:
gsql -d postgres -rQuery database instance status:
gs_ctl queryStop the database instance process:
gs_ctl stopStart the database instance process:
gs_ctl startOverview of using the openGauss RPM package
Overview For users of non-openEuler 22.03 LTS ISO packages, the official openEuler 22.03 LTS source needs to be configured.
Step.1
Add the openEuler 22.03 LTS everything software repository locally for different hardware platforms (aarch64/x86_64). The location of the openGauss package is:
https://repo.openeuler.org/openEuler-22.03-LTS/everything/
After the configuration is complete, execute
dnf updateUpdate the remote repository locally.
Step.2
Install the openGauss package and its corresponding dependencies.
dnf install opengauss -yAfter installation is complete:
The installation path of openGauss is /usr/local/opengauss
First look at the openGauss environment variables. The environment variables required to start openGauss and connect to the service are placed in /var/lib/opengauss/.bash_profile
export GAUSSHOME=/usr/local/opengauss/
export LD_LIBRARY_PATH=/usr/local/opengauss/lib:$LD_LIBRARY_PATH
export PATH=/usr/local/opengauss/bin:$PATH
export PGDATA=/var/lib/opengauss/data
export PORT=7654From these environment variables, you can visually see the openGauss installation path, DATA PATH, dependent library path, and so on.
In addition, the openGauss lightweight build option opengauss_config_file_mini is placed in /usr/local/opengauss/share/postgresql/
The default startup configuration file is /usr/local/opengauss/share/postgresql/postgresql.conf.sample, which can be modified or re-specified as needed.
Systemd related files are stored in /usr/local/opengauss/script/
Step.3
After the openGauss package is successfully installed, an opengauss user will be created for it to run the openGauss service. Then you can use:
systemctl start opengaussStart the openGauss single-node environment.
Notes:
1. Before installation, make sure that there is no opengauss user with the same name in the system to avoid installation conflicts;
2. Currently, only openGauss single-node environment installation is supported. For more configuration, please refer to the official documentation of the openGauss community;
3. To modify the openGauss configuration file or systemd startup script, refer to
/usr/local/opengauss/script/opengauss.service
/usr/local/opengauss/script/autostart.shadd adaptation;
4. To add a new configuration or directory, you need to give the opengauss user corresponding permissions.
Community members of both parties work together to provide an example for inter-community cooperation
This time, the two communities were able to achieve their goals smoothly, thanks to the concerted efforts of the members of the two communities. Committer- Zhang Xubo (https://gitee.com/zhang_xubo) from the openGauss community and openEuler DB SIG maintainer- Zhao Bo (https://gitee.com/bzhaoop) implemented this cooperation in the open source community in an open and transparent manner , the completed tasks and discussions are in line with the open source community contribution process, including TC regular meeting discussions, Issue and PR submissions, etc. The following is a brief introduction to the content of this work, hoping to provide a reference for future cooperation between relevant communities.
1. The openGauss community 2.1.0 release package introduces openEuler 22.03 LTS
The software packages built and released by openEuler this time are all from the openGauss community and the upstream community of the corresponding dependent software packages, involving the openGauss 2.1.0 version. The links are as follows:
https://gitee.com/opengauss/openGauss-server
https://gitee.com/opengauss/DCF
The package involved in the construction and release of openEuler this time comes from the openGauss community release package (openGauss-server-2.1.0.tar.gz), the link is as follows:
https://gitee.com/opengauss/openGauss-server/tree/2.1.0/
https://gitee.com/opengauss/openGauss-server/releases/v2.1.0
The introduction of software packages and the PRs submitted to the openEuler community are done in collaboration with the openGauss community and the openEuler DB SIG. The quality and maintenance of the relevant software packages are jointly guaranteed by the openGauss community and the openEuler DB SIG.
2. Work focus
The focus of this work is mainly on the following aspects:
1) openGauss dependency analysis and sorting
Since the openGauss community itself has a relatively large system, for general-purpose databases, other software that is relied upon when publishing its own software comes from the upstream community, and some functions are functionally enhanced to a certain extent, so some dependent libraries and openEuler software warehouse have been Some upstream communities release conflicting versions, and this part has been independently maintained by the openGauss community within its community and in the openEuler software repository. In this cooperation, all dependent libraries have been introduced into the openEuler software repository, fully integrated into the openEuler software ecosystem.
2) OpenGauss ease of use script introduced
The introduction of the openGauss RPM package this time, in order to retain the user habits, the systemd service is extended, and the openGauss service is fully adapted, including the service startup control script. In addition, the openGauss cold upgrade script is also provided, and is in the openGauss RPM software. During the package installation, the same configuration as described in the openGauss community documentation, such as the running user and the corresponding configuration, is carried out, which greatly facilitates the installation cost of openGauss for users to use openGauss on openEuler, and achieves the one-click installation function.
3. Follow-up work
1) In order to deepen the cooperation between the two communities, and from the perspective of improving the ease of use for users, it is planned to add documents for installing openGauss software in RPM mode in the two communities of openEuler and openGauss, so as to provide users with a variety of installation methods;
2) With the continuous iteration of upstream openGauss community releases, it is necessary to continuously replace the latest openGauss software in the openEuler software repository, and plan to release it in the latest openEuler release. It will be released in the openEuler release version for users to experience in advance. For example, openGauss 3.0.0 (released in April this year) is planned to be released in the openEuler 22.09 innovative version this year, while retaining the openGauss (22.03 LTS) version of openEuler LTS ( 2.1.0) version;
3) If you are interested in the follow-up plan, you are welcome to sign the CLA on the official community website and participate in the contribution.
The two communities empower each other and jointly create a rich and diverse software ecosystem
The openGauss community and the openEuler community are two open source and open communities. Through mutual cooperation and integration, openGauss has entered the openEuler 22.03 LTS ISO image, and at the same time, the openEuler 22.03 LTS official repository has provided the openGauss software package, which has greatly improved the usability of openGauss users; At the same time, it also brings convenience to users who use openEuler 22.03 LTS ISO and other mirror sources.
In the future, openGauss and the openEuler community will continue to deepen cooperation and maintain the iterative version of openGauss in the openEuler software repository to ensure the quality of openGauss software. With the continuous iteration of openGauss functions and performance, openGauss is becoming more and more mature, adhering to the concept of co-construction, sharing and co-governance, and is recognized by more and more users. This time, through the mutual cooperation with the openEuler open source community, the ease of use of openGauss will be improved. It is believed that openGauss will become the choice of more users, and more people are welcome to join the openGauss and openEuler communities to jointly create a rich and diverse basic software ecosystem.
openGauss: openGauss is an open source relational database management system released under the Mulan Permissive License v2. The openGauss kernel is deeply integrated with Huawei's years of experience in the database field, combined with the needs of enterprise-level scenarios, and continues to build competitive features. At the same time, openGauss is also an open source database platform that encourages community contribution and cooperation.
openEuler: openEuler is an open source operating system. The current openEuler kernel is derived from Linux, supports Kunpeng and other processors, and can fully release the potential of computing chips. It is an efficient, stable and secure open source operating system built by global open source contributors, suitable for databases, big data, cloud Computing, artificial intelligence and other application scenarios. At the same time, openEuler is a global operating system open source community. Through community cooperation, it creates an innovative platform, builds a unified and open operating system that supports multi-processor architecture, and promotes the prosperity and development of software and hardware application ecology.