TT Bigdata
目录

Step9—AmbariServer 初始化

# Step9—AmbariServer 初始化

前面已经准备好了本地仓库、JDK、MariaDB 和 JDBC 驱动，现在可以初始化 Ambari Server。这个步骤只在核心节点 hadoop1.test.com 做，工作节点后续会通过 Ambari Web UI 注册和安装 Agent。

新版本安装我建议使用 ambari-plus setup 完成服务初始化。它会把 Ambari Plus 需要的安装项集中在一个入口里处理，后面排查也更容易对齐。

本文示例参数：

项目 值
Ambari Server 节点 hadoop1.test.com
数据库地址 hadoop1.test.com:3306
Ambari 数据库 ambari
Ambari 用户 ambari
JDBC 驱动 /usr/share/java/mysql-connector-java.jar
Ambari JDK /usr/jdk64/jdk17
Stack JDK /usr/jdk64/jdk1.8
初始化入口 ambari-plus setup

提示

主机名这里我建议全程使用 FQDN，例如 hadoop1.test.com。后面如果继续接 Kerberos、LDAP、SPNEGO 或证书，短主机名和 FQDN 混用很容易引出 Principal、回调地址、证书 SAN 不一致的问题。

# 创建 Ambari 数据库和用户

在核心节点执行。这里登录 MariaDB root 时，密码输入 Step8 里设置的 root。示例里的 Ambari 数据库密码是 ambari，生产环境请换成自己的强密码，并和后面 ambari-plus setup 里输入的密码保持一致。

AMBARI_DB_PASSWORD='ambari'

mysql -uroot -p <<EOF
CREATE DATABASE IF NOT EXISTS ambari DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER IF NOT EXISTS 'ambari'@'%' IDENTIFIED BY '${AMBARI_DB_PASSWORD}';
CREATE USER IF NOT EXISTS 'ambari'@'localhost' IDENTIFIED BY '${AMBARI_DB_PASSWORD}';

GRANT ALL PRIVILEGES ON ambari.* TO 'ambari'@'%';
GRANT ALL PRIVILEGES ON ambari.* TO 'ambari'@'localhost';

FLUSH PRIVILEGES;
EOF
1
2
3
4
5
6
7
8
9
10
11
12
13

检查 Ambari 用户能否连接自己的库：

mysql -h hadoop1.test.com -uambari -p -D ambari -e "SELECT DATABASE();"
1

Ambari 数据库和用户连接验证

如果这次要一起安装 Hive

如果你计划在同一轮安装 Hive，可以提前创建 Hive Metastore 库和用户。只安装 Ambari Server 时，这段可以先不做。

HIVE_DB_PASSWORD='hive'

mysql -uroot -p <<EOF
CREATE DATABASE IF NOT EXISTS hive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER IF NOT EXISTS 'hive'@'%' IDENTIFIED BY '${HIVE_DB_PASSWORD}';
CREATE USER IF NOT EXISTS 'hive'@'localhost' IDENTIFIED BY '${HIVE_DB_PASSWORD}';

GRANT ALL PRIVILEGES ON hive.* TO 'hive'@'%';
GRANT ALL PRIVILEGES ON hive.* TO 'hive'@'localhost';

FLUSH PRIVILEGES;
EOF
1
2
3
4
5
6
7
8
9
10
11
12
13

# 安装 Ambari Server

核心节点从本地仓库安装。

    if command -v dnf >/dev/null 2>&1; then
  sudo dnf clean all
  sudo dnf makecache
  sudo dnf -y install ambari-server ambari-agent
else
  sudo yum clean all
  sudo yum makecache
  sudo yum -y install ambari-server ambari-agent
fi
    1
    2
    3
    4
    5
    6
    7
    8
    9
    sudo apt update
sudo apt install -y ambari-server ambari-agent
    1
    2
    // Make sure to add code blocks to your code group

    安装后确认官方 Ambari DDL 文件存在：

    ls -l /var/lib/ambari-server/resources/Ambari-DDL-MySQL-CREATE.sql
command -v ambari-plus
    1
    2

    Ambari Server 安装结果检查

    # 确认 JDBC 驱动

    ambari-plus setup 会使用 Step7 准备好的 MySQL JDBC 驱动。进入交互前先确认这个路径存在，避免安装到一半再回来补文件：

    ls -lh /usr/share/java/mysql-connector-java.jar
readlink -f /usr/share/java/mysql-connector-java.jar
    1
    2

    如果文件不存在，回到 Step7 检查驱动包和软链接。

    MySQL JDBC 驱动检查

    # 执行官方 Ambari DDL 初始化

    Ambari Server 安装后会提供 MySQL DDL。先判断是否已经初始化过：

    mysql -uambari -p -D ambari -N -e "SHOW TABLES LIKE 'metainfo';"
    1

    如果没有输出，再执行：

    mysql -uambari -p ambari < /var/lib/ambari-server/resources/Ambari-DDL-MySQL-CREATE.sql
    1

    再次检查：

    mysql -uambari -p -D ambari -N -e "SHOW TABLES LIKE 'metainfo';"
    1

    能看到 metainfo，说明官方 Ambari DDL 已经导入。

    官方 Ambari DDL 导入验证

    注意

    官方 Ambari DDL 和 Ambari Plus 增量 DDL 必须导入同一个数据库。本文统一使用 ambari 库，不要额外创建 ambari_plus 库，否则服务启动后会读不到扩展表。

    # 执行 Ambari Plus 增量 DDL

    官方 DDL 只会创建 Ambari 原生表。Ambari Plus 还需要自己的租户、权限控制面、登录欢迎语和审计表，所以这里必须继续执行 Ambari Plus 增量 DDL。

    完整 SQL 放在黄金会员附录：【必需】ambari plus 数据库初始化文件。

    将附录中的 SQL 保存为 Ambari-Plus-DDL-MySQL-CREATE.sql 后，在核心节点导入到同一个 ambari 库：

    mysql -uambari -p ambari < Ambari-Plus-DDL-MySQL-CREATE.sql
    1

    导入后验证关键表和基线数据：

    mysql -uambari -p -D ambari -N -e "SHOW TABLES LIKE 'ambari_plus_tenant';"
mysql -uambari -p -D ambari -e "SELECT tenant_key,status FROM ambari_plus_tenant;"
    1
    2

    能看到 ambari_plus_tenant，并且内置 root 租户状态为 ACTIVE，说明增量 DDL 已经导入。

    Ambari Plus 增量 DDL 导入验证

    # 执行 ambari-plus setup

    数据库和 DDL 都准备好以后，就可以进入 ambari-plus setup。第一次安装我建议走交互式，把每个选项确认清楚；同一套规范已经跑通后，再把参数整理成静默命令用于批量部署。

    # 1. 启动 setup 向导

    在核心节点执行：

    sudo ambari-plus setup
    1

    启动后，终端会进入 setup 向导。后面每一步按提示输入或选择即可；如果是非 TTY 环境，会自动降级成编号输入。批量部署用的静默命令放在第 11 小节，第一次安装先按交互式走完一遍更稳。

    # 2. 选择语言

    语言选择建议选 中文 (Chinese)，后面的数据库、JDK、Web 目录等提示会更容易核对。

    Step9-2 ambari-plus setup 语言选择

    静默模式对应参数：

    --language zh
    1

    如果终端里边框字符显示成方块，先确认系统是 UTF-8 环境：

    locale | grep LANG
echo "TERM=$TERM"
    1
    2

    RHEL 7 / CentOS 7 这类老环境如果显示异常，可以先执行：

    export LANG=en_US.UTF-8
export TERM=xterm-256color
    1
    2

    # 3. 环境检查

    进入正式配置后，第一步是环境检查。这里主要看两件事：

    检查项 通过标准
    执行权限 使用 root 或 sudo 执行
    Ambari 配置文件 /etc/ambari-server/conf/ambari.properties 存在

    如果提示 ambari.properties 不存在，通常是 ambari-server 包还没有安装好，先回到前面的“安装 Ambari Server”小节确认包安装结果。

    Step9-3 ambari-plus setup 环境检查

    # 4. 系统用户

    系统用户这一步用来决定 Ambari Server daemon 使用哪个系统账号运行。普通安装建议保持默认，不自定义系统用户。

    提示 建议
    是否自定义 ambari-server daemon 用户 选择 n

    只有在企业环境里已经规划好专门的服务账号时，才需要自定义。否则这里随意改用户，后面更容易遇到日志目录、PID 文件、资源目录权限不一致的问题。

    静默模式如果不传 --custom-user，就是默认用户路线。

    Step9-4 ambari-plus setup 系统用户

    # 5. JDK 配置

    JDK 配置会让你填写两套路径：

    配置项 建议填写
    Ambari JDK /usr/jdk64/jdk17
    Stack JDK /usr/jdk64/jdk1.8

    这两个路径和 Step6 的软链接要完全一致。填完后，如果界面提示路径不存在，不要继续硬往下走，先回到 Step6 检查：

    ls -ld /usr/jdk64/jdk17 /usr/jdk64/jdk1.8
/usr/jdk64/jdk17/bin/java -version
/usr/jdk64/jdk1.8/bin/java -version
    1
    2
    3

    静默模式对应参数：

    -j /usr/jdk64/jdk17 \
--stack-java-home /usr/jdk64/jdk1.8
    1
    2

    Step9-5 ambari-plus setup JDK 配置

    # 6. GPL 许可

    GPL 许可主要影响 LZO 这类 GPL 相关能力。离线包里已经准备好相关包，并且你确认当前环境允许使用时，可以选择接受；如果只是先跑 Ambari Server 基础安装，也可以先不启用。

    场景 建议
    已准备 GPL 相关离线包 选择接受
    不确定是否需要 先不接受，后面按组件需要再补

    静默模式接受 GPL：

    --accept-gpl
    1

    Step9-6 ambari-plus setup GPL 许可

    # 7. 数据库配置

    这里选择高级数据库配置，数据库类型选 MySQL / MariaDB，并填写前面已经创建好的 Ambari 数据库信息。

    Step9-7.1 ambari-plus setup 进入高级数据库配置

    配置项 本文示例
    是否进入高级数据库配置 y
    数据库类型 MySQL / MariaDB
    数据库地址 hadoop1.test.com
    数据库端口 3306
    数据库名 ambari
    数据库用户 ambari
    数据库密码 前面设置的 AMBARI_DB_PASSWORD
    JDBC 驱动 /usr/share/java/mysql-connector-java.jar

    Step9-7.2 ambari-plus setup 选择 MySQL MariaDB

    注意

    数据库地址如果填主机名，必须确保 Step3 的 hosts 解析已经通过。这里建议直接填写 FQDN，并保证 /etc/hosts 中存在 hadoop1.test.com 到内网 IP 的解析。

    数据库这一步不要临时改库名。前面官方 Ambari DDL 和 Ambari Plus 增量 DDL 都导入到了 ambari 库，这里也必须填同一个库。

    静默模式对应参数：

    --advanced-db --database mysql \
--databasehost hadoop1.test.com --databaseport 3306 \
--databasename ambari --databaseusername ambari \
--databasepassword "${AMBARI_DB_PASSWORD}" \
--jdbc-driver /usr/share/java/mysql-connector-java.jar
    1
    2
    3
    4
    5

    选择自定义 JDBC 驱动后，填写 Step7 准备好的 jar 路径：

    Step9-7.3 ambari-plus setup JDBC 驱动

    数据库信息填完后，界面会把主机、端口、库名、用户名和 JDBC 驱动汇总出来。密码显示为 ****，这是正常的。

    Step9-7.4 ambari-plus setup 数据库汇总

    # 8. 主密钥与 JCE Policy

    主密钥用于加密保存敏感配置。演示环境为了快速跑通，可以先不启用；生产环境建议启用，并把主密钥交给受控的凭据管理流程保存。

    JCE Policy 用于 Java 加密能力扩展。如果你的 JDK 和安全策略已经满足组件要求，可以先不单独配置；需要安装策略包时，再填写实际路径。

    配置项 演示环境 生产建议
    Master Key 可先跳过 建议启用
    JCE Policy 可先跳过 按安全规范配置

    静默模式跳过这两项：

    --no-master-key --no-jce-policy
    1

    静默模式启用时，可以改成：

    --master-key "${AMBARI_MASTER_KEY}" \
--jce-policy /opt/jce8_policy.zip
    1
    2

    Step9-8 ambari-plus setup 主密钥与 JCE Policy

    # 9. Web 目录和服务端口

    Ambari Plus 会额外写入 Web 前端目录和服务端口配置。默认值建议先保持不变：

    配置项 建议值
    Web 目录 /usr/lib/ambari-plus/web
    Server 端口 8080

    填写前可以先确认 Web 目录存在：

    ls -ld /usr/lib/ambari-plus/web
    1

    如果这里改了端口，后面的防火墙和访问地址也要一起改。本文继续使用默认 8080。

    静默模式对应参数：

    --web-dir /usr/lib/ambari-plus/web \
--server-port 8080
    1
    2

    Step9-9 ambari-plus setup Web 目录和服务端口

    # 10. 确认并应用配置

    所有选项填写完后，界面会进入确认面板。这里不要急着回车，先把数据库地址、库名、JDK 路径、Web 目录和端口再核对一遍。

    核对项 正确值
    数据库 hadoop1.test.com:3306/ambari
    数据库用户 ambari
    Ambari JDK /usr/jdk64/jdk17
    Stack JDK /usr/jdk64/jdk1.8
    Web 目录 /usr/lib/ambari-plus/web
    Server 端口 8080

    确认页里能看到完整配置时，再选择开始安装。

    Step9-10.1 ambari-plus setup 确认配置

    执行完成后，重点看 JDBC driver was successfully initialized、server.jdbc.url、server.jdbc.database_name 和 webapp.dir。它们分别说明 JDBC 驱动已经注册，数据库连接配置已经写入，Ambari Server 的 Web 目录已经切到 Plus 前端资源。

    Step9-10.2 ambari-plus setup 执行完成

    然后回到命令行检查 ambari.properties：

    grep -E '^(ambari-server.user|java.home|stack.java.home|server.os_family|server.os_type|server\.jdbc|webapp.dir|client.api.port)=' /etc/ambari-server/conf/ambari.properties
    1

    如果端口仍然使用默认 8080，client.api.port 可能不会单独写入，这是正常的；重点是 server.jdbc.url、server.jdbc.database_name、ambari-server.user 和 webapp.dir=/usr/lib/ambari-plus/web 都能查到。

    # 11. 静默模式批量部署

    交互式流程跑通后，可以把同样的配置固化成静默命令。下面这份命令对应本文示例环境，适合复制后按自己的主机名和密码变量调整：

    export AMBARI_DB_PASSWORD='ambari'

sudo ambari-plus setup -s --language zh --accept-gpl \
  --advanced-db --database mysql \
  --databasehost hadoop1.test.com --databaseport 3306 \
  --databasename ambari --databaseusername ambari \
  --databasepassword "${AMBARI_DB_PASSWORD}" \
  --jdbc-driver /usr/share/java/mysql-connector-java.jar \
  -j /usr/jdk64/jdk17 \
  --stack-java-home /usr/jdk64/jdk1.8 \
  --no-master-key --no-jce-policy \
  --web-dir /usr/lib/ambari-plus/web \
  --server-port 8080
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13

    静默模式不会逐项停下来确认，缺少必填参数时会一次性列出缺失项并退出。第一次整理命令时，我建议先在测试环境跑一遍，再拿到生产环境使用。

    # 启动 Ambari Server 和本机 Agent

    sudo ambari-plus restart
sudo ambari-plus status

sudo ambari-agent restart
sudo ambari-agent status
    1
    2
    3
    4
    5

    ambari-plus restart 会继续调用 Ambari Server 的启动逻辑。看到 Server started listening on 8080，并且 ambari-plus status 返回 Ambari Server running，说明服务端已经加载新配置。

    Ambari Plus Server 启动验证

    本机 Agent、Web 端口和数据库基线也一起确认。这里能看到 Agent 处于运行状态，8080 返回 200 OK，ambari_plus_tenant 里内置租户为 ACTIVE。

    Ambari Plus Agent Web 数据库验证

    # 放通 8080

      sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --reload
      1
      2
      sudo ufw allow 8080/tcp
sudo ufw reload
      1
      2
      // Make sure to add code blocks to your code group

      云主机同样要检查安全组。

      # 访问 Web UI

      浏览器访问：

      http://hadoop1.test.com:8080
      1

      页面能够正常打开时，可以看到 Ambari Plus 的登录入口。正式环境里可以换成自己的域名、VIP 或内网 FQDN。

      Ambari Plus Web UI 登录页

      当前 Ambari Plus 包默认管理员账号为：

      用户名 密码
      admin Admin@2026

      登录后建议第一时间修改默认密码。到这里，安装前准备和 Ambari Server 初始化就告一段落，下一步进入 Web UI 初始化集群，开始添加 hadoop2.test.com、hadoop3.test.com 并安装服务。

      Step8—MariaDB 初始化
      【必需】ambari plus 数据库初始化文件

      ← 【必需】ambari plus 数据库初始化文件→

      最近更新
      01
      当前版本 2026/06
      06-05
      02
      Step7—Mariadb初始化
      03-23
      03
      【Kylin V10 aarch64】强力卸载脚本 aarch64
      03-22
      更多文章>
      Theme by Vdoing | Copyright © 2017-2026 JaneTTR | MIT License