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

Wei-Chiu Chuang updated HDDS-13208:
-----------------------------------
    Description: 
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.

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

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
>
> 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.



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

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to