Skip to content

Commit

Permalink
adding documentation for certificate change problems (#162)
Browse files Browse the repository at this point in the history
  • Loading branch information
WardDeb authored Jan 5, 2024
2 parents 394bc31 + 6cc99ae commit 66aed10
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions docs/usage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,21 @@ remove all the flags:

and rerun dissectBCL. Note that an existing demuxSheet in the folder won't be overwritten, allowing you to jump in.

Issues with Parkour verification
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In this case (which is rare as it's caused by changing the certificate provider and it is not commonly listed), the certificate issuer is not recognized as dissect throws this error:

.. code-block:: console
requests.exceptions.SSLError: HTTPSConnectionPool(host='parkourURL', port=443): Max retries exceeded with url:
/api/analysis_list/analysis_list/?flowcell_id=XXXXXXXXX (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate
verify failed: unable to get local issuer certificate (_ssl.c:1007)')))
then, the new certificate needs to be added in the system (i.e. for CentOS 7, copying it to /etc/pki/ca-trust/source/anchors/ and run "update-ca-trust").

Finally, the cert field under the parkour header in the configuration file needs to point to the file copied in the anchors directory.


Other issues
^^^^^^^^^^^^
It can happen that the pipeline just crashes. A point of entry there would be to have a look at the log files. These are written per flowcell.
Expand Down

0 comments on commit 66aed10

Please sign in to comment.