@@ -19,128 +19,32 @@ Troubleshoot Errors
19
19
Troubleshoot Local Atlas Deployment Issues
20
20
------------------------------------------
21
21
22
- Error: qemu exited unexpectedly with exit code -1, stderr: qemu-system-x86_64: Error: HV_DENIED
23
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
24
-
25
- The {+atlas-cli+} uses `Podman <https://podman.io/>`__ and `QEMU
26
- <https://www.qemu.org/>`__. We have identified this issue on MacOS x86
27
- architectures. To resolve this issue, upgrade to the latest version of
28
- QEMU and restart Podman.
29
-
30
- Error: exit status 127
31
- ~~~~~~~~~~~~~~~~~~~~~~
32
-
33
- This error might occur when you use the ``atlas deployments setup``
34
- command on Ubuntu Linux because of a `known issue
35
- <https://bugs.launchpad.net/ubuntu/+source/libpod/+bug/2024394>`__ with
36
- Podman. We don't support Ubuntu for local |service| deployments during
37
- this Public Preview stage.
38
-
39
- MongoNetworkError: connect ECONNREFUSED
40
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41
-
42
- This issue might occur after your machine goes into sleep mode or
43
- restarts. When you try to connect to the local |service| deployment,
44
- this error occurs.
45
-
46
- The {+atlas-cli+} uses `Podman <https://podman.io/>`__ and `QEMU
47
- <https://www.qemu.org/>`__ to run dockerized instances of MongoDB.
48
- Podman has a daemonless architecture. So, the local MongoDB instances
49
- don't restart automatically.
50
-
51
- To fix this issue:
52
-
53
- 1. List the available deployments.
54
-
55
- .. code-block:: sh
56
-
57
- atlas deployments list
58
-
59
- #. To resume the container, copy and paste the following command into
60
- your terminal, and replace ``{deployment-name}`` with the name of
61
- the deployment to start.
62
-
63
- .. code-block:: sh
64
-
65
- atlas deployments start {deployment-name}
66
-
67
- Issues on Windows
68
- ~~~~~~~~~~~~~~~~~
69
-
70
- We don't support Windows for local |service| deployments during this
71
- Public Preview stage.
72
-
73
22
Local Machine Issues
74
23
~~~~~~~~~~~~~~~~~~~~
75
24
76
25
If the {+atlas-cli+} slows down to an unusable state after you create
77
26
multiple local |service| deployments and load data, you might have
78
27
reached the limits of your machine.
79
28
80
- Consider allocating more memory:
81
-
82
- 1. Stop the Podman machine:
83
-
84
- .. code-block:: sh
85
-
86
- podman machine stop
87
-
88
- #. Allocate more memory based on your machine settings:
89
-
90
- .. code-block:: sh
29
+ If you're working on Docker Desktop for `Windows <https://docs.docker.com/desktop/settings/windows/#resources>`__
30
+ or `MacOS <https://docs.docker.com/desktop/settings/mac/#resources>`__, consider allocating
31
+ more memory.
91
32
92
- podman machine set --cpus 3 --memory 5120
93
-
94
- #. Start the Podman machine:
95
-
96
- .. code-block:: sh
97
-
98
- podman machine start
99
-
100
- #. List the Podman containers.
101
-
102
- .. code-block:: sh
103
-
104
- podman ps --all
105
-
106
- #. To resume the container, copy and paste the following command into
107
- your terminal and replace ``{container-name}`` with the name of the
108
- container to start.
109
-
110
- .. code-block:: sh
111
-
112
- podman start {container-name}
113
-
114
- Podman Issues
33
+ Docker Issues
115
34
~~~~~~~~~~~~~
116
35
117
- The {+atlas-cli+} uses `Podman <https://podman.io />`__ for
36
+ The {+atlas-cli+} uses `Docker <https://www.docker.com />`__ for
118
37
``atlas deployments`` commands.
119
38
120
- To install Podman, run the following command:
121
-
122
- .. code-block:: sh
123
-
124
- brew install podman
125
-
126
- To initialize a Podman machine, run the following command:
127
-
128
- .. code-block:: sh
129
-
130
- podman machine init
131
-
132
- To start a Podman machine, run the following command:
133
-
134
- .. code-block::
135
-
136
- podman machine start
39
+ - For MacOS or Windows, install `Docker Desktop v4.31+ <https://docs.docker.com/desktop/release-notes/#4310>`__.
40
+ - For Linux, install `Docker Engine v27.0+ <https://docs.docker.com/engine/release-notes/27.0/>`__.
137
41
138
42
If your local |service| deployment doesn't work, you might need to
139
- clean up your Podman environment and start fresh:
43
+ clean up your Docker environment and start fresh:
140
44
141
45
.. code-block::
142
46
143
- podman kill --all && podman system prune --force && podman volume rm --all
47
+ docker stop $(docker ps -a -q) && docker system prune -a
144
48
145
49
Run Diagnostics
146
50
~~~~~~~~~~~~~~~
0 commit comments