panda-client
The panda-client package includes python modules and command-line tools to allow end-users to submit/manage their analysis on the PanDA system. This package is supposed to be used by end-users as functionality is simplified and limited. System administrators or developers should refer to API reference.
Installation
panda-client works either python 2 and 3, and is self-contained so that you don’t have to install an external package or software. The installation step can be skipped if panda-client has been centrally installed like ATLAS. Otherwise, simply run the following pip command in a virtual environment to install all python modules, command-line tools and configuration files:
pip install panda-client
If you install panda-client in JupyterLab,
pip install panda-client[jupyter]
will install extra packages in addition to panda-client.
Setup
The setup file panda_setup.(c)sh is automatically generated under $VIRTUAL_ENV/etc/panda when panda-client
is installed via pip. You need to source the file to setup the required environment variables before using the
python modules and command-line tools. It is good to define a shell function to source the setup file as shown
in the ATLAS users tag.
source $VIRTUAL_ENV/etc/panda/panda_setup.sh
export ATLAS_LOCAL_ROOT_BASE=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase
setupATLAS
lsetup panda
The following environment variables need to change if necessary.
Name |
Description |
Example |
|---|---|---|
PANDA_URL_SSL |
Base HTTPS URL of PanDA server |
|
PANDA_URL |
Base HTTP URL of PanDA server |
|
PANDAMON_URL |
URL of PanDA monitor |
|
PANDACACHE_URL |
Base URL of PanDA sandbox server |
|
PANDA_AUTH |
Authentication mechanism. oidc to enable OIDC/OAuth2.0. x509_no_grid to use X509 without grid niddleware |
oidc |
PANDA_AUTH_VO |
Virtual organization name (required only when PANDA_AUTH=oidc) |
wlcg |
PANDA_VERIFY_HOST |
Set off to disable the host verification |
off |
PANDA_USE_NATIVE_HTTPLIB |
Set 1 to use native http lib instead of curl |
1 |
X509_USER_PROXY |
Grid proxy file path (required only when PANDA_AUTH = x509_no_grid) |
/tmp/x509up_u`id -u` |
PANDA_NICKNAME |
Grid nickname (required only when PANDA_AUTH = x509_no_grid) |
my_nickname |
export PANDA_URL_SSL=https://pandaserver-doma.cern.ch/server/panda
export PANDA_URL=http://pandaserver-doma.cern.ch:25080/server/panda
export PANDACACHE_URL=https://pandaserver-doma.cern.ch/server/panda
export PANDAMON_URL=https://panda-doma.cern.ch
export PANDA_AUTH=oidc
export PANDA_AUTH_VO=<your organization>
export PANDA_USE_NATIVE_HTTPLIB=1
export PANDA_AUTH=oidc
export PANDA_AUTH_VO=atlas
export PANDA_USE_NATIVE_HTTPLIB=1