Update of DIRAC user workflows (#179)

* Minor fixes

* Reviving distributed computing section

* Removing unnecesary changes

* Recovering image

---------

Co-authored-by: Juraj Smiesko <j@kjvbrt.org>

Author: kjvbrt

.gitignore

@@ -40,4 +40,4 @@ node_modules
 book.pdf
 *~
 build
-venv
+venv

5-distributed-computing/README.md

@@ -28,6 +28,7 @@ Unless specified otherwise, in the remainder of this section the word `DIRAC` re
 
 ```{eval-rst}
 .. toctree::
+    :maxdepth: 2
     :caption: Contents:
 
     ./EventProducer.md

5-distributed-computing/RegisteringToFccVO.md

@@ -1,4 +1,4 @@
-# Getting Started with DIRAC
+# Getting started with FCC distributed computing
 
 <!-- contributors:start -->
 :::{admonition} Page contributors
@@ -8,26 +8,29 @@ Gerardo Ganis, Juraj Smiesko, Brieuc Francois
 :::
 <!-- contributors:end -->
 
+
+For more detailed documentation how user's can use the distributed resources
+managed by iLCDirac, refer to the iLCDirac's
+[User Guide](https://ilcdirac-doc.web.cern.ch/DOC/Files/UserGuide/index.html).
+
 ## Registering to the FCC VO
 
-The [standard Grid VO registration procedure][signup]
-should be followed to be enable to use the resources connected with the FCC VO (open a request only if you need to).
+The [standard Grid VO registration procedure][signup] should be followed to be
+able to use the resources connected with the FCC Virtual Organization (VO).
 If your request is pending approval for too long, please [contact us](mailto:FCC-PED-SoftwareAndComputing-Coordination@cern.ch).
 
 :::{admonition} Note
 :class: callout
 
-You need to use a browser where you have installed your certificate and the
-[CERN CA][cernca] certificates. Firefox usually works fine, Google Chrome
-usually does not work. Safari might also work.
+As for the VO registration, you need to use a browser where you can import your
+GRID certificate together with the [CERN CA][cernca] certificates. Firefox
+usually works fine, Google Chrome usually does not work. Safari might also work.
 :::
 
-[signup]: https://fcc-auth.cern.ch/dashboard#!/newClient
-
 ## Enabling DIRAC
 
 DIRAC is available on CernVM-FS. To enable the relevant applications and
-scripts, the following setup script needs to be sourced first
+scripts, the following setup script needs first to be sourced
 
 ```bash
 source /cvmfs/clicdp.cern.ch/DIRAC/bashrc
@@ -38,7 +41,9 @@ To submit jobs through DIRAC a proxy needs to be created and uploaded:
 ```bash
 dirac-proxy-init -g fcc_user
 ```
+
 A successful creation looks like this:
+
 ```
 Generating proxy...
 Enter Certificate password:
@@ -60,11 +65,15 @@ Proxies uploaded:
  DN                                                                           | Group | Until (GMT)
  /DC=ch/DC=cern/OU=Organic Units/OU=Users/CN=ganis/CN=393971/CN=Gerardo Ganis |  | 2022/05/13 12:12
 ```
+
 The last section shows the valid proxies upload to the DIRAC system. It can also be checked with
+
 ```bash
 dirac-proxy-info -m
 ```
+
 with output similar to
+
 ```
 subject      : /DC=ch/DC=cern/OU=Organic Units/OU=Users/CN=ganis/CN=393971/CN=Gerardo Ganis/CN=2178341058/CN=3000266373
 issuer       : /DC=ch/DC=cern/OU=Organic Units/OU=Users/CN=ganis/CN=393971/CN=Gerardo Ganis/CN=2178341058
@@ -87,12 +96,14 @@ If everything worked fine, your proxy should be mapped to the `fcc001` user. Thi
 export EOS_MGM_URL=root://eospublic.cern.ch
 XrdSecPROTOCOL=gsi,unix eos whoami
 ```
+
 the result should look similar to this:
+
 ```
 Virtual Identity: uid=140035 (99,140035) gid=2855 (99,2855) [authz:gsi] host=lxplus743.cern.ch domain=cern.ch geo-location=0513
 ```
 
-At CERN the uid of `fcc001` is 140035.
+At CERN the uid of `fcc001` is `140035`.
 
 ## Copying, browsing, accessing files
 
@@ -116,7 +127,7 @@ $ ls -lt /eos/experiment/fcc/prod/fcc/user/g/ganis
 total 9545
 -rw-r--r--. 1 fcc001 fcc-cg 9768981 Nov  3  2021 edm4hep_test_output.root
 ```
-Files can be replicated to another STorage Element, e.g. CNAF-DISK, using
+Files can be replicated to another Storage Element, e.g. CNAF-DISK, using
 `dirac-dms-replicate-lfn`:
 ```
 $ dirac-dms-replicate-lfn /fcc/user/g/ganis/edm4hep_test_output.root CNAF-DISK
@@ -143,17 +154,13 @@ root [1]
 
 ## The web portal
 
-The [DIRAC web portal][diracweb] is available to check the status of things. It shows all the jobs submitted and the
-files registered.
+The [DIRAC web portal][diracweb] is available to check the status of things. It
+shows all the jobs submitted and the files registered. An example screenshot
+is shown below.
 
+![ILCDirac Web](images/dirac-web-job-listing.png)
 
-:::{admonition} Note
-:class: callout
-
-As for the VO registration, you need to use a browser where you have installed
-your certificate and the [CERN CA][cernca] certificates. Firefox usually works
-fine, Safari might also work. Google Chrome usually does not work.
-:::
 
-[diracweb]: https://voilcdiracwebapp2.cern.ch/DIRAC/?view=tabs&theme=Crisp&url_state=1|*DIRAC.JobMonitor.classes.JobMonitor
+[signup]: https://fcc-auth.cern.ch/start-registration
+[diracweb]: https://voilcdiracwebapp2.cern.ch/DIRAC/?theme=Classic&url_state=1|*DIRAC.JobMonitor.classes.JobMonitor:,
 [cernca]: https://ca.cern.ch/cafiles/certificates/Grid.aspx

5-distributed-computing/Workflows.md

@@ -8,15 +8,22 @@ Gerardo Ganis, Juraj Smiesko
 :::
 <!-- contributors:end -->
 
-These pages provide - and dissect - examples of workflows to be run on distributed resources with the [DIRAC Interware system][dirac].
+>
+> Original author: Gerardo Ganis
+>
 
-The python scripts discussed in these pages are available at [https://github.com/HEP-FCC/FCCDIRAC][fccdirac].
+These pages provide &mdash; and dissect &mdash; examples of workflows to be run
+on distributed resources of FCC with the [DIRAC Interware system][dirac].
+
+The python scripts discussed in these pages are available at
+[https://github.com/HEP-FCC/FCCDIRAC][fccdirac].
 
 [dirac]: https://dirac.readthedocs.io/en/latest/
-[fccdirac]: https://github.com/HEP-FCC/FCCDIRAC
+[fccdirac]: https://github.com/HEP-FCC/FCCDIRAC/tree/master/workflows
 
 ```{eval-rst}
 .. toctree::
+    :maxdepth: 2
     :caption: Contents:
 
     workflows/Overview.md