|
|
| Line 1: |
Line 1: |
| | =Overview= | | =Overview= |
| − | General notes on design and deployment can be found on a separate page: [[ P3s notes ]] | + | General notes on design and deployment (some of historical interest) |
| | + | can be found on a separate page: "[[ P3s notes ]]". On that page, the basics |
| | + | of the pilot framework approach to p3s design and implementation are explained. |
| | | | |
| − | = Deployment Status =
| + | What is presented below is a brief "how-to" for p3s. |
| − | == Services and Software Provisioning ==
| |
| − | * p3s is running on Openstack: p3s-web, currently visible only within the CERN perimeter
| |
| − | * EOS mounted
| |
| − | * LArSoft/dunetpc is periodically built at CERN by Dorota Stefan
| |
| − | ** software set up using CVMFS and EOS
| |
| − | ** tested under p3s
| |
| − | * If payloads need a customized environment (e.g. python modules etc) this can be achieved using the "virtual environment" where various software can be managed in the user space
| |
| − | ** still needs common AFS or EOS area to be provisioned to the WN
| |
| − | * AFS will be available on lxplus/lxbatch till the end of 2018
| |
| − | ** still heavily used by the LHC experiments
| |
| − | ** its “EOS equivalent” works but is still work in progress
| |
| − | * Currently p3s relies on a few machines in the neut cluster to host Web and DB services
| |
| − | ** while most nodes will be migrated to EHN1, it is important to secure a few “neurdqm” at least in the medium term
| |
| − | ** needed for integration and basic testing in a controlled environment
| |
| | | | |
| − | == LXBATCH == | + | =Clients and Servers= |
| − | http://batchdocs.web.cern.ch/batchdocs/
| + | The user interacts with the system by means of clients. This is the only way |
| | + | to change the state of the server and the objects it contains it its database. |
| | | | |
| − | =Pilots and Jobs=
| + | The p3s server provides the following set of functionality: |
| − | ==Pilots==
| + | * creates entities e.g. job records in its database, according to messages received from clients which may be actuated by the user or run as a part of an automated script |
| − | Pilots are created completely independently of the server and contact the server via HTTP once they are initiated. The server searches its database of "defined jobs", sorts the jobs by priority and sends a reference to a job to the pilot which sent the request. In the current version, the job reference contains the path to the executable, its parameters and also the part of the job environment which helps to reference the data both in the input and the output by using environment variables.
| |
| | | | |
| − | States:
| + | * changes the state of entities |
| − | * active | |
| − | * dispatched
| |
| − | * running
| |
| − | * finished (completion of a job)
| |
| − | * stopped (timeout w/o getting a job)
| |
| − | | |
| − | Status:
| |
| − | * OK
| |
| − | * FAIL
| |
| − | | |
| − | ==Jobs==
| |
| − | States:
| |
| − | * template
| |
| − | * defined
| |
| − | * dispatched (sent to a pilot for execution)
| |
| − | * running
| |
| − | * finished
| |
| − | | |
| − | Events:
| |
| − | * jobstart
| |
| − | * jobstop
| |
| − | | |
| − | ==Matching jobs to pilots==
| |
| − | Jobs are created in the "template" state and won't be matched
| |
| − | | |
| − | =DAG=
| |
| − | ==DAG as a template==
| |
| − | * DAG describes the topology and general properties of a workflow, and serves as a template for workflows. The system stores multiple templates referred to by their names.
| |
| − | | |
| − | * Vertex and Edge tables: vertices are jobs and the edges are data. The edge class has the following attributes at a minimum
| |
| − | ** ID
| |
| − | ** Source node
| |
| − | ** Target node
| |
| − | | |
| − | The ID is important if we want to support multiple edges between same nodes (e.g. files of different types produced by one job and consumed by another). This type of DAG is sometimes called MultiDiGraph but terminology may vary. Of course other useful parameters are implemented (path, state etc) as the edges refer to actual data.
| |
| − | | |
| − | * Leaves of a DAG: can only be a job, not data (since all data are edges and not vertices). This also has the benefit of not having final data unaccounted for - it must me either flushed or moved to permanent storage in most cases. The job/task responsible for either of these operations forms the leaf. If the data source for the root of the tree is purely external, such DAG nodes is assigned a special type "NOOP" and is handled accordingly (e.g. no pilots are necessary for its execution and it's essentially a pass-through)
| |
| − | | |
| − | <hr/>
| |
| − | =P3S walk-through=
| |
| − | Below is a scenario of the actual operation of the p3s prototype as it is tested:
| |
| − | | |
| − | * DAGs which are templates for actual workflows are defined in XML and sent to the p3s server where they are stored, as needed. There is no limit on how many templates can be in the system, and they can be updated or deleted at will. They are identified by a unique name and I propose to use this for versioning too, for simplicity.
| |
| − | | |
| − | * Also for simplicity, payloads are fixed in a particular DAG - which means DAGs of same topology but with different node content (or with different data types corresponding to edges) will be considered different. Doing proper inheritance quickly became too complex so I skipped it. To illustrate, if you change an executable in a single node or a single file format in a DAG, you will have to create a new DAG (and under a new name, presumably).
| |
| − | | |
| − | * a watcher script detects existence of a file (configurable) in a directory (configurable), it will loop and sleep as configured. If triggered, it's configured to create a workflow based on a specific DAG template.
| |
| − | | |
| − | * as per the above statement, the server is prompted via HTTP to create a workflow based on a pre-loaded template of a certain kind; the edges in the DAG which served as placeholders are populated with the actual file path information provided by the watcher (or rather its instance, which can be many). Multiple files can be plugged into a DAG if needed via the same interface.
| |
| − | | |
| − | * if the first node in the graph is a NOOP it's automatically toggled to "finished" so the rest of the DAG can proceed. This covers the scenario where the source of the data is purely external - however it doesn't need to be and the file finding jobs can be the first node (I think you suggested this once). The "first node" is picked via topological sorting, so it's scientific.
| |
| − | | |
| − | * the first unfinished job in the graph which is not dummy (NOOP) is automatically set to "defined" state, which means it can be matched to a pilot. Other jobs remain in the "template" state until their ancestors are executed.
| |
| − | | |
| − | * in the meantime, an independent script on some worker node is creating pilots (again, looping and sleeping as configured)
| |
| − | | |
| − | * brokerage (matching) happens and jobs get executed; their children in the graph are then toggled to "defined" state so they in turn can be picked by the pilots.
| |
| − | | |
| − | * every time a job is finished we check if it was the last one in a DAG, in which case the whole workflow is toggled to "finished" state.
| |
| − | | |
| − | | |
| − | =LArSoft=
| |
| − | <pre>
| |
| − | you will find larsoft in:
| |
| − | /mnt/nas01/software/dqm/larsoft/
| |
| − | | |
| − | To setup cvfms:
| |
| − | source /cvmfs/dune.opensciencegrid.org/products/dune/setup_dune.sh
| |
| − | source /cvmfs/fermilab.opensciencegrid.org/products/larsoft/setups
| |
| − | | |
| − | then in the directory where larsoft is:
| |
| − | cd /mnt/nas01/software/dqm/larsoft/v06
| |
| − | source localProducts_larsoft_v06_33_00_e14_prof/setup
| |
| − | mrbslp
| |
| − | | |
| − | To run one example from Voica's modules:
| |
| − | lar -c job/onlinemonitorprotodune.fcl /mnt/nas01/users/radescu/Feb2017_v22/inputs/detsim_single_DistONSuppOFF_100.root
| |
| − | | |
| − | if you want only one event then:
| |
| − | lar -c job/onlinemonitorprotodune.fcl /mnt/nas01/users/radescu/Feb2017_v22/inputs/detsim_single_DistONSuppOFF_100.root -n1
| |
| − | | |
| − | at the end it should create:
| |
| − | onlinemonit.root
| |
| − | and three text files (Voica knows what is there)
| |
| − | | |
| − | | |
| − | lar -c /mnt/nas01/software/dqm/larsoft/v06/job/onlinemonitorprotodune.fcl /mnt/nas01/users/radescu/Feb2017_v22/inputs/detsim_single_DistONSuppOFF_100.root -n1
| |
| − | </pre>
| |
| − | | |
| − | = Archive =
| |
| − | ==Online Hardware==
| |
| − | P3S is not using this hardware which was initially planned for deployment in EHN1, so this is of purely
| |
| − | historical interest
| |
| − | | |
| − | Cooling power (water) for 18 racks, each consuming up to 18KW
| |
| − | * 6 cooled racks to the DAQ (3 NP04 and 3 NP02) in one counting room
| |
| − | * 12 cooled racks for computing farms in a second counting room
| |
| − | | |
| − | ==AutoPyFactory==
| |
| − | * https://twiki.grid.iu.edu/bin/view/Documentation/Release3/AutoPyFactory
| |
| − | * https://twiki.grid.iu.edu/bin/view/Documentation/Release3/AutoPyFactoryDeployment
| |
| − | * https://twiki.grid.iu.edu/bin/view/Documentation/Release3/AutoPyFactory
| |
| − | | |
| − | <pre>
| |
| − | [CERN_COMPASS_PROD]
| |
| − | enabled = True
| |
| − | batchqueue = CERN_COMPASS_PROD
| |
| − | wmsqueue = CERN_COMPASS_PROD
| |
| − | batchsubmitplugin = CondorOSGCE
| |
| − | batchsubmit.condorosgce.gridresource = ce503.cern.ch
| |
| − | #batchsubmit.condorosgce.gridresource = condorce01.cern.ch
| |
| − | sched.maxtorun.maximum = 9999
| |
| − | batchsubmit.condorosgce.condor_attributes = periodic_remove = (JobStatus == 2 && (CurrentTime - EnteredCurrentStatus) > 604800)
| |
| − | batchsubmit.condorosgce.condor_attributes.+maxMemory = 1900
| |
| − | batchsubmit.condorosgce.condor_attributes.+xcount = 1
| |
| − | batchsubmit.condorosgce.proxy = compass-production
| |
| − | executable.arguments = %(executable.defaultarguments)s
| |
| − | | |
| − | executable = /home/autopyfactory/runpilot3-wrapper-compass.sh
| |
| − | executable.defaultarguments = -F COMPASS -s %(wmsqueue)s -h %(batchqueue)s -I vm127.jinr.ru -p 943 -w https://vm127.jinr.ru
| |
| − | </pre>
| |
