Skip to content

Ticketing template when using RCT pipeline scripts

Ioannis Paraskevakos edited this page Oct 2, 2018 · 2 revisions

When encountering an issue during execution, please check whether the source of the error is in the pipeline script. If you suspect it is, please open a ticket in the respective use case repository. Include any information about the execution setup, such as links to inputs, resource used, number of nodes/cores/gpus, number of pipelines, or any other relevant information.

If you suspect the source of the error comes from EnTK or tools below please open a ticket in the github repo and follow these steps:

Enable verbose messages

Run your script again with RADICAL_VERBOSE=DEBUG and RADICAL_ENTK_VERBOSE=DEBUG. Once these environment variables are set, a lot of messages will be displayed as they are written to the standard error stream. Please redirect these messages to a single file.

Example:

RADICAL_VERBOSE=DEBUG RADICAL_ENTK_VERBOSE=DEBUG python example.py &> verbose.log

Attach verbose.log to the ticket.

NOTE: If you suspect sections of this file to be pointing to the error you may consider mentioning that in the ticket via inline comments.

Example:
```
These lines of the log might be 
talking about the error
```

Client and remote logs in RP

When running a RP script or a tool that uses RP, multiple logs are created by the components of RP. A set of these logs are created in the current working directory on the client machine (where your script lies) and a set of logs are created on the remote machine (HPC) in a specific location. You can bring all the logs to the client by running the following cmd (on the client):

radicalpilot-fetch-logfiles <session id>

In order to determine the session id, you can look for a folder that is created on the client in current working directory. It should have the format rp.session.*. You can find the latest folder by doing ls -ltr (last is recent). All the logfiles are brought to this rp.session.* folder. Please zip this folder and attach to github ticket.

Access to sandbox

Sometimes the above two steps may not be enough, the developers might require to take a look at the entire sandbox. You may either downlod the entire sandbox from the remote machine (using scp/gsiscp), zip the folder, and attach it to the ticket or provide access to the sandbox on the remote machine.

If you are not sure where to open a ticket please prefer the use case repo.

Also report the Python you are using as well as the radical-stack

Clone this wiki locally