From 3c6007df46f7446439be8d0890d92559fec414ee Mon Sep 17 00:00:00 2001 From: "Bruno P. Kinoshita" Date: Wed, 9 Aug 2023 10:49:01 +0200 Subject: [PATCH 1/3] Review error codes, add info from the Python Log module --- docs/source/troubleshooting/error-codes.rst | 247 +++++++++++--------- 1 file changed, 143 insertions(+), 104 deletions(-) diff --git a/docs/source/troubleshooting/error-codes.rst b/docs/source/troubleshooting/error-codes.rst index 9ed70aa32..c9a40efbc 100644 --- a/docs/source/troubleshooting/error-codes.rst +++ b/docs/source/troubleshooting/error-codes.rst @@ -2,171 +2,210 @@ Error codes and solutions ######################### +.. note:: + Increasing the logging level gives you more detailed information + about your error, e.g. ``autosubmit -lc DEBUG -lf DEBUG ``, + where ``>`` could be ``create``, ``run``, etc. + +Every error in Autosubmit contains a numeric error code, to help users and developers +to identify the category of the error. These errors are organized as follows: + ++---------------+-------------+ +| Level | Starts from | ++===============+=============+ +| EVERYTHING | 0 | ++---------------+-------------+ +| STATUS_FAILED | 500 | ++---------------+-------------+ +| STATUS | 1000 | ++---------------+-------------+ +| DEBUG | 2000 | ++---------------+-------------+ +| WARNING | 3000 | ++---------------+-------------+ +| INFO | 4000 | ++---------------+-------------+ +| RESULT | 5000 | ++---------------+-------------+ +| ERROR | 6000 | ++---------------+-------------+ +| CRITICAL | 7000 | ++---------------+-------------+ +| NO_LOG | 8000 | ++---------------+-------------+ + +Levels such as ``DEBUG``, ``WARNING``, ``INFO``, and ``RESULT`` are commonly +used when writing log messages. You may find it in the output of commands in +case there is a minor issue with your configuration such as a deprecated call. + +The two levels that normally appear with traceback and important log messages +are either ``ERROR`` or ``CRITICAL``. + +Autosubmit has two error types. ``AutosubmitError`` uses the ``ERRORR`` level, +and is raised for minor errors where the program execution may be able to +recover. ``AutosubmitCritical`` uses the ``CRITICAL`` level and is for errors +that abort the program execution. + +The detailed error codes along with details and possible workarounds are +listed below. + +Minor errors - Error codes [6000+] +=================================== + ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| Code | Details | Solution | ++======+==========================================+================================================================================================+ +| 6001 | Failed to retrieve log files | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6002 | Failed to reconnect | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6003 | Failed connection, wrong configuration | Check your platform configuration | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6004 | Input output issues | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6005 | Unable to execute the command | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6006 | Failed command | Check err output for more info, command worked but some issue was detected | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6007 | Broken sFTP connection | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6008 | Inconsistent/unexpected, job status | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6009 | Failed job checker | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6010 | Corrupted ``job_list`` using backup | Automatically, if it fails try ``mv /pkl/job_list_backup.pkl /pkl/job_list.pkl`` | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6011 | Incorrect mail notifier configuration | Double check your mail configuration on your job configuration (job status) and | +| | | the experiment configuration (email) | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6012 | Migrate, archive/unarchive I/O issues | Check the migrate configuration | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6013 | Configuration issues | Check log output for more info | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6014 | Git can not clone repository submodule | Check submodule url, perform a ``refresh`` | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6015 | Submission failed | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ +| 6016 | Temporary connection issues | Automatically, if there are no major issues | ++------+------------------------------------------+------------------------------------------------------------------------------------------------+ + Experiment Locked - Critical Error 7000 ======================================= -+------------------------------------------------------------------------------------------------------------------------------------------------+ -| Code | Details | Solution | -+======+===================================================================+=====================================================================+ -| 7000 | Experiment is locked due another instance of Autosubmit using it | Halt other experiment instances //Delete /tmp/autosubmit.lock| -+------+-------------------------------------------------------------------+---------------------------------------------------------------------+ -Database Issues - Critical Error codes [7001-7005] ++--------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Code | Details | Solution | ++======+===================================================================+=============================================================================+ +| 7000 | Experiment is locked due another instance of Autosubmit using it | Halt other experiment instances, then ``rm /tmp/autosubmit.lock`` | ++------+-------------------------------------------------------------------+-----------------------------------------------------------------------------+ + +Database Issues - Critical Error codes [7001-7009] =================================================== +These issues occur due to server side issues. Check your site settings, and +report an issue to the Autosubmit team in Git if the issue persists. + +------------------------------------------------------------------------------------------------------------------------+ | Code | Details | Solution | +======+===============================================+=================================================================+ -| 7001 | Connection to the db could not be established | Check if database exist | +| 7001 | Connection to the db could not be established | Check if database exists | +------+-----------------------------------------------+-----------------------------------------------------------------+ | 7002 | Wrong version | Check system sqlite version | +------+-----------------------------------------------+-----------------------------------------------------------------+ -| 7003 | Database doesn't exist | Check if database exist | +| 7003 | Database doesn't exist | Check if database exists | +------+-----------------------------------------------+-----------------------------------------------------------------+ | 7004 | Can't create a new database | Check your user permissions | +------+-----------------------------------------------+-----------------------------------------------------------------+ -| 7005 | AS database is corrupted or locked | Please, open a new issue ASAP. (If you are on BSC environment) | +| 7005 | AS database is corrupted or locked | Report the issue to the Autosubmit team in Git | +------+-----------------------------------------------+-----------------------------------------------------------------+ -| 7006 | Experiment database not found | Please, ask your administrator to run `autosubmit install` | +| 7006 | Experiment database not found | Ask the site administrator to run ``autosubmit install`` | +------+-----------------------------------------------+-----------------------------------------------------------------+ -| 7007 | Experiment database permissions | Invalid permissions, ask your administrator to add R/W | +| 7007 | Experiment database permissions | Invalid permissions, ask your administrator to add ``R/W`` | +------+-----------------------------------------------+-----------------------------------------------------------------+ -.. _default_solution_1: - -Default Solution ----------------- -These issues are usually from server side, please, ask first in Autosubmit git if you don't have a custom installation. - ----- - Wrong User Input - Critical Error codes [7010-7030] ==================================================== +These issues are caused by the user input. Check the logs and also the +existing issues in git for possible workarounds. Report an issue to the +Autosubmit team in Git if the issue persists. + +------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ | Code | Details | Solution | +======+======================================================+================================================================================================+ -| 7010 | Experiment has been halted in a manual way | +| 7010 | Experiment has been halted manually | | +------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 7011 | Wrong arguments for an specific command | Check the command section for more info | +| 7011 | Wrong arguments for a specific command | Check the command section for more information | +------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 7012 | Insufficient permissions for an specific experiment. | Check if you have enough permissions, experiment exist or specified expid has a typo | +| 7012 | Insufficient permissions for an specific experiment | Check if you have enough permissions, and that the experiment exists | +------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 7013 | Pending commits | You must commit/synchronize pending changes in the experiment proj folder. | +| 7013 | Pending commits | You must commit pending changes in the experiment ``proj`` folder | +------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 7014 | Wrong configuration | Check your experiment/conf files, also take a look to the ASLOG/command.log detailed output | +| 7014 | Wrong configuration | Check your experiment configuration files, and at the ``/tmp/ASLOG/.log`` output | ++------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ +| 7015 | Job list is empty | Check your experiment configuration files | +------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ - -**Default Solution** - -These issues are usually mistakes from the user input, check the available logs and git resolved issues. Alternative, you can ask for help to Autosubmit team. - ----- Platform issues - Critical Error codes. Local [7040-7050] and remote [7050-7060] ================================================================================= +The Autosubmit logs should contain more detailed information about the error. +Check your platform configuration and general status (connectivity, permissions, +etc.). + +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Code | Details | Solution | +======+=================================================================+=========================================================================================================================================+ -| 7040 | Invalid experiment pkl/db likely due a local platform failure | Should be recovered automatically, if not check if there is a backup file and do it manually | -+------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -| 7041 | Weird job status | Weird Job status, try to recover experiment(check the recovery how-to for more info) if this issue persist please, report it to gitlab | +| 7040 | Invalid experiment ``pkl`` or ``db`` files | Should be recovered automatically, if not check if there is a backup file and do it manually | +------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -| 7050 | Connection can't be established. | Check your experiment platform configuration | +| 7041 | Unexpected job status | Try to run ``autosubmit recovery ``, report the issue to the Autosubmit team if it persists | +------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -| 7050 | Failure after a restart, connection can't be restored. | Check or ask (manually) if the remote platforms have any known issues | +| 7050 | Connection can not be established | Check your experiment platform configuration | +------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -| 7051 | Invalid ssh configuration. | Check .ssh/config file. Additionally, Check if you can perform a password less connection to that platform. | +| 7051 | Invalid SSH configuration | Check ``.ssh/config`` file. Additionally, check if you can perform a password-less connection to that platform | +------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -| 7052 | Scheduler is not installed or correctly configured. | Check if there is a scheduler installed in the remote machine. | +| 7052 | Scheduler is not installed or not correctly configured | Check if there is a scheduler installed in the remote machine | +------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -**Default Solution** - -Check autosubmit log for detailed information, there will be additional error codes. - ----- - Uncatalogued codes - Critical Error codes [7060+] ================================================== +The Autosubmit logs should contain more detailed information about the error. +If you believe you found a bug, feel free to report an issue to the Autosubmit +team in Git. + +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Code | Details | Solution | +======+===============================================+==================================================================================================================================================================================+ -| 7060 | Display issues during monitoring | Use a different output or txt. | +| 7060 | Display issues during monitoring | Use a different output or use plain text (``txt``) | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7061 | Stat command failed | Check Aslogs command output, open a git issue. | +| 7061 | Stat command failed | Check the command output in ``ASLOGS`` for a possible bug, report it to the Autosubmit team in Git. | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7062 | Svn issues | Check, in expdef, if url exist. | +| 7062 | Svn issues | Check if URL was configured in the experiment configuration | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7063 | cp/rsync issues | Check if destination path exist. | +| 7063 | cp/rsync issues | Check if destination path exists. | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7064 | Git issues | Check that the proj folder is a well configured git folder. Also, check GIT: expdef config. | +| 7064 | Git issues | Check ``GIT:`` experiment configuration. If issue persists, check if ``proj`` folder is a valid Git repository. | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7065 | Wrong git configuration | Invalid git url. Check GIT: expdef config. If issue persists, check if proj folder is a well configured git folder. | +| 7065 | Wrong git configuration | Invalid Git url. Check ``GIT:`` experiment configuration. If issue persists, check if ``proj`` folder is a valid Git repository. | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7066 | Pre-submission feature issues | New feature, this message shouldn't be prompt. Please report it to Git. | +| 7066 | Pre-submission feature issues | New feature, this message should not be issued, Please report it in Git | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7067 | Historical Database not found | Configure historicdb: PATH:. | +| 7067 | Historical Database not found | Configure ``historicdb: PATH:`` | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7068 | Monitor output can't be loaded | Try another output method// Check if the experiment is reachable. | +| 7068 | Monitor output can't be loaded | Try another output method, check if the experiment exists and is readable | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7069 | Monitor output format invalid | Try another output method. | +| 7069 | Monitor output format invalid | Try another output method | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7070 | Bug in code | Contact us via git/e-mail output. | +| 7070 | Bug in the code | Please submit an issue to the Autosubmit team in Git | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7071 | AS can't run in this host | If you think that this is an error, check the .autosubmitrc and modify the allowed/forbidden directives. | +| 7071 | AS can't run in this host | If you think that this is an error, check the ``.autosubmitrc`` and modify the allowed and forbidden directives | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7072 | Basic configuration not found | Administrator: run `autosubmit configure --advanced` or create a common file in /etc/autosubmitrc. | -| | | User: run `autosubmit configure` or create a $HOME/.autosubmitrc. Following the skeleton of installation page | +| 7072 | Basic configuration not found | Administrator: run ``autosubmit configure --advanced`` or create a common file in ``/etc/autosubmitrc``. | +| | | User: run ``autosubmit configure`` or create a ``$HOME/.autosubmitrc`` (consult the installation documentation) | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7073 | Private key is encrypted | Each Session: Add your key into the ssh agent. ex. ssh-add $HOME/.ssh/id_rsa, then launch autosubmit. | -| | | Alternative: You can use a non-encrypted key, just make sure that nobody except you has access to the file. | +| 7073 | Private key is encrypted | Add your key to your ssh agent, e.g. ``ssh-add $HOME/.ssh/id_rsa``, then try running Autosubmit again. | +| | | You can also use a non-encrypted key (make sure nobody else has access to the file). | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7074 | Profiling process failed | You can find descriptive explanations in the log, as well as hints to solve the problem. | +| 7074 | Profiling process failed | You can find more detailed information in the logs, as well as hints to solve the problem | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -**Default Solution** - -Check autosubmit log for detailed information, there will be additional error codes. - ----- - -Minor errors - Error codes [6000+] -=================================== - -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| Code | Details | Solution | -+======+======================================================+================================================================================================+ -| 6001 | Failed to retrieve log files | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6002 | Failed reconnection | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6003 | Failed connection, wrong configuration | Check your platform.yml file | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6004 | Input output issues | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6005 | Unable to execute the command | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6006 | Failed command | Check err output for more info, command worked but some issue was detected | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6007 | Broken sFTP connection | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6008 | Inconsistent/unexpected ,job status | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6009 | Failed job checker | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6010 | Corrupted job_list using backup | Automatically, if it fails, Perform mv /pkl/job_list_backup.pkl /pkl/job_list.pkl| -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6011 | Incorrect mail notifier configuration | Double check your mail configuration on job.yml (job status) and autosubmit.yml (email) | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6012 | Migrate , archive/unarchive I/O issues | Check migrate how-to configuration | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6013 | Configuration issues | Check log output for more info | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6014 | Git Can't clone repository submodule | Check submodule url, perform a refresh | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6015 | Submission failed | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -| 6016 | Temporal connection issues | Automatically, if there aren't bigger issues | -+------+------------------------------------------------------+------------------------------------------------------------------------------------------------+ -- GitLab From a8f1f246c0b506362410ec7f10c594cf74112c0d Mon Sep 17 00:00:00 2001 From: "Bruno P. Kinoshita" Date: Wed, 9 Aug 2023 11:32:57 +0200 Subject: [PATCH 2/3] CSS changes for tables and figures. --- docs/source/_static/css/autosubmit.css | 12 ++++++++++++ docs/source/conf.py | 6 ++++++ docs/source/troubleshooting/error-codes.rst | 13 ++++++++----- 3 files changed, 26 insertions(+), 5 deletions(-) create mode 100644 docs/source/_static/css/autosubmit.css diff --git a/docs/source/_static/css/autosubmit.css b/docs/source/_static/css/autosubmit.css new file mode 100644 index 000000000..fca5cf8ac --- /dev/null +++ b/docs/source/_static/css/autosubmit.css @@ -0,0 +1,12 @@ +/* NOTE: This file customizes the current Sphinx theme for the Autosubmit docs. */ + +/* For the error code page, where we have large tables. */ +td, th { + white-space: normal !important; + word-wrap: break-all !important; +} + +/* For the profiler docs, that contain figures with paragraphs below. */ +figure { + margin-bottom: 2rem !important; +} diff --git a/docs/source/conf.py b/docs/source/conf.py index 86c568184..3312c09c2 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -165,6 +165,12 @@ html_theme = 'sphinx_rtd_theme' # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] +# These paths are either relative to html_static_path +# or fully qualified paths (eg. https://...) +html_css_files = [ + 'css/autosubmit.css' +] + # Add any extra paths that contain custom files (such as robots.txt or # .htaccess) here, relative to this directory. These files are copied # directly to the root of the documentation. diff --git a/docs/source/troubleshooting/error-codes.rst b/docs/source/troubleshooting/error-codes.rst index c9a40efbc..917119722 100644 --- a/docs/source/troubleshooting/error-codes.rst +++ b/docs/source/troubleshooting/error-codes.rst @@ -178,15 +178,15 @@ team in Git. +======+===============================================+==================================================================================================================================================================================+ | 7060 | Display issues during monitoring | Use a different output or use plain text (``txt``) | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7061 | Stat command failed | Check the command output in ``ASLOGS`` for a possible bug, report it to the Autosubmit team in Git. | +| 7061 | Stat command failed | Check the command output in ``ASLOGS`` for a possible bug, report it to the Autosubmit team in Git | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 7062 | Svn issues | Check if URL was configured in the experiment configuration | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7063 | cp/rsync issues | Check if destination path exists. | +| 7063 | cp/rsync issues | Check if destination path exists | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7064 | Git issues | Check ``GIT:`` experiment configuration. If issue persists, check if ``proj`` folder is a valid Git repository. | +| 7064 | Git issues | Check ``GIT:`` experiment configuration. If issue persists, check if ``proj`` folder is a valid Git repository | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| 7065 | Wrong git configuration | Invalid Git url. Check ``GIT:`` experiment configuration. If issue persists, check if ``proj`` folder is a valid Git repository. | +| 7065 | Wrong git configuration | Invalid Git url. Check ``GIT:`` experiment configuration. If issue persists, check if ``proj`` folder is a valid Git repository | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 7066 | Pre-submission feature issues | New feature, this message should not be issued, Please report it in Git | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -204,8 +204,11 @@ team in Git. | | | User: run ``autosubmit configure`` or create a ``$HOME/.autosubmitrc`` (consult the installation documentation) | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 7073 | Private key is encrypted | Add your key to your ssh agent, e.g. ``ssh-add $HOME/.ssh/id_rsa``, then try running Autosubmit again. | -| | | You can also use a non-encrypted key (make sure nobody else has access to the file). | +| | | You can also use a non-encrypted key (make sure nobody else has access to the file) | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 7074 | Profiling process failed | You can find more detailed information in the logs, as well as hints to solve the problem | +------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +.. note:: + Please submit an issue to the Autosubmit team if you have not found your error + code listed here. -- GitLab From 125f6ffa5b1be934aa8141d172e7e3af8e1118a1 Mon Sep 17 00:00:00 2001 From: "Bruno P. Kinoshita" Date: Wed, 9 Aug 2023 12:08:45 +0200 Subject: [PATCH 3/3] Correct rst table syntax --- docs/source/troubleshooting/error-codes.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/source/troubleshooting/error-codes.rst b/docs/source/troubleshooting/error-codes.rst index 917119722..0e6f12fe8 100644 --- a/docs/source/troubleshooting/error-codes.rst +++ b/docs/source/troubleshooting/error-codes.rst @@ -92,11 +92,11 @@ Minor errors - Error codes [6000+] Experiment Locked - Critical Error 7000 ======================================= -+--------------------------------------------------------------------------------------------------------------------------------------------------------+ -| Code | Details | Solution | -+======+===================================================================+=============================================================================+ -| 7000 | Experiment is locked due another instance of Autosubmit using it | Halt other experiment instances, then ``rm /tmp/autosubmit.lock`` | -+------+-------------------------------------------------------------------+-----------------------------------------------------------------------------+ ++-------+-------------------------------------------------------------------+------------------------------------------------------------------------------+ +| Code | Details | Solution | ++=======+===================================================================+==============================================================================+ +| 7000 | Experiment is locked due another instance of Autosubmit using it | Halt other experiment instances, then ``rm /tmp/autosubmit.lock`` | ++-------+-------------------------------------------------------------------+------------------------------------------------------------------------------+ Database Issues - Critical Error codes [7001-7009] =================================================== @@ -104,7 +104,7 @@ Database Issues - Critical Error codes [7001-7009] These issues occur due to server side issues. Check your site settings, and report an issue to the Autosubmit team in Git if the issue persists. -+------------------------------------------------------------------------------------------------------------------------+ ++------+-----------------------------------------------+-----------------------------------------------------------------+ | Code | Details | Solution | +======+===============================================+=================================================================+ | 7001 | Connection to the db could not be established | Check if database exists | @@ -152,8 +152,8 @@ The Autosubmit logs should contain more detailed information about the error. Check your platform configuration and general status (connectivity, permissions, etc.). -+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| Code | Details | Solution | ++------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ +| Code | Details | Solution | +======+=================================================================+=========================================================================================================================================+ | 7040 | Invalid experiment ``pkl`` or ``db`` files | Should be recovered automatically, if not check if there is a backup file and do it manually | +------+-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ -- GitLab