裸金属

本指南介绍如何在物理机或虚拟机上部署 Apache Ozone。你可以选择手动安装，也可以使用 Ozone Installer 工具进行自动化部署。

Ozone 组件

Ozone Manager (OM) - 管理命名空间（卷、桶、键）
Storage Container Manager (SCM) - 块管理器，为数据写入提供块
Datanodes (DN) - 存储容器并处理数据读写操作
Recon（可选）- 管理与监控界面
S3 Gateway (S3G)（可选）- 提供对 Ozone 的 S3 兼容 API 访问

了解更多：Ozone 架构概览

前置条件

所有节点：

Linux 操作系统（RHEL/CentOS 7+、Ubuntu 20.04+）
Java 11 或 Java 17（OpenJDK）
至少 4 GB 内存
SSH 访问权限
节点之间的网络连通性

手动安装所需：

所有节点的 root/sudo 权限
用于下载二进制文件的 wget 或 curl

自动化安装所需：

控制节点： Python 3.10-3.12、Ansible Community 10.x
受管节点： Python 3.7+、sudo 权限

方式一：手动安装

note

在我们的所有示例中，将以 /opt/ozone 作为 Ozone 配置和二进制文件的基准目录，以 /data/ozone 存放应用数据和元数据。你可以根据自身环境随意使用其他路径。

步骤 1：安装 Java


jdk_version=11



sudo yum install -y java-${jdk_version}-openjdk-devel





sudo apt-get update

sudo apt-get install -y openjdk-${jdk_version}-jdk





java -version

设置 JAVA_HOME：




sudo update-alternatives --config java





export JAVA_HOME=/usr/lib/jvm/java-11-openjdk

export PATH=$PATH:$JAVA_HOME/bin

步骤 2：创建服务用户




sudo groupadd ozone

sudo useradd -g ozone -m -s /bin/bash ozone





sudo mkdir -p /data/ozone/{metadata,datanode/id,datanode/data}

sudo chown -R ozone:ozone /data/ozone





sudo mkdir -p /opt/ozone

sudo chown ozone:ozone /opt/ozone

第 3 步：下载并解压 Ozone

请查看 GitHub releases 获取最新版本。




sudo su - ozone





wget https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0.tar.gz





tar -xzf ozone-2.1.0.tar.gz -C /opt/

ln -s /opt/ozone /opt/ozone-2.1.0

cd /opt/ozone

第 4 步：生成与配置




bin/ozone genconf /opt/ozone/etc/hadoop/

编辑 /opt/ozone/etc/hadoop/ozone-site.xml：


<configuration>

  <property>

    <name>ozone.metadata.dirs</name>

    <value>/data/ozone/metadata</value>

  </property>



  <property>

    <name>ozone.scm.names</name>

    <value>scm-host.example.com</value>

  </property>



  <property>

    <name>ozone.om.address</name>

    <value>om-host.example.com</value>

  </property>



  <property>

    <name>ozone.scm.datanode.id.dir</name>

    <value>/data/ozone/datanode/id</value>

  </property>



  <property>

    <name>hdds.datanode.dir</name>

    <value>/data/ozone/datanode/data</value>

  </property>



  <property>

    <name>ozone.replication</name>

    <value>3</value>



  </property>





  <property>

    <name>ozone.s3g.http-address</name>

    <value>0.0.0.0:9878</value>

  </property>

</configuration>

配置资源：

将 ozone-site.xml 复制到所有节点。

第 5 步：初始化服务




bin/ozone scm --init





bin/ozone om --init

第 6 步：启动服务




bin/ozone --daemon start scm





bin/ozone --daemon start om





bin/ozone --daemon start datanode





bin/ozone --daemon start recon





bin/ozone --daemon start s3g

第 7 步：验证安装




jps







bin/ozone sh volume create /vol1

bin/ozone sh bucket create /vol1/bucket1

echo "Hello Ozone" > /tmp/test.txt

bin/ozone sh key put /vol1/bucket1/key1 /tmp/test.txt

bin/ozone sh key list /vol1/bucket1

停止服务（如需要）


bin/ozone --daemon stop s3g

bin/ozone --daemon stop datanode

bin/ozone --daemon stop om

bin/ozone --daemon stop scm

bin/ozone --daemon stop recon

方法二：自动化安装（推荐）

ozone-installer 是一个基于 Ansible 的工具，用于自动化部署 Ozone。它可以自动完成 Java 安装、用户创建以及所有配置步骤。

安装步骤

1. 克隆并进行设置：


git clone https://github.com/apache/ozone-installer.git

cd ozone-installer

pip install -r requirements.txt

2. 运行安装程序：




python3 ozone_installer.py -H hostname.example.com -v 2.1.0





python3 ozone_installer.py -H "host{1..5}.example.com" -v 2.1.0





python3 ozone_installer.py -F hosts.txt -v 2.1.0





python3 ozone_installer.py -H hosts -v 2.1.0 --python-interpreter /usr/bin/python3.9





python3 ozone_installer.py --clean -H hosts -v 2.1.0

安装内容

自动安装包括：

安装 Java 11 或 17（如果尚未安装）
创建服务用户（ozone）
创建目录结构
安装并配置 Ozone 二进制文件
配置 S3 Gateway

非高可用（HA）（1-2 个节点）：

第一台主机：OM + SCM + Recon（如启用则含 S3G）
所有主机：Datanode

高可用（HA）（3 个及以上节点）：

前三台主机：OM + SCM（HA）
第一台主机：Recon + S3G（如启用）
所有主机：Datanode

默认路径：

安装目录：/opt/ozone
数据目录：/data/ozone
服务用户：ozone:ozone

更多详情请参阅 ozone-installer 仓库。