升级

Slack Docker Pulls GitHub edit source

基础升级流程

正常情况下,用户可以直接关闭当前的 Alluxio 进程,将 Alluxio 二进制文件更改为更高的版本,同时还按之前的方式配置 Alluxio 集群,并使用现有的日志文件夹/地址来启动 Alluxio 进程 进行升级。Alluxio 可读取以前的日志文件并从 Journal 日志中自动恢复 Alluxio 元数据。

以下两种情况下master日志无法向后兼容,需要采取额外的步骤来升级 Alluxio 集群:

  • 从 Alluxio 1.x 版本升级到 Alluxio 2.x 版本
  • 使用内嵌日志的情况下从 Alluxio 2.3.x 及以下版本升级到 Alluxio 2.4.0 及以上版本

本文档介绍了如何将 Alluxio 升级到非向后兼容版本。 即使是要升级到可向后兼容的版本,仍然建议按照以下步骤在升级前创建备份。

创建当前版本的备份

Alluxio-1.8.1 版本引入了日志备份(backup)功能。 注意,请不要在备份前修改 Alluxio 二进制文件。 通过运行以下命令创建日志备份:

$ ./bin/alluxio fsadmin backup
Successfully backed up journal to ${BACKUP_PATH}

${BACKUP_PATH} 将根据日志的日期和配置确定。 备份文件将默认保存到集群根 UFS 的 alluxio.master.backup.directory 中, 也可以使用 backup [local_address] --local 命令将文件备份到当前 leading master 节点的本地文件系统中。

升级并从备份启动

停止现有的 Alluxio 集群后,下载并解压新版本的 Alluxio 。 从 /conf 目录拷贝旧的配置文件。然后通过以下命令将集群格式化:

$ ./bin/alluxio format
  • 警告: 该操作会对 Alluxio worker 上的内存虚拟硬盘(ramdisk)进行格式化(即:删除其中的内容)。 如果您希望保留 worker 上的内存虚拟硬盘,请参阅 Alluxio worker 内存虚拟硬盘缓存持久化

然后使用 -i ${BACKUP_PATH} 参数启动集群, 将 ${BACKUP_PATH} 替换为具体的备份路径。

$ ./bin/alluxio-start.sh -i ${BACKUP_PATH} all

注意这里的 ${BACKUP_PATH} 应该是类似 HDFS 地址的完整路径,可以被所有 Alluxio master 访问。 如果要备份到本地文件系统路径,需将备份文件复制到所有 master 节点上的同一位置,然后通过本地备份文件路径启动所有 master。

升级客户端和服务器

Alluxio 2.x 版本对 RPC 层进行了重大修改, 因此 2.0.0 之前版本的客户端不能与 2.0.0 之后版本的服务器一起运行,反之亦然。 如果要使用 Alluxio-2.x 客户端需升级所有应用程序中的 Alluxio 客户端。

请参阅以下步骤:

  1. 备份 Alluxio 中文件的元数据。请参阅有关 backup 命令的文档
  2. 停止 Alluxio 集群。
    $ ./bin/alluxio-stop.sh all
    
  3. 更新所有应用程序的 Alluxio 客户端 jar 路径。例如Yarn, Spark, HivePresto,在 Cloudera Manager 的 “YARN (包括MR2)” 部分,在 “Configuration” 选项卡中,搜索参数 “Gateway Client Environment Advanced Configuration Snippet (Safety Valve) for hadoop-env.sh”。然后将以下行添加到脚本中:
    $ export HADOOP_CLASSPATH=/<PATH_TO_ALLUXIO>/client/alluxio-2.10.0-SNAPSHOT-client.jar:${HADOOP_CLASSPATH}
    

    如下所示: locality

  4. 启动Alluxio集群
    $ ./bin/alluxio-start.sh all
    
  5. 如果您已经更新了某个应用程序的 Alluxio 客户端 jar,请重新启动该应用程序,以便使用新的 Alluxio 客户端 jar。

其他选项

Alluxio worker 内存磁盘缓存持久化

如果您已经配置了 Alluxio worker 上的内存磁盘缓存,可使用另一个存储介质(例如,主机的本地磁盘)来持久化和恢复这些缓存的内容。

在运行 alluxio-stop.sh 时加上 -c 参数来指定 worker 保存其内存磁盘内容的路径(worker会将内容保存到其主机的文件系统中):

$ ./bin/alluxio-stop.sh workers -c ${CACHE_PATH}
  • 警告: 该操作将覆盖并替换给定 ${CACHE_PATH} 中的所有现有内容

然后,在运行 alluxio-start.sh 时加上 -c 参数来指定包含 worker 内存磁盘缓存内容的目录。

$ ./bin/alluxio-start.sh workers NoMount -c ${CACHE_PATH}
  • 警告: 该操作将覆盖并替换已配置的 worker 内存磁盘路径中所有的现有内容。