RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2024-12-18 01:16:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #12370 from wido/docs-cephfs-disaster

Browse Source 
doc: Update CephFS disaster recovery documentation

Reviewed-by: John Spray <john.spray@redhat.com>
This commit is contained in:
John Spray 2017-02-17 16:59:35 +00:00 committed by GitHub
commit f5ac182cbd
2 changed files with 26 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/cephfs/disaster-recovery.rst
View File

@ -140,25 +140,37 @@ it into the metadata pool.
cephfs-data-scan scan_extents <data pool> cephfs-data-scan scan_extents <data pool>
cephfs-data-scan scan_inodes <data pool> cephfs-data-scan scan_inodes <data pool>
This command may take a very long time if there are many This command may take a *very long* time if there are many
files or very large files in the data pool. To accelerate files or very large files in the data pool.
the process, run multiple instances of the tool. Decide on
a number of workers, and pass each worker a number within To accelerate the process, run multiple instances of the tool.
the range 0-(N_workers - 1), like so:
Decide on a number of workers, and pass each worker a number within
the range 0-(worker_m - 1).
The example below shows how to run 4 workers simultaneously:
:: ::
# Worker 0 # Worker 0
cephfs-data-scan scan_extents --worker_n 0 --worker_m 1 <data pool> cephfs-data-scan scan_extents --worker_n 0 --worker_m 4 <data pool>
# Worker 1 # Worker 1
cephfs-data-scan scan_extents --worker_n 1 --worker_m 1<data pool> 1 1 cephfs-data-scan scan_extents --worker_n 1 --worker_m 4 <data pool>
# Worker 2
cephfs-data-scan scan_extents --worker_n 2 --worker_m 4 <data pool>
# Worker 3
cephfs-data-scan scan_extents --worker_n 3 --worker_m 4 <data pool>
# Worker 0 # Worker 0
cephfs-data-scan scan_inodes --worker_n 0 --worker_m 1 <data pool> cephfs-data-scan scan_inodes --worker_n 0 --worker_m 4 <data pool>
# Worker 1 # Worker 1
cephfs-data-scan scan_inodes --worker_n 1 --worker_m 1 <data pool> cephfs-data-scan scan_inodes --worker_n 1 --worker_m 4 <data pool>
# Worker 2
cephfs-data-scan scan_inodes --worker_n 2 --worker_m 4 <data pool>
# Worker 3
cephfs-data-scan scan_inodes --worker_n 3 --worker_m 4 <data pool>
It is important to ensure that all workers have completed the It is **important** to ensure that all workers have completed the
scan_extents phase before any workers enter the scan_inodes phase. scan_extents phase before any workers enter the scan_inodes phase.
After completing the metadata recovery, you may want to run cleanup After completing the metadata recovery, you may want to run cleanup

6
src/tools/cephfs/DataScan.cc
View File

@ -33,14 +33,16 @@ void DataScan::usage()
{ {
std::cout << "Usage: \n" std::cout << "Usage: \n"
<< " cephfs-data-scan init [--force-init]\n" << " cephfs-data-scan init [--force-init]\n"
<< " cephfs-data-scan scan_extents [--force-pool] <data pool name>\n" << " cephfs-data-scan scan_extents [--force-pool] [--worker_n N --worker_m M] <data pool name>\n"
<< " cephfs-data-scan scan_inodes [--force-pool] [--force-corrupt] <data pool name>\n" << " cephfs-data-scan scan_inodes [--force-pool] [--force-corrupt] [--worker_n N --worker_m M] <data pool name>\n"
<< " cephfs-data-scan pg_files <path> <pg id> [<pg id>...]\n" << " cephfs-data-scan pg_files <path> <pg id> [<pg id>...]\n"
<< " cephfs-data-scan scan_links\n" << " cephfs-data-scan scan_links\n"
<< "\n" << "\n"
<< " --force-corrupt: overrite apparently corrupt structures\n" << " --force-corrupt: overrite apparently corrupt structures\n"
<< " --force-init: write root inodes even if they exist\n" << " --force-init: write root inodes even if they exist\n"
<< " --force-pool: use data pool even if it is not in FSMap\n" << " --force-pool: use data pool even if it is not in FSMap\n"
<< " --worker_m: Maximum number of workers\n"
<< " --worker_n: Worker number, range 0-(worker_m-1)\n"
<< "\n" << "\n"
<< " cephfs-data-scan scan_frags [--force-corrupt]\n" << " cephfs-data-scan scan_frags [--force-corrupt]\n"
<< " cephfs-data-scan cleanup <data pool name>\n" << " cephfs-data-scan cleanup <data pool name>\n"