Installing keepalive 0.1
Unpack the tarball in a temporary location. E.g.:
$ cd /tmp $ tar xzf ~/keepalive-0.1.tar.gz
Move or copy the 'keepalive' subdirectory in the unpacked directory to the 'Products' directory of the $INSTANCE_HOME of the Zope application server instance. E.g.:
$ cp -r keepalive-0.1/keepalive /home/zope/prod/instance/Products/
$ /home/zope/prod/instance/bin/zopectl restart
Verify that the new product installed correctly by visiting the /Control_Panel/Products tab.
- In the ZMI for the application server, add a 'ZEO Keepalive Too' from the add menu, leaving the ID of the tool the default.
- In the root user folder, add a new user, 'keepalive'. Note: you may use an existing user, but need to be able to put the password for this user in the zope.conf file (see #4 below, under "Configure the Clients").
- On the "Security" tab of the new tool, click the checkboxk for 'Manage properties' under the 'Owner' column, and then click the "Save Changes" button.
- From the "Security" tab, click the "local roles" link, and grant the new 'keepalive' user the 'Owner' role.
- On the "Properties" tab of the new tool, set the warning and error intervals, in seconds, used to change the color of the display when a client falls out of date. Set the refre interval, in seconds, if you want the "Status" page to auto refresh.
For each client in your cluster:
Edit the zope.conf for the client, adding a stanza similar to the following:
%import Products.keepalive <clock-server> method /keepalive_tool/updateClient?key=foo period 60 user admin password qqq123 host localhost </clock-server>
Replace the 'foo' in each case with a unique name for the client.
Replace the '60' with an interval, in seconds, at which you want the clients to write their updates to the tool.
Replace the 'admin' and 'qqq123' with the login and password of the user who has the 'Owner' role on the tool (see #2 above, under "Set up the Tool").
Restart the client.