[DOCFIX] Update cn version of Upgrade doc #16840
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
@voddle thanks for updating the doc |
jiacheliu3
requested changes
Feb 12, 2023
docs/cn/administration/Upgrade.md
Outdated
|
|
||
| ## 基础升级流程 | ||
|
|
||
| 正常情况下，用户可以直接关闭当前的 Alluxio 进程，将 Alluxio 二进制文件更改为更新的版本，同时还按之前的方式配置 Alluxio 集群，并使用现有的日志文件夹/地址来启动 Alluxio 进程 |
There was a problem hiding this comment.
Suggested change
| 正常情况下，用户可以直接关闭当前的 Alluxio 进程，将 Alluxio 二进制文件更改为更新的版本，同时还按之前的方式配置 Alluxio 集群，并使用现有的日志文件夹/地址来启动 Alluxio 进程 | |
| 正常情况下，用户可以直接关闭当前的 Alluxio 进程，将 Alluxio 二进制文件更改为更高的版本，同时还按之前的方式配置 Alluxio 集群，并使用现有的日志文件夹/地址来启动 Alluxio 进程 |
docs/cn/administration/Upgrade.md
Outdated
| ## 基础升级流程 | ||
|
|
||
| 正常情况下，用户可以直接关闭当前的 Alluxio 进程，将 Alluxio 二进制文件更改为更新的版本，同时还按之前的方式配置 Alluxio 集群，并使用现有的日志文件夹/地址来启动 Alluxio 进程 | ||
| 进行升级。Alluxio 可读取以前的日志文件并自动恢复 Alluxio 元数据。 |
There was a problem hiding this comment.
Suggested change
| 进行升级。Alluxio 可读取以前的日志文件并自动恢复 Alluxio 元数据。 | |
| 进行升级。Alluxio 可读取以前的日志文件并从 Journal 日志中自动恢复 Alluxio 元数据。 |
docs/cn/administration/Upgrade.md
Outdated
| 以下两种情况下master日志无法向后兼容，需要采取额外的步骤来升级 Alluxio 集群： | ||
|
|
||
| - 从 Alluxio 1.x 版本升级到 Alluxio 2.x 版本 | ||
| - 使用[内嵌日志]({{ '/cn/operation/Journal.html' | relativize_url}})的情况下从 Alluxio 2.3.x 及以下版本升级到 Alluxio 2.4.0 及以上版本 |
There was a problem hiding this comment.
改成link到Journal.html#xxx embedded journal?
docs/cn/administration/Upgrade.md
Outdated
|
|
||
| ## 创建当前版本的备份 | ||
|
|
||
| Alluxio-1.8.1 版本引入了日志备份功能。 |
There was a problem hiding this comment.
Suggested change
| Alluxio-1.8.1 版本引入了日志备份功能。 | |
| Alluxio-1.8.1 版本引入了日志备份（backup）功能。 |
docs/cn/administration/Upgrade.md
Outdated
|
|
||
| Alluxio-1.8.1 版本引入了日志备份功能。 | ||
| 注意，请不要在备份前修改 Alluxio 二进制文件。 | ||
| 在运行 1.8.1 之前版本的 master 时，通过运行以下命令创建日志备份： |
There was a problem hiding this comment.
是不是只说了<=1.8.1版本时候怎么backup？那我觉得这里有点问题。用2.x版本的时候指令应该是一样的，你可以快速在自己电脑上验证一下，然后直接把“在运行 1.8.1 之前版本的 master 时”去掉
docs/cn/administration/Upgrade.md
Outdated
|
|
||
| Alluxio 2.x 版本对 RPC 层进行了重大修改， | ||
| 因此 2.0.0 之前版本的客户端不能与 2.0.0 之后版本的服务器一起运行，反之亦然。 | ||
| 如果要使用 Alluxio-2.x 客户端需升级所有应用程序 。 |
There was a problem hiding this comment.
Suggested change
| 如果要使用 Alluxio-2.x 客户端需升级所有应用程序 。 | |
| 如果要使用 Alluxio-2.x 客户端需升级所有应用程序 中的Alluxio客户端。 |
docs/cn/administration/Upgrade.md
Outdated
| ```console | ||
| $ export HADOOP_CLASSPATH={{site.ALLUXIO_CLIENT_JAR_PATH}}:${HADOOP_CLASSPATH} | ||
| ``` | ||
| 如下所示： |
docs/cn/administration/Upgrade.md
Outdated
| ```console | ||
| $ ./bin/alluxio format | ||
| ``` | ||
| - **警告：** 该操作会对 Alluxio worker 上的内存虚拟硬盘进行格式化（即：删除其中的内容）。 |
There was a problem hiding this comment.
Suggested change
| - **警告：** 该操作会对 Alluxio worker 上的内存虚拟硬盘进行格式化（即：删除其中的内容）。 | |
| - **警告：** 该操作会对 Alluxio worker 上的内存虚拟硬盘（ramdisk）进行格式化（即：删除其中的内容）。 |
jiacheliu3
reviewed
Feb 13, 2023
docs/cn/administration/Upgrade.md
Outdated
| 以下两种情况下master日志无法向后兼容，需要采取额外的步骤来升级 Alluxio 集群： | ||
|
|
||
| - 从 Alluxio 1.x 版本升级到 Alluxio 2.x 版本 | ||
| - 使用[内嵌日志]({{ '/cn/operation/Journal.html#Configuring Embedded Journal' | relativize_url}})的情况下从 Alluxio 2.3.x 及以下版本升级到 Alluxio 2.4.0 及以上版本 |
There was a problem hiding this comment.
double check the URL, is it correct?
|
alluxio-bot, merge this please |
jiacheliu3
pushed a commit
to jiacheliu3/alluxio
that referenced
this pull request
May 16, 2023
What changes are proposed in this pull request? Update cn version of Upgrade doc. Why are the changes needed? There is no corresponding Chinese documentation for upgrade. Does this PR introduce any user facing changes? More Chinese users can access Alluxio documentation more easily. pr-link: Alluxio#16840 change-id: cid-be17d3c207fbbaa3211f6e3e7611a2e15741b66f
jiacheliu3
pushed a commit
to jiacheliu3/alluxio
that referenced
this pull request
May 16, 2023
What changes are proposed in this pull request? Update cn version of Upgrade doc. Why are the changes needed? There is no corresponding Chinese documentation for upgrade. Does this PR introduce any user facing changes? More Chinese users can access Alluxio documentation more easily. pr-link: Alluxio#16840 change-id: cid-be17d3c207fbbaa3211f6e3e7611a2e15741b66f
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What changes are proposed in this pull request?
Update cn version of Upgrade doc.
Why are the changes needed?
There is no corresponding Chinese documentation for upgrade.
Does this PR introduce any user facing changes?
More Chinese users can access Alluxio documentation more easily.