Skip to content

[irods/irods#7984] Document rebalance with partial success, commands to query replicas #424

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MartinFlores751 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[irods/irods#7984] Document rebalance with partial success, commands to query replicas #424

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs/plugins/composable_resources.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Copy link
Copy Markdown
Member

@trel trel May 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what non-zero error code? can we know and be explicit here?


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":
Comment on lines +482 to +487
Copy link
Copy Markdown
Contributor Author

@MartinFlores751 MartinFlores751 May 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider removing the quotations around good. That is the proper name of the replica status: https://docs.irods.org/5.0.2/system_overview/data_objects/#replica-status

Copy link
Copy Markdown
Member

@trel trel May 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the quotes are okay - or perhaps you're looking to make them backticks which makes it look like a literal or codename?

I think backticks could be more correct... please look around and compare to other places where we talk about replica statuses.

```
SELECT COUNT(DATA_COLL_ID) WHERE DATA_REPL_STATUS != '1'
Copy link
Copy Markdown
Contributor Author

@MartinFlores751 MartinFlores751 May 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if DATA_ID is more appropriate here, or if DATA_COLL_ID is what is best...

Copy link
Copy Markdown
Member

@trel trel May 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think DATA_ID is correct - that will match which data objects have non-good replicas...

DATA_COLL_ID will be the COLL_ID of the parent of the data objects in question... so I don't think that's right.

```
Loading