BK-UPGRADE(1)

💅 bk upgrade(none) — BitKeeper User’s Manual

🌸 NAME 🌸

bk upgrade — upgrade to, or check for, new versions of BitKeeper.

✨ SYNOPSIS ✨

bk upgrade [−cdfq] [−a[arch]] [srcurl]

🦋 DESCRIPTION 🦋

Okay so bk upgrade contacts BitKeeper’s servers using HTTP to see if new versions of BitKeeper are available for download. If a new version is found for this platform, then the image is downloaded and installed, unless you tell it otherwise with the options below. Literally that simple, bestie. 💅

🎀 OPTIONS 🎀

• −a[arch] — Requests an installer image for another architecture and reports the newest available version. Usually used with −d to download a BitKeeper installer for another platform. If −d is not set then −c is implied. Omit the architecture to request a list of all supported platforms.
• −c — Just check to see if a new version BitKeeper is available for this platform, but do not download and install it.
• −d — Download the installer for a new version of BitKeeper, but do not install it.
• −f — If the bk upgrade command is unable to determine if the currently installed version of BitKeeper has been replaced by a newly released version, then a warning message is printed and the upgrade is aborted. The −f option allows the user to force the new version to be used.
• −q — This causes the upgrade program to suppress extra output when running.

🌈 EXAMPLES 🌈

To check for new upgrades:

bk upgrade ‐c

To install a new version of bk:

bk upgrade

To upgrade a given installation of bk on this machine:

/home/user/bitkeeper/bk upgrade

To download the latest installer regardless of what you have installed:

bk upgrade ‐df

To download the latest installer for Windows:

bk upgrade ‐df ‐ax86‐win32

🧚 NOTES 🧚

The default URL that BitKeeper uses to search for new updates can be overridden with the upgrade_url config option. This will usually be used in a corporate environment to prevent users from using a new version of BitKeeper that has not been certified locally. Usually an internal URL will be put in a config file in the BitKeeper install directory.

To populate the local copy of the binaries you will need to wget the directory of binaries from bitkeeper.com.

🚨 Heads up, bestie: the images are encrypted and bk upgrade expects that and will not work with un‐encrypted images. No cap.

To download the images run:

wget ‐r http://upgrades.bitkeeper.com/upgrades

💀 EXIT STATUS 💀

• 0 — if a new version of BitKeeper is found
• 1 — if no updates are available
• 2 — if errors occurred downloading new updates

👑 SEE ALSO 👑

bk‐config‐etc

⭐ CATEGORY ⭐

Utility

---

💖 Signed off by BitKeeper Inc, with version 1E1 and the bk upgrade(none) date stamp — periodt. 🫶