HOWTO Plone
From Gentoo Linux Wiki
| Installation • Kernel & Hardware • Networks • Portage • Software • System • X Server • Gaming • Non-x86 • Emulators • Misc |
Contents |
[edit] Introduction
Plone is 'A user-friendly and powerful open source Content Management System'. Plone is hosted by the Zope application environment. Zope will automatically be installed when you emerge Plone.
[edit] How to install Plone-2.5 on a Gentoo box
# emerge -v =net-zope/zope-2.9.5
if that gives you mask errors, run
# echo "net-zope/zope" >> /etc/portage/package.keywords
continuing on ...
# echo net-zope/plone >> /etc/portage/package.keywords # emerge libxslt ">=plone-2.5.1" -n # env-update
also you may try
# ACCEPT_KEYWORDS=~x86 -v =net-zope/zope-2.9.6
You should update to the latest libxslt, some versions may cause problems.
Plone needs zope version higher or equal 2.8.7, so you don't have to install zope 2.9. To use Plone 2.5 with Zope 2.8.7+, you must add Five to your instance Products, you may find it here:
http://codespeak.net/z3/five/release/Five-1.2.6.tgz
[edit] Configure Zope
Create an instance of Zope under zope <3.3 :
# zope-config
Don't worry if the user exists.
Create an instance of Zope under zope >=3.3.0 :
# cd /usr/lib/zope-3.3.1/bin/ # ./mkzopeinstance
Start Zope under zope <3.3
# /etc/init.d/zope-instance start
(where 'instance' is the name of your instance - this can be found using 'ls /etc/init.d/')
As zope-config is not available, to start Zope under zope >=3.3.0 you have to use the script generated in the instance (?) [gbin: any specialist / maintainer can help us here ? thx.]
# cd /your/instance/path/bin # ./zopectl start
Zope should now be available at:
http://localhost:8080 and http://localhost:8080/manage
[edit] Install Plone
# zprod-manager add /usr/share/zproduct/plone-2.5.3
Check all options and then restart Zope.
# /etc/init.d/zope-instance restart
Once Zope has loaded, go to http://localhost:8080/manage and log in with the root administrator password you created before.
In the drop-down at the top right next to the Add button, select Plone site and click Add. The id you give it will be the URL to the instance, so if you give it the name plone-site, you can access it on http://localhost:8080/plone-site.
After it has installed, find the instance in the ZMI, and go to the portal_quickinstaller tool. Here, install Archetypes, MimetypeRegistry, PortalTransforms, and DocFinderTab by ticking the boxes next to them and clicking Install.
That's it! You now have a cleanly configured Zope instance, with a single Plone site set up inside it, a recent release of Archetypes and the DocFinderTab.
[edit] AddOns (Plone Products)
Here's a list of apps you may also want to emerge depending on the transforms you will need (transforms are used by some products to convert document types. i.e. generating pdf from html, or html from pdf, microsoft office documents, Oo documents,...)
- wv unrtf xlhtml imaging libxml2 pdf2html reportlab xpdf
- coreblog2
[edit] Troubleshooting
[edit] Useful Links
- Gentoo.org [3]
- Plone.org [4]
- PloneSkins.org [5]
- Zope.org [6]
- Official installation HOWTO
