升级
基础升级流程
正常情况下,用户可以直接关闭当前的 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 客户端。
请参阅以下步骤:
- 备份 Alluxio 中文件的元数据。请参阅有关
backup
命令的文档。 - 停止 Alluxio 集群。
$ ./bin/alluxio-stop.sh all
- 更新所有应用程序的 Alluxio 客户端 jar 路径。例如
Yarn
,Spark
,Hive
和Presto
,在 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}
如下所示:
- 启动Alluxio集群
$ ./bin/alluxio-start.sh all
- 如果您已经更新了某个应用程序的 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 内存磁盘路径中所有的现有内容。