Skip to content

DAOS-18907 doc: markdown fixes (#18174)#18189

Open
Michael-Hennecke wants to merge 1 commit intorelease/2.6from
michael-hennecke/26/DAOS-18907
Open

DAOS-18907 doc: markdown fixes (#18174)#18189
Michael-Hennecke wants to merge 1 commit intorelease/2.6from
michael-hennecke/26/DAOS-18907

Conversation

@Michael-Hennecke
Copy link
Copy Markdown
Collaborator

markdown fixes in admin guide docs
(unclean cherry-picking commit a5d8bfa, reverting some contents that does not apply to release/2.6)

Doc-only: true

markdown fixes in admin guide docs
(unclean cherry-picking commit a5d8bfa, reverting some
contents that does not apply to release/2.6)

Signed-off-by: Michael Hennecke <michael.hennecke@hpe.com>
@Michael-Hennecke Michael-Hennecke requested a review from a team as a code owner May 6, 2026 14:13
@Michael-Hennecke Michael-Hennecke added unclean-cherry-pick Indicates that a cherry-pick had merge conflicts that needed resolving. doc-only Changes only affect documentation, not code labels May 6, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 6, 2026

Ticket title is 'Document PMEM ADR failure recovery and safe use of pmempool'
Status is 'Open'
Labels: 'triaged'
https://daosio.atlassian.net/browse/DAOS-18907


1. Stop I/O and safely shut down all `daos_server` and `daos_agent` processes.
2. Update the `mgmt_svc_replicas` list in the `daos_server` configuration file.
2. Update the `access_points` list in the `daos_server` configuration file.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Just for confirmation, the name change from access_points to mgmt_svc_replica has not been done in 2.6 ?

|DAOS\_SCHED\_RELAX\_INTVL|CPU relax interval in milliseconds. INTEGER. Default to 1 ms.|
|DAOS\_STRICT\_SHUTDOWN|Use the strict mode when shutting down engines. BOOL. Default to 0. In the strict mode, when certain resource leaks are detected, for instance, the engine will raise an assertion failure.|
|DAOS\_DTX\_AGG\_THD\_CNT|DTX aggregation count threshold. The valid range is [2^20, 2^24]. The default value is 2^19*7.|
|DAOS\_DTX\_AGG\_THD\_CNT|DTX aggregation count threshold. The valid range is [2^20, 2^24]. The default value is 2^19.|
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Sound strange to have a default value outside of the allowed range

Exclusion may compromise the Pool Redundancy Factor (RF), potentially leading
to data loss. If this is the case, the command will refuse to perform the exclusion
and return the error code -DER_RF. You can proceed with the exclusion by specifying
and return the error code -DER\_RF. You can proceed with the exclusion by specifying
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
and return the error code -DER\_RF. You can proceed with the exclusion by specifying
and return the error code `-DER_RF`. You can proceed with the exclusion by specifying

data would not be integrated into a rebuild and would be lost.
Drain operation is not allowed if there are other ongoing rebuild operations, otherwise
it will return -DER_BUSY.
it will return -DER\_BUSY.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
it will return -DER\_BUSY.
it will return `-DER_BUSY`.

supplying a target idx list, or reintegrate an entire engine rank by omitting the list.
Reintegrate operation is not allowed if there are other ongoing rebuild operations,
otherwise it will return -DER_BUSY.
otherwise it will return -DER\_BUSY.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
otherwise it will return -DER\_BUSY.
otherwise it will return `-DER_BUSY.`

basis. In other words, each section under the `servers:` section must
have its own logging configuration. The `log_file` config parameter
is converted to a D_LOG_FILE environment variable value. For more
is converted to a D\_LOG\_FILE environment variable value. For more
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
is converted to a D\_LOG\_FILE environment variable value. For more
is converted to a `D_LOG_FILE` environment variable value. For more

facilities that can be defined on a per-project basis (such as those for
CaRT and DAOS). DD_SUBSYS can be used to set which subsystems to enable
logging. By default all subsystems are enabled ("DD_SUBSYS=all").
CaRT and DAOS). DD\_SUBSYS can be used to set which subsystems to enable
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
CaRT and DAOS). DD\_SUBSYS can be used to set which subsystems to enable
CaRT and DAOS). `DD_SUBSYS` can be used to set which subsystems to enable

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

Labels

doc-only Changes only affect documentation, not code unclean-cherry-pick Indicates that a cherry-pick had merge conflicts that needed resolving.

Development

Successfully merging this pull request may close these issues.

2 participants