Skip to content

Conversation

@vyalamar
Copy link

@vyalamar vyalamar commented Jan 5, 2026

What changes were proposed in this pull request?

This PR improves the Dynamic Property Reload (Reconfigurability) documentation:

  1. Renamed title from "Reconfigurability" to "Dynamic Property Reload" per the JIRA task
  2. Added comprehensive reference tables listing all reconfigurable properties for OM, SCM, and DataNode (previously only showed ozone.administrators)
  3. Fixed typo in SCM section (incorrectly showed "Started OM reconfiguration" instead of "Started reconfiguration")
  4. Replaced placeholder ozone.example.config with actual DataNode property hdds.datanode.block.deleting.limit.per.interval
  5. Added Best Practices section for operators
  6. Improved formatting with proper markdown tables and code blocks
  7. Updated Chinese translation with the same placeholder fix

What is the link to the Apache JIRA

https://issues.apache.org/jira/browse/HDDS-14293

How was this patch tested?

This is a documentation-only change. Verified that the markdown renders correctly locally.

Copy link
Contributor

@sreejasahithi sreejasahithi left a comment

Choose a reason for hiding this comment

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

Thanks @vyalamar for working on this, left few comments

sreejasahithi

This comment was marked as duplicate.

- Added ozone.readonly.administrators to OM and SCM
- Added ozone.key.deleting.limit.per.task to OM
- Added ozone.directory.deleting.service.interval to OM
- Added ozone.thread.number.dir.deletion to OM
- Added ozone.snapshot.filtering.service.interval to OM
- Added hdds.datanode.block.delete.threads.max to Datanode
- Added ozone.block.deleting.service.workers to Datanode
- Added ozone.block.deleting.service.interval to Datanode
- Added ozone.block.deleting.service.timeout to Datanode
- Added hdds.datanode.replication.streams.limit to Datanode
@vyalamar
Copy link
Author

vyalamar commented Jan 5, 2026

@sreejasahithi Can you please check. I have addressed all your comments.

@vyalamar
Copy link
Author

vyalamar commented Jan 5, 2026

@sreejasahithi Can you please look into apache/ozone-site#217

@adoroszlai adoroszlai added the documentation Improvements or additions to documentation label Jan 5, 2026
Copy link
Contributor

@sreejasahithi sreejasahithi left a comment

Choose a reason for hiding this comment

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

Thanks @vyalamar for updating the patch. Left few minor comments

Could you please also add in the doc that --address must be specified if --in-service-datanodes is not given.(even though your examples do show this)


```shell
$ ozone admin reconfig --service=DATANODE --in-service-datanodes properties
Datanode: Node [hadoop1:19864] Reconfigurable properties:
Copy link
Contributor

Choose a reason for hiding this comment

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

it should be

Suggested change
Datanode: Node [hadoop1:19864] Reconfigurable properties:
DN: Node [hadoop1:19864] Reconfigurable properties:

command:
```shell
ozone admin reconfig --service=[OM|SCM|DATANODE] --address=<ip:port> start|status|properties
ozone admin reconfig --service=[OM|SCM|DATANODE] --address=<ip:port> <operation>
Copy link
Contributor

Choose a reason for hiding this comment

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

--address can be <ip:port> or <hostname:port>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants