From ff8bb672000980f3de7391e5d268e789d5cbe974 Mon Sep 17 00:00:00 2001 From: Yiqun Lin Date: Wed, 1 Jul 2020 14:18:18 +0800 Subject: [PATCH] HDFS-15374. Add documentation for fedbalance tool. Contributed by Jinglun. --- hadoop-project/src/site/site.xml | 1 + .../site/markdown/HDFSFederationBalance.md | 171 ++++++++++++++++++ .../src/site/resources/css/site.css | 30 +++ .../images/BalanceProcedureScheduler.png | Bin 0 -> 48275 bytes 4 files changed, 202 insertions(+) create mode 100644 hadoop-tools/hadoop-federation-balance/src/site/markdown/HDFSFederationBalance.md create mode 100644 hadoop-tools/hadoop-federation-balance/src/site/resources/css/site.css create mode 100644 hadoop-tools/hadoop-federation-balance/src/site/resources/images/BalanceProcedureScheduler.png diff --git a/hadoop-project/src/site/site.xml b/hadoop-project/src/site/site.xml index c3c0f19319f..4c9d356e3e9 100644 --- a/hadoop-project/src/site/site.xml +++ b/hadoop-project/src/site/site.xml @@ -198,6 +198,7 @@ + diff --git a/hadoop-tools/hadoop-federation-balance/src/site/markdown/HDFSFederationBalance.md b/hadoop-tools/hadoop-federation-balance/src/site/markdown/HDFSFederationBalance.md new file mode 100644 index 00000000000..ff42eaf552e --- /dev/null +++ b/hadoop-tools/hadoop-federation-balance/src/site/markdown/HDFSFederationBalance.md @@ -0,0 +1,171 @@ + + +HDFS Federation Balance Guide +===================== + + + +Overview +-------- + + HDFS Federation Balance is a tool balancing data across different federation + namespaces. It uses [DistCp](../hadoop-distcp/DistCp.html) to copy data from + the source path to the target path. First it creates a snapshot at the source + path and submits the initial distcp. Second it uses distcp diff to do the + incremental copy until the source and the target are the same. Then If it's + working in RBF mode it updates the mount table in Router. Finally it moves the + source to trash. + + This document aims to describe the usage and design of the HDFS Federation + Balance. + +Usage +----- + +### Basic Usage + + The hdfs federation balance tool supports both normal federation cluster and + router-based federation cluster. Taking rbf for example. Supposing we have a + mount entry in Router: + + Source Destination + /foo/src hdfs://namespace-0/foo/src + + The command below runs an hdfs federation balance job. The first parameter is + the mount entry. The second one is the target path which must include the + target cluster. The option `-router` indicates this is in router-based + federation mode. + + bash$ /bin/hadoop fedbalance -router submit /foo/src hdfs://namespace-1/foo/dst + + It copies data from hdfs://namespace-0/foo/src to hdfs://namespace-1/foo/dst + incrementally and finally updates the mount entry to: + + Source Destination + /foo/src hdfs://namespace-1/foo/dst + + If the hadoop shell process exits unexpectedly, we can use the command below + to continue the unfinished job: + + bash$ /bin/hadoop fedbalance continue + + This will scan the journal to find all the unfinished jobs, recover and + continue to execute them. + + If we want to balance in a normal federation cluster, use the command below. + + bash$ /bin/hadoop fedbalance submit hdfs://namespace-0/foo/src hdfs://namespace-1/foo/dst + + In normal federation mode the source path must includes the path schema. + +### RBF Mode And Normal Federation Mode + + The hdfs federation balance tool has 2 modes: + + * the router-based federation mode (RBF mode). + * the normal federation mode. + + By default the command runs in the normal federation mode. You can specify the + rbf mode by using the option `-router`. + + In the rbf mode the first parameter is taken as the mount point. It disables + write by setting the mount point readonly. + + In the normal federation mode the first parameter is taken as the full path of + the source. The first parameter must include the source cluster. It disables + write by cancelling all the permissions of the source path. + + Details about disabling write see [HDFS FedBalance](#HDFS_FedBalance). + +### Command Options + +Command `submit` has 5 options: + +| Option key | Description | Default | +| ------------------------------ | ------------------------------------ | ------- | +| -router | Run in router-based federation mode. | Normal federation mode. | +| -forceCloseOpen | Force close all open files when there is no diff in the DIFF_DISTCP stage. | Wait until there is no open files. | +| -map | Max number of concurrent maps to use for copy. | 10 | +| -bandwidth | Specify bandwidth per map in MB. | 10 | +| -delay | Specify the delayed duration(millie seconds) when the job needs to retry. | 1000 | +| -moveToTrash | This options has 3 values: `trash` (move the source path to trash), `delete` (delete the source path directly) and `skip` (skip both trash and deletion). By default the server side trash interval is used. If the trash is disabled in the server side, the default trash interval 60 minutes is used. | trash | + +### Configuration Options +-------------------- + +Set configuration options at fedbalance-site.xml. + +| Configuration key | Description | Default | +| ------------------------------ | ------------------------------------ | ------- | +| hdfs.fedbalance.procedure.work.thread.num | The worker threads number of the BalanceProcedureScheduler. BalanceProcedureScheduler is responsible for scheduling a balance job, including submit, run, delay and recover. | 10 | +| hdfs.fedbalance.procedure.scheduler.journal.uri | The uri of the journal, the journal file is used for handling the job persistence and recover. | hdfs://localhost:8020/tmp/procedure | + +Architecture of HDFS Federation Balance +---------------------- + + The components of the HDFS Federation Balance can be classified into the + following categories: + + * Balance Procedure Scheduler + * HDFS FedBalance + +### Balance Procedure Scheduler + + The Balance Procedure Scheduler implements a state machine. It's responsible + for scheduling a balance job, including submit, run, delay and recover. + The model is showed below: + + ![Balance Procedure Scheduler](images/BalanceProcedureScheduler.png) + + * After a job is submitted, the job is added to the pendingQueue. + * The worker threads take jobs and run them. Journals are written to storage. + * If writing the journal fails, the job is added to the recoverQueue for later + recovery. If Worker thread catches a RetryTaskException, it adds the job to + the delayQueue. + * Rooster thread takes job from delayQueue and adds it back to pendingQueue. + * When a scheduler starts, it scans all the unfinished jobs from the journal + and add them to the recoverQueue. The recover thread will recover them from + the journal and add them back to the pendingQueue. + +### HDFS FedBalance + + HDFS FedBalance is implemented as a job of the state machine. All the distcp + balance logic are implemented here. An HDFS FedBalance job consists of 3 + procedures: + + * DistCpProcedure: This is the first procedure. It handles all the data copy + works. There are 6 stages: + * PRE_CHECK: Do the pre-check of the src and dst path. + * INIT_DISTCP: Create a snapshot of the source path and distcp it to the + target. + * DIFF_DISTCP: Submit distcp with `-diff` round by round to sync source and + target paths. If `-forceCloseOpen` is set, this stage will finish when + there is no diff between src and dst. Otherwise this stage only finishes + when there is no diff and no open files. + * DISABLE_WRITE: Disable write operations so the src won't be changed. When + working in router mode, it is done by making the mount point readonly. + In normal federation mode it is done by cancelling all the permissions of + the source path. + * FINAL_DISTCP: Force close all the open files and submit the final distcp. + * FINISH: Do the cleanup works. In normal federation mode the finish stage + also restores the permission of the dst path. + + * MountTableProcedure: This procedure updates the mount entry in Router. The + readonly is unset and the destination is updated of the mount point. This + procedure is activated only when option `-router`. + + * TrashProcedure: This procedure moves the source path to trash. + + After all 3 procedures finish, the balance job is done. \ No newline at end of file diff --git a/hadoop-tools/hadoop-federation-balance/src/site/resources/css/site.css b/hadoop-tools/hadoop-federation-balance/src/site/resources/css/site.css new file mode 100644 index 00000000000..f830baafa8c --- /dev/null +++ b/hadoop-tools/hadoop-federation-balance/src/site/resources/css/site.css @@ -0,0 +1,30 @@ +/* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed with +* this work for additional information regarding copyright ownership. +* The ASF licenses this file to You under the Apache License, Version 2.0 +* (the "License"); you may not use this file except in compliance with +* the License. You may obtain a copy of the License at +* +* http://www.apache.org/licenses/LICENSE-2.0 +* +* Unless required by applicable law or agreed to in writing, software +* distributed under the License is distributed on an "AS IS" BASIS, +* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +* See the License for the specific language governing permissions and +* limitations under the License. +*/ +#banner { + height: 93px; + background: none; +} + +#bannerLeft img { + margin-left: 30px; + margin-top: 10px; +} + +#bannerRight img { + margin: 17px; +} + diff --git a/hadoop-tools/hadoop-federation-balance/src/site/resources/images/BalanceProcedureScheduler.png b/hadoop-tools/hadoop-federation-balance/src/site/resources/images/BalanceProcedureScheduler.png new file mode 100644 index 0000000000000000000000000000000000000000..0a070027665dc3addbac7b8b45fdedff3078523d GIT binary patch literal 48275 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

vC;?f|65_VQ0CUd6C1* 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 literal 0 HcmV?d00001