Path

7x / documentation / ez publish / technical manual / 6.x / features / queue handling in asynchron... / setting up the asynchronous...


Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

Setting up the asynchronous publishing service with an init script

This is the method that we recommend on production. Standard init scripts are provided, and can be used to have the daemon started on boot.

Create a symbolic link to the script matching your platform in /etc/init.d/. You can choose the name you want for the symbolic link. This allows you to setup multiple daemons on your server for multiple sites.

  • For Red Hat Enterprise Linux (RHEL), CentOS, Fedora, SUSE:
bin/startup/rhel/ezasynchronouspublisher
  • For Debian and Ubuntu:
bin/startup/debian/ezasynchronouspublisher

This is an example for Debian:

cd /etc/init.d
ln -s /path/to/ezpublish/bin/startup/debian/ezasynchronouspublisher
chmod +x ezasynchronouspublisher

The daemon can now be started using:

/etc/init.d/ezasynchronouspublisher start

The daemon options are listed by:

/etc/init.d/ezasynchronouspublisher help

The daemon can now be configured to start up on boot using:

chkconfig ezasynchronouspublisher on

Customized variable settings for init scripts

The init scripts come with default settings that should match most platforms. If your web server user is not the platform's default and/or the PHP CLI executable is not part of the web server user's PATH, this can be configured.

First, copy the default configuration file for your platform to the correct directory for your OS:

  • RHEL:
/etc/ezasynchronouspublisher.conf
  • Debian:
/etc/default/ezasynchronouspublisher.conf

Example for Debian/Ubuntu:

cp bin/startup/<platform>/ezasynchronouspublisher.defaults /etc/default/ezasynchronouspublisher.conf

Then edit this file, uncomment and set the required variables to the required values as according to the comments in the settings file.

In the case where both the file "ezasynchronouspublisher.defaults" and "ezasynchronouspublisher.conf" exists, the .conf file will have precedence.

Geir Arne Waaler (24/01/2011 12:25 pm)

Geir Arne Waaler (29/08/2011 9:34 am)


Comments

There are no comments.