sbsv2/raptor/notes/localresourcecopying.txt
author mikek
Fri, 04 Jun 2010 13:09:28 +0100
changeset 18 de5b887c98f7
permissions -rw-r--r--
Upgrading to Raptor 2.14
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
18
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     1
Resources were copied using make rules.  This is sensible in local
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     2
machine builds but non-optimal in cluster builds.  It is entirely IO
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     3
bound so that instead of benefitting from running on the cluster it
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     4
simply creates more IO as files need to be transferred over the network,
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     5
possibly multiple times.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     6
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     7
This change introduces the <finalcopy> tag to the log which the frontend
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     8
reads in a new "default" filter called FilterCopyFile.  Thus the python
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
     9
frontend does the copying rather than the cluster build engine.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    10
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    11
This happens at the end of each invocation of the build engine or "stage".
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    12
Since resources are built in their own stage, the copying is completed
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    13
before build tasks in the other stages require them.  The copied files
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    14
are not needed in the resource stage itself.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    15
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    16
The filter uses <progress:end ...> tags to determine when a stage
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    17
is finished and this requires that the timing feature be switched on
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    18
permanently.
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    19
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    20
The format of the tag is:
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    21
<finalcopy source="sourcefilename">dest_filename1 dest_filename2 ...</finalcopy>
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    22
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    23
Spaces may not be used in filenames. The sequence "%20" may be used
de5b887c98f7 Upgrading to Raptor 2.14
mikek
parents:
diff changeset
    24
instead.