Client tools for Panda analysis jobs

This page is outdated. New documentation is available at https://panda-wms.readthedocs.io/en/latest/client/panda-client.html

       Current version of panda-client : 1.4.36 (9/7/2020)  

Introduction

The panda-client package contains following tools to submit/manage analysis jobs on PanDA.

• pathena
  • Athena jobs
• prun
  • ROOT/general jobs
• pbook
  • Bookkeeping

---

Preparation

First of all, please make sure you have a grid certificate. See Starting on the Grid. You should have usercert.pem and userkey.pem under ~/.globus.

$ ls ~/.globus/*
usercert.pem userkey.pem

Installation

The panda-client package is distributed in two kinds of format, tarball and rpm. Users can choose one format as they like. Installation procedure is described individually. You can find available release packages in the repository. If you are using CVMFS you can skip this section and go directly to setup for CVMFS user.

tarball

wget --no-check-certificate https://atlpan.web.cern.ch/atlpan/panda-client/panda-client-1.4.36.tar.gz
tar xvfz panda-client-*
cd panda-client-*
python setup.py install --prefix=[install dir]

e.g.,

python setup.py install --prefix=~/mypanda

pip

You need root privilege, or to use --user, or virtualenv.

pip install panda-client

Setup

If you are using CVMFS see setup for CVMFS user.

First, you need to source the panda setup script according to your installation. The script sets PANDA_CONFIG_ROOT (~/.pathena by default) in addition to some environment variables. PANDA_CONFIG_ROOT is a directory name where user's configuration/data files are contained.

source [install dir]/etc/panda/panda_setup.[c]sh

e.g.,

source ~/mypanda/etc/panda/panda_setup.sh

For rpm,

source /etc/panda/panda_setup.sh

If you are going to use pathena, this step needs to be done after sourcing Athena's setup.sh since it changes the PATH environment variable. e.g.,

source setup.sh -tag=15.6.10,32,setup
source ~/mypanda/etc/panda/panda_setup.sh

Setup file on CVMFS

The latest version of panda-client is also available on CVMFS. You don't need to maintain the package by yourself. To setup

export ATLAS_LOCAL_ROOT_BASE=/cvmfs/atlas.cern.ch/repo/ATLASLocalRootBase
setupATLAS
lsetup panda

---

Documentation on individual tool

The following pages describe how to use tools;

• pathena
  • How to submit Athena jobs to PanDA
• prun
  • How to submit ROOT/General jobs to PanDA
• pbook
  • Bookkeeping for PanDA analysis jobs
• phpo
  • How to submit hyperparameter optimization jobs to PanDA

---

Release Notes

See ChangeLog.