-
Notifications
You must be signed in to change notification settings - Fork 967
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
doc: add english documents about smooth upgrade #5141
Merged
Merged
Changes from all commits
Commits
Show all changes
12 commits
Select commit
Hold shift + click to select a range
90dbb0c
add english documents about smooth upgrade
zhijian-pro 6507848
Update docs/en/administration/upgrade.md
zhijian-pro a66bee8
Update docs/en/administration/upgrade.md
zhijian-pro 6acd6ca
Update docs/en/administration/upgrade.md
zhijian-pro 5380d3a
Update docs/en/administration/upgrade.md
zhijian-pro ef34a60
Update docs/en/administration/upgrade.md
zhijian-pro 1b2e685
Update docs/en/administration/upgrade.md
zhijian-pro 981b5e0
Update docs/en/administration/upgrade.md
zhijian-pro ca14247
Update docs/en/administration/upgrade.md
zhijian-pro 722c295
Update docs/en/administration/upgrade.md
zhijian-pro a1d6872
Update docs/en/administration/upgrade.md
zhijian-pro 7f23732
Update docs/en/administration/upgrade.md
zhijian-pro File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
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
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -8,6 +8,8 @@ Upgrade methods vary with different JuiceFS clients. | |||||
|
||||||
## Mount point | ||||||
|
||||||
### Normal upgrade | ||||||
|
||||||
The JuiceFS client only has one binary file. So to upgrade the new version, you only need to replace the old one with the new one. | ||||||
|
||||||
- **Use pre-compiled client**: Refer to [Install the pre-compiled client](../getting-started/installation.md#install-the-pre-compiled-client) for details. | ||||||
|
@@ -19,6 +21,42 @@ For the file system that has been mounted using the old version of JuiceFS clien | |||||
When unmounting the file system, make sure that no application is accessing it. Otherwise the unmount will fail. Do not forcibly unmount the file system, as it may cause the application unable to continue to access it as expected. | ||||||
::: | ||||||
|
||||||
### Smooth upgrade | ||||||
|
||||||
Starting from version v1.2, JuiceFS supports the smooth upgrade feature, which allows you to mount JuiceFS again at the same mount point to achieve a seamless client upgrade. In addition, this feature can also be used to dynamically adjust mount parameters. | ||||||
|
||||||
Here are two common scenarios for illustration: | ||||||
|
||||||
- Client upgrade | ||||||
For example, if you have a `juicefs mount` process like `juicefs mount redis://127.0.0.1:6379/0 /mnt/jfs -d` and want to upgrade to a new JuiceFS client without unmounting, perform the following steps: | ||||||
|
||||||
```shell | ||||||
# 1. Backup the current binary | ||||||
cp juicefs juicefs.bak | ||||||
|
||||||
# 2. Download the new binary to overwrite the current juicefs binary | ||||||
|
||||||
# 3. Execute the juicefs mount command again to complete the smooth upgrade | ||||||
juicefs mount redis://127.0.0.1:6379/0 /mnt/jfs -d | ||||||
``` | ||||||
|
||||||
- Dynamically adjusting mount parameters | ||||||
|
||||||
For example, if you have a `juicefs mount` process like `juicefs mount redis://127.0.0.1:6379/0 /mnt/jfs -d` and want to adjust the log level to debug without unmounting, execute the following command: | ||||||
|
||||||
```shell | ||||||
# Adjust the log level | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
juicefs mount redis://127.0.0.1:6379/0 /mnt/jfs --debug -d | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
``` | ||||||
|
||||||
Notes: | ||||||
|
||||||
- Smooth upgrades require both old and new JuiceFS client versions to be v1.2 or higher. | ||||||
|
||||||
- The FUSE parameters in the new mount parameters should be consistent with the old mount parameters, otherwise the smooth upgrade will overwrite the mount at the current mount point. | ||||||
|
||||||
- When `enable-xattr` is enabled, smooth upgrade will overwrite the mount at the current mount point. | ||||||
|
||||||
## Kubernetes CSI Driver | ||||||
|
||||||
Please refer to [official documentation](https://juicefs.com/docs/csi/upgrade-csi-driver) to learn how to upgrade JuiceFS CSI Driver. | ||||||
|
Oops, something went wrong.
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.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.