Changes for page User documentation

Last modified by alexisdurieux on 2022/01/27 15:00

From version 2.1
edited by evareill
on 2021/04/28 16:48
Change comment: There is no comment for this version
To version 1.1
edited by evareill
on 2021/04/28 11:57
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -40,6 +40,7 @@
40 40  1. The HPC Job Proxy logs the job results, and pushes the actual cost of the job run for Bob to the EBRAINS Quota Manager.
41 41  1. The HPC Job Proxy notifies the Application of the results of the job.
42 42  
43 +
43 43  == Sample transaction diagram ==
44 44  
45 45  [[image:ebrains-job-proxy-Job sequence.png]]
... ... @@ -51,7 +51,7 @@
51 51  
52 52  * Submit a job: **POST /api/jobs/**
53 53  
54 -To submit a job to the proxy, you need to provide the following information as part of the POST JSON body:
55 +​​​​​​​To submit a job to the proxy, you need to provide the following information as part of the POST JSON body:
55 55  
56 56  * **job_def** - JSON: The Unicore job definition. For more information, please visit the [[__Unicore documentation__>>url:https://sourceforge.net/p/unicore/wiki/Job_Description/]]
57 57  * **site** - string: The Fenix site on which to run the job.
... ... @@ -71,6 +71,7 @@
71 71  JURON
72 72  )))
73 73  
75 +
74 74  * Fetch a job's details: **GET /api/jobs/<job_id>**
75 75  
76 76  The proxy will query Unicore on-the-fly for the job’s latest details. Fenix sites retain the information of past jobs for a set amount of days (30 days at CSCS). If the request is made after that delay, the information returned is that which has been stored in the HPC Job Proxy. The full information retrieved and stored is the following:
... ... @@ -94,9 +94,9 @@
94 94  {{/code}}
95 95  {{/info}}
96 96  
97 -* Fetch a file present in the job's execution directory: **GET /api/jobs/<job_id>/<filename>**
99 +* Fetch a job's file: **GET /api/jobs/<job_id>/<filename>**
98 98  
99 -​​​​​​​Out of convenience, you can fetch the files that are present in the job's execution directory. The output, error and exit code of a job are placed by Unicore in the job’s working directory. The filenames available are: stdout, stderr, UNICORE_SCRIPT_EXIT_CODE. If the job has pre commands or post commands, the following filenames are also available: stdout and stderr respectively under the folders .UNICORE_POST_0/ or .UNICORE_PRE_0/. If your job is creating files than they are too available to be fetched.
101 +​​​​​​​Out of convenience, you can fetch the output of a job (placed by Unicore in the job’s working directory). The filenames available are: stdout, stderr, UNICORE_SCRIPT_EXIT_CODE. If the job has pre commands or post commands, the following filenames are also available: stdout and stderr respectively under the folders .UNICORE_POST_0/ or .UNICORE_PRE_0/
100 100  
101 101  The proxy will respond with the //raw content// of the requested file. These files are available as long as the site does not delete them (30 days for CSCS PIZ DAINT).
102 102