- Create the new shard (`repo123.phacility.net`) and service (`repox123.phacility.net`) following [[ phacility_cluster/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.