For the complete DHIS2 documentation index, see llms.txt.

多丽丝设置指南{ #doris-setup-guide }¶

注意： 自 doris Ansible 角色起，本手动操作指南已不再是主要实现路径——当您配置 [apache_doris] 主机时，deploy/dhis2.yml 会自动部署 Doris （参见 docs/apache-doris-playbook.md）。本文档保留作为参考，以便理解或手动重现这些步骤。

先决条件{ #prerequisites }¶

Ubuntu 24.04 服务器版
使用具有 sudo 权限的非 root 用户进行 SSH 访问

步骤 1：准备环境{ #step-1-prepare-the-environment }¶

注意：
如果 Doris 在 LXD 容器中运行，请在 LXD 主机 上应用以下配置。

增加打开文件描述符的数量{ #increase-the-number-of-open-file-descriptors }¶

编辑 /etc/security/limits.conf：

vim /etc/security/limits.conf

添加以下几行：

* 软限制 nofile 1000000
* 硬限制 nofile 1000000

增加虚拟内存区域限制{ #increase-the-virtual-memory-area-limit }¶

sysctl -w vm.max_map_count=2000000

步骤 2：在主机上禁用交换空间{ #step-2-disable-swap-on-the-host }¶

要临时禁用交换分区（重启后恢复）：

sudo swapoff -a

要永久禁用交换分区，请编辑 /etc/fstab 并注释掉交换分区的条目：

sudo vim /etc/fstab

<attribute id>

#<file system>      <dir>        <type>   <options>            <dump> <pass> 
tmpfs                  /tmp          tmpfs     nodev,nosuid          0      0
/dev/sda1              /             ext4      defaults,noatime      0      1
# /dev/sda2            none          swap      defaults              0      0
/dev/sda3              /home         ext4      defaults,noatime      0      2

然后重新启动计算机。

步骤 3：安装 Java 17（Doris 3.0.x 所需）{ #step-3-install-java-17-required-for-doris-30x }¶

ssh<server_ip> -p<ssh_port>
sudo apt update && sudo apt upgrade -y
sudo apt install openjdk-17-jre-headless -y

第 4 步：创建一个专用的 Doris 用户{ #step-4-create-a-dedicated-doris-user }¶

sudo adduser --comment "Doris 应用程序用户" --home /usr/local/doris --disabled-login --system doris

第 5 步：切换到 Doris 用户{ #step-5-switch-to-the-doris-user }¶

sudo su -l doris -s /bin/bash

第 6 步：下载 Doris 二进制文件{ #step-6-download-doris-binaries }¶

# 示例：版本 3.0.5
wget https://apache-doris-releases.oss-accelerate.aliyuncs.com/apache-doris-3.0.5-bin-x64.tar.gz

第 7 步：解压存档{ #step-7-extract-the-archive }¶

tar -xvzf apache-doris-3.0.5-bin-x64.tar.gz

第 8 步：配置 `fe.conf` 和 `be.conf`¶

在两个配置文件中都设置 JAVA_HOME 环境变量：

# 前端配置
vim fe/conf/fe.conf

添加或更新：

JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"

对 be/conf/be.conf 也按同样的方式操作。

第 9 步：启动前端{ #step-9-start-the-frontend }¶

./fe/bin/start_fe.sh --daemon

步骤 10：为 Doris 创建 systemd 服务{ #step-10-create-systemd-services-for-doris }¶

Doris 前端（`/etc/systemd/system/doris-fe.service`）{ #doris-frontend-etcsystemdsystemdoris-feservice }¶

[Unit]
Description=Apache Doris 前端 (FE)
After=network.target

[Service]
Type=forking
User=doris
WorkingDirectory=/usr/local/doris/fe
ExecStart=/usr/local/doris/fe/bin/start_fe.sh --daemon
ExecStop=/usr/local/doris/fe/bin/stop_fe.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

Doris 后端 (`/etc/systemd/system/doris-be.service`){ #doris-backend-etcsystemdsystemdoris-beservice }¶

[Unit]
Description=Apache Doris 后端 (BE)
After=network-online.target

[Service]
Type=forking
User=doris
LimitCORE=infinity
LimitNOFILE=200000
WorkingDirectory=/usr/local/doris/be
ExecStart=/usr/local/doris/be/bin/start_be.sh --daemon
ExecStop=/usr/local/doris/be/bin/stop_be.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用并启动这两个服务：

sudo systemctl enable doris-fe
sudo systemctl enable doris-be
sudo systemctl start doris-fe
sudo systemctl start doris-be

步骤 11：通过 MySQL 客户端连接到 Doris （可选）¶

您需要使用 MySQL 客户端来注册一个后端（BE）节点：

sudo apt install mysql-client-core-8.0

然后连接：

mysql -uroot -P9030 -h127.0.0.1

MySQL 命令行界面：

ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";

第 12 步：配置 DHIS2 以使用 Doris 进行分析{ #step-12-configure-dhis2-to-use-doris-for-analytics }¶

# 分析数据库管理系统
analytics.database = doris

# JDBC 驱动程序
analytics.connection.driver_class = com.mysql.cj.jdbc.Driver

# 连接 URL
analytics.connection.url = jdbc:mysql://172.19.2.40:9030/analytics

# 身份验证
analytics.connection.username =<doris_user>
analytics.connection.password =<doris_database_password>

PostgreSQL JDBC 驱动程序{ #postgresql-jdbc-driver }¶

(如有需要，请在此处添加配置或使用说明。)