bk upgrade(7.3ce) BitKeeper User's Manual bk upgrade(7.3ce)
NAME
bk upgrade - upgrade to, or check for, new versions of BitKeeper
SYNOPSIS
bk upgrade [-cdfq] [-a[<arch>]] [<srcurl>]
DESCRIPTION
The bk upgrade command contacts BitKeeper's servers using HTTP to see
if new versions of BitKeeper are available for download. If a new ver-
sion is found for this platform, then the image is downloaded and
installed, unless instructed otherwise with the options below.
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 plat-
form. 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 an warning message is
printed and the upgrade is aborted. The "-f" option allow
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 ver-
sion 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; the images are encrypted and
bk upgrade expects that and will not work with un-encrypted images.
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
BitKeeper Inc 1E1 bk upgrade(7.3ce)
Utility