Project

General

Profile

Port a Pipeline » History » Version 18

Nancy Ouyang, 04/17/2015 04:04 PM

1 7 Tom Clegg
{{>toc}}
2
3 1 Nancy Ouyang
h1. Port a Pipeline
4
5
Like any other tool, Arvados requires time to learn. Thus, we don't encourage using Arvados for initial development of analysis pipelines or exploratory research on small subsets of data, when each quick-and-dirty iteration takes minutes on a single machine. But for any computationally-intense work, Arvados offers a lot of benefits.
6
7 8 Nancy Ouyang
Okay, cool, provenance, reproducibility, easily scaling to gigabytes of data and mucho RAM, evaluating existing pipelines like lobSTR quickly.
8 1 Nancy Ouyang
9 8 Nancy Ouyang
But what about if you want to these benefits when running your own pipelines?
10
In other words, how do you **port a pipeline** to Arvados?
11 1 Nancy Ouyang
12
h2. 1. Quick Way
13
14
First, do you just want to parallelize a single bash script?
15
16 9 Nancy Ouyang
Check if you can use @arv-run@. Take this arv-run example, which searches multiple FASTQ files in parallel, and saves the results to Keep through shell redirection:
17
18
    $ arv-run grep -H -n GCTACCAAGTTT \< *.fa \> output.txt
19 1 Nancy Ouyang
20
h3. 1.1 Install arv-run
21
22
See: http://doc.arvados.org/sdk/python/sdk-python.html and http://doc.arvados.org/user/reference/api-tokens.html, or in short below:
23
<pre>
24
$ sudo apt-get install python-pip python-dev libattr1-dev libfuse-dev pkg-config python-yaml
25
$ sudo pip install --pre arvados-python-client
26
</pre>
27
(Lost? See http://doc.arvados.org/sdk/python/sdk-python.html )
28
29
If you try to use arv run right now, it will complain about some settings your missing. To fix that,
30
31 13 Nancy Ouyang
# Go to http://cloud.curoverse.com
32 1 Nancy Ouyang
# Login with any Google account (you may need to click login a few times if you hit multiple redirects from Google)
33
# Click in the upper right on your account name -> Manage Account
34 15 Nancy Ouyang
... !{height:10em}manage_account.png!:manage_account.png
35 1 Nancy Ouyang
# Optional: While you're here, click "send request for shell access", since that will give you shell access to a VM with all of the Arvados tools pre-installed.
36 14 Nancy Ouyang
1) !{height:10em}send_request.png!:send_request.png 2) !{height:10em}request_sent.png!:request_sent.png 3) !{height:10em}access_granted.png!:access_granted.png 
37 12 Nancy Ouyang
# Copy the lines of text into your terminal, something like
38 1 Nancy Ouyang
<pre>
39
HISTIGNORE=$HISTIGNORE:'export ARVADOS_API_TOKEN=*'
40
export ARVADOS_API_TOKEN=sekritlongthing
41 12 Nancy Ouyang
export ARVADOS_API_HOST=qr1hi.arvadosapi.com
42 1 Nancy Ouyang
unset ARVADOS_API_HOST_INSECURE
43 17 Nancy Ouyang
</pre> ... !{height:5em}terminal_ssh.png!:terminal_ssh.png
44 14 Nancy Ouyang
# If you want this to persist across reboot, add the above lines to ~/.bashrc or your ~/.bash_profile
45 1 Nancy Ouyang
46
(Lost? See http://doc.arvados.org/user/reference/api-tokens.html )
47
48
h3. 1.2 Submit job to Arvados
49
50
First, check: Does your command work locally?
51
52
    $ grep -H -n GCTACCAAGTTT *.fa
53
54
If so, then submit it to arvados using @arv run@
55
56
    $ arv-run grep -H -n GCTACCAAGTTT \< *.fa \> output.txt
57
58
* This bash command stores the results as output.txt
59
* Note that due to the particulars of grep, Arvados will report this pipeline as failed if grep does not find anything, and no output will appear on Arvados
60
61
Your dataset is uploaded to Arvados if it wasn't on there already (which may take a while if it's a large dataset), your "grep" job is submitted to run on the Arvados cluster, and you get the results in a few minutes (stored inside output.txt in Arvados). If you go to Workbench at su92l, you will see the pipeline running. It may take a few minutes for Arvados to spool up a node, provision it, and run your job. The robots are working hard for you, grab a cup of coffee.
62
63
(Lost? See http://doc.arvados.org/user/topics/arv-run.html )
64
65
h3. 1.3 However
66
67 10 Nancy Ouyang
If your pipeline looks more like
68
69 11 Nancy Ouyang
!{width: 50%}https://arvados.org/attachments/download/428/provenance_graph_full.png!:https://arvados.org/attachments/download/428/provenance_graph_full.png
70 10 Nancy Ouyang
71
@arv-run@ is not powerful enough. Here we gooooo.
72 1 Nancy Ouyang
73
h2. 2. In Short
74
75
**Estimated reading time: 1 hour.**
76
77
You must write a **pipeline template** that describes your pipeline to Arvados.
78
79
h3. 2.1 VM (Virtual Machine) Access
80
81
Note: You'll need the Arvados set of command-line tools to follow along. The easiest way to get started is to get access to a Virtual Machine (VM) with all the tools pre-installed.
82
83 18 Nancy Ouyang
# Go to qr1hi.arvadosapi.com
84 1 Nancy Ouyang
# Login with google account (you may need to click login a few times, our redirects are not working well)
85 18 Nancy Ouyang
# Click in the upper right on your account name -> Manage Account
86
# Hit the "Request shell access" button under Manage Account in workbench.
87 1 Nancy Ouyang
88
h3. 2.2 Pipeline Template Example
89
90
Here is what a simple pipeline template looks like, where the output of program A is provided as input to program B. We'll explain what it all means shortly, but first, don't worry -- you'll never be creating a pipeline template from scratch. You'll always copy and modify an existing boilerplate one (yes, a template for the pipeline template! :])
91
92
93
    **pipelinetemplate.json**
94
    {
95
    "name": "Tiny Bash Script",
96
      "components": {
97
        "Create Two Files": {
98
          "script": "run-command",
99
          "script_version": "master",
100
          "repository": "nancy",
101
          "script_parameters": {
102
            "command": [
103
              "$(job.srcdir)/crunch_scripts/createtwofiles.sh"
104
            ]
105
          ,
106
          "runtime_constraints": {
107
            "docker_image": "nancy/cgatools-wormtable"
108
        ,
109
        "Merge Files": {
110
          "script": "run-command",
111
          "script_version": "master",
112
          "repository": "nancy",
113
          "script_parameters": {
114
            "command": [
115
              "$(job.srcdir)/crunch_scripts/mergefiles.sh",
116
              "$(input)"
117
            ],
118
            "input": {
119
              "output_of": "Create Two Files"
120
          ,
121
          "runtime_constraints": {
122
            "docker_image": "nancy/cgatools-wormtable"
123
          
124
h2. 3. simple and sweet port-a-pipeline example
125
126
Okay, let's dig into what's going on.
127
128
h3. 3.1 the setup
129
130
We'll port an artificially simple pipeline which involves just two short bash scripts, described as "A" and "B" below:
131
132
**Script A. Create two files**
133
Input: nothing
134
Output: two files (out1.txt and out2.txt)
135
136
**Script B. Merge two files into a single file**
137
Input: output of step A
138
Output: a single file (output.txt)
139
140
Visually, this looks like [!graph image] (ignore the long strings of gibberish in the rectangles for now).
141
142
Here's what we've explained so far in the pipeline template:
143
144
145
    **pipelinetemplate.json**
146
    {
147
    **"name": "Tiny Bash Script",**
148
      "components": {
149
       **"Create Two Files": {**
150
          "script": "run-command",
151
          "script_version": "master",
152
          "repository": "arvados",
153
          "script_parameters": {
154
            "command": [
155
              "$(job.srcdir)/crunch_scripts/ *createtwofiles.sh* "
156
            ]
157
          ,
158
          "runtime_constraints": {
159
            "docker_image": "nancy/cgatools-wormtable"
160
        ,
161
        **"Merge Files": {**
162
          "script": "run-command",
163
          "script_version": "master",
164
          "repository": "arvados",
165
          "script_parameters": {
166
            "command": [
167
              "$(job.srcdir)/crunch_scripts/ *mergefiles.sh* ",
168
              "$(input)"
169
            ],
170
           **"input": {**
171
              **"output_of": "Create Two Files"**
172
          ,
173
          "runtime_constraints": {
174
            "docker_image": "nancy/cgatools-wormtable"
175
176
177
h3. **3.2 arv-what?**
178
179
Before we go further, let's take a quick step back. Arvados consists of two parts
180
181
**Part 1. Keep** - I have all your files in the cloud!
182
183
You can access your files through your browser, using **Workbench**, or using the Arvados command line (CLI) tools (link: http://doc.arvados.org/sdk/cli/index.html ).
184
185
Visually, this looks like
186
[!image 1: workbench]
187
[!image 2: shell session, arv mount]
188
189
**Part 2. Crunch** - I run all your scripts in the cloud!
190
191
Crunch both dispatches jobs and provides version control for your pipelines.
192
193
You describe your workflow to Crunch using **pipeline templates**. Pipeline templates describe a pipeline ("workflow"), the type of inputs each step in the pipeline requires, and . You provide a high-level description of how data flows through the pipeline—for example, the outputs of programs A and B are provided as input to program C—and let Crunch take care of the details of starting the individual programs at the right time with the inputs you specified.
194
195
[!image 2: complex pipeline]
196
197
Once you save a pipeline template in Arvados, you run it by creating a pipeline instance that lists the specific inputs you’d like to use. The pipeline’s final output(s) will be saved in a project you specify.
198
199
Concretely, a pipeline template describes
200
201
* **data inputs** - specified as Keep content addresses
202
* **job scripts** - stored in a Git version control repository and referenced by a commit hash
203
* **parameters** - which, along with the data inputs, can have default values or can be filled in later when the pipeline is actually run
204
* **the execution environment** - stored in Docker images and referenced by Docker image name
205
206
**What is Docker**? Docker allows Arvados to replicate the execution environment your tools need. You install whatever bioinformatics tools (bwa-mem, vcftools, etc.) you are using inside a Docker image, upload it to Arvados, and Arvados will recreate your environment for computers in the cloud.
207
208
**Protip:** Install stable external tools in Docker. Put your own scripts in a Git repository. This is because each docker image is about 500 GB, so each new docker image takes a while to upload (30 minutes) if you are not using Arvados on a local cluster. In the future, we hope to use small diff files describing just the changes made to Docker image instead of the full Docker image. [Last updated 19 Feb 2015]
209
210
h3. 3.3 In More Detail
211
212
Alright, let's put that all together.
213
214
    **pipelinetemplate.json**
215
    {
216
    "name": "Tiny Bash Script",
217
      "components": {
218
        "Create Two Files": {
219
          "script": "run-command",
220
          "script_version": "master",
221
          "repository": "nancy",
222
          "script_parameters": {
223
            "command": [
224
              "$(job.srcdir)/crunch_scripts/createtwofiles.sh" **#[1]**
225
            ]
226
          ,
227
          "runtime_constraints": {
228
            "docker_image": "nancy/cgatools-wormtable"
229
        ,
230
        "Merge Files": {
231
          "script": "run-command",
232
          "script_version": "master",
233
          "repository": "nancy",
234
          "script_parameters": {
235
            "command": [
236
              "$(job.srcdir)/crunch_scripts/mergefiles.sh", **#[2]**
237
              "$(input)"
238
            ],
239
            "input": {
240
              "output_of": "Create Two Files" **#[3]**
241
          ,
242
          "runtime_constraints": {
243
            "docker_image": "nancy/cgatools-wormtable"    
244
    
245
**Explanation**
246
    
247
[1] **$(job.srcdir)** references the git repository "in the cloud". Even though **run-command** is in nancy/crunch_scripts/ and is "magically found" by Arvados, INSIDE run-command you can't reference other files in the same repo as run-command without this magic variable.
248
249
Any output files as a result of this run-command will be automagically stored to keep as an auto-named collection (which you can think of as a folder for now).
250
251
[2] Okay, so how does the next script know where to find the output of the previous job? run-command will keep track of the collections it's created, so we can feed that in as an argument to our next script. In this "command" section under "run-command", you can think of the commas as spaces. Thus, what this line is saying is "run mergefile.sh on the previous input", or
252
253
  $ mergefiles.sh [directory with output of previous command]
254
255
[3] Here we set the variable "input" to point to the directory with the output of the previous command "Create Two Files".
256
257
(Lost? Try the hands-on example in the next section, or read more detailed documentation on the Arvados website: 
258
259
* http://doc.arvados.org/user/tutorials/running-external-program.html
260
* http://doc.arvados.org/user/topics/run-command.html
261
* http://doc.arvados.org/api/schema/PipelineTemplate.html )
262
263
h3. 3.4 All hands on deck!
264
265
Okay, now that we know the rough shape of what's going on, let's get our hands dirty.
266
267 2 Nancy Ouyang
*From your local machine, login to Arvados virtual machine*
268 1 Nancy Ouyang
269 4 Nancy Ouyang
Single step:
270 1 Nancy Ouyang
271 4 Nancy Ouyang
  nrw@ *@nrw-local@* $ ssh nancy@lightning-dev4.shell.arvados
272
273 1 Nancy Ouyang
(Lost? See "SSH access to machine with Arvados commandline tools installed" http://doc.arvados.org/user/getting_started/ssh-access-unix.html )
274
275
**In VM, create pipeline template**
276
277
A few steps:
278
279
  nancy@ *@lightning-dev4.su92l@* :~$ arv create pipeline_template
280
Created object qr1hi-p5p6p-3p6uweo7omeq9e7
281
$ arv edit qr1hi-p5p6p-3p6uweo7omeq9e7 #Create the pipeline template as described above! [[Todo: concrete thing]]
282
283
(Lost? See "Writing a pipeline template" http://doc.arvados.org/user/tutorials/running-external-program.html )
284
285
*In VM, set up git repository with run_command and our scripts*
286
287 2 Nancy Ouyang
A few steps: 
288 1 Nancy Ouyang
289 2 Nancy Ouyang
  $ mkdir @~@/projects
290
$ cd @~@/projects
291
~/projects $ git clone git@git.qr1hi.arvadosapi.com:nancy.git 
292 1 Nancy Ouyang
293 2 Nancy Ouyang
(Lost? Find your own git URL by going to https://workbench.su92l.arvadosapi.com/manage_account )
294 1 Nancy Ouyang
295 2 Nancy Ouyang
    ⤷Copy run_command & its dependencies into this crunch_scripts
296
  $ git clone https://github.com/curoverse/arvados.git 
297 1 Nancy Ouyang
298 2 Nancy Ouyang
(Lost? Visit https://github.com/curoverse/arvados )
299
300
  @  @$ cd ./nancy
301
  *@~/projects/nancy@* $ mkdir crunch_scripts
302
  *@~/projects/nancy@* $ cd crunch_scripts
303
  *@~/projects/nancy/crunch_scripts@* $ cp @~@/projects/arvados/crunch_scripts/run_command . #trailing dot!
304
  ~/projects/nancy/crunch_scripts$ cp ~/projects/arvados/crunch_scripts/crunchutil . #trailing dot!
305
306
  @  @$ cd ~/projects/nancy/crunch_scripts
307
308
  @  @$ vi createtwofiles.sh
309
    ⤷ $cat createtwofiles.sh
310
    #!/bin/bash
311
    echo "Hello " > out1.txt
312
    echo "Arvados!" > out2.txt
313
314
  @  @$ vi mergefiles.sh
315 1 Nancy Ouyang
    ⤷$cat mergefiles.sh
316 5 Nancy Ouyang
      #!/bin/bash *#[1]*
317
      PREVOUTDIR=$1 *#[2]*
318
      echo $TASK_KEEPMOUNT/by_id/$PREVOUTDIR *#[3]*
319 1 Nancy Ouyang
      cat $TASK_KEEPMOUNT/by_id/$PREVOUTDIR/*.txt > output.txt
320
    
321 5 Nancy Ouyang
⤷ *Explanations*
322 6 Nancy Ouyang
*[1]* We use the @#!@ syntax to let bash know what to execute this file with
323 5 Nancy Ouyang
324
  ⤷To find the location of any particular tool, try using **which**
325
    $ which python
326
    /usr/bin/python
327
    $ which bash
328
    /bin/bash
329
    
330
*[2]* [[TODO: $1]] Here we give a human-readable name, @PREVOUTDIR@, to the first argument given to @mergefiles.sh@, which (referring back to the pipeline template) we defined as the directory containing the output of the previous job (which ran @createtwofiles.sh@).
331
    
332
*[3]* Using the environmental variable @TASK_KEEPMOUNT@ allows us to not make assumptions about where **keep** is mounted. @TASK_KEEPMOUNT@ will be replaced by Arvados automatically with the name of the location to which **keep** is mounted on each worker node. (Lost? Visit http://doc.arvados.org/user/tutorials/tutorial-keep-mount.html )
333 1 Nancy Ouyang
    
334 6 Nancy Ouyang
<pre>$ chmod +x createtwofiles.sh mergefiles.sh # make these files executable</pre>
335 1 Nancy Ouyang
336
**Commit changes and push to remote**
337
338 2 Nancy Ouyang
A few steps: 
339 1 Nancy Ouyang
340 2 Nancy Ouyang
  $ git status #check that everything looks ok
341
$ git add *
342
$ git commit -m “hello world-of-arvados scripts!”
343
$ git push
344
345 1 Nancy Ouyang
**Install Docker**
346
347 2 Nancy Ouyang
A few steps: 
348 1 Nancy Ouyang
349 2 Nancy Ouyang
  $ sudo apt-get install docker.io
350
$ sudo groupadd docker
351
$ sudo gpasswd -a $USER docker #in my case, I replace $USER with “nancy”
352
$ sudo service docker restart
353
$ exec su -l $USER   #if you don’t want to login+out or spawn a new shell, this will restart your shell
354
355 1 Nancy Ouyang
**Make docker less sad about running out of space on the VM**
356
357 2 Nancy Ouyang
A few steps:
358
359
  $ sudo mkdir /data/docker
360
$ sudo vi /etc/default/docker
361
@  @⤷$ cat /etc/default/docker
362
      DOCKER_OPTS="--graph='/data/docker'"
363
      export TMPDIR="/data/docker"
364 1 Nancy Ouyang
     
365
**Make Arvados less sad about running out of space on the VM**
366 2 Nancy Ouyang
367
A few steps: 
368
369 1 Nancy Ouyang
    $ sudo mkdir /data/docker-cache
370 3 Nancy Ouyang
$ sudo chown nancy:nancy /data/docker-cache
371
$ ln -s /data/docker-cache docker
372 1 Nancy Ouyang
373
**Create Docker image with Arvados command-line tools and other tools we want**
374 2 Nancy Ouyang
375
A few steps: 
376
377 3 Nancy Ouyang
    $ docker pull arvados/jobs
378 1 Nancy Ouyang
$ docker run -ti arvados/jobs /bin/bash
379 2 Nancy Ouyang
380 4 Nancy Ouyang
Now we are in the docker image.
381 2 Nancy Ouyang
382 1 Nancy Ouyang
    root@4fa648c759f3:/# apt-get update 
383
384 2 Nancy Ouyang
    @  @⤷In the docker image, install external tools that you don't expect to need to update often. 
385 1 Nancy Ouyang
    For instance, we can install the wormtable python tool in this docker image
386 2 Nancy Ouyang
    @  @# apt-get install libdb-dev
387 3 Nancy Ouyang
    @  @# pip install wormtable
388 1 Nancy Ouyang
389
    @  @  ⤷ Note: If you're installing from binaries, you should either
390 6 Nancy Ouyang
        1) Install in existing places where bash looks for programs (e.g. install in /usr/local/bin/cgatools). 
391
        To see where bash looks, inspect the PATH variable.
392 1 Nancy Ouyang
          #echo $PATH
393
          /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
394 6 Nancy Ouyang
        2) If you put them in a custom directory, remember them to reference them as such in your scripts
395
        (e.g. spell out /home/nrw/local/bin/cgatools).
396
        Arvados will not respect modifyng the $PATH variable by using the ~/.bashrc configuration file in the docker image.
397 2 Nancy Ouyang
398 1 Nancy Ouyang
(Lost? See http://doc.arvados.org/user/topics/arv-docker.html )
399
    
400
  root@4fa648c759f3:/# exit
401 2 Nancy Ouyang
402 1 Nancy Ouyang
*Commit Docker image*
403 2 Nancy Ouyang
<pre>
404 6 Nancy Ouyang
$ docker commit 4fa648c759f3 nancy/cgatools-wormtable #Label the image thoughtfully
405
$ #For instance here I used the name of key tools I installed: cgatools & wormtable
406 2 Nancy Ouyang
</pre>
407 1 Nancy Ouyang
408 2 Nancy Ouyang
*Upload Docker image from your VM to Keep*
409
<pre>
410
$ arv keep docker nancy/cgatools-wormtable #this takes a few minutes
411
$ arv keep docker #lists docker images in the cloud, so you can double-check what was uploaded </pre>
412 1 Nancy Ouyang
413
**Run this pipeline!**
414
Go to Workbench and hit **Run**.
415 2 Nancy Ouyang
<pre>$ firefox http://su92l.arvadosapi.com</pre>
416 1 Nancy Ouyang
[!image: workbench with 'tiny bash script']
417
418 2 Nancy Ouyang
*Note: If no worker nodes are already provisioned, your job may take up to 10 minutes to queue up and start.* Behind-the-scenes, Arvados is requesting compute nodes for you and installing your Docker image and otherwise setting up the environment on those nodes. Then Arvados will be ready to run your job. Be patient -- the wait time may seem frustrating for a trivial pipeline like this, but Arvados really excels at handling long and complicated pipelines with built-in data provenance and pipeline reproducibility.
419 1 Nancy Ouyang
420
h3. 3.5 Celebrate
421
422
Whew! Congratulations on porting your first pipeline to Arvados! Check out http://doc.arvados.org/user/topics/crunch-tools-overview.html to learn more about the different ways to port pipelines to Arvados and how to take full advantage of Arvados's features, like restarting pipelines from where they failed instead of from the beginning. 
423
424
h2. 4. Debugging Tips and Pro-Tips
425
426
h3. **4.1 Pro-tips**
427
428
**Keep mounts are read-only right now. [19 March 2015]**
429
Need to 1) make some temporary directories or 2) change directories away from wherever you started out in but still upload the results to keep?
430
431
For 1, Explicitly use the $HOME directory and make the temporary files there
432
For 2, Use present working directory, $(pwd) at the beginning of your script to write down the directory where run-command will look for files to upload to keep.
433
434
Here's an example:
435
<pre>
436
$ cat mergefiles.sh
437
  TMPDIR=$HOME #directory to make temporary files in
438
  OUTDIR=$(pwd) #directory to put output files in
439
  mkdir $TMPDIR
440
  touch $TMPDIR/sometemporaryfile.txt #this file is deleted when the worker node is stopped
441
  touch $OUTDIR/someoutputfile.txt #this file will be uploaded to keep by run-command
442
</pre>
443
444
* make sure you point to the right repository, your own or arvados.
445
* make sure you pin the script versions of your python sdk, docker image, and script version or you will not get reproducibiltiy.
446
* if you have a file you want to use as a crunch script, make sure its in a crunch_scripts directory. otherwise, arvados will not find it. i.e. ~/path/to/git/repo/crunch_scripts/foo.py
447
448
h3. 4.2 Common log errors and reasons for pipelines to fail
449
450
Todo.
451
452
h3. 4.3 Miscellaneous Notes
453
454
Other ways to avoid the read-only keep mount problem is to use task.vwd which uses symlinks from the output directory which is writable to the colelction in keep. If you can change your working directory to the output directory and do all your work there, you'll avoid the keep read only issue.  (lost? see http://doc.arvados.org/user/topics/run-command.html )
455
    
456
When indexing, i.e. tabix, bwa index, etc. The index file tends to be created in the same directory as your fastq file. In order to avoid this, use ^. There is no way to send the index file to another directory. If you figure out a way, please tell me.
457
458
"bash" "-c" could be your friend, it works sometimes, sometimes it doesnt. I don't have a good handle on why this works sometimes.
459
460
if you're trying to iterate over >1 files using the task.foreach, its important to know that run-command uses a m x n method of making groups. I dont think I can explain it right now, but it may not be exactly what you want and you can trip over it. (lost? see http://doc.arvados.org/user/topics/run-command.html )
461
462
When trying to pair up reads, its hard to use run-command. You have to manipulate basename and hope your file names are foo.1 foo.2. base name will treat the group as foo (because you'll regex the groups as foo) and you can glob for foo.1 and foo.2. but if the file names are foo_1 and foo_2, you cant regex search them for foo becuase you'll get both names into a group and you'll be iterating through both of them twice, because of m x n. 
463
    
464
Your scripts need to point to the right place where the file is. Its currently hard to figure out how to grep the file names, you have to do some magic through the collection api.
465
466
h2. 5. Learn More
467
468
To learn more, head over to the Arvados User Guide documentation online: http://doc.arvados.org/user/