Page MenuHomePhabricator

Migrating Repository Shards
Updated 18 Days AgoPublic

  • Create the new shard (repo123.phacility.net) and service (repox123.phacility.net) following Adding Hardware.
  • Add the new service (repox123.phacility.net) to the instance.
  • Disable allocations on the old service (repox000.phacility.net).
admin/ $ PHABRICATOR_INSTANCE=admin /core/lib/instances/bin/instances set-service-property \
  --instance turtle --service repox000.phacility.net --key disable-allocations --value true
  • Review service configuration in web UI.
  • Sync services.

The instance is now running with two repository service shards, and only the new shard accepts new allocations. This is a stable state. From here, we'd like to migrate existing repositories to the new shard.

For each repository (from bin/repository list), save the state:

src/ $ PHABRICATOR_INSTANCE=turtle /core/lib/services/bin/services save-repository \
    --repository rXYZ --maintenance <message>

...then load it on the destination shard:

dst/ $ PHABRICATOR_INSTANCE=turtle /core/lib/services/bin/services load-repository \
    --repository rXYZ --file <phid> --activate-device repo123.phacility.net

Once this is finished:

  • Disable daemons on the old shard.
admin/ $ PHABRICATOR_INSTANCE=admin /core/lib/instances/bin/instances set-service-property \
  --instance turtle --service repox000.phacility.net --key disable-daemons --value true
  • Synchronize services.

For historical context, see T13393.

Last Author
epriestley
Last Edited
Sat, Sep 28, 2:59 PM

Event Timeline

epriestley edited the content of this document. (Show Details)Sat, Sep 28, 2:59 PM
epriestley created this object.
epriestley added a project: Phacility.