PureData Server - Version 1.4

This document describes the PureData Server. The server is designed to be used with the PureLoad PureData tasks.

PureDataServer is used to store data in multiple named hash maps. Data associated with keys are simple comma-separated strings (actually the server handles the comma separated string as any string value).

PureData Protocol

For details of the protocol used see PureData Protocol

Installation

Extract the installation tar-file and the complete the following steps:

  1. Install Java or find where Java is installed on your system
  2. Edit the start script: bin/puredata-server.sh
    Specify JAVA_HOME if not already set on your system
  3. Check and edit conf/server.properties
    Default should be ok in most cases. Also see the comments in the file.
  4. Start the server: bin/puredata-server.sh

Verify that the server is running by connecting to the server using telnet. Issue a simple command, like STATUS and verify that you get a response.

Example:

# telnet localhost 3737
Connected to localhost.
Escape character is '^]'.
STATUS
VAL maps:0;total-size:0;heap:61;heap-max:1011;heap-used:6;OS:Mac OS X x86_64 10.8.5;JVM:1.6.0_37 Apple Inc.;
EXIT
Connection closed by foreign host.

Configuration

There are 2 configuration files found in the conf directory: