@@ -52,8 +52,9 @@ The IR for PaddlePaddle after refactoring is called a `Block`, it specifies the
...
@@ -52,8 +52,9 @@ The IR for PaddlePaddle after refactoring is called a `Block`, it specifies the
The user can not directly specify the parameter update rule for the parameter server in the Python module, since the parameter server does not use the same computation definition as the trainer. Instead, the update rule is baked inside the parameter server. The user can not specify the update rule explicitly.
The user can not directly specify the parameter update rule for the parameter server in the Python module, since the parameter server does not use the same computation definition as the trainer. Instead, the update rule is baked inside the parameter server. The user can not specify the update rule explicitly.
This could be fixed by making the parameter server run the same computation definition as the trainer (the user's Python module). For a detailed explanation, refer to this document -
This could be fixed by making the parameter server also run an IR, which can be different to the trainer side
[Design Doc: Operation Graph Based Parameter Server](./parameter_server.md)
For a detailed explanation, refer to this document -
The above code is what a typical Python trainer code is, the neural network topology is built using the helper functions such as `paddle.layer.fc`. Training is done by calling `session.eval` iteratively.
The code above is a typical local training program, the "Training Program" is built using helper functions such as
`fluid.layer.fc`. The training is done by calling `Executor.run`
#### session.eval
iteratively.
As shown in the graph, `session.eval` sends the IR and the evaluation inputs or targets to the PaddlePaddle cluster for evaluation.
For more details, the implementation of IR is [Program](../program.md), and `ProgramDesc` is the protobuf type.
The targets can be any variable in the computation graph. When the target is say, the `optimizer` variable, the neural network will be optimized once. When the target is the `cost` variable, `session.eval` returns the cost value. Based on what the target is, an appropriate action is taken.
[Executor](../executor.md) simply runs the `ProgramDesc`. For local training you generally use
The Python `session` is a wrapper of the C++ `Session` class. For more information about `Session`, refer to this document - [Design Doc: Session](./session.md).
`Executor` to run the program locally. For any kind of distributed training, you can use
`RemoteExecutor` to specify desired distributed training method with some optional arguments.
### PaddlePaddle Converter
### Distributed Transpiler
The PaddlePaddle converter automatically converts the IR in the request (IR and evaluation inputs/targets) from PaddlePaddle Python to partitioned IRs and dispatches the new IRs and evaluation inputs/targets to different PaddlePaddle runtimes. Below are the steps that are followed :
The Distributed Transpiler automatically converts the IR (in protobuf format) to partitioned IRs. Then
1. Add a `feed` OP that feeds the eval inputs, and a `fetch` OP that fetches the eval targets to the IR.
the Remote Executor dispatches the new IRs to Remote Executors across the cluster.
Below are the steps that are followed :
2. Extract a new computation (sub)graph with the `feed` and `fetch` OPs as the boundary. The runtime does not need to run the OP that is not dependent on the `fetch` OP.
1. User only need to change `Executor` to `RemoteExecutor` to change local program to distributed program.
3. Optimize the computation graph.
1. `RemoteExecutor` calls `Distributed Transpiler` to "transpile" user's program to several IRs representing a
distributed training program:
4. Place the OPs in the graph onto different devices on different PaddlePaddle runtime according to a placement algorithm and the device constraints specified by the user.
1. Parse configurations from `RemoteExecutor`.
1. Determine the type of distributed program, can be DataParallelism, ModelParallelism or Streaming.
5. Partition the graph according to runtime boundaries and add `send` / `recv` OP pair on the runtime boundaries.
1. Partition the `ProgramDesc` according to type and add `send` / `recv` OP pair on the boundaries. Take
DataParallelism type for example, it removes the optimization operators and add a `send` OP to the
"trainer" role, then add the optimization operators to the parameter server role within the `recv` OP.
1. Dispatch the partitioned graph to different `RemoteExecutor` in the cluster.
1. `RemoteExecutor` on each node run the received `ProgramDesc` utill the end.
### RemoteExecutor
As shown in the graph, `RemoteExecutor.run` sends the IR to the cluster for Execution.
You can also use parameter `fetch_list` to interactively fetch variable back to local for
log printing.
The Python `RemoteExecutor` is derived from `Executor` class.
```python
exe = RemoteExecutor(
feed=feeder.feed(data),
fetch_list=[avg_cost],
job_desc=JobDesc(
jobname,
num_trainer,
num_pserver,
cpu_per_trainer,
gpu_per_trainer,
mem_per_trainer,
cpu_per_pserver,
mem_per_pserver
))
for data in train_reader():
loss, acc = exe.run(trainer_prog,
feed=feeder.feed(data),
fetch_list=[avg_cost])
```
6. Dispatch the partitioned graph to different PaddlePaddle runtimes.
`JobDesc` object describe the distributed job resource specification to run on
Cluster environment.
7. PaddlePaddle runtimes with the `fetch` OP reports evaluation results back to the converter, the converter reports the evaluation results back to the PaddlePaddle Python.
<img src="src/remote_executor.png"/>
The output IRs will be cached to optimize the conversion latency.
to a server in the cluster which executes `RemoteExecutor.listen`. This server is responsible
to start the final Kubernetes Jobs to run the different role of `ProgramDesc`.
#### Placement Algorithm
### Placement Algorithm
Our first implementation will only support "trainer-parameter server" placement: the parameters, initializers, and optimizers are all placed on the PaddlePaddle runtimes with the parameter server role. Everything else will be placed on the PaddlePaddle runtimes with the trainer role. This has the same functionality as the "trainer-parameter server" architecture of PaddlePaddle v0.10.0, but is more generic and flexible.
Our first implementation will only support "trainer-parameter server" placement: the parameters, initializers, and optimizers are all placed on the PaddlePaddle runtimes with the parameter server role. Everything else will be placed on the PaddlePaddle runtimes with the trainer role. This has the same functionality as the "trainer-parameter server" architecture of PaddlePaddle v0.10.0, but is more generic and flexible.
In the future, a more general placement algorithm should be implemented, which makes placements according to the input IR, and a model of device computation time and device communication time. Model parallelism requires the generic placement algorithm.
In the future, a more general placement algorithm should be implemented, which makes placements according to the input IR, and a model of device computation time and device communication time. Model parallelism requires the generic placement algorithm.
### PaddlePaddle Runtime
The PaddlePaddle runtime owns multiple devices (e.g., CPUs, GPUs) and runs the IR. The runtime does not need to do OP placement since it is already done by the converter.
### Local Training Architecture
### Local Training Architecture
The local training architecture will be the same as the distributed training architecture, the difference is that everything runs locally, and there is just one PaddlePaddle runtime:
The local training architecture will be the same as the distributed training architecture, the difference is that everything runs locally, and there is just one PaddlePaddle runtime:
...
@@ -132,9 +176,18 @@ The local training architecture will be the same as the distributed training arc
...
@@ -132,9 +176,18 @@ The local training architecture will be the same as the distributed training arc
### Training Data
### Training Data
In PaddlePaddle v0.10.0, training data is typically read with a [data reader](../reader/README.md) from Python. This approach is no longer efficient when training in a distributed fashion since the Python process no longer runs on the same node with the trainer processes. The Python reader will need to read from the distributed filesystem (assuming it has the required access) and send to the trainers, doubling the network traffic.
In PaddlePaddle v0.10.0, training data is typically read
with [data reader](../reader/README.md) from Python. This approach is
When doing distributed training, the user can still use Python data reader: the training data are sent with `session.eval`. However this should be used for debugging purpose only. The users are encouraged to use the read data OPs.
no longer efficient when training distributedly since the Python
process no longer runs on the same node with the trainer processes,
the Python reader will need to read from the distributed filesystem
(assuming it has the access) and send to the trainers, doubling the
network traffic.
When doing distributed training, the user can still use Python data
reader: the training data are sent with `Executor.run`. However, should
be used for debugging purpose only. The users are encouraged to use
<spanid="design-doc-operation-graph-based-parameter-server"></span><h1>Design Doc: Operation Graph Based Parameter Server<aclass="headerlink"href="#design-doc-operation-graph-based-parameter-server"title="Permalink to this headline">¶</a></h1>
<spanid="design-doc-parameter-server"></span><h1>Design Doc: Parameter Server<aclass="headerlink"href="#design-doc-parameter-server"title="Permalink to this headline">¶</a></h1>
<divclass="section"id="abstract">
<divclass="section"id="abstract">
<spanid="abstract"></span><h2>Abstract<aclass="headerlink"href="#abstract"title="Permalink to this headline">¶</a></h2>
<spanid="abstract"></span><h2>Abstract<aclass="headerlink"href="#abstract"title="Permalink to this headline">¶</a></h2>
<p>We propose an approach to implement the parameter server. In this
<p>We propose an approach to implement the parameter server. In this
...
@@ -220,7 +220,7 @@ different purposes.</p>
...
@@ -220,7 +220,7 @@ different purposes.</p>
<divclass="section"id="background">
<divclass="section"id="background">
<spanid="background"></span><h2>Background<aclass="headerlink"href="#background"title="Permalink to this headline">¶</a></h2>
<spanid="background"></span><h2>Background<aclass="headerlink"href="#background"title="Permalink to this headline">¶</a></h2>
<p>The previous implementations of the parameter server does not run a
<p>The previous implementations of the parameter server does not run a
communication and checkpointing are implemented twice on both the
communication and checkpointing are implemented twice on both the
trainer and the parameter server.</p>
trainer and the parameter server.</p>
<p>It would be great if we can write code once and use them on both the
<p>It would be great if we can write code once and use them on both the
...
@@ -232,10 +232,10 @@ server becomes a natural extension.</p>
...
@@ -232,10 +232,10 @@ server becomes a natural extension.</p>
</div>
</div>
<divclass="section"id="design">
<divclass="section"id="design">
<spanid="design"></span><h2>Design<aclass="headerlink"href="#design"title="Permalink to this headline">¶</a></h2>
<spanid="design"></span><h2>Design<aclass="headerlink"href="#design"title="Permalink to this headline">¶</a></h2>
<divclass="section"id="graph-converter">
<divclass="section"id="distributed-transpiler">
<spanid="graph-converter"></span><h3>Graph Converter<aclass="headerlink"href="#graph-converter"title="Permalink to this headline">¶</a></h3>
<spanid="distributed-transpiler"></span><h3>Distributed Transpiler<aclass="headerlink"href="#distributed-transpiler"title="Permalink to this headline">¶</a></h3>
<p>The <em>graph converter</em> converts the user-defined operation (OP) graph
<p>The <em>Distributed Transpiler</em> converts the user-defined fluid program
into subgraphs to be scheduled on different nodes with the following
into sub-programs to be scheduled on different nodes with the following
steps:</p>
steps:</p>
<olclass="simple">
<olclass="simple">
<li>OP placement: the OPs will be placed on different nodes according
<li>OP placement: the OPs will be placed on different nodes according
...
@@ -252,8 +252,8 @@ subgraphs for the trainer and the parameter server:</p>
...
@@ -252,8 +252,8 @@ subgraphs for the trainer and the parameter server:</p>
<p>After converting:</p>
<p>After converting:</p>
<p><imgsrc="src/dist-graph.png"width="700"/></p>
<p><imgsrc="src/dist-graph.png"width="700"/></p>
<olclass="simple">
<olclass="simple">
<li>The parameter variable W and it’s optimizer subgraph are placed on the parameter server.</li>
<li>The parameter variable W and it’s optimizer program are placed on the parameter server.</li>
<li>Operators are added to the subgraphs.<ul>
<li>Operators are added to the program.<ul>
<li><em>Send</em> sends data to the connected <em>Recv</em> operator. The
<li><em>Send</em> sends data to the connected <em>Recv</em> operator. The
scheduler on the receive node will only schedule <em>Recv</em> operator
scheduler on the receive node will only schedule <em>Recv</em> operator
to run when the <em>Send</em> operator has ran (the <em>Send</em> OP will mark
to run when the <em>Send</em> operator has ran (the <em>Send</em> OP will mark
...
@@ -271,11 +271,10 @@ tensors.</li>
...
@@ -271,11 +271,10 @@ tensors.</li>
<spanid="benefits"></span><h3>Benefits<aclass="headerlink"href="#benefits"title="Permalink to this headline">¶</a></h3>
<spanid="benefits"></span><h3>Benefits<aclass="headerlink"href="#benefits"title="Permalink to this headline">¶</a></h3>
<ulclass="simple">
<ulclass="simple">
<li>Model parallelism become easier to implement: it’s an extension to
<li>Model parallelism become easier to implement: it’s an extension to
the trainer - parameter server approach. we already have the
the trainer - parameter server approach. We can have several “Transpilers”
communication OPs, but need to extend the graph converter’s
to achieve different goals.</li>
placement functionality.</li>
<li>User-defined optimizer is easier to add - user can now express it as
<li>User-defined optimizer is easier to add - user can now express it as
a subgraph.</li>
a sub-program.</li>
<li>No more duplication logic inside the trainer and the parameter
<li>No more duplication logic inside the trainer and the parameter
server mentioned in the background section.</li>
server mentioned in the background section.</li>
</ul>
</ul>
...
@@ -283,24 +282,21 @@ server mentioned in the background section.</li>
...
@@ -283,24 +282,21 @@ server mentioned in the background section.</li>
<divclass="section"id="challenges">
<divclass="section"id="challenges">
<spanid="challenges"></span><h3>Challenges<aclass="headerlink"href="#challenges"title="Permalink to this headline">¶</a></h3>
<spanid="challenges"></span><h3>Challenges<aclass="headerlink"href="#challenges"title="Permalink to this headline">¶</a></h3>
<ulclass="simple">
<ulclass="simple">
<li>It might be hard for the graph converter to cut a general graph
(without any hint for which subgraph is the optimizer). We may need
to label which subgraph inside the OP graph is the optimizer.</li>
<li>It’s important to balance the parameter shards of on multiple
<li>It’s important to balance the parameter shards of on multiple
parameter server. If a single parameter is very big (some
parameter server. If a single parameter is very big (some
word-embedding, fully connected, softmax layer), we need to
word-embedding, fully connected, softmax layer), we need to
automatically partition the single parameter onto different
automatically partition the single parameter onto different
parameter servers when possible (only element-wise optimizer depends
parameter servers when possible (only element-wise optimizer depends
on the parameter variable).</li>
on the parameter variable).</li>
<li>In the “Aync SGD” figure, the “W” variable on the parameter server
could be read and wrote concurrently. See
<aclass="reference external"href="https://github.com/PaddlePaddle/Paddle/pull/6394">here</a> for more
details about concurrent program in fluid.</li>
</ul>
</ul>
</div>
</div>
<divclass="section"id="discussion">
<divclass="section"id="discussion">
<spanid="discussion"></span><h3>Discussion<aclass="headerlink"href="#discussion"title="Permalink to this headline">¶</a></h3>
<spanid="discussion"></span><h3>Discussion<aclass="headerlink"href="#discussion"title="Permalink to this headline">¶</a></h3>
<ulclass="simple">
<ulclass="simple">
<li>In the “Aync SGD” figure, the “W” variable on the parameter server
could be read and wrote concurrently, what is our locking strategy?
E.g., each variable have a lock cpp method to be invoked by every
OP, or, have a lock OP.</li>
<li>Can the Enqueue OP be implemented under our current tensor design
<li>Can the Enqueue OP be implemented under our current tensor design
(puts the input tensor into the queue tensor)?</li>
(puts the input tensor into the queue tensor)?</li>
<li><em>Dequeue</em> OP will have variable numbers of output (depends on the
<li><em>Dequeue</em> OP will have variable numbers of output (depends on the
@@ -52,8 +52,9 @@ The IR for PaddlePaddle after refactoring is called a `Block`, it specifies the
...
@@ -52,8 +52,9 @@ The IR for PaddlePaddle after refactoring is called a `Block`, it specifies the
The user can not directly specify the parameter update rule for the parameter server in the Python module, since the parameter server does not use the same computation definition as the trainer. Instead, the update rule is baked inside the parameter server. The user can not specify the update rule explicitly.
The user can not directly specify the parameter update rule for the parameter server in the Python module, since the parameter server does not use the same computation definition as the trainer. Instead, the update rule is baked inside the parameter server. The user can not specify the update rule explicitly.
This could be fixed by making the parameter server run the same computation definition as the trainer (the user's Python module). For a detailed explanation, refer to this document -
This could be fixed by making the parameter server also run an IR, which can be different to the trainer side
[Design Doc: Operation Graph Based Parameter Server](./parameter_server.md)
For a detailed explanation, refer to this document -
The above code is what a typical Python trainer code is, the neural network topology is built using the helper functions such as `paddle.layer.fc`. Training is done by calling `session.eval` iteratively.
The code above is a typical local training program, the "Training Program" is built using helper functions such as
`fluid.layer.fc`. The training is done by calling `Executor.run`
#### session.eval
iteratively.
As shown in the graph, `session.eval` sends the IR and the evaluation inputs or targets to the PaddlePaddle cluster for evaluation.
For more details, the implementation of IR is [Program](../program.md), and `ProgramDesc` is the protobuf type.
The targets can be any variable in the computation graph. When the target is say, the `optimizer` variable, the neural network will be optimized once. When the target is the `cost` variable, `session.eval` returns the cost value. Based on what the target is, an appropriate action is taken.
[Executor](../executor.md) simply runs the `ProgramDesc`. For local training you generally use
The Python `session` is a wrapper of the C++ `Session` class. For more information about `Session`, refer to this document - [Design Doc: Session](./session.md).
`Executor` to run the program locally. For any kind of distributed training, you can use
`RemoteExecutor` to specify desired distributed training method with some optional arguments.
### PaddlePaddle Converter
### Distributed Transpiler
The PaddlePaddle converter automatically converts the IR in the request (IR and evaluation inputs/targets) from PaddlePaddle Python to partitioned IRs and dispatches the new IRs and evaluation inputs/targets to different PaddlePaddle runtimes. Below are the steps that are followed :
The Distributed Transpiler automatically converts the IR (in protobuf format) to partitioned IRs. Then
1. Add a `feed` OP that feeds the eval inputs, and a `fetch` OP that fetches the eval targets to the IR.
the Remote Executor dispatches the new IRs to Remote Executors across the cluster.
Below are the steps that are followed :
2. Extract a new computation (sub)graph with the `feed` and `fetch` OPs as the boundary. The runtime does not need to run the OP that is not dependent on the `fetch` OP.
1. User only need to change `Executor` to `RemoteExecutor` to change local program to distributed program.
3. Optimize the computation graph.
1. `RemoteExecutor` calls `Distributed Transpiler` to "transpile" user's program to several IRs representing a
distributed training program:
4. Place the OPs in the graph onto different devices on different PaddlePaddle runtime according to a placement algorithm and the device constraints specified by the user.
1. Parse configurations from `RemoteExecutor`.
1. Determine the type of distributed program, can be DataParallelism, ModelParallelism or Streaming.
5. Partition the graph according to runtime boundaries and add `send` / `recv` OP pair on the runtime boundaries.
1. Partition the `ProgramDesc` according to type and add `send` / `recv` OP pair on the boundaries. Take
DataParallelism type for example, it removes the optimization operators and add a `send` OP to the
"trainer" role, then add the optimization operators to the parameter server role within the `recv` OP.
1. Dispatch the partitioned graph to different `RemoteExecutor` in the cluster.
1. `RemoteExecutor` on each node run the received `ProgramDesc` utill the end.
### RemoteExecutor
As shown in the graph, `RemoteExecutor.run` sends the IR to the cluster for Execution.
You can also use parameter `fetch_list` to interactively fetch variable back to local for
log printing.
The Python `RemoteExecutor` is derived from `Executor` class.
```python
exe = RemoteExecutor(
feed=feeder.feed(data),
fetch_list=[avg_cost],
job_desc=JobDesc(
jobname,
num_trainer,
num_pserver,
cpu_per_trainer,
gpu_per_trainer,
mem_per_trainer,
cpu_per_pserver,
mem_per_pserver
))
for data in train_reader():
loss, acc = exe.run(trainer_prog,
feed=feeder.feed(data),
fetch_list=[avg_cost])
```
6. Dispatch the partitioned graph to different PaddlePaddle runtimes.
`JobDesc` object describe the distributed job resource specification to run on
Cluster environment.
7. PaddlePaddle runtimes with the `fetch` OP reports evaluation results back to the converter, the converter reports the evaluation results back to the PaddlePaddle Python.
<img src="src/remote_executor.png"/>
The output IRs will be cached to optimize the conversion latency.
to a server in the cluster which executes `RemoteExecutor.listen`. This server is responsible
to start the final Kubernetes Jobs to run the different role of `ProgramDesc`.
#### Placement Algorithm
### Placement Algorithm
Our first implementation will only support "trainer-parameter server" placement: the parameters, initializers, and optimizers are all placed on the PaddlePaddle runtimes with the parameter server role. Everything else will be placed on the PaddlePaddle runtimes with the trainer role. This has the same functionality as the "trainer-parameter server" architecture of PaddlePaddle v0.10.0, but is more generic and flexible.
Our first implementation will only support "trainer-parameter server" placement: the parameters, initializers, and optimizers are all placed on the PaddlePaddle runtimes with the parameter server role. Everything else will be placed on the PaddlePaddle runtimes with the trainer role. This has the same functionality as the "trainer-parameter server" architecture of PaddlePaddle v0.10.0, but is more generic and flexible.
In the future, a more general placement algorithm should be implemented, which makes placements according to the input IR, and a model of device computation time and device communication time. Model parallelism requires the generic placement algorithm.
In the future, a more general placement algorithm should be implemented, which makes placements according to the input IR, and a model of device computation time and device communication time. Model parallelism requires the generic placement algorithm.
### PaddlePaddle Runtime
The PaddlePaddle runtime owns multiple devices (e.g., CPUs, GPUs) and runs the IR. The runtime does not need to do OP placement since it is already done by the converter.
### Local Training Architecture
### Local Training Architecture
The local training architecture will be the same as the distributed training architecture, the difference is that everything runs locally, and there is just one PaddlePaddle runtime:
The local training architecture will be the same as the distributed training architecture, the difference is that everything runs locally, and there is just one PaddlePaddle runtime:
...
@@ -132,9 +176,18 @@ The local training architecture will be the same as the distributed training arc
...
@@ -132,9 +176,18 @@ The local training architecture will be the same as the distributed training arc
### Training Data
### Training Data
In PaddlePaddle v0.10.0, training data is typically read with a [data reader](../reader/README.md) from Python. This approach is no longer efficient when training in a distributed fashion since the Python process no longer runs on the same node with the trainer processes. The Python reader will need to read from the distributed filesystem (assuming it has the required access) and send to the trainers, doubling the network traffic.
In PaddlePaddle v0.10.0, training data is typically read
with [data reader](../reader/README.md) from Python. This approach is
When doing distributed training, the user can still use Python data reader: the training data are sent with `session.eval`. However this should be used for debugging purpose only. The users are encouraged to use the read data OPs.
no longer efficient when training distributedly since the Python
process no longer runs on the same node with the trainer processes,
the Python reader will need to read from the distributed filesystem
(assuming it has the access) and send to the trainers, doubling the
network traffic.
When doing distributed training, the user can still use Python data
reader: the training data are sent with `Executor.run`. However, should
be used for debugging purpose only. The users are encouraged to use