Skip to content

Commit bcb5608

Browse files
DOCSP-41112 -- Update local dev prereqs from Podman to Docker (#416)
* DOCSP-41112 -- Update local dev prereqs from Podman to Docker * DOCSP-41112 -- rebuild * DOCSP-41112 -- update troubleshooting.txt
1 parent ff1bbd2 commit bcb5608

File tree

2 files changed

+15
-112
lines changed

2 files changed

+15
-112
lines changed

source/includes/fact-deploy-tutorial-prereqs.rst

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -52,15 +52,14 @@ Before you begin, complete the following prerequisites:
5252
other operating systems, see :dbtools:`Installing the Database Tools
5353
</installation/installation/>`.
5454

55-
- Install `Podman <https://podman.io/>`__ version 4.4 and later.
55+
- Install `Docker <https://www.docker.com//>`__.
5656

57-
**Example (MacOS):**
58-
59-
.. code-block:: sh
60-
61-
brew install podman
57+
- For MacOS or Windows, install `Docker Desktop v4.31+ <https://docs.docker.com/desktop/release-notes/#4310>`__.
58+
- For Linux, install `Docker Engine v27.0+ <https://docs.docker.com/engine/release-notes/27.0/>`__.
6259

6360
.. note::
6461

65-
Podman requires a network connection for pulling and caching
62+
Docker requires a network connection for pulling and caching
6663
MongoDB images.
64+
65+
`Podman <https://podman.io>`__ is also supported for Linux RHEL versions.

source/troubleshooting.txt

Lines changed: 9 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -19,128 +19,32 @@ Troubleshoot Errors
1919
Troubleshoot Local Atlas Deployment Issues
2020
------------------------------------------
2121

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-
7322
Local Machine Issues
7423
~~~~~~~~~~~~~~~~~~~~
7524

7625
If the {+atlas-cli+} slows down to an unusable state after you create
7726
multiple local |service| deployments and load data, you might have
7827
reached the limits of your machine.
7928

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.
9132

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
11534
~~~~~~~~~~~~~
11635

117-
The {+atlas-cli+} uses `Podman <https://podman.io/>`__ for
36+
The {+atlas-cli+} uses `Docker <https://www.docker.com/>`__ for
11837
``atlas deployments`` commands.
11938

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/>`__.
13741

13842
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:
14044

14145
.. code-block::
14246

143-
podman kill --all && podman system prune --force && podman volume rm --all
47+
docker stop $(docker ps -a -q) && docker system prune -a
14448

14549
Run Diagnostics
14650
~~~~~~~~~~~~~~~

0 commit comments

Comments
 (0)