Skip to content

Commit 00e7ed7

Browse files
rtapellagrallewellynbsatoriu
authored
Troubleshooting section (#515)
* initial troubleshooting placeholder section * added a dps error code page * added troubleshooting for kernel resetting * Update account_not_activated guide * reword a little --------- Co-authored-by: grallewellyn <grace.llewellyn@jpl.nasa.gov> Co-authored-by: bsatoriu <bsatoriu@jpl.nasa.gov>
1 parent fa12c6e commit 00e7ed7

File tree

5 files changed

+151
-0
lines changed

5 files changed

+151
-0
lines changed

‎docs/source/index.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Welcome to the MAAP User Documentation!
1313
science_examples.rst
1414
technical_tutorials.rst
1515
system_reference.rst
16+
troubleshooting_guides.rst
1617
release_notes.rst
1718

1819
Indices and tables

‎docs/source/troubleshooting/account_not_activated.ipynb‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"id": "58641795-4f3e-40af-9374-b882f2be6eb1",
6+
"metadata": {},
7+
"source": [
8+
"# My Account is No Longer Activated"
9+
]
10+
},
11+
{
12+
"cell_type": "markdown",
13+
"id": "cd3c4962",
14+
"metadata": {},
15+
"source": [
16+
"You may see an error message when logging in about your account not being \"activated.\" In this case, alert the MAAP support team via Slack or by sending an email to support@maap-project.org. Likely causes of this error include:\n",
17+
"\n",
18+
"1. **MAAP service outage** - if an operational outage has occurred in one of the MAAP subsystems such as the REST API or the SSO service, this will prevent the ADE from being able to validate the user's account status. The [MAAP Status Page](https://maap-project.github.io/maap-statuspage/) may help identify an outage.\n",
19+
"2. **EarthData profile change** - if you changed your email or username in EarthData Login, this may cause a sign-in conflict, requiring a MAAP admin to re-sync your profile within the ADE.\n",
20+
"3. **MAAP access suspension** - if your access to MAAP has been suspended (disabled), access will need to be re-activated by a MAAP admin before the ADE can be accessed. "
21+
]
22+
}
23+
],
24+
"metadata": {
25+
"kernelspec": {
26+
"display_name": "Python 3",
27+
"language": "python",
28+
"name": "python3"
29+
},
30+
"language_info": {
31+
"codemirror_mode": {
32+
"name": "ipython",
33+
"version": 3
34+
},
35+
"file_extension": ".py",
36+
"mimetype": "text/x-python",
37+
"name": "python",
38+
"nbconvert_exporter": "python",
39+
"pygments_lexer": "ipython3",
40+
"version": "3.9.1"
41+
}
42+
},
43+
"nbformat": 4,
44+
"nbformat_minor": 5
45+
}

‎docs/source/troubleshooting/dps_error_codes.ipynb‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"id": "58641795-4f3e-40af-9374-b882f2be6eb1",
6+
"metadata": {},
7+
"source": [
8+
"# Error Codes in DPS"
9+
]
10+
},
11+
{
12+
"cell_type": "markdown",
13+
"id": "cd3c4962",
14+
"metadata": {},
15+
"source": [
16+
"Jobs run at scale in the DPS may fail for various reasons. Here are some of the common error codes and how to resolve those errors."
17+
]
18+
},
19+
{
20+
"cell_type": "markdown",
21+
"id": "b647510a",
22+
"metadata": {},
23+
"source": [
24+
"error code | explanation | resolution\n",
25+
"---------- | ----------- | ----------\n",
26+
"exit code 143 | The system lost access to a resource due to [spot-instance interruption](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-interruptions.html) | Re-run the job(s) later or with a different resource\n"
27+
]
28+
}
29+
],
30+
"metadata": {
31+
"kernelspec": {
32+
"display_name": "Python 3",
33+
"language": "python",
34+
"name": "python3"
35+
},
36+
"language_info": {
37+
"codemirror_mode": {
38+
"name": "ipython",
39+
"version": 3
40+
},
41+
"file_extension": ".py",
42+
"mimetype": "text/x-python",
43+
"name": "python",
44+
"nbconvert_exporter": "python",
45+
"pygments_lexer": "ipython3",
46+
"version": "3.9.1"
47+
}
48+
},
49+
"nbformat": 4,
50+
"nbformat_minor": 5
51+
}

‎docs/source/troubleshooting/kernel_resetting.ipynb‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
{
2+
"cells": [
3+
{
4+
"cell_type": "markdown",
5+
"id": "58641795-4f3e-40af-9374-b882f2be6eb1",
6+
"metadata": {},
7+
"source": [
8+
"# Kernel resetting repeatedly"
9+
]
10+
},
11+
{
12+
"cell_type": "markdown",
13+
"id": "cd3c4962",
14+
"metadata": {},
15+
"source": [
16+
"The underlying cause for this could be that you deleted the conda environment that you used to create the kernelspec you are trying to run with \n",
17+
"\n",
18+
"Resolution: Make sure the conda environment for the jupyter kernelspec still exists.\n"
19+
]
20+
}
21+
],
22+
"metadata": {
23+
"kernelspec": {
24+
"display_name": "Python 3",
25+
"language": "python",
26+
"name": "python3"
27+
},
28+
"language_info": {
29+
"codemirror_mode": {
30+
"name": "ipython",
31+
"version": 3
32+
},
33+
"file_extension": ".py",
34+
"mimetype": "text/x-python",
35+
"name": "python",
36+
"nbconvert_exporter": "python",
37+
"pygments_lexer": "ipython3",
38+
"version": "3.9.1"
39+
}
40+
},
41+
"nbformat": 4,
42+
"nbformat_minor": 5
43+
}

‎docs/source/troubleshooting_guides.rst‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
Troubleshooting Guides
2+
=======================================
3+
4+
This section will help manage known issues and debugging tips.
5+
6+
.. toctree::
7+
:maxdepth: 2
8+
9+
troubleshooting/account_not_activated.ipynb
10+
troubleshooting/dps_error_codes.ipynb
11+
troubleshooting/kernel_resetting.ipynb

0 commit comments

Comments
 (0)