[ 
https://issues.apache.org/jira/browse/HDDS-13208?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Wei-Chiu Chuang updated HDDS-13208:
-----------------------------------
    Description: 
I tried to find any reference to volumes in an Ozone Datanode, but couldn't 
find any.

https://ozone.apache.org/docs/edge/concept/datanodes.html

I want to add a section "Volume management" in Datanodes.md

We should
(1) explain what a volume is in the context of Ozone DataNode; do not confuse 
it with namespace volumes in Ozone Manager. That a "volume" is essentially a 
disk, and a volume stores many containers.
(2) I wanted to also add descriptions for volume choosing policy. Find the 
description for the property hdds.datanode.volume.choosing.policy. There are 
two policies: CapacityVolumeChoosingPolicy (default) and 
RoundRobinVolumeChoosingPolicy. Use the source code as the source of truth to 
explain what they do and how they work.
(3) Create a table to include configuration properties related to volumes. 
Include default values and descriptions.
(3) Add a disk balancer description -- while volume choosing policy is useful, 
cluster operations can result in imbalanced disks. For example, in scenarios 
that we need to add new disks or to replace broken disks, the datanode's disks 
usage becomes uneven Ozone community is developing a new feature 'disk 
balancer' that aims to balance disks of Datanodes. The feature is under 
development of HDDS-5713, and is coming soon.

  was:
https://ozone.apache.org/docs/edge/concept/datanodes.html

I want to add a section "Volume management" under 
I tried to find any reference to volumes in an Ozone Datanode, but couldn't 
find any.

We should
(1) explain what a volume is in the context of Ozone DataNode; do not confuse 
it with namespace volumes in Ozone Manager. That a "volume" is essentially a 
disk, and a volume stores many containers.
(2) I wanted to also add descriptions for volume choosing policy. Find the 
description for the property hdds.datanode.volume.choosing.policy. There are 
two policies: CapacityVolumeChoosingPolicy (default) and 
RoundRobinVolumeChoosingPolicy. Use the source code as the source of truth to 
explain what they do and how they work.
(3) Create a table to include configuration properties related to volumes. 
Include default values and descriptions.
(3) Add a disk balancer description -- while volume choosing policy is useful, 
cluster operations can result in imbalanced disks. For example, in scenarios 
that we need to add new disks or to replace broken disks, the datanode's disks 
usage becomes uneven Ozone community is developing a new feature 'disk 
balancer' that aims to balance disks of Datanodes. The feature is under 
development of HDDS-5713, and is coming soon.


> [Docs] Add volume management section under Architecture/Datanodes
> -----------------------------------------------------------------
>
>                 Key: HDDS-13208
>                 URL: https://issues.apache.org/jira/browse/HDDS-13208
>             Project: Apache Ozone
>          Issue Type: Task
>          Components: documentation
>            Reporter: Wei-Chiu Chuang
>            Assignee: Wei-Chiu Chuang
>            Priority: Major
>
> I tried to find any reference to volumes in an Ozone Datanode, but couldn't 
> find any.
> https://ozone.apache.org/docs/edge/concept/datanodes.html
> I want to add a section "Volume management" in Datanodes.md
> We should
> (1) explain what a volume is in the context of Ozone DataNode; do not confuse 
> it with namespace volumes in Ozone Manager. That a "volume" is essentially a 
> disk, and a volume stores many containers.
> (2) I wanted to also add descriptions for volume choosing policy. Find the 
> description for the property hdds.datanode.volume.choosing.policy. There are 
> two policies: CapacityVolumeChoosingPolicy (default) and 
> RoundRobinVolumeChoosingPolicy. Use the source code as the source of truth to 
> explain what they do and how they work.
> (3) Create a table to include configuration properties related to volumes. 
> Include default values and descriptions.
> (3) Add a disk balancer description -- while volume choosing policy is 
> useful, cluster operations can result in imbalanced disks. For example, in 
> scenarios that we need to add new disks or to replace broken disks, the 
> datanode's disks usage becomes uneven Ozone community is developing a new 
> feature 'disk balancer' that aims to balance disks of Datanodes. The feature 
> is under development of HDDS-5713, and is coming soon.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@ozone.apache.org
For additional commands, e-mail: issues-h...@ozone.apache.org

Reply via email to