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

The following environment variables need to change if necessary.

Name

Description

Example

PANDA_URL_SSL

Base HTTPS URL of PanDA server

https://pandaserver-doma.cern.ch/server/panda

PANDA_URL

Base HTTP URL of PanDA server

http://pandaserver-doma.cern.ch:25080/server/panda

PANDAMON_URL

URL of PanDA monitor

https://panda-doma.cern.ch

PANDACACHE_URL

Base URL of PanDA sandbox server

https://pandaserver-doma.cern.ch/server/panda

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