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