Getting Started

Downloading

ResourceSync PuSH can be obtained here.

Installation

The install, decompress the downloaded file.

To decompress zip files, run the following from the command line.

$ unzip resourcesync_push-<version>.zip

To decompress tarballs

$ tar xvzf resourcesync_push-<version>.tar.gz

To install ResourceSync PuSH, run the following command. Note: Administrative privileges are needed to install.

$ sudo python setup.py install

Setup and Configuration

The install script, in addition to installing the ResourceSync PuSH library in Python's site-packages folder, will also install the configuration files and the binaries.

The binary files to start the servers will be installed in the system path (usually in the folder /usr/bin/ or /usr/local/bin).

To start the publisher, type:

$ resourcesync_pub

For starting the hub:

$ resourcesync_hub

For the subscriber:

$ resourcesync_sub

By default, the hub will listen to the HTTP port 8000, the publisher 8100 and the subscriber will listen to 8200. Each of the servers will start with 8 processes and each of the processes with 2 threads each. These parameters can be changed in the configuration files. They are installed in the folder /etc/resourcesync_push/. The folder should contain 4 files. Each of the server instance above will have it's own configuration file with the same name appended with the extension .ini.

$ ls -l /etc/resourcesync_push/
total 32
-rw-r--r--  1 root  wheel   399 Apr 17 13:08 resourcesync_hub.ini
-rw-r--r--  1 root  wheel   289 Apr 17 13:08 resourcesync_pub.ini
-rw-r--r--  1 root  wheel  1176 Apr 17 13:08 resourcesync_push.ini
-rw-r--r--  1 root  wheel   291 Apr 17 13:08 resourcesync_sub.ini

An example configuration file looks like:

[uwsgi]
http = :8000
module = resourcesync_push.hub.hub
callable = application
processes = 8
threads = 2
master = true

NOTE: The parameters module and callable should not be changed and doing so will break the installation.

The need for the configuration file resourcesync_push.ini is explained in the next sections.