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

Commit aa96c34

Browse files
authored
docs: More troubleshooting tips (starting from scratch; broken outline) (#1141)
1 parent e931768 commit aa96c34

1 file changed

Lines changed: 11 additions & 1 deletion

File tree

docs/troubleshoot_general_tips.rst

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -220,7 +220,9 @@ Demo course is empty in studio
220220
------------------------------
221221
After provisioning and opening Studio, you may see an empty outline for the demo course. This usually means there is a disconnect between the block ids in mySQL and the corresponding data in Mongo.
222222

223-
To fix, simply add a new subsection and publish. The act of publishing should reload the whole course correctly.
223+
To fix this locally, simply add a new subsection and publish. The act of publishing should reload the whole course correctly.
224+
225+
See https://github.com/openedx/devstack/issues/1073 for the GitHub issue tracking this bug.
224226

225227
CORS error from login_refresh in MFE
226228
------------------------------------
@@ -243,6 +245,14 @@ See `the github issue`_ to follow the work being done on the resolution.
243245
.. _the github issue: https://github.com/openedx/devstack/issues/1072
244246

245247

248+
Starting From Scratch
249+
=====================
250+
251+
If you think your devstack is broken beyond repair, you can start from scratch using ``make dev.destroy``, followed by the :doc:`getting_started` instructions.
252+
253+
If you want to make absolutely sure that there are no lingering data volumes after the ``dev.destroy`` step, run ``docker volume ls --quiet | grep devstack`` -- if you see surviving devstack volumes that are currently mentioned in docker-compose.yml, there may be a bug. If you can reproduce the issue reliably, consider `reporting an issue <Reporting New Issues_>`_.
254+
255+
246256
Reporting New Issues
247257
====================
248258

0 commit comments

Comments
 (0)