Skip to content
This repository was archived by the owner on Aug 1, 2024. It is now read-only.

Commit 4809677

Browse files
author
Rebecca Graber
authored
docs: Update troubleshoot guide with reset info (#1152)
1 parent e7b0b3e commit 4809677

1 file changed

Lines changed: 18 additions & 1 deletion

File tree

docs/troubleshoot_general_tips.rst

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,7 @@ See `the github issue`_ to follow the work being done on the resolution.
247247
Past problems (fixed)
248248
=====================
249249

250-
If you see any of the following issues, you'll need to update your repos and pull the latest images.
250+
If you see any of the following issues, you'll need to `update your repos and pull the latest images`_.
251251

252252
Permission denied for copying studio-frontend JS & CSS during provisioning
253253
--------------------------------------------------------------------------
@@ -263,6 +263,23 @@ During ``make dev.provision``, the edx-platform script ``copy-node-modules.sh``
263263

264264
This issue was introduced on edx-platform master in July 2023 and was resolved in August 2023 (without becoming part of a named release). See https://github.com/openedx/devstack/issues/1138 for more details, including a workaround for those unable to upgrade their repos or images for some reason.
265265

266+
.. _update your repos and pull the latest images:
267+
268+
Updating Devstack
269+
=================
270+
It may be that the bug you have encountered has already been resolved and you just need to update your devstack. You can do this without losing any of your existing data or having to reprovision, although you will lose your container command history once you pull new images.
271+
272+
To update devstack to the latest images and code:
273+
274+
1. ``make dev.stop`` This will stop all running containers.
275+
2. ``make dev.reset-repos`` This will pull all the latest code into all your devstack service and MFE repos.
276+
3. ``git fetch && git pull`` on the master branch in devstack. This will pull all the latest code into the devstack repo itself.
277+
4. ``make dev.pull.lms`` This will pull the latest lms image and all its dependencies. If you need other services/MFEs, you can replace this with ``make dev.pull.lms+cms+other_service+other_MFE...`` or ``make dev.pull.large-and-slow`` if you really need everything.
278+
279+
Depending on your needs, you may also want to run ``make dev.migrate.lms`` to apply all the latest migrations and/or ``make dev.static.lms`` to recompile static assets.
280+
Like with pulling images, you can also narrow these commands to specific services/MFEs with ``make dev.migrate.lms+cms+...,`` or run ``make dev.migrate`` and ``make dev.static`` (no suffixes) to include everything.
281+
282+
Running ``make dev.reset`` will do all the above for all services, which can be useful but takes much more time. It will also run a full ``docker system prune -f`` to get rid of unused images and networks.
266283

267284
Starting From Scratch
268285
=====================

0 commit comments

Comments
 (0)