Difference between revisions of "Plone"

From ArchWiki
Jump to: navigation, search
m (See Also: url typo)
(improve install link as recommended in Help:Style#Package management instructions)
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Web Server]]
+
[[Category:Web server]]
 
[http://http://plone.org/ Plone] is a free and open source content management system built on top of the Zope application server written in [[Python]]. Plone can be used for all kinds of websites, including blogs, internet sites, webshops and intranets. The strengths of Plone are its flexible and adaptable workflow, very good security, extensibility, high usability and flexibility.
 
[http://http://plone.org/ Plone] is a free and open source content management system built on top of the Zope application server written in [[Python]]. Plone can be used for all kinds of websites, including blogs, internet sites, webshops and intranets. The strengths of Plone are its flexible and adaptable workflow, very good security, extensibility, high usability and flexibility.
  
 
== Installation ==
 
== Installation ==
[[Pacman|Install]] package {{AUR|plone-zeo}} from the [[AUR]]. Please be aware, that the AUR package installs the Plone Unified Installer in {{Ic|/usr/src}}, which is then run by Pacman upon initial install. The Unified Installer compiles and installs the package in {{Ic|/opt/Plone}}. The package is mainly intended to provide a convenient way to quickly install and get up and running with Plone, as it handles the dependencies and bundles the init script and a systemd unit file.
+
[[Install]] package {{AUR|plone}}{{Broken package link|{{aur-mirror|plone}}}} from the [[AUR]]. Please be aware, that the AUR package copies the Plone Unified Installer to {{Ic|/opt/plone}}, which is then run by Pacman upon initial install. The Unified Installer compiles and installs Plone in {{Ic|/opt/plone}}. The package provides a convenient way to quickly install and get up and running with Plone, as it handles the dependencies and bundles a systemd unit file.
  
Note, that Plone site version upgrades are not handled by [[Pacman]] using the AUR package, because the files in {{Ic|/opt/Plone}} are not managed by Pacman directly. (see below for instructions on how to upgrade a Plone site)
+
Note, that Plone site version upgrades are not handled by [[Pacman]] using the AUR package, because the files in {{Ic|/opt/plone}} are not managed by Pacman directly. Re-running the installer is not the recommended way to upgrade Plone (see below for instructions on how to upgrade a Plone site).
  
==== Manual Installation ====
+
=== Manual Installation ===
  
The official way to install Plone is by using the Unified Installer, which is also used by the {{AUR|plone-zeo}} package. Doing a manual install will give you additional options.
+
The official way to install Plone is by using the Unified Installer, which is also used by the {{AUR|plone}}{{Broken package link|{{aur-mirror|plone}}}} package. Doing a manual install will give you additional options.
  
 
The following prerequisites need to be installed:
 
The following prerequisites need to be installed:
  
* Required: {{Pkg|base-devel}}
+
* Required: {{Grp|base-devel}}
 
* Recommended:{{Pkg|libxml2}} {{Pkg|libxslt}} {{Pkg|libjpeg-turbo}} {{Pkg|openssl}} {{Pkg|sudo}}
 
* Recommended:{{Pkg|libxml2}} {{Pkg|libxslt}} {{Pkg|libjpeg-turbo}} {{Pkg|openssl}} {{Pkg|sudo}}
 
* Optional: {{Pkg|wv}} {{Pkg|poppler}} for Word and PDF document indexing
 
* Optional: {{Pkg|wv}} {{Pkg|poppler}} for Word and PDF document indexing
  
Download the latest installer from [http://plone.org/products here] and follow the [http://plone.org/documentation/manual/installing-plone Plone Install Guide]
+
Download the latest installer from [http://plone.org/products here] and follow the [https://plone.org/documentation Plone Install Docs] and some Arch Linux specific [http://docs.plone.org/manage/deploying/preparing.html Server Preparations]
  
 
For example to install Plone for production use, using a ZEO server configuration do the following as root:
 
For example to install Plone for production use, using a ZEO server configuration do the following as root:
 
  pacman -S base-devel libxml2 libxslt libjpeg-turbo openssl sudo
 
  pacman -S base-devel libxml2 libxslt libjpeg-turbo openssl sudo
  pver=4.2.1 # replace this with the latest version
+
  pver=4.3.2 # replace this with the latest version
 
  wget http://launchpad.net/plone/${pver:0:3}/$pver/+download/Plone-$pver-UnifiedInstaller.tgz
 
  wget http://launchpad.net/plone/${pver:0:3}/$pver/+download/Plone-$pver-UnifiedInstaller.tgz
 
  tar -xzf *UnifiedInstaller.tgz
 
  tar -xzf *UnifiedInstaller.tgz
  ./Plone-$pver-UnifiedInstaller/install.sh --target=/opt/Plone zeo
+
  ./Plone-$pver-UnifiedInstaller/install.sh --target=/opt/plone zeo
 
The installer provides informative messages as well as saving an {{Ic|install.log}} to help analyse potential problems.
 
The installer provides informative messages as well as saving an {{Ic|install.log}} to help analyse potential problems.
  
Line 30: Line 30:
  
 
Manually start the service with:
 
Manually start the service with:
  sudo -u plone /opt/Plone/zeocluster/bin/plonectl start
+
  sudo -u plone_daemon /opt/plone/zeocluster/bin/plonectl start
 
Then try the site on {{Ic|http://yoursite:8080}}
 
Then try the site on {{Ic|http://yoursite:8080}}
  
Line 36: Line 36:
  
 
Stop the service with:
 
Stop the service with:
  sudo -u plone /opt/Plone/zeocluster/bin/plonectl stop
+
  sudo -u plone_daemon /opt/plone/zeocluster/bin/plonectl stop
==== Using Systemd ====
+
==== Automatically using Systemd ====
 
To enable the Plone service by default at start-up, run:
 
To enable the Plone service by default at start-up, run:
 
  systemctl enable plone
 
  systemctl enable plone
==== Using SysVinit ====
 
To enable the Plone service by default at start-up just add {{Ic|plone}} to the {{Ic|DAEMONS}} array in {{ic|/etc/rc.conf}}:
 
DAEMONS=(... plone)
 
 
== Customizing ==
 
== Customizing ==
To change ports, or to install add-ons and themes edit the file {{Ic|buildout.cfg}} at {{Ic|/opt/Plone/zeocluster}}.
+
To change ports, or to install add-ons and themes edit the file {{Ic|buildout.cfg}} at {{Ic|/opt/plone/zeocluster}}.
  
 
Apply the new settings by running:
 
Apply the new settings by running:
  cd /opt/Plone/zeocluster
+
  cd /opt/plone/zeocluster
  sudo -u plone bin/buildout  
+
  sudo -u plone_buildout bin/buildout  
 
== Upgrades ==
 
== Upgrades ==
Upgrades are done in a similar way using buildout. This should be fairly straightforward, from one minor version to another. For example to upgrade to Plone 4.2.x do the following: In your {{Ic|buildout.cfg}}, comment out {{Ic|versions.cfg}} and uncomment the line pointing to dist.plone.org, so it looks like this:
+
Upgrades are done in a similar way using buildout. This should be fairly straightforward, from one minor version to another. For example to upgrade to Plone 4.3.x do the following: In your {{Ic|buildout.cfg}}, comment out {{Ic|versions.cfg}} and uncomment the line pointing to dist.plone.org, so it looks like this:
 
  extends =  
 
  extends =  
 
  base.cfg
 
  base.cfg
 
  # versions.cfg
 
  # versions.cfg
  http://dist.plone.org/release/4.2-latest/versions.cfg  
+
  http://dist.plone.org/release/4.3-latest/versions.cfg  
 
Then stop Plone and re-run buildout:
 
Then stop Plone and re-run buildout:
  cd /opt/Plone/zeocluster
+
  cd /opt/plone/zeocluster
  sudo -u plone bin/buildout   
+
  sudo -u plone_buildout bin/buildout   
 
Restart Plone and visit the Management Interface at (http://yoursite:8080). You will likely see a message prompting you to run Plone's migration script. Click the Upgrade button next to the site and the upgrade script will run.
 
Restart Plone and visit the Management Interface at (http://yoursite:8080). You will likely see a message prompting you to run Plone's migration script. Click the Upgrade button next to the site and the upgrade script will run.
  
Line 63: Line 60:
  
 
== See Also ==
 
== See Also ==
* [http://plone.org/ Plone Official Site]
+
* [http://http://plone.org/ Plone Official Site]
 
* [http://plone.org/documentation Official Documentation]
 
* [http://plone.org/documentation Official Documentation]
* [http://en.wikipedia.org/wiki/Plone_(software) Plone Wikipedia Article]
+
* [[wikipedia:Plone_(software)|Plone Wikipedia Article]]

Latest revision as of 21:20, 13 December 2015

Plone is a free and open source content management system built on top of the Zope application server written in Python. Plone can be used for all kinds of websites, including blogs, internet sites, webshops and intranets. The strengths of Plone are its flexible and adaptable workflow, very good security, extensibility, high usability and flexibility.

Installation

Install package ploneAUR[broken link: archived in aur-mirror] from the AUR. Please be aware, that the AUR package copies the Plone Unified Installer to /opt/plone, which is then run by Pacman upon initial install. The Unified Installer compiles and installs Plone in /opt/plone. The package provides a convenient way to quickly install and get up and running with Plone, as it handles the dependencies and bundles a systemd unit file.

Note, that Plone site version upgrades are not handled by Pacman using the AUR package, because the files in /opt/plone are not managed by Pacman directly. Re-running the installer is not the recommended way to upgrade Plone (see below for instructions on how to upgrade a Plone site).

Manual Installation

The official way to install Plone is by using the Unified Installer, which is also used by the ploneAUR[broken link: archived in aur-mirror] package. Doing a manual install will give you additional options.

The following prerequisites need to be installed:

Download the latest installer from here and follow the Plone Install Docs and some Arch Linux specific Server Preparations

For example to install Plone for production use, using a ZEO server configuration do the following as root:

pacman -S base-devel libxml2 libxslt libjpeg-turbo openssl sudo
pver=4.3.2 # replace this with the latest version
wget http://launchpad.net/plone/${pver:0:3}/$pver/+download/Plone-$pver-UnifiedInstaller.tgz
tar -xzf *UnifiedInstaller.tgz
./Plone-$pver-UnifiedInstaller/install.sh --target=/opt/plone zeo

The installer provides informative messages as well as saving an install.log to help analyse potential problems.

Starting Plone

Manually start the service with:

sudo -u plone_daemon /opt/plone/zeocluster/bin/plonectl start

Then try the site on http://yoursite:8080

Use the displayed login password, which can also be found in /opt/Plone/zeocluster/adminPassword.txt The start page allows you to create an initial site, by filling in the name of the new site and choosing optional add-ons.

Stop the service with:

sudo -u plone_daemon /opt/plone/zeocluster/bin/plonectl stop

Automatically using Systemd

To enable the Plone service by default at start-up, run:

systemctl enable plone

Customizing

To change ports, or to install add-ons and themes edit the file buildout.cfg at /opt/plone/zeocluster.

Apply the new settings by running:

cd /opt/plone/zeocluster
sudo -u plone_buildout bin/buildout 

Upgrades

Upgrades are done in a similar way using buildout. This should be fairly straightforward, from one minor version to another. For example to upgrade to Plone 4.3.x do the following: In your buildout.cfg, comment out versions.cfg and uncomment the line pointing to dist.plone.org, so it looks like this:

extends = 
base.cfg
# versions.cfg
http://dist.plone.org/release/4.3-latest/versions.cfg 

Then stop Plone and re-run buildout:

cd /opt/plone/zeocluster
sudo -u plone_buildout bin/buildout  

Restart Plone and visit the Management Interface at (http://yoursite:8080). You will likely see a message prompting you to run Plone's migration script. Click the Upgrade button next to the site and the upgrade script will run.

For more information on upgrades, especially between major versions of Plone read the Upgrade Guide

See Also