Buildout für Produktivserver

[zeoserver]

zeo-address

gibt die Adresse des ZEO-Servers an.

Der Standardwert ist 8100.

[instance], [instance2]

zeo-client

wird der Wert auf true gesetzt, wird aus der Instanz ein ZEO-Client, der auf einen ZEO-Server mit einer bestimmten zeo-address verweist.

http-address

Port des HTTP-Servers. Der Standardwert ist 8080.

ip-address

ist die Standard-IP-Adresse, an der der ZEO-Client auf Anfragen horcht. Ist kein Wert angegeben, lauscht Zope auf allen IP-Adressen der Maschine. Die Anweisung kann überschrieben werden in den Server-Konfigurationen <http-server> etc. Üblicherweise ist keine IP-Adresse angegeben.

zeo-address

gibt die Adresse des ZEO-Servers an, z.B. 212.42.230.152:8100.

Der Standardwert ist 8100.

Temporary Storage

In temporary storages werden z.B. Session-Daten gespeichert. Da diese nicht für jede einzelne Instanz gespeichert werden sollten sondern zentral, können Sie auf den ZEO-Server verlagert werden.

1. Zunächst sollte hierzu jede Instanz so konfiguriert werden, dass sie den temporary storage auf dem ZEO-Server anlegen soll:

   eggs =
       tempstorage
   zodb-temporary-storage =
       <zodb_db temporary>
           # Temporary storage database (for sessions)
           <zeoclient>
               server ${zeoserver:zeo-address}
               storage temp
               name zeostorage
               var ${buildout:directory}/var/filestorage
           </zeoclient>
           mount-point /temp_folder
           container-class Products.TemporaryFolder.TemporaryContainer
       </zodb_db>
   

2. Umgekehrt muss nun dem ZEO-Server noch mitgeteilt werden, dass er den temporary storage hosten soll:

   zeo-conf-additional =
       %import tempstorage
       <temporarystorage temp>
           name temporary storage for sessioning
       </temporarystorage>
   

Plone 4

Für Plone 4 müssen folgende Änderungen in der Buildout-Konfigurationsdatei vorgenommen werden:

1. Der [buildout]-Abschnitt sollte auf einer anderen versions.cfg verweisen:

   [buildout]
   …
   extends =
       http://dist.plone.org/release/4.0.6/versions.cfg
   

2. Der [zope2]-Abschnitt mit plone.recipe.zope2install kann entfernt werden da Zope nun automatisch als Abhängigkeit installiert wird.

   Auch alle Referenzen auf diesen Abschnitt, wie z.B. ${zope2:location} sollten entfernt werden.

3. Zur Installation des ZEO-Servers sollte nun das Rezept plone.recipe.zeoserver verwendet werden, das keine Angabe für zope2-location erwartet:

   [zeoserver]
   recipe = plone.recipe.zeoserver
   zeo-address = 8100
   

4. Dafür muss nun im [zeoserver]-Abschnitt das Egg tempstorage explizit angegeben werden:

   eggs =
       plone.recipe.zeoserver
       tempstorage
   

5. Die Instanzen mit dem Rezept plone.recipe.zope2instance sollten ergänzt werden um die Konfiguration des BLOB storage:

   blob-storage =

   ${buildout:directory}/var/blobstorage

   Falls die Instanz auf derselben Maschine wie der ZEO-Server läuft, können beide denselben BLOB storage nutzen und in den Abschnitten für die Instanzen sollte dann folgendes eingetragen werden:

   shared-blob = on
   

Verändern eines bestehenden Abschnitts

Um einen bestehenden Abschnitt zu ergänzen, kann mit += z.B. der PDBDebugMode für den zweiten ZEO-Client hinzugefügt werden:

[buildout]
    extends = buildout.cfg
[instance2]
…
eggs +=
    Products.PDBDebugMode

Umgekehrt können auch einzelne Werte entfernt werden:

eggs -=
    Products.PDBDebugMode

[zeoserver]

verwendet plone.recipe.zope2zeoserver, um einen ZEO-Server in parts/zeoserver aufzusetzen.

zope2-location

verweist auf die im zope2-Abschnitt angegebene Installation.

zeo-address

gibt den Port des ZEO-Servers an, der Standardwert ist 8100.

Es können auch noch weitere Konfigurationsoptionen angegeben werden, z.B.

zeo-conf

Ein relativer oder absoluter Pfad zur zeo.conf-Datei. Wird kein Pfad angegeben, wird eine zeo.conf-Datei mit den in [zeoserver] angegebenen Werten generiert.

zeo-conf-additional

Zusätzliche Angaben zur zeo.conf-Datei. Dabei müssen die nachfolgenden Zeilen eingerückt sein.

Einen vollständigen Überblick über alle Optionen erhalten Sie in plone.recipe.zope2zeoserver.

[instance], [instance2]

verwenden plone.recipe.zope2instance

zeo-client

wird der Wert auf true gesetzt, wird aus der Instanz ein ZEO-Client, der auf einen ZEO-Server mit einer bestimmten zeo-address verweist.

zeo-address

gibt die Adresse des ZEO-Servers an, der Standardwert ist 8100.

Meist empfiehlt es sich, den Wert aus dem zeoserver-Abschnitt zu übernehmen:

${zeoserver:zeo-address}

zodb-cache-size

Anzahl der Objekte, die der ZEO-Client im Cache halten kann.

debug-mode, verbose-security

Damit die instance-Instanz die Daten ausliefert und die instance2-Instanz zum Debuggen verwendet werden kann, werden nur für die instance2-Instanz die Werte auf On gesetzt.

zope-conf-additional

erlaubt weitere Einstellungen der Zope-Konfiguration, in unserem Fall werden für den zweiten ZEO-Client die zserver-threads auf 1 heruntergesetzt. Debugging und Maintenance werden deutlich vereinfacht, da immer nur eine Anfrage gleichzeitig abgearbeitet wird.

Eine Übersicht über die für zope2instance verfügbaren Optionen erhalten Sie in http://pypi.python.org/pypi/plone.recipe.zope2instance.