Warning, /pilot2/doc/getting_started/launch.rst is written in an unsupported language. File is not indexed.
0001 ..
0002 Licensed under the Apache License, Version 2.0 (the "License");
0003 you may not use this file except in compliance with the License.
0004 You may obtain a copy of the License at
0005 http://www.apache.org/licenses/LICENSE-2.0
0006
0007 Authors:
0008 - Daniel Drizhuk, d.drizhuk@gmail.com, 2017
0009 - Paul Nilsson, paul.nilsson@cern.ch, 2017
0010
0011 Launch pilot 2
0012 ==============
0013
0014 The pilot is a dependency-less Python application and relies on ``/usr/bin/env python``. The minimum pilot can be
0015 called like:
0016
0017 .. code-block:: shell
0018
0019 ./pilot.py -d -q <QUEUE_NAME>
0020
0021 The ``QUEUE_NAME`` correspond to the ATLAS PandaQueue as defined in `AGIS`_. This will launch the default ``generic``
0022 workflow with a default lifetime of 10 seconds.
0023
0024 .. _AGIS: http://atlas-agis.cern.ch/agis/
0025
0026 The ``-d`` argument changes the logger to produce debug output.
0027
0028 The current range of implemented pilot options is:
0029
0030 ``-a``: Pilot work directory (string; full path). This is the main work directory for the pilot. In this directory, the
0031 work directory of the payload will be created (``./PanDA_Pilot2_%d_%s" % (os.getpid(), str(int(time.time())))``).
0032
0033 ``-d``: Enable debug mode for logging messages. No value should be specified.
0034
0035 ``-w``: Desired workflow (string). Default is ``generic``, which currently means stage-in, payload execution and
0036 stage-out will be performed. Other workflows to be defined. The workflow name should match an existing module in the
0037 ``workflow`` Pilot 2 directory.
0038
0039 ``-l``: Lifetime in seconds (integer). Default during Pilot 2 testing and implementation stage is currently 3600 s. It
0040 will be increased at a later time.
0041
0042 ``-q``: PanDA queue name (string). E.g. AGLT2_TEST-condor.
0043
0044 ``-s``: PanDA site name (string). E.g. AGLT2_TEST. Note: the site name is only necessary for the dispatcher. The pilot
0045 will send it to the dispatcher with the getJob command.
0046
0047 ``-j``: Job label (string). A prod/source label which currently has default value `ptest`. For production jobs, set
0048 this to `managed` while `user` is the value for user jobs. Setting it to `test` will result in a test job.
0049
0050 ``--cacert``: CA certificate to use with HTTPS calls to server, commonly X509 proxy (string). Not needed on the grid.
0051
0052 ``--capath``: CA certificates path (string). Not needed on the grid.
0053
0054 ``--url``: PanDA server URL (string). Default is `https://pandaserver.cern.ch`.
0055
0056 ``-p``: PanDA server port (integer). Default is `25443`.
0057
0058 ``--config``: Config file path (string). Path to `pilot_config.cfg` file.
0059
0060 ``--country_group``: Country group option for getjob request (string).
0061
0062 ``--working_group``: Working group option for getjob request (string).
0063
0064 ``--allow_other_country``: Is the resource allowed to be used outside the privileged group (boolean)?
0065
0066 ``--allow_same_user``: Multi-jobs will only come from same taskID and thus same user (boolean).
0067
0068 ``--pilot_user``: Pilot user (string). E.g. name of experiment.
0069
0070
0071
0072
0073
0074
0075
0076
0077
