1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
|
Installing Plone manually, step by step instructions.
==============================================================================
**SUMMARY**
1) Download and install Zope
2) Find your instance's Products directory
3) Download and install CMFPlone
4) Download and install optional products
For alternative install docs, try http://plone.org/documentation. They may be
more up to date, and have useful illustrations to go with them.
===============================================================================
**ASSUMPTIONS**
1) You are running a *nix server
2) You are comfortable with standard Unix commands, including
* wget or cvs
* tar
* symlinking
3) You are familiar with logging into the Zope Management Interface
===============================================================================
**REQUIREMENTS**
**MANDATORY**
- Zope 2.9.4+ (does not run natively on Zope 3)
http://www.zope.org/Products/Zope/2.9.4
**If you are running Zope 2.9.5+ you should consider removing the ``Five``
Product included with Plone**
or
Zope 2.8.7+
http://www.zope.org/Products/Zope/2.8.7
**To use Plone 2.5 with Zope 2.8, you must remove the included ``Five``
package and replace it with Five 1.2.6+ from
http://codespeak.net/z3/five/release/Five-1.2.6.tgz**
- CMF 1.6.2+ (neither 1.5 nor 2.x+ will work)
Included in the Plone tarball
- CMFQuickInstallerTool 1.5.9 or newer
Included in the Plone tarball
- GroupUserFolder 3.54 or newer
Included in the Plone tarball
- CMFFormController 2.0.5 or newer
Included in the Plone tarball
- SecureMailHost 1.0.4 or newer
Included in the Plone tarball
- Archetypes 1.4.1 or newer
Included in the Plone tarball
- ATContentTypes 1.1.3 or newer
Included in the Plone tarball
- ATReferenceBrowserWidget 1.5 or newer
Included in the Plone tarball
- ResourceRegistries 1.3.2 or newer
Included in the Plone tarball
- ExtendedPathIndex 2.4 or newer
Included in the Plone tarball
- CMFDynamicViewFTI 2.1 or newer
Included in the Plone tarball
- Python Imaging Library 1.1.5 or newer
Not included in the Plone tarball
http://effbot.org/downloads/#Imaging
Note: You have to build PIL with jpeg and png support. See the README
of PIL for more information.
- Python ElementTree
Not included in the Plone tarball
http://effbot.org/downloads/#elementtree
- Placeless Translation Service 1.3.2 or newer
Included in the Plone tarball
- PloneTranslations 2.6.0
Included in the Plone tarball
- PloneLanguageTool 1.4 or newer
Included in the Plone tarball
- CMFPlacefulWorkflow 1.0.2 or newer
Included in the Plone tarball
- PlonePAS 2.1 or newer
Included in the Plone tarball
- PasswordResetTool 0.4 or newer
Included in the Plone tarball
- PluggableAuthService 1.4 or newer
Included in the Plone tarball
- PluginRegistry 1.1 or newer
Included in the Plone tarball
- ExternalEditor 0.9.2 or newer
Included in the Plone tarball
- kupu 1.3.8 or newer
Included in the Plone tarball
**OPTIONAL**
- CacheFu 1.0.1 or newer
Included in the Plone tarball
In order to use CacheFu, you must copy or link the directories
``CacheSetup``, ``CMFSquidTool``, ``PageCacheManager``, and
``PolicyHTTPCacheManager`` into your Products directory and carefully
read the instructions included with the product.
===============================================================================
**INSTALLATION PROCEDURE:**
-------------------------------------------------------------------------------
1. Download and install Zope
Install Zope and start it. Check that it's running.
*****************************************************************************
* If you want to run Plone on FreeBSD, you'll need to up the thread stack *
* size of your python interpreter or else Zope will repeatedly crash! *
* Compile python with 'make WANT_HUGE_STACK_SIZE=yes' or use the compiler *
* option CFLAG: -DTHREAD_STACK_SIZE=0x100000 *
*****************************************************************************
-------------------------------------------------------------------------------
2. Find your instance's Products directory
The location of this varies from system to system, so to avoid hunting for it,
go to the Zope Management Interface (ZMI) Control Panel in your Zope's root,
which will likely be at one of the following URLs:
http://yourhost:8080/Control_Panel/manage_main
http://yourhost:9673/Control_Panel/manage_main (if you're using Debian)
http://yourhost/Control_Panel/manage_main (if you're proxying through a front
end webserver)
This page will tell you your INSTANCE_HOME. There is a Products folder in each
site's INSTANCE_HOME folder. This is the best place to install add-on Products
for a site.
$SOFTWARE_HOME/Products folder
Sometimes a Product's documentation will instruct you to install it in
SOFTWARE_HOME/Products. SOFTWARE_HOME refers to the lib/python sub-folder of
the Zope folder. We strongly discourage installing packages in these places for
two reasons:
* These folders affect all Plone 2 sites using that version of Zope.
* If you reinstall Plone 2 or a newer version of Plone 2, Zope will
be replaced.
Any time you're asked to place packages into a Products folder, choose
the INSTANCE_HOME/Products folder instead. Thank you!
-------------------------------------------------------------------------------
3. Download and install CMFPlone
Unpack the Plone tarball
The results will be a directory named CMFPlone-xxxx where
xxxx is the version. This should contain the following subdirectories:
Archetypes
ATContentTypes
ATReferenceBrowserWidget
CacheFu
CMFActionIcons
CMFCalendar
CMFCore
CMFDefault
CMFDynamicViewFTI
CMFFormController
CMFPlacefulWorkflow
CMFPlone
CMFQuickInstallerTool
CMFSetup
CMFTopic
CMFUid
DCWorkflow
ExtendedPathIndex
ExternalEditor
Five -
replace this with a 1.2.x version from codespeak.net/z3/five
to run with Zope 2.8, or optionally remove it if running with
Zope 2.9.5+
GenericSetup
GroupUserFolder
kupu
MimetypesRegistry
PasswordResetTool
PlacelessTranslationService
PloneErrorReporting
PloneLanguageTool
PlonePAS
PloneTranslations
PluggableAuthService
PluginRegistry
PortalTransforms
ResourceRegistries
SecureMailHost
statusmessages
validation
Move (or symlink) each of these subdirectories into your
$INSTANCE_HOME/Products
directory. If it does not exist, create it. If you are running Zope 2.9.x
do not place Five in your Products directory, or Zope will not start.
*****************************************************************************
* Note that each of these is a Product in its own right and *must* be *
* directly within $INSTANCE_HOME/Products. If you just move the entire CMF *
* directory into $INSTANCE_HOME/Products, your Zope Instance will *not* be *
* able to find these required products, and you will not be able to run *
* Plone. *
*****************************************************************************
It's probably A Good Idea at this point to restart your Zope to load these
Products, then test that they have installed correctly. You can do this by
logging into the ZMI - you should have
1) The Plone Products (BTreeFolder2 etc.) listed in the Products section of
the Control_Panel
2) "Plone Site" as one of the options in the "Add" dropdown in the ZMI Root
Folder
Complete the install test by adding a Plone Site from the pulldown in the root
folder.
*****************************************************************************
* Make sure this is not done inside the Control Panel, but in the root of *
* the Zope site. *
*****************************************************************************
When you do this, it asks you to complete a form, specifying the site's Id,
Title, Description and where your members' user folder should be. Complete
these fields and hit the "Add Plone Site" button. After a short while, you
should be looking at a basic Plone site containing the details you entered.
-------------------------------------------------------------------------------
4. Download and install optional products
The above steps install the "mandatory" products.
Use Plone Setup's "Add/Remove Products" to install optional products bundled
with Plone: PloneErrorReporting
For optional products not bundled with Plone: Download the product, unpack the
product into your instance's Products directory, restart Zope, and install them
in Plone using Plone Setup's "Add/Remove Products."
===============================================================================
Have fun, and don't forget to report any bugs or inconsistencies in the
Plone bug tracker: http://dev.plone.org/plone/
Thank you for using Plone!
|
