|
|
#require no-reposimplestore
|
|
|
|
|
|
$ cat >> $HGRCPATH << EOF
|
|
|
> [extensions]
|
|
|
> share =
|
|
|
> EOF
|
|
|
|
|
|
store and revlogv1 are required in source
|
|
|
|
|
|
$ hg --config format.usestore=false init no-store
|
|
|
$ hg -R no-store debugupgraderepo
|
|
|
abort: cannot upgrade repository; requirement missing: store
|
|
|
[255]
|
|
|
|
|
|
$ hg init no-revlogv1
|
|
|
$ cat > no-revlogv1/.hg/requires << EOF
|
|
|
> dotencode
|
|
|
> fncache
|
|
|
> generaldelta
|
|
|
> store
|
|
|
> EOF
|
|
|
|
|
|
$ hg -R no-revlogv1 debugupgraderepo
|
|
|
abort: cannot upgrade repository; requirement missing: revlogv1
|
|
|
[255]
|
|
|
|
|
|
Cannot upgrade shared repositories
|
|
|
|
|
|
$ hg init share-parent
|
|
|
$ hg -q share share-parent share-child
|
|
|
|
|
|
$ hg -R share-child debugupgraderepo
|
|
|
abort: cannot upgrade repository; unsupported source requirement: shared
|
|
|
[255]
|
|
|
|
|
|
Do not yet support upgrading treemanifest repos
|
|
|
|
|
|
$ hg --config experimental.treemanifest=true init treemanifest
|
|
|
$ hg -R treemanifest debugupgraderepo
|
|
|
abort: cannot upgrade repository; unsupported source requirement: treemanifest
|
|
|
[255]
|
|
|
|
|
|
Cannot add treemanifest requirement during upgrade
|
|
|
|
|
|
$ hg init disallowaddedreq
|
|
|
$ hg -R disallowaddedreq --config experimental.treemanifest=true debugupgraderepo
|
|
|
abort: cannot upgrade repository; do not support adding requirement: treemanifest
|
|
|
[255]
|
|
|
|
|
|
An upgrade of a repository created with recommended settings only suggests optimizations
|
|
|
|
|
|
$ hg init empty
|
|
|
$ cd empty
|
|
|
$ hg debugformat
|
|
|
format-variant repo
|
|
|
fncache: yes
|
|
|
dotencode: yes
|
|
|
generaldelta: yes
|
|
|
sparserevlog: yes
|
|
|
plain-cl-delta: yes
|
|
|
compression: zlib
|
|
|
compression-level: default
|
|
|
$ hg debugformat --verbose
|
|
|
format-variant repo config default
|
|
|
fncache: yes yes yes
|
|
|
dotencode: yes yes yes
|
|
|
generaldelta: yes yes yes
|
|
|
sparserevlog: yes yes yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zlib zlib zlib
|
|
|
compression-level: default default default
|
|
|
$ hg debugformat --verbose --config format.usefncache=no
|
|
|
format-variant repo config default
|
|
|
fncache: yes no yes
|
|
|
dotencode: yes no yes
|
|
|
generaldelta: yes yes yes
|
|
|
sparserevlog: yes yes yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zlib zlib zlib
|
|
|
compression-level: default default default
|
|
|
$ hg debugformat --verbose --config format.usefncache=no --color=debug
|
|
|
format-variant repo config default
|
|
|
[formatvariant.name.mismatchconfig|fncache: ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special| no][formatvariant.default| yes]
|
|
|
[formatvariant.name.mismatchconfig|dotencode: ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special| no][formatvariant.default| yes]
|
|
|
[formatvariant.name.uptodate|generaldelta: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
|
|
|
[formatvariant.name.uptodate|sparserevlog: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
|
|
|
[formatvariant.name.uptodate|plain-cl-delta: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
|
|
|
[formatvariant.name.uptodate|compression: ][formatvariant.repo.uptodate| zlib][formatvariant.config.default| zlib][formatvariant.default| zlib]
|
|
|
[formatvariant.name.uptodate|compression-level:][formatvariant.repo.uptodate| default][formatvariant.config.default| default][formatvariant.default| default]
|
|
|
$ hg debugformat -Tjson
|
|
|
[
|
|
|
{
|
|
|
"config": true,
|
|
|
"default": true,
|
|
|
"name": "fncache",
|
|
|
"repo": true
|
|
|
},
|
|
|
{
|
|
|
"config": true,
|
|
|
"default": true,
|
|
|
"name": "dotencode",
|
|
|
"repo": true
|
|
|
},
|
|
|
{
|
|
|
"config": true,
|
|
|
"default": true,
|
|
|
"name": "generaldelta",
|
|
|
"repo": true
|
|
|
},
|
|
|
{
|
|
|
"config": true,
|
|
|
"default": true,
|
|
|
"name": "sparserevlog",
|
|
|
"repo": true
|
|
|
},
|
|
|
{
|
|
|
"config": true,
|
|
|
"default": true,
|
|
|
"name": "plain-cl-delta",
|
|
|
"repo": true
|
|
|
},
|
|
|
{
|
|
|
"config": "zlib",
|
|
|
"default": "zlib",
|
|
|
"name": "compression",
|
|
|
"repo": "zlib"
|
|
|
},
|
|
|
{
|
|
|
"config": "default",
|
|
|
"default": "default",
|
|
|
"name": "compression-level",
|
|
|
"repo": "default"
|
|
|
}
|
|
|
]
|
|
|
$ hg debugupgraderepo
|
|
|
(no feature deficiencies found in existing repository)
|
|
|
performing an upgrade with "--run" will make the following changes:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
additional optimizations are available by specifying "--optimize <name>":
|
|
|
|
|
|
re-delta-parent
|
|
|
deltas within internal storage will be recalculated to choose an optimal base revision where this was not already done; the size of the repository may shrink and various operations may become faster; the first time this optimization is performed could slow down upgrade execution considerably; subsequent invocations should not run noticeably slower
|
|
|
|
|
|
re-delta-multibase
|
|
|
deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges
|
|
|
|
|
|
re-delta-all
|
|
|
deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed
|
|
|
|
|
|
re-delta-fulladd
|
|
|
every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.
|
|
|
|
|
|
|
|
|
--optimize can be used to add optimizations
|
|
|
|
|
|
$ hg debugupgrade --optimize redeltaparent
|
|
|
(no feature deficiencies found in existing repository)
|
|
|
performing an upgrade with "--run" will make the following changes:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
re-delta-parent
|
|
|
deltas within internal storage will choose a new base revision if needed
|
|
|
|
|
|
additional optimizations are available by specifying "--optimize <name>":
|
|
|
|
|
|
re-delta-multibase
|
|
|
deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges
|
|
|
|
|
|
re-delta-all
|
|
|
deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed
|
|
|
|
|
|
re-delta-fulladd
|
|
|
every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.
|
|
|
|
|
|
|
|
|
modern form of the option
|
|
|
|
|
|
$ hg debugupgrade --optimize re-delta-parent
|
|
|
(no feature deficiencies found in existing repository)
|
|
|
performing an upgrade with "--run" will make the following changes:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
re-delta-parent
|
|
|
deltas within internal storage will choose a new base revision if needed
|
|
|
|
|
|
additional optimizations are available by specifying "--optimize <name>":
|
|
|
|
|
|
re-delta-multibase
|
|
|
deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges
|
|
|
|
|
|
re-delta-all
|
|
|
deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed
|
|
|
|
|
|
re-delta-fulladd
|
|
|
every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.
|
|
|
|
|
|
|
|
|
unknown optimization:
|
|
|
|
|
|
$ hg debugupgrade --optimize foobar
|
|
|
abort: unknown optimization action requested: foobar
|
|
|
(run without arguments to see valid optimizations)
|
|
|
[255]
|
|
|
|
|
|
Various sub-optimal detections work
|
|
|
|
|
|
$ cat > .hg/requires << EOF
|
|
|
> revlogv1
|
|
|
> store
|
|
|
> EOF
|
|
|
|
|
|
$ hg debugformat
|
|
|
format-variant repo
|
|
|
fncache: no
|
|
|
dotencode: no
|
|
|
generaldelta: no
|
|
|
sparserevlog: no
|
|
|
plain-cl-delta: yes
|
|
|
compression: zlib
|
|
|
compression-level: default
|
|
|
$ hg debugformat --verbose
|
|
|
format-variant repo config default
|
|
|
fncache: no yes yes
|
|
|
dotencode: no yes yes
|
|
|
generaldelta: no yes yes
|
|
|
sparserevlog: no yes yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zlib zlib zlib
|
|
|
compression-level: default default default
|
|
|
$ hg debugformat --verbose --config format.usegeneraldelta=no
|
|
|
format-variant repo config default
|
|
|
fncache: no yes yes
|
|
|
dotencode: no yes yes
|
|
|
generaldelta: no no yes
|
|
|
sparserevlog: no no yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zlib zlib zlib
|
|
|
compression-level: default default default
|
|
|
$ hg debugformat --verbose --config format.usegeneraldelta=no --color=debug
|
|
|
format-variant repo config default
|
|
|
[formatvariant.name.mismatchconfig|fncache: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes]
|
|
|
[formatvariant.name.mismatchconfig|dotencode: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes]
|
|
|
[formatvariant.name.mismatchdefault|generaldelta: ][formatvariant.repo.mismatchdefault| no][formatvariant.config.special| no][formatvariant.default| yes]
|
|
|
[formatvariant.name.mismatchdefault|sparserevlog: ][formatvariant.repo.mismatchdefault| no][formatvariant.config.special| no][formatvariant.default| yes]
|
|
|
[formatvariant.name.uptodate|plain-cl-delta: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
|
|
|
[formatvariant.name.uptodate|compression: ][formatvariant.repo.uptodate| zlib][formatvariant.config.default| zlib][formatvariant.default| zlib]
|
|
|
[formatvariant.name.uptodate|compression-level:][formatvariant.repo.uptodate| default][formatvariant.config.default| default][formatvariant.default| default]
|
|
|
$ hg debugupgraderepo
|
|
|
repository lacks features recommended by current config options:
|
|
|
|
|
|
fncache
|
|
|
long and reserved filenames may not work correctly; repository performance is sub-optimal
|
|
|
|
|
|
dotencode
|
|
|
storage of filenames beginning with a period or space may not work correctly
|
|
|
|
|
|
generaldelta
|
|
|
deltas within internal storage are unable to choose optimal revisions; repository is larger and slower than it could be; interaction with other repositories may require extra network and CPU resources, making "hg push" and "hg pull" slower
|
|
|
|
|
|
sparserevlog
|
|
|
in order to limit disk reading and memory usage on older version, the span of a delta chain from its root to its end is limited, whatever the relevant data in this span. This can severly limit Mercurial ability to build good chain of delta resulting is much more storage space being taken and limit reusability of on disk delta during exchange.
|
|
|
|
|
|
|
|
|
performing an upgrade with "--run" will make the following changes:
|
|
|
|
|
|
requirements
|
|
|
preserved: revlogv1, store
|
|
|
added: dotencode, fncache, generaldelta, sparserevlog
|
|
|
|
|
|
fncache
|
|
|
repository will be more resilient to storing certain paths and performance of certain operations should be improved
|
|
|
|
|
|
dotencode
|
|
|
repository will be better able to store files beginning with a space or period
|
|
|
|
|
|
generaldelta
|
|
|
repository storage will be able to create optimal deltas; new repository data will be smaller and read times should decrease; interacting with other repositories using this storage model should require less network and CPU resources, making "hg push" and "hg pull" faster
|
|
|
|
|
|
sparserevlog
|
|
|
Revlog supports delta chain with more unused data between payload. These gaps will be skipped at read time. This allows for better delta chains, making a better compression and faster exchange with server.
|
|
|
|
|
|
additional optimizations are available by specifying "--optimize <name>":
|
|
|
|
|
|
re-delta-parent
|
|
|
deltas within internal storage will be recalculated to choose an optimal base revision where this was not already done; the size of the repository may shrink and various operations may become faster; the first time this optimization is performed could slow down upgrade execution considerably; subsequent invocations should not run noticeably slower
|
|
|
|
|
|
re-delta-multibase
|
|
|
deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges
|
|
|
|
|
|
re-delta-all
|
|
|
deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed
|
|
|
|
|
|
re-delta-fulladd
|
|
|
every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.
|
|
|
|
|
|
|
|
|
$ hg --config format.dotencode=false debugupgraderepo
|
|
|
repository lacks features recommended by current config options:
|
|
|
|
|
|
fncache
|
|
|
long and reserved filenames may not work correctly; repository performance is sub-optimal
|
|
|
|
|
|
generaldelta
|
|
|
deltas within internal storage are unable to choose optimal revisions; repository is larger and slower than it could be; interaction with other repositories may require extra network and CPU resources, making "hg push" and "hg pull" slower
|
|
|
|
|
|
sparserevlog
|
|
|
in order to limit disk reading and memory usage on older version, the span of a delta chain from its root to its end is limited, whatever the relevant data in this span. This can severly limit Mercurial ability to build good chain of delta resulting is much more storage space being taken and limit reusability of on disk delta during exchange.
|
|
|
|
|
|
repository lacks features used by the default config options:
|
|
|
|
|
|
dotencode
|
|
|
storage of filenames beginning with a period or space may not work correctly
|
|
|
|
|
|
|
|
|
performing an upgrade with "--run" will make the following changes:
|
|
|
|
|
|
requirements
|
|
|
preserved: revlogv1, store
|
|
|
added: fncache, generaldelta, sparserevlog
|
|
|
|
|
|
fncache
|
|
|
repository will be more resilient to storing certain paths and performance of certain operations should be improved
|
|
|
|
|
|
generaldelta
|
|
|
repository storage will be able to create optimal deltas; new repository data will be smaller and read times should decrease; interacting with other repositories using this storage model should require less network and CPU resources, making "hg push" and "hg pull" faster
|
|
|
|
|
|
sparserevlog
|
|
|
Revlog supports delta chain with more unused data between payload. These gaps will be skipped at read time. This allows for better delta chains, making a better compression and faster exchange with server.
|
|
|
|
|
|
additional optimizations are available by specifying "--optimize <name>":
|
|
|
|
|
|
re-delta-parent
|
|
|
deltas within internal storage will be recalculated to choose an optimal base revision where this was not already done; the size of the repository may shrink and various operations may become faster; the first time this optimization is performed could slow down upgrade execution considerably; subsequent invocations should not run noticeably slower
|
|
|
|
|
|
re-delta-multibase
|
|
|
deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges
|
|
|
|
|
|
re-delta-all
|
|
|
deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed
|
|
|
|
|
|
re-delta-fulladd
|
|
|
every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.
|
|
|
|
|
|
|
|
|
$ cd ..
|
|
|
|
|
|
Upgrading a repository that is already modern essentially no-ops
|
|
|
|
|
|
$ hg init modern
|
|
|
$ hg -R modern debugupgraderepo --run
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/modern/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/modern/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/modern/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/modern/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
|
|
|
Upgrading a repository to generaldelta works
|
|
|
|
|
|
$ hg --config format.usegeneraldelta=false init upgradegd
|
|
|
$ cd upgradegd
|
|
|
$ touch f0
|
|
|
$ hg -q commit -A -m initial
|
|
|
$ touch f1
|
|
|
$ hg -q commit -A -m 'add f1'
|
|
|
$ hg -q up -r 0
|
|
|
$ touch f2
|
|
|
$ hg -q commit -A -m 'add f2'
|
|
|
|
|
|
$ hg debugupgraderepo --run --config format.sparse-revlog=false
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, revlogv1, store
|
|
|
added: generaldelta
|
|
|
|
|
|
generaldelta
|
|
|
repository storage will be able to create optimal deltas; new repository data will be smaller and read times should decrease; interacting with other repositories using this storage model should require less network and CPU resources, making "hg push" and "hg pull" faster
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/upgradegd/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 9 total revisions (3 in filelogs, 3 in manifests, 3 in changelog)
|
|
|
migrating 917 bytes in store; 401 bytes tracked data
|
|
|
migrating 3 filelogs containing 3 revisions (192 bytes in store; 0 bytes tracked data)
|
|
|
finished migrating 3 filelog revisions across 3 filelogs; change in size: 0 bytes
|
|
|
migrating 1 manifests containing 3 revisions (349 bytes in store; 220 bytes tracked data)
|
|
|
finished migrating 3 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 3 revisions (376 bytes in store; 181 bytes tracked data)
|
|
|
finished migrating 3 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 9 total revisions; total change in store size: 0 bytes
|
|
|
copying phaseroots
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/upgradegd/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/upgradegd/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/upgradegd/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
|
|
|
Original requirements backed up
|
|
|
|
|
|
$ cat .hg/upgradebackup.*/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
revlogv1
|
|
|
store
|
|
|
|
|
|
generaldelta added to original requirements files
|
|
|
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlogv1
|
|
|
store
|
|
|
|
|
|
store directory has files we expect
|
|
|
|
|
|
$ ls .hg/store
|
|
|
00changelog.i
|
|
|
00manifest.i
|
|
|
data
|
|
|
fncache
|
|
|
phaseroots
|
|
|
undo
|
|
|
undo.backupfiles
|
|
|
undo.phaseroots
|
|
|
|
|
|
manifest should be generaldelta
|
|
|
|
|
|
$ hg debugrevlog -m | grep flags
|
|
|
flags : inline, generaldelta
|
|
|
|
|
|
verify should be happy
|
|
|
|
|
|
$ hg verify
|
|
|
checking changesets
|
|
|
checking manifests
|
|
|
crosschecking files in changesets and manifests
|
|
|
checking files
|
|
|
checked 3 changesets with 3 changes to 3 files
|
|
|
|
|
|
old store should be backed up
|
|
|
|
|
|
$ ls -d .hg/upgradebackup.*/
|
|
|
.hg/upgradebackup.*/ (glob)
|
|
|
$ ls .hg/upgradebackup.*/store
|
|
|
00changelog.i
|
|
|
00manifest.i
|
|
|
data
|
|
|
fncache
|
|
|
phaseroots
|
|
|
undo
|
|
|
undo.backup.fncache
|
|
|
undo.backupfiles
|
|
|
undo.phaseroots
|
|
|
|
|
|
unless --no-backup is passed
|
|
|
|
|
|
$ rm -rf .hg/upgradebackup.*/
|
|
|
$ hg debugupgraderepo --run --no-backup
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, store
|
|
|
added: sparserevlog
|
|
|
|
|
|
sparserevlog
|
|
|
Revlog supports delta chain with more unused data between payload. These gaps will be skipped at read time. This allows for better delta chains, making a better compression and faster exchange with server.
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/upgradegd/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 9 total revisions (3 in filelogs, 3 in manifests, 3 in changelog)
|
|
|
migrating 917 bytes in store; 401 bytes tracked data
|
|
|
migrating 3 filelogs containing 3 revisions (192 bytes in store; 0 bytes tracked data)
|
|
|
finished migrating 3 filelog revisions across 3 filelogs; change in size: 0 bytes
|
|
|
migrating 1 manifests containing 3 revisions (349 bytes in store; 220 bytes tracked data)
|
|
|
finished migrating 3 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 3 revisions (376 bytes in store; 181 bytes tracked data)
|
|
|
finished migrating 3 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 9 total revisions; total change in store size: 0 bytes
|
|
|
copying phaseroots
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/upgradegd/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for * (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing old repository content$TESTTMP/upgradegd/.hg/upgradebackup.* (glob)
|
|
|
removing temporary repository $TESTTMP/upgradegd/.hg/upgrade.* (glob)
|
|
|
$ ls -1 .hg/ | grep upgradebackup
|
|
|
[1]
|
|
|
$ cd ..
|
|
|
|
|
|
|
|
|
store files with special filenames aren't encoded during copy
|
|
|
|
|
|
$ hg init store-filenames
|
|
|
$ cd store-filenames
|
|
|
$ touch foo
|
|
|
$ hg -q commit -A -m initial
|
|
|
$ touch .hg/store/.XX_special_filename
|
|
|
|
|
|
$ hg debugupgraderepo --run
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/store-filenames/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 3 total revisions (1 in filelogs, 1 in manifests, 1 in changelog)
|
|
|
migrating 301 bytes in store; 107 bytes tracked data
|
|
|
migrating 1 filelogs containing 1 revisions (64 bytes in store; 0 bytes tracked data)
|
|
|
finished migrating 1 filelog revisions across 1 filelogs; change in size: 0 bytes
|
|
|
migrating 1 manifests containing 1 revisions (110 bytes in store; 45 bytes tracked data)
|
|
|
finished migrating 1 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 1 revisions (127 bytes in store; 62 bytes tracked data)
|
|
|
finished migrating 1 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 3 total revisions; total change in store size: 0 bytes
|
|
|
copying .XX_special_filename
|
|
|
copying phaseroots
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/store-filenames/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/store-filenames/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/store-filenames/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
$ hg debugupgraderepo --run --optimize redeltafulladd
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
re-delta-fulladd
|
|
|
each revision will be added as new content to the internal storage; this will likely drastically slow down execution time, but some extensions might need it
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/store-filenames/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 3 total revisions (1 in filelogs, 1 in manifests, 1 in changelog)
|
|
|
migrating 301 bytes in store; 107 bytes tracked data
|
|
|
migrating 1 filelogs containing 1 revisions (64 bytes in store; 0 bytes tracked data)
|
|
|
finished migrating 1 filelog revisions across 1 filelogs; change in size: 0 bytes
|
|
|
migrating 1 manifests containing 1 revisions (110 bytes in store; 45 bytes tracked data)
|
|
|
finished migrating 1 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 1 revisions (127 bytes in store; 62 bytes tracked data)
|
|
|
finished migrating 1 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 3 total revisions; total change in store size: 0 bytes
|
|
|
copying .XX_special_filename
|
|
|
copying phaseroots
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/store-filenames/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/store-filenames/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/store-filenames/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
|
|
|
fncache is valid after upgrade
|
|
|
|
|
|
$ hg debugrebuildfncache
|
|
|
fncache already up to date
|
|
|
|
|
|
$ cd ..
|
|
|
|
|
|
Check upgrading a large file repository
|
|
|
---------------------------------------
|
|
|
|
|
|
$ hg init largefilesrepo
|
|
|
$ cat << EOF >> largefilesrepo/.hg/hgrc
|
|
|
> [extensions]
|
|
|
> largefiles =
|
|
|
> EOF
|
|
|
|
|
|
$ cd largefilesrepo
|
|
|
$ touch foo
|
|
|
$ hg add --large foo
|
|
|
$ hg -q commit -m initial
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
largefiles
|
|
|
revlogv1
|
|
|
sparserevlog
|
|
|
store
|
|
|
|
|
|
$ hg debugupgraderepo --run
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, largefiles, revlogv1, sparserevlog, store
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/largefilesrepo/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 3 total revisions (1 in filelogs, 1 in manifests, 1 in changelog)
|
|
|
migrating 355 bytes in store; 160 bytes tracked data
|
|
|
migrating 1 filelogs containing 1 revisions (106 bytes in store; 41 bytes tracked data)
|
|
|
finished migrating 1 filelog revisions across 1 filelogs; change in size: 0 bytes
|
|
|
migrating 1 manifests containing 1 revisions (116 bytes in store; 51 bytes tracked data)
|
|
|
finished migrating 1 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 1 revisions (133 bytes in store; 68 bytes tracked data)
|
|
|
finished migrating 1 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 3 total revisions; total change in store size: 0 bytes
|
|
|
copying phaseroots
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/largefilesrepo/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/largefilesrepo/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/largefilesrepo/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
largefiles
|
|
|
revlogv1
|
|
|
sparserevlog
|
|
|
store
|
|
|
|
|
|
$ cat << EOF >> .hg/hgrc
|
|
|
> [extensions]
|
|
|
> lfs =
|
|
|
> [lfs]
|
|
|
> threshold = 10
|
|
|
> EOF
|
|
|
$ echo '123456789012345' > lfs.bin
|
|
|
$ hg ci -Am 'lfs.bin'
|
|
|
adding lfs.bin
|
|
|
$ grep lfs .hg/requires
|
|
|
lfs
|
|
|
$ find .hg/store/lfs -type f
|
|
|
.hg/store/lfs/objects/d0/beab232adff5ba365880366ad30b1edb85c4c5372442b5d2fe27adc96d653f
|
|
|
|
|
|
$ hg debugupgraderepo --run
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, largefiles, lfs, revlogv1, sparserevlog, store
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/largefilesrepo/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 6 total revisions (2 in filelogs, 2 in manifests, 2 in changelog)
|
|
|
migrating 801 bytes in store; 467 bytes tracked data
|
|
|
migrating 2 filelogs containing 2 revisions (296 bytes in store; 182 bytes tracked data)
|
|
|
finished migrating 2 filelog revisions across 2 filelogs; change in size: 0 bytes
|
|
|
migrating 1 manifests containing 2 revisions (241 bytes in store; 151 bytes tracked data)
|
|
|
finished migrating 2 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 2 revisions (264 bytes in store; 134 bytes tracked data)
|
|
|
finished migrating 2 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 6 total revisions; total change in store size: 0 bytes
|
|
|
copying phaseroots
|
|
|
copying lfs blob d0beab232adff5ba365880366ad30b1edb85c4c5372442b5d2fe27adc96d653f
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/largefilesrepo/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/largefilesrepo/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/largefilesrepo/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
|
|
|
$ grep lfs .hg/requires
|
|
|
lfs
|
|
|
$ find .hg/store/lfs -type f
|
|
|
.hg/store/lfs/objects/d0/beab232adff5ba365880366ad30b1edb85c4c5372442b5d2fe27adc96d653f
|
|
|
$ hg verify
|
|
|
checking changesets
|
|
|
checking manifests
|
|
|
crosschecking files in changesets and manifests
|
|
|
checking files
|
|
|
checked 2 changesets with 2 changes to 2 files
|
|
|
$ hg debugdata lfs.bin 0
|
|
|
version https://git-lfs.github.com/spec/v1
|
|
|
oid sha256:d0beab232adff5ba365880366ad30b1edb85c4c5372442b5d2fe27adc96d653f
|
|
|
size 16
|
|
|
x-is-binary 0
|
|
|
|
|
|
$ cd ..
|
|
|
|
|
|
repository config is taken in account
|
|
|
-------------------------------------
|
|
|
|
|
|
$ cat << EOF >> $HGRCPATH
|
|
|
> [format]
|
|
|
> maxchainlen = 1
|
|
|
> EOF
|
|
|
|
|
|
$ hg init localconfig
|
|
|
$ cd localconfig
|
|
|
$ cat << EOF > file
|
|
|
> some content
|
|
|
> with some length
|
|
|
> to make sure we get a delta
|
|
|
> after changes
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> very long
|
|
|
> EOF
|
|
|
$ hg -q commit -A -m A
|
|
|
$ echo "new line" >> file
|
|
|
$ hg -q commit -m B
|
|
|
$ echo "new line" >> file
|
|
|
$ hg -q commit -m C
|
|
|
|
|
|
$ cat << EOF >> .hg/hgrc
|
|
|
> [format]
|
|
|
> maxchainlen = 9001
|
|
|
> EOF
|
|
|
$ hg config format
|
|
|
format.maxchainlen=9001
|
|
|
$ hg debugdeltachain file
|
|
|
rev chain# chainlen prev delta size rawsize chainsize ratio lindist extradist extraratio readsize largestblk rddensity srchunks
|
|
|
0 1 1 -1 base 77 182 77 0.42308 77 0 0.00000 77 77 1.00000 1
|
|
|
1 1 2 0 p1 21 191 98 0.51309 98 0 0.00000 98 98 1.00000 1
|
|
|
2 1 2 0 other 30 200 107 0.53500 128 21 0.19626 128 128 0.83594 1
|
|
|
|
|
|
$ hg debugupgraderepo --run --optimize redeltaall
|
|
|
upgrade will perform the following actions:
|
|
|
|
|
|
requirements
|
|
|
preserved: dotencode, fncache, generaldelta, revlogv1, sparserevlog, store
|
|
|
|
|
|
re-delta-all
|
|
|
deltas within internal storage will be fully recomputed; this will likely drastically slow down execution time
|
|
|
|
|
|
beginning upgrade...
|
|
|
repository locked and read-only
|
|
|
creating temporary repository to stage migrated data: $TESTTMP/localconfig/.hg/upgrade.* (glob)
|
|
|
(it is safe to interrupt this process any time before data migration completes)
|
|
|
migrating 9 total revisions (3 in filelogs, 3 in manifests, 3 in changelog)
|
|
|
migrating 1019 bytes in store; 882 bytes tracked data
|
|
|
migrating 1 filelogs containing 3 revisions (320 bytes in store; 573 bytes tracked data)
|
|
|
finished migrating 3 filelog revisions across 1 filelogs; change in size: -9 bytes
|
|
|
migrating 1 manifests containing 3 revisions (333 bytes in store; 138 bytes tracked data)
|
|
|
finished migrating 3 manifest revisions across 1 manifests; change in size: 0 bytes
|
|
|
migrating changelog containing 3 revisions (366 bytes in store; 171 bytes tracked data)
|
|
|
finished migrating 3 changelog revisions; change in size: 0 bytes
|
|
|
finished migrating 9 total revisions; total change in store size: -9 bytes
|
|
|
copying phaseroots
|
|
|
data fully migrated to temporary repository
|
|
|
marking source repository as being upgraded; clients will be unable to read from repository
|
|
|
starting in-place swap of repository data
|
|
|
replaced files will be backed up at $TESTTMP/localconfig/.hg/upgradebackup.* (glob)
|
|
|
replacing store...
|
|
|
store replacement complete; repository was inconsistent for *s (glob)
|
|
|
finalizing requirements file and making repository readable again
|
|
|
removing temporary repository $TESTTMP/localconfig/.hg/upgrade.* (glob)
|
|
|
copy of old repository backed up at $TESTTMP/localconfig/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
$ hg debugdeltachain file
|
|
|
rev chain# chainlen prev delta size rawsize chainsize ratio lindist extradist extraratio readsize largestblk rddensity srchunks
|
|
|
0 1 1 -1 base 77 182 77 0.42308 77 0 0.00000 77 77 1.00000 1
|
|
|
1 1 2 0 p1 21 191 98 0.51309 98 0 0.00000 98 98 1.00000 1
|
|
|
2 1 3 1 p1 21 200 119 0.59500 119 0 0.00000 119 119 1.00000 1
|
|
|
$ cd ..
|
|
|
|
|
|
$ cat << EOF >> $HGRCPATH
|
|
|
> [format]
|
|
|
> maxchainlen = 9001
|
|
|
> EOF
|
|
|
|
|
|
Check upgrading a sparse-revlog repository
|
|
|
---------------------------------------
|
|
|
|
|
|
$ hg init sparserevlogrepo --config format.sparse-revlog=no
|
|
|
$ cd sparserevlogrepo
|
|
|
$ touch foo
|
|
|
$ hg add foo
|
|
|
$ hg -q commit -m "foo"
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlogv1
|
|
|
store
|
|
|
|
|
|
Check that we can add the sparse-revlog format requirement
|
|
|
$ hg --config format.sparse-revlog=yes debugupgraderepo --run >/dev/null
|
|
|
copy of old repository backed up at $TESTTMP/sparserevlogrepo/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlogv1
|
|
|
sparserevlog
|
|
|
store
|
|
|
|
|
|
Check that we can remove the sparse-revlog format requirement
|
|
|
$ hg --config format.sparse-revlog=no debugupgraderepo --run >/dev/null
|
|
|
copy of old repository backed up at $TESTTMP/sparserevlogrepo/.hg/upgradebackup.* (glob)
|
|
|
the old repository will not be deleted; remove it to free up disk space once the upgraded repository is verified
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlogv1
|
|
|
store
|
|
|
|
|
|
#if zstd
|
|
|
|
|
|
Check upgrading to a zstd revlog
|
|
|
--------------------------------
|
|
|
|
|
|
upgrade
|
|
|
|
|
|
$ hg --config format.revlog-compression=zstd debugupgraderepo --run --no-backup >/dev/null
|
|
|
$ hg debugformat -v
|
|
|
format-variant repo config default
|
|
|
fncache: yes yes yes
|
|
|
dotencode: yes yes yes
|
|
|
generaldelta: yes yes yes
|
|
|
sparserevlog: yes yes yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zstd zlib zlib
|
|
|
compression-level: default default default
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlog-compression-zstd
|
|
|
revlogv1
|
|
|
sparserevlog
|
|
|
store
|
|
|
|
|
|
downgrade
|
|
|
|
|
|
$ hg debugupgraderepo --run --no-backup > /dev/null
|
|
|
$ hg debugformat -v
|
|
|
format-variant repo config default
|
|
|
fncache: yes yes yes
|
|
|
dotencode: yes yes yes
|
|
|
generaldelta: yes yes yes
|
|
|
sparserevlog: yes yes yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zlib zlib zlib
|
|
|
compression-level: default default default
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlogv1
|
|
|
sparserevlog
|
|
|
store
|
|
|
|
|
|
upgrade from hgrc
|
|
|
|
|
|
$ cat >> .hg/hgrc << EOF
|
|
|
> [format]
|
|
|
> revlog-compression=zstd
|
|
|
> EOF
|
|
|
$ hg debugupgraderepo --run --no-backup > /dev/null
|
|
|
$ hg debugformat -v
|
|
|
format-variant repo config default
|
|
|
fncache: yes yes yes
|
|
|
dotencode: yes yes yes
|
|
|
generaldelta: yes yes yes
|
|
|
sparserevlog: yes yes yes
|
|
|
plain-cl-delta: yes yes yes
|
|
|
compression: zstd zstd zlib
|
|
|
compression-level: default default default
|
|
|
$ cat .hg/requires
|
|
|
dotencode
|
|
|
fncache
|
|
|
generaldelta
|
|
|
revlog-compression-zstd
|
|
|
revlogv1
|
|
|
sparserevlog
|
|
|
store
|
|
|
|
|
|
$ cd ..
|
|
|
|
|
|
#endif
|
|
|
|
