From cddee121798cee37bcd1c6a4574c1306043c71a2 Mon Sep 17 00:00:00 2001 From: "Martin Jaime Flores Jr." Date: Fri, 22 May 2026 14:12:22 -0500 Subject: [PATCH] [irods/irods_7984] Document rebalance with partial success, commands to query replicas --- docs/plugins/composable_resources.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/plugins/composable_resources.md b/docs/plugins/composable_resources.md index 34d7abb..528cfcb 100644 --- a/docs/plugins/composable_resources.md +++ b/docs/plugins/composable_resources.md @@ -476,3 +476,15 @@ META_RESC_ATTR_UNITS = 20180203T140006Z ``` When a rebalance completes successfully, the timestamp AVU is removed. + +If the rebalance operation encounters data objects that cannot be replicated, due to being stale or locked, a `-1834000 REBALANCE_NOT_COMPLETE` message will be displayed and a non-zero exit code is returned after replicating all remaining good data objects. Afterwards, the unreplicated data objects must be handled manually if replication is still desired. + +To find all data objects with replicas which are not marked "good": +``` +SELECT COLL_NAME, DATA_NAME WHERE DATA_REPL_STATUS != '1' +``` + +To get the number of data objects with replicas which are not marked "good": +``` +SELECT COUNT(DATA_COLL_ID) WHERE DATA_REPL_STATUS != '1' +```