TrueCloudLab/rclone
16
0
Fork 3
Code Issues 6 Pull requests 1 Projects Releases 1 Packages Wiki Activity Actions

selfupdate: add instructions on reverting the update (#5141)

Browse source
This commit is contained in:
Ivan Andreev 2021-03-18 23:11:16 +03:00 • committed by GitHub
parent 9ee3ad70e9
commit 2bdbf00fa3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 30 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
cmd/selfupdate/help.go
View file

@ -6,10 +6,30 @@ This command downloads the latest release of rclone and replaces
the currently running binary. The download is verified with a hashsum the currently running binary. The download is verified with a hashsum
and cryptographically signed signature. and cryptographically signed signature.
The |--version VER| flag, if given, will update to a concrete version If used without flags (or with implied |--stable| flag), this command
will install the latest stable release. However, some issues may be fixed
(or features added) only in the latest beta release. In such cases you should
run the command with the |--beta| flag, i.e. |rclone selfupdate --beta|.
You can check in advance what version would be installed by adding the
|--check| flag, then repeat the command without it when you are satisfied.
Sometimes the rclone team may recommend you a concrete beta or stable
rclone release to troubleshoot your issue or add a bleeding edge feature.
The |--version VER| flag, if given, will update to the concrete version
instead of the latest one. If you omit micro version from |VER| (for instead of the latest one. If you omit micro version from |VER| (for
example |1.53|), the latest matching micro version will be used. example |1.53|), the latest matching micro version will be used.
Upon successful update rclone will print a message that contains a previous
version number. You will need it if you later decide to revert your update
for some reason. Then you'll have to note the previous version and run the
following command: |rclone selfupdate [--beta] OLDVER|.
If the old version contains only dots and digits (for example |v1.54.0|)
then it's a stable release so you won't need the |--beta| flag. Beta releases
have an additional information similar to |v1.54.0-beta.5111.06f1c0c61|.
(if you are a developer and use a locally built rclone, the version number
will end with |-DEV|, you will have to rebuild it as it obvisously can't
be distributed).
If you previously installed rclone via a package manager, the package may If you previously installed rclone via a package manager, the package may
include local documentation or configure services. You may wish to update include local documentation or configure services. You may wish to update
with the flag |--package deb| or |--package rpm| (whichever is correct for with the flag |--package deb| or |--package rpm| (whichever is correct for
@ -19,4 +39,9 @@ inaccurate after it.
Note: Windows forbids deletion of a currently running executable so this Note: Windows forbids deletion of a currently running executable so this
command will rename the old executable to 'rclone.old.exe' upon success. command will rename the old executable to 'rclone.old.exe' upon success.
Please note that this command was not available before rclone version 1.55.
If it fails for you with the message |unknown command "selfupdate"| then
you will need to update manually following the install instructions located
at https://rclone.org/install/
` `

15
cmd/selfupdate/selfupdate.go
View file

@ -146,15 +146,8 @@ func InstallUpdate(ctx context.Context, opt *Options) error {
return errors.Wrap(err, "unable to detect new version") return errors.Wrap(err, "unable to detect new version")
} }
if newVersion == "" { oldVersion := fs.Version
var err error if newVersion == oldVersion {
_, newVersion, _, err = versionCmd.GetVersion(siteURL + "/version.txt")
if err != nil {
return errors.Wrap(err, "unable to detect new version")
}
}
if newVersion == fs.Version {
fmt.Println("rclone is up to date") fmt.Println("rclone is up to date")
return nil return nil
} }
@ -166,7 +159,7 @@ func InstallUpdate(ctx context.Context, opt *Options) error {
} else { } else {
err := installPackage(ctx, opt.Beta, newVersion, siteURL, opt.Package) err := installPackage(ctx, opt.Beta, newVersion, siteURL, opt.Package)
if err == nil { if err == nil {
fmt.Printf("Successfully updated rclone package to version %s\n", newVersion) fmt.Printf("Successfully updated rclone package from version %s to version %s\n", oldVersion, newVersion)
} }
return err return err
} }
@ -218,7 +211,7 @@ func InstallUpdate(ctx context.Context, opt *Options) error {
err = replaceExecutable(targetFile, newFile, savedFile) err = replaceExecutable(targetFile, newFile, savedFile)
if err == nil { if err == nil {
fmt.Printf("Successfully updated rclone to version %s\n", newVersion) fmt.Printf("Successfully updated rclone from version %s to version %s\n", oldVersion, newVersion)
} }
return err return err
} }