Skip to content

Commit acd7055

Browse files
Improve upgrade troubleshooting.
- Fix some links. - Products don't exist anymore. Use the term add-ons or packages.
1 parent 45be978 commit acd7055

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

docs/backend/upgrading/troubleshooting.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,15 +21,15 @@ When a site error occurs, or Zope fails to start, there's probably an informativ
2121
Locate [these log files](https://plone.org/documentation/faq/plone-logs) and inspect instance.log.
2222
Ignore irrelevant warnings and search for words such as error, exception and traceback (case-insensitive).
2323

24-
When Zope doesn't start and there's no useful information in the log file, you can start Zope interactively and watch for error messages in the output::
24+
When Zope doesn't start and there's no useful information in the log file, you can start Zope interactively and watch for error messages in the output:
2525

26-
```
26+
```bash
2727
bin/instance fg
2828
```
2929

3030
You may be able to find more information on the error messages in:
3131

32-
- the {doc}`Version-specific migration tips </manage/upgrading/version_specific_migration/index>` for your version of Plone
32+
- the {doc}`Version-specific migration tips </backend/upgrading/version_specific_migration/index>` for your version of Plone
3333
- the {doc}`Error References </appendices/error-reference>`
3434

3535
## Test without customizations
@@ -41,11 +41,11 @@ Temporarily remove your customizations, for example by removing your layers from
4141
If the problem disappears, you'll need to double-check your customizations.
4242
It's usually best to copy the original files of the new version of Plone to your skin, and re-customize those.
4343

44-
## Test without products
44+
## Test without add-ons
4545

46-
Bugs or compatibility problems in products that you have installed may cause problems in Plone.
47-
Go to Site Setup > Add/Remove Products and remove (uninstall) all product that are not distributed with Plone.
48-
Remove the uninstalled products from the Products directory of your Zope instance.
46+
Bugs or compatibility problems in add-ons that you have installed may cause problems in Plone.
47+
Go to Site Setup > Add-ons and deactivate all add-ons that are not distributed with Plone.
48+
Remove the deactivated add-ons from the packages of your Zope instance.
4949

5050
If the problem disappears, you'll need to doublecheck the offending product:
5151

@@ -81,7 +81,7 @@ The more complex your story is, the more likely that it is unique to your situat
8181

8282
Once you have investigated, analyzed, identified and confirmed the cause of your problem and you are convinced it's a bug (rather than an X-file), go to the appropriate bug tracker and report it:
8383

84-
- Products: the README usually tells how to report bugs
84+
- Add-ons: the README usually tells how to report bugs
8585
- [Plone Issue Tracker](https://github.com/plone/Products.CMFPlone/issues)
8686

8787
Do not use the bug trackers to ask for help.

0 commit comments

Comments
 (0)