文档中心知识库API Explorer
文档中心›ZCF›ZStack Cloud›探索更多›用户手册ZCF

安装部署

环境准备

前提条件

安装/升级ZStack Cloud需使用ZStack Cloud ISO，特性如下：
  1. ZStack Cloud ISO以自研的Helix为底座。Helix是运行在基础设施层和上层客户操作系统之间的虚拟化内核软件，集成硬件驱动、宏内核、虚拟代理等必要组件。当上层各类客户操作系统对底层硬件资源进行访问时，Helix可屏蔽底层异构硬件的差异，使客户操作系统免除对最底层物理硬件的驱动依赖，并增强虚拟化运行环境中的硬件兼容性、高可靠性、高可用性、可扩展性、运行性能。
  2. ZStack Cloud 4.8.38官网提供以下版本ISO：
    • h84r版：ZStack-Cloud-x86_64-DVD-4.8.38-h84r.iso
  3. 安装ZStack Cloud无需连接公网，也无须配置yum源，可完全离线安装。
  4. 提供以下几种安装模式：企业版管理节点模式、社区版管理节点模式、计算节点模式、专家模式、精简专家模式，用户请按需选择。
  5. 默认选项：DATE&TIME为亚洲东八区，LANGUAGE为English(United States)，KEYBOARD为English(US)。
本教程将详细介绍ZStack Cloud初装流程，分为以下步骤：
  1. 准备文件。
  2. 写入镜像。
  3. 安装操作系统。

操作步骤

  1. 准备文件。
    安装ZStack Cloud前，请准备以下软件包，以便安装部署过程顺利执行：
    • ZStack Cloud ISO：
      • h84r版：ZStack-Cloud-x86_64-DVD-4.8.38-h84r.iso
      • 下载地址：点击这里
    • ZStack Cloud安装包：
      • 软件名称：ZStack-Cloud-installer-4.8.38.bin
      • 下载地址：点击这里
    Note: 软件下载后，请通过MD5校验工具核对校验码，以确保软件完整无损。
  2. 使用Rufus或Fedora Media Writer，将此ISO镜像刻录到U盘。
    Rufus和Fedora Media Writer刻录镜像的流程基本相同，本章节以使用Rufus为例进行介绍。如需获取Fedora Media Writer刻录镜像的详细步骤，请参考《快速安装使用教程》。
    1. 在Rufus中打开ISO镜像。

      接入U盘，打开Rufus，引导类型选择列表选择镜像文件（请选择），点击选择按钮，打开已下载好的ISO镜像文件。

      如图 1所示：
      图 1. 在Rufus打开ISO镜像


    2. 写入镜像。

      选择好ISO镜像后，其他Rufus选项按照默认设置，点击开始。

      如图 2所示：
      图 2. 在Rufus写入镜像


    3. 点击开始后，会提示U盘数据被格式化，点击确定，Rufus会把ISO镜像刻录至U盘。
      Note: 若U盘中存有重要数据，请确保格式化前已做好备份。
      如图 3所示：
      图 3. 在Rufus确认写入ISO镜像


    4. 此时U盘可用来作为启动盘，支持Legacy模式和UEFI模式引导。
  3. 安装操作系统。
    1. 配置服务器。
      • 确认服务器内硬盘的数据已备份，安装过程会覆盖写入。
      • 进入BIOS，开启CPU VT和超线程HT选项。
      • 进入阵列卡配置合适的RAID级别，以提供一定的数据冗余特性。
      • 设置系统启动盘为第一启动顺序。
    2. 选择引导项。

      进入ISO系统引导界面，选择默认选项开始安装操作系统。

      如图 4所示，
      图 4. 系统引导


      Note:
      • ZStack Cloud提供以下安装方式：图形界面方式、VNC方式和字符安装方式，用户可根据实际情况选择，建议使用图形界面安装。
      • 若服务器无VGA接口，仅支持串口连接，用户可使用VNC方式或字符安装方式。
    3. 安装配置汇总。

      该页面展示系统安装配置，用户可按需修改，ZStack Cloud默认已配置以下内容：

      • DATE&TIME：默认亚洲东八区，建议管理员提前检测物理机时间，配置为当前时间和时区
      • LANGUAGE：默认English(United States)
      • KEYBOARD：默认English(US)
      如图 5所示：
      图 5. 系统安装界面


    4. 选择安装模式。

      在安装配置汇总界面，点击SOFTWARE SELECTION，进入安装模式选择界面，选择安装模式。

      ZStack Cloud包含以下安装模式：
      • ZStack Enterprise Management Node：ZStack企业版管理节点模式
        Note: 首次安装建议选择此模式。
      • ZStack Community Management Node：ZStack社区版管理节点模式
      • ZStack Compute Node：ZStack计算节点模式
      • ZStack Expert Mode：ZStack专家模式
        Note:
        • 若选择该模式，系统安装后将进入终端界面，由用户自定义安装。除该模式外，其余模式将在系统安装完成后自动开始安装对应模式的云平台。
        • No ZStack Local Repo选项表示精简安装，安装过程不拷贝ISO，并且不生成内部源。
      如图 6所示：
      图 6. 选择安装模式


    5. 配置硬盘分区。

      在安装配置汇总界面，点击INSTALLATION DESTINATION，进入硬盘分区界面。

      如图 7所示：
      图 7. 默认磁盘分区


      Note: 此处建议仅配置系统磁盘，其余磁盘可在系统安装后配置。
      ZStack Cloud建议使用Automatic选项自动配置磁盘分区。若用户需手动配置，可根据BIOS引导模式参考以下内容：
      • UEFI 模式
        • /boot：存放Linux启动所需的核心文件，建议分配1GB空间
        • /boot/efi：存放UEFI启动引导文件，建议分配500MB
        • swap：交换区，建议分配32GB
        • /：Linux系统根目录，建议分配全部剩余空间
      • Legacy模式
        • /boot：存放Linux 启动所需的核心文件，建议分配 1GB空间
        • swap：交换区，建议分配 32GB
        • /：Linux系统根目录，建议分配全部剩余空间
      Note:
      • 以上数值为ZStack Cloud建议分区容量（磁盘总容量大于300GB）。
      • Legacy模式下，若系统盘容量大于2TB，需配置BIOS boot分区，以支持GPT分区。UEFI模式没有此限制，且支持GPT分区。
    6. 配置网络。
      本步骤将配置网卡静态IP地址以及网卡自动激活，该配置仅适用于POC测试。生产环境部署建议配置网卡归一化，详情请参考网卡归一化(可选)章节。
      1. 配置静态IP地址。
        1. 在安装配置汇总界面，点击NETWORK & HOST NAME > Ethernet（ens3） > Configure...，弹出ens3配置界面。点击IPv4 Settings > Method > Manual，用于切换IP地址获取方式为手动指定。
          Note: 用户可按需配置IP地址获取方式，包括使用DHCP自动获取、手动指定等。
        2. 点击Add添加IP地址条目，根据按需配置IP地址、子网掩码、网关地址，完成后点击save保存配置。
          如图 8所示：
          图 8. 配置静态IP地址


      2. 配置网卡自动激活。

        在ens3配置界面，点击General > Connect automatically with priority (0) > Save，修改网卡自动激活。

        如图 9所示：
        图 9. 配置网卡自动激活


    7. 设置密码。

      在安装配置汇总界面，点击Root Password，设置操作系统root用户密码。

      如图 10所示：
      图 10. 设置密码


    8. 开始安装。

      返回安装配置汇总界面，点击Begin Installation开始安装操作系统。

      如图 11所示：
      图 11. 开始安装


    9. 进入系统。

      安装完成后，点击重启，即可启动进入ZStack Cloud系统。

网卡归一化(可选)

本章节主要介绍网卡归一化配置方法，在实际生产环境中安装部署ZStack Cloud建议使用该方法。

以下介绍网卡归一化的两种配置方式：命令行方式和图形界面方式。

命令行方式

用户可在ZStack Cloud安装完成后，按照具体部署场景需求，参考以下命令快速实现网卡归一化：
# 创建链路聚合虚拟接口，基于LACP模式
zs-bond-lacp -c [bond-name]
zs-bond-lacp -c bond0

# 创建链路聚合虚拟接口，基于主备模式
zs-bond-ab -c [bond-name]
zs-bond-ab -c bond0

# 加载物理接口到聚合接口
zs-nic-to-bond -a [bond-name] [nic-name]
zs-nic-to-bond -a bond0 ens3

# 创建VLAN接口
zs-vlan -c [nic-name] [vlan]
zs-vlan -c bond0 10

# 创建网桥并配置网络地址
zs-network-setting -b [interface] [ipaddress] [netmask] [gateway]
zs-network-setting -b bond0.10 192.168.1.10 255.255.255.0 192.168.1.1

图形界面方式

用户可在安装操作系统时使用图形界面进行网卡归一化配置，流程如下：
  1. 添加Bond设备。
  2. 添加Bond Slave。
  3. 选择Bond模式。
  4. 原网卡接口禁用IPv4。
  5. 完成配置。
  6. 配置Bond静态IP地址。
  7. 配置网卡自动激活。
  1. 添加Bond设备。

    在安装配置汇总界面，点击NETWORK & HOST NAME > Ethernet（ens3） > Configure...，弹出ens3配置界面。点击左下角的"+"号，弹出Add device界面，在下拉菜单中选择Bond，点击Add。

    如图 1所示：
    图 1. 添加一个Bond设备


  2. 添加Bond Slave。
    1. 在Bond配置界面，点击Add，添加Bond Slave。
      如图 2所示：
      图 2. 添加Bond Slave


    2. 弹出Choose a Connection Type界面，在下拉菜单中选择Bond Slave连接类型，如Ethernet，点击Create...，如图 3所示：
      图 3. 选择Bond Slave连接类型


    3. 弹出Editing bond0 slave1界面的Ethernet子页面，在Device下拉菜单中选择需要Bond的Slave设备，如ens3（相应MAC地址），其它选择默认或按需自定义设置，点击Save，如图 4所示：
      图 4. 选择Bond Slave设备


  3. 选择Bond模式。

    在Bond配置界面，Mode下拉菜单中，按需选择Bond模式，如Active backup（主备模式），其它选择默认或按需自定义设置，点击Save，如图 5所示：

    图 5. 选择Bond模式


  4. 原网卡接口禁用IPv4。
    • 选择Ethernet (ens3)，点击Configure... > IPv4 Settings，将Method参数值改为Disabled，点击Save，保存配置。
    • 如图 6所示：
      图 6. 禁用IPv4


  5. 完成配置。

    如图 7所示：

    Note:

    请检查Bond配置项，必须保证On开启且配置了地址，同时Bond Slave（如ens3）也On开启，否则ZStack Cloud无法正常安装。

    图 7. 网卡归一化完成


  6. 配置Bond静态IP地址。
    1. 在安装配置汇总界面，点击NETWORK & HOST NAMEBond（bond0）Configure...，弹出Bond（bond0）配置界面。点击IPv4 Settings > Method > Manual，用于切换IP地址获取方式为手动指定。
      Note: 用户可按需配置IP地址获取方式，包括使用DHCP自动获取、手动指定等。
    2. 点击Add添加IP地址条目，根据按需配置IP地址、子网掩码、网关地址，完成后点击save保存配置。
  7. 配置网卡自动激活。
    在Bond（bond0）配置界面，点击General > Connect automatically with priority (0) > Save，修改网卡自动激活。
    图 8. 配置网卡自动激活


安装ZStack Cloud

本节主要介绍ZStack Cloud 4.8.38的安装模式。

ZStack Cloud ISO安装模式

ZStack Cloud ISO提供以下安装模式：
  • 企业版管理节点模式
  • 社区版管理节点模式
  • 计算节点模式
  • 专家模式
安装模式的步骤介绍：
  1. 企业版管理节点模式
    • 安装基础系统
    • 安装MariaDB、CloudBus消息总线等依赖包
    • 自动安装并启动ZStack Cloud
  2. 社区版管理节点模式
    • 安装基础系统
    • 安装MariaDB、CloudBus消息总线等依赖包
    • 自动安装并启动ZStack Cloud
    Note:
    • 企业版管理节点模式与社区版管理节点模式的区别在于许可证类型不同导致相关功能的不同。
    • 企业版管理节点模式与社区版管理节点模式在安装步骤上完全相同。
  3. 计算节点模式
    • 安装基础系统
    • 安装libvirt、QEMU等虚拟化组件
  4. 专家模式
    • 安装基础系统
    Note:
    • 专家模式基本等同于最小安装模式。
    • 当管理员需要做更深度的定制时，可以选择进入专家模式，手动转化为其它三种模式中的任何一种。
不同安装模式适用不同安装场景，如表 1所示：
模式 场景
企业版管理节点模式 仅适用于安装企业版管理节点。
社区版管理节点模式 仅适用于安装社区版管理节点。
计算节点模式
适用于安装云平台内除管理节点外的其他节点，例如：
  • 计算节点。
  • 镜像仓库、Ceph镜像服务器节点、Ceph镜像服务器Mount节点。
  • Ceph主存储节点、Ceph主存储Mount节点。
  • PXE部署服务器节点、本地灾备服务器节点、远端备份服务器节点（异地）。
专家模式

ZStack Cloud管理节点模式

如前所述：
  • 企业版管理节点模式与社区版管理节点模式的区别在于许可证类型不同导致相关功能不同。
  • 企业版管理节点模式与社区版管理节点模式在安装步骤上完全相同。

自动安装ZStack Cloud管理节点

如果选择企业版/社区版管理节点模式，重启后会自动安装ZStack Cloud管理节点。
图 1. 自动安装管理节点


ZStack Cloud计算节点模式

如果用户选择计算节点模式，重启后会自动安装ZStack Cloud计算节点。
Note: 部分场景下，需要All-in-One模式来搭建ZStack Cloud，这时应选用ZStack Cloud管理节点模式安装。

补充说明

管理节点可以添加计算节点的个数在技术上无限制，仅与授权数量相关。

ZStack Cloud专家模式

如果用户选择专家模式，重启后会进入终端界面，用户可根据实际场景需求，自定义安装所需ZStack Cloud环境。

补充说明

专家模式支持精简安装，在选择安装模式步骤，勾选右侧No ZStack Local Repo表示精简安装。

图 1. 精简专家模式


Note: 精简专家模式安装过程不拷贝/opt/zstack-dvd/目录下的ISO、并且/etc/yum.repos.d/目录下不生成zstack-local.repo等配置文件。

管理ZStack Cloud

操作步骤

  1. 首次安装后，系统自启动ZStack Cloud服务。
  2. 管理节点重启后，ZStack Cloud服务将开机自启。
  3. 管理节点因维护或其他异常原因停止服务后，需手动启动服务。
    启动ZStack Cloud服务方法如下：
    [root@localhost ~]#zstack-ctl start #此命令将同时启动管理节点和Web UI服务
  4. 用户可使用zstack-ctl status命令，查看ZStack Cloud管理节点相关服务的运行状态。 
    [root@10-0-5-87 ~]# zstack-ctl status
ZSTACK_HOME: /usr/local/zstack/apache-tomcat/webapps/zstack
zstack.properties: /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties
log4j2.xml: /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/log4j2.xml
PID file: /usr/local/zstack/management-server.pid
log file: /usr/local/zstack/apache-tomcat/logs/management-server.log
version: 4.8.38 (ZStack-enterprise 4.8.38)
MN status: Running [PID:123135]
UI status: Running [PID:795] http://10.0.0.254:5000
  5. 用户也可以使用zstack-ctl ui_status命令单独查看Web UI服务状态。 
    [root@172-20-12-20 ~]# zstack-ctl ui_status
UI status: Running [PID:8459] http://10.0.0.254:5000
  6. 在使用过程中如需重启管理节点服务，不重启Web UI服务，则需执行：
    zstack-ctl restart_node
  7. 在使用过程中不建议全部停止及重启所有服务。如果确需重启所有服务，可执行以下命令进行重启：
    zstack-ctl stop && zstack-ctl start

升级ZStack Cloud

本文档以h84r版ZStack Cloud的升级场景为例进行介绍。
  • 升级前，管理节点与计算节点均安装h84r版操作系统，将管理节点升级至最新的h84r版操作系统。
  • 只需升级管理节点，计算节点会自动完成升级。
  • 升级前，管理员需对数据库进行备份。
  • 升级过程中，不支持访问管理平台界面和命令入口，运行状态的云主机服务不受升级影响。
  • 升级完成后，需及时清理浏览器缓存或刷新管理节点浏览器UI界面。

离线升级云平台

  1. 离线升级ZStack Cloud之前，请管理员准备好以下必要的软件包，建议将以下软件或脚本保存至管理节点所在的/root/目录下。
    • ZStack Cloud ISO：
      • 软件名称（h84r）：ZStack-Cloud-x86_64-DVD-4.8.38-h84r.iso
      • 下载地址：点击这里
    • ZStack Cloud安装包：
      • 软件名称：ZStack-Cloud-installer-4.8.38.bin
      • 下载地址：点击这里
    Note: 软件下载后，需通过MD5校验工具核对校验码，确认与发行信息一致。
  2. 升级前，管理员需确保数据库已做好备份。
    • 可执行以下命令，对数据库进行手动备份：
      [root@zstack-1 ~]# zstack-ctl dump_mysql --file-name zstack-mysql-before-upgrade
      Note:
      • 命令执行后，将会在/var/lib/zstack/mysql-backup/下创建数据库备份。
      • 升级过程中，将升级ZStack Cloud代理服务器，不触及主存储和镜像服务器中的数据内容。
    • 可使用ZStack Cloud提供的灾备服务，对数据库进行定时备份。
      Note:
      • 灾备服务以单独的功能模块形式提供，需提前购买灾备服务模块许可证，且需在购买云平台许可证基础上使用，不可单独使用。
  3. 管理员执行以下命令升级ZStack Cloud管理服务。
    #支持两种离线升级方式，推荐使用第一种:
# 第一种方式： 升级本地仓库和管理服务
[root@zstack-1 opt]# zstack-upgrade ZStack-Cloud-x86_64-DVD-4.8.38-h84r.iso
# 第二种方式： 先升级本地仓库再升级管理服务:
[root@zstack-1 opt]# zstack-upgrade -r ZStack-Cloud-x86_64-DVD-4.8.38-h84r.iso
[root@zstack-1 opt]# bash ZStack-Cloud-installer-4.8.38.bin -u -P MYSQL_ROOT_PASSWORD
    Note:
    • 若数据库root密码采用系统默认密码zstack.mysql.password， -P MYSQL_ROOT_PASSWORD参数可省略。
    • 执行zstack-upgrade命令前需确认所准备的ISO是基于h84r版，避免使用其他版本ISO覆盖本地源。
    • 升级本地仓库时会自动更新升级脚本，脚本升级完成后，可按提示重新执行上一步命令即可。
上一篇配置需求下一篇系统登录