You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: coredev/troubleshooting.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,10 +11,10 @@ myst:
11
11
12
12
This chapter describes how to troubleshoot development issues in Plone.
13
13
14
+
14
15
## Buildout issues
15
16
16
17
Buildout can be frustrating for those unfamiliar with parsing through autistic robot language.
17
-
18
18
These errors are almost always a quick fix, and a little bit of understanding goes a long way.
19
19
20
20
@@ -30,15 +30,11 @@ Let's take this one for example:
30
30
```
31
31
32
32
Buildout has simply noticed that the version of buildout required by the file `bootstrap.py` you are trying to run does not match the version of buildout in your Python library.
33
-
34
33
In the error above, your system has buildout 1.5.1 installed and the `bootstrap.py` file wants to run with 1.5.2.
35
34
36
35
To fix, you have a couple options.
37
-
38
36
First, you can force buildout to run with the version you already have installed by invoking the version tag.
39
-
40
37
This tells your Plone `bootstrap.py` file to play nicely with the version that you already have installed.
41
-
42
38
In the case of the error pasted above, that would be:
43
39
44
40
```shell
@@ -70,7 +66,7 @@ Hooray!
70
66
`mr.developer` is never unhappy, except when it is.
71
67
Although this technically isn't a buildout issue, it happens when running buildout, so I'm putting it under buildout issues.
72
68
73
-
When working with the dev instance, especially with all the moving back and forth between GitHub and svn, you may have an old copy of a `src` package.
69
+
When working with the dev instance, especially with all the moving back and forth between GitHub and Subversion, you may have an old copy of a `src` package.
74
70
The error looks like:
75
71
76
72
```console
@@ -96,10 +92,10 @@ If buildout ends with warning you that some packages could not be downloaded, th
96
92
This is bad and could cause all sorts of whack out errors when you start or try to run things because it never actually downloaded the package.
97
93
98
94
There are two ways to get this error to go away.
95
+
99
96
The first is to delete all instances of host filtering.
100
97
Go through all the files and delete any lines which say `allow-hosts =` and `allow-hosts +=`.
101
98
In theory, by restricting which hosts you download from, buildout will go faster.
102
-
103
99
The point is that they are safely deletable.
104
100
105
101
The second option is to allow the host that it is pointing to by adding something like this to your `.cfg`:
@@ -161,7 +157,9 @@ Delete {file}`mkzopeinstance.py` from {file}`bin/`, and rerun buildout to correc
161
157
### Can't open file '/Startup/run.py'
162
158
163
159
Two possible fixes.
160
+
164
161
If you use Python 2.4 by mistake, use 2.6 instead.
162
+
165
163
Or you may need to make sure you run `bin/buildout …` after `bin/develop …`.
166
164
Try removing {file}`parts/*`, {file}`bin/*`, {file}`.installed.cfg`, then re-bootstrap and re-run buildout, develop, buildout.
0 commit comments