| 1 |
; $Id$
|
| 2 |
|
| 3 |
requirements
|
| 4 |
--------------
|
| 5 |
MySQL with InnoDB support
|
| 6 |
must be able to run shell comands from php
|
| 7 |
must be able to run php-cli with the command "php"
|
| 8 |
must be able to run "ps"
|
| 9 |
must be able to run "hostname"
|
| 10 |
must be able to run "nohup"
|
| 11 |
|
| 12 |
installation and configuration
|
| 13 |
-------------------------------
|
| 14 |
1. Read the README file
|
| 15 |
2. Download DataSync to your favorite modules folder
|
| 16 |
3. Enable datasync.module and optionally datasync_consumer
|
| 17 |
datasync_producer.module on the admin/build/modules page
|
| 18 |
4. Set your HMAC key to something secret on the
|
| 19 |
admin/settings/datasync page.
|
| 20 |
You can now use the core DataSync API
|
| 21 |
But you will probably want to use datasync_consumer and
|
| 22 |
datasync_producer modules:
|
| 23 |
5. Download or write modules that implement the hooks of
|
| 24 |
the datasync_consumer.module and datasync_producer.module
|
| 25 |
(see datasync_api_example.module as an example)
|
| 26 |
6. Enable them on the admin/build/modules page
|
| 27 |
7. Add the hostnames (the output of the command "hostname")
|
| 28 |
of the servers that you want to run datasync consumers and
|
| 29 |
producers on admin/settings/datasync/consumer and
|
| 30 |
admin/settings/datasync/producer.
|
| 31 |
8. Enable the consumers and producers you want to run on
|
| 32 |
admin/settings/datasync
|
| 33 |
9. Make sure your cron.php is set to run at least every hour
|
| 34 |
to keep the datasync_consume.php and datasync_produce.php
|
| 35 |
scripts alive (Note that they won't stall your cron.php,
|
| 36 |
they just spawn php cli processes.)
|
| 37 |
10. Watch your jobs run automagically.
|