|
1 | 1 | <?xml version="1.0" encoding="UTF-8"?>
|
2 |
| -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
| 2 | +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
3 | 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
4 | 4 | <chapter>
|
5 | 5 | <title>Data Handling Components</title>
|
|
34 | 34 | that server to enable file sprays and desprays.</para>
|
35 | 35 | </sect1>
|
36 | 36 |
|
| 37 | + <sect1 id="FileMovement"> |
| 38 | + <title>File Movement</title> |
| 39 | + |
| 40 | + <para>The ESP file service can request whether an import (spray), despray, |
| 41 | + or copy command is a <emphasis role="bold">push</emphasis> or a <emphasis |
| 42 | + role="bold">pull</emphasis> command.</para> |
| 43 | + |
| 44 | + <para>These processes run as DFU workunits and communicate with service |
| 45 | + components, either running as dynamically launched ftslave processes (the |
| 46 | + default behavior on Bare-Metal deployments), or as tasks running on a |
| 47 | + dafilesrv service (the only option on a Containerized deployment).</para> |
| 48 | + |
| 49 | + <itemizedlist> |
| 50 | + <listitem> |
| 51 | + <para><emphasis role="bold">pull</emphasis> means that the commands |
| 52 | + will notionally run per target part and pull from the source.</para> |
| 53 | + </listitem> |
| 54 | + |
| 55 | + <listitem> |
| 56 | + <para><emphasis role="bold">push</emphasis> means the commands will |
| 57 | + notionally run per source part and push to the target.</para> |
| 58 | + </listitem> |
| 59 | + </itemizedlist> |
| 60 | + |
| 61 | + <para>In Bare-Metal deployments, where the compute is coupled to the data, |
| 62 | + ftslave processes are launched on either the source or the target nodes |
| 63 | + depending on whether pushing or pulling.</para> |
| 64 | + |
| 65 | + <para>In a Containerized system, the commands always run on a dedicated |
| 66 | + dafilesrv spray-service where neither the source nor the target are |
| 67 | + local.</para> |
| 68 | + |
| 69 | + <para>The default setting in a bare-metal system is useFtSlave=true, an |
| 70 | + option of dfuserver, but can be configured off so Bare-Metal will use |
| 71 | + dafilesrv as a service, too.</para> |
| 72 | + |
| 73 | + <para>It is generally recommended to leave the decision to whether to pull |
| 74 | + or push up to the platform. In Bare-Metal, it may decide that it has to |
| 75 | + push because running ftslave on the target side is not supported such as |
| 76 | + when the the Landing Zone is a Windows server. It may also choose to pull |
| 77 | + when it concludes it is more efficient to do so. In a Containerized |
| 78 | + system, some target planes may not support multiple processes writing |
| 79 | + concurrently, and therefore pull is forced. If you implicitly request pull |
| 80 | + or push and the platform cannot satisfy the request, it will warn and |
| 81 | + continue with the method that is supported.</para> |
| 82 | + |
| 83 | + <para>In addition, the <emphasis role="bold">noCommon</emphasis> option is |
| 84 | + available. The noCommon option prevents the job/dfuserver from "commoning |
| 85 | + up" the individual partition commands into a single request. Commoning up |
| 86 | + means a single ftslave or service command will process multiple partitions |
| 87 | + sequentially. Not commoning up, means multiple concurrent partitions, that |
| 88 | + would otherwise be grouped, will operate in parallel as individual |
| 89 | + ftslaves or individual spray service commands.</para> |
| 90 | + |
| 91 | + <para>In Bare-Metal, noCommon is on by default, and will mean that any |
| 92 | + partition command that is destined for the same host, that would otherwise |
| 93 | + be grouped into a single command, will be left as multiple concurrent |
| 94 | + commands. For example, if spraying a file to a Thor cluster in Bare-Metal, |
| 95 | + and the Thor group has several partitions per node (because |
| 96 | + slavesPerNode>1), then with the default noCommon=true and pull mode, |
| 97 | + each of the multiple partition pull commands for each node would run in |
| 98 | + parallel.</para> |
| 99 | + |
| 100 | + <para>In Containerized deployments, noCommon is currently not supported |
| 101 | + and will be ignored.</para> |
| 102 | + </sect1> |
| 103 | + |
37 | 104 | <sect1 id="Working_with_a_data_file">
|
38 | 105 | <title>Working with data files</title>
|
39 | 106 |
|
|
66 | 133 | <?dbfo keep-together="always"?>
|
67 | 134 |
|
68 | 135 | <tgroup cols="2">
|
69 |
| - <colspec colwidth="49.50pt" /> |
| 136 | + <colspec colwidth="49.50pt"/> |
70 | 137 |
|
71 |
| - <colspec /> |
| 138 | + <colspec/> |
72 | 139 |
|
73 | 140 | <tbody>
|
74 | 141 | <row>
|
75 | 142 | <entry><inlinegraphic
|
76 |
| - fileref="../../images/caution.png" /></entry> |
| 143 | + fileref="../../images/caution.png"/></entry> |
77 | 144 |
|
78 | 145 | <entry>Your IP address could be different from the ones
|
79 | 146 | provided in the example images. Please use the IP address
|
|
99 | 166 | <mediaobject>
|
100 | 167 | <imageobject>
|
101 | 168 | <imagedata fileref="../../images/LZimg03-1.jpg"
|
102 |
| - vendor="eclwatchSS" /> |
| 169 | + vendor="eclwatchSS"/> |
103 | 170 | </imageobject>
|
104 | 171 | </mediaobject>
|
105 | 172 | </figure>A system file dialog opens. Browse and select the file to
|
|
112 | 179 | <mediaobject>
|
113 | 180 | <imageobject>
|
114 | 181 | <imagedata fileref="../../images/LZimg04.jpg"
|
115 |
| - vendor="eclwatchSS" /> |
| 182 | + vendor="eclwatchSS"/> |
116 | 183 | </imageobject>
|
117 | 184 | </mediaobject>
|
118 | 185 | </figure></para>
|
|
146 | 213 |
|
147 | 214 | <para><informaltable colsep="1" rowsep="1">
|
148 | 215 | <tgroup cols="2">
|
149 |
| - <colspec colwidth="80pt" /> |
| 216 | + <colspec colwidth="80pt"/> |
150 | 217 |
|
151 |
| - <colspec colwidth="100pt" /> |
| 218 | + <colspec colwidth="100pt"/> |
152 | 219 |
|
153 | 220 | <tbody>
|
154 | 221 | <row>
|
|
235 | 302 |
|
236 | 303 | <mediaobject>
|
237 | 304 | <imageobject>
|
238 |
| - <imagedata fileref="../../images/IMDB_01.jpg" /> |
| 305 | + <imagedata fileref="../../images/IMDB_01.jpg"/> |
239 | 306 | </imageobject>
|
240 | 307 | </mediaobject>
|
241 | 308 | </figure></para>
|
|
291 | 358 | entries in the Dali Server's Distributed File System.</para>
|
292 | 359 |
|
293 | 360 | <para><graphic fileref="../../images/DHMan-3.jpg"
|
294 |
| - vendor="eclwatchSS" /></para> |
| 361 | + vendor="eclwatchSS"/></para> |
295 | 362 |
|
296 | 363 | <para>From this page, you can despray or copy any file.</para>
|
297 | 364 | </listitem>
|
|
328 | 395 |
|
329 | 396 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
330 | 397 | <tgroup cols="2">
|
331 |
| - <colspec colwidth="122.40pt" /> |
| 398 | + <colspec colwidth="122.40pt"/> |
332 | 399 |
|
333 |
| - <colspec colwidth="333.00pt" /> |
| 400 | + <colspec colwidth="333.00pt"/> |
334 | 401 |
|
335 | 402 | <tbody>
|
336 | 403 | <row>
|
|
474 | 541 |
|
475 | 542 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
476 | 543 | <tgroup cols="2">
|
477 |
| - <colspec colwidth="1*" /> |
| 544 | + <colspec colwidth="1*"/> |
478 | 545 |
|
479 |
| - <colspec colwidth="3*" /> |
| 546 | + <colspec colwidth="3*"/> |
480 | 547 |
|
481 | 548 | <tbody>
|
482 | 549 | <row>
|
|
680 | 747 |
|
681 | 748 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
682 | 749 | <tgroup cols="2">
|
683 |
| - <colspec colwidth="122.40pt" /> |
| 750 | + <colspec colwidth="122.40pt"/> |
684 | 751 |
|
685 |
| - <colspec colwidth="333.00pt" /> |
| 752 | + <colspec colwidth="333.00pt"/> |
686 | 753 |
|
687 | 754 | <tbody>
|
688 | 755 | <row>
|
|
838 | 905 |
|
839 | 906 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
840 | 907 | <tgroup cols="2">
|
841 |
| - <colspec colwidth="122.40pt" /> |
| 908 | + <colspec colwidth="122.40pt"/> |
842 | 909 |
|
843 |
| - <colspec colwidth="333.00pt" /> |
| 910 | + <colspec colwidth="333.00pt"/> |
844 | 911 |
|
845 | 912 | <tbody>
|
846 | 913 | <row>
|
|
998 | 1065 |
|
999 | 1066 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
1000 | 1067 | <tgroup cols="2">
|
1001 |
| - <colspec colwidth="122.40pt" /> |
| 1068 | + <colspec colwidth="122.40pt"/> |
1002 | 1069 |
|
1003 |
| - <colspec colwidth="333.00pt" /> |
| 1070 | + <colspec colwidth="333.00pt"/> |
1004 | 1071 |
|
1005 | 1072 | <tbody>
|
1006 | 1073 | <row>
|
|
1145 | 1212 |
|
1146 | 1213 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
1147 | 1214 | <tgroup cols="2">
|
1148 |
| - <colspec colwidth="122.40pt" /> |
| 1215 | + <colspec colwidth="122.40pt"/> |
1149 | 1216 |
|
1150 |
| - <colspec colwidth="333.00pt" /> |
| 1217 | + <colspec colwidth="333.00pt"/> |
1151 | 1218 |
|
1152 | 1219 | <tbody>
|
1153 | 1220 | <row>
|
|
1271 | 1338 | button.</para>
|
1272 | 1339 |
|
1273 | 1340 | <para><graphic fileref="../../images/DHMan-3a.jpg"
|
1274 |
| - vendor="eclwatchSS" /></para> |
| 1341 | + vendor="eclwatchSS"/></para> |
1275 | 1342 | </listitem>
|
1276 | 1343 |
|
1277 | 1344 | <listitem>
|
|
1280 | 1347 |
|
1281 | 1348 | <para><informaltable colsep="0" frame="none" rowsep="0">
|
1282 | 1349 | <tgroup cols="2">
|
1283 |
| - <colspec align="left" colwidth="122.40pt" /> |
| 1350 | + <colspec align="left" colwidth="122.40pt"/> |
1284 | 1351 |
|
1285 |
| - <colspec colwidth="333.00pt" /> |
| 1352 | + <colspec colwidth="333.00pt"/> |
1286 | 1353 |
|
1287 | 1354 | <tbody>
|
1288 | 1355 | <row>
|
|
1373 | 1440 |
|
1374 | 1441 | <informaltable colsep="0" frame="none" rowsep="0">
|
1375 | 1442 | <tgroup cols="2">
|
1376 |
| - <colspec colwidth="122.40pt" /> |
| 1443 | + <colspec colwidth="122.40pt"/> |
1377 | 1444 |
|
1378 |
| - <colspec colwidth="333.00pt" /> |
| 1445 | + <colspec colwidth="333.00pt"/> |
1379 | 1446 |
|
1380 | 1447 | <tbody>
|
1381 | 1448 | <row>
|
|
1499 | 1566 |
|
1500 | 1567 | <informaltable colsep="0" frame="none" rowsep="0">
|
1501 | 1568 | <tgroup cols="2">
|
1502 |
| - <colspec colwidth="122.40pt" /> |
| 1569 | + <colspec colwidth="122.40pt"/> |
1503 | 1570 |
|
1504 |
| - <colspec colwidth="333.00pt" /> |
| 1571 | + <colspec colwidth="333.00pt"/> |
1505 | 1572 |
|
1506 | 1573 | <tbody>
|
1507 | 1574 | <row>
|
|
0 commit comments