From [protofusion] :: Wiki

Contents 1 Welcome to DistRen's Online Documentation 1.1 Repository 1.2 Compiling It Yourself 1.3 Slave Setup 1.4 Frame Naming 1.5 Monitoring Interfaces

Welcome to DistRen's Online Documentation

Repository

[1] and [2] both contain the mercurial repository for DistRen. Neither will be out of sync with the other for more than 5 minutes. If you are interested in contributing or manually compiling a build, you may run the following command to get the source: hg clone https://protofusion.org/hg/DistRen Ensure that you have mercurial installed for your system to clone the repository. You can also download prebuilt testing packages and see build data at our automated build system

Compiling It Yourself

Requires:

• libxml2 - In most repos - should eventually be removed from buildsystem (as of 3/7/10)
• libcurl
• libmysql
• libarchive
• check
• libconfuse - In some repos, [3] (Now supports relative paths!)
• autoconf
• autoconf-archive

To Compile:

• Fill the dependencies listed above
• CENTOS: aclocal -I /usr/share/aclocal
• Download the source with hg clone https://protofusion.org/hg/DistRen or grab the most recent tarball here
• Run autoreconf -vfi
• Run CFLAGS="-g -ggdb -Wall" ./configure --prefix="${HOME}"
• Run make all install

Slave Setup

The slave binary of DistRen requires no manual setup, as the conf file is edited by the code itself. To set up a slave, see the procedure below, or invoke distrenslave -h

• Before attempting to run the slave, please create an account via the web interface, or contact a developer
• Place your username in distrenslave.conf
• Run distrenslave with no arguments
• You may want to clean out your datadir every once and a while, as distren does not yet do this automatically

If you are experiencing problems, contact a developer or log on to #distren on irc://protofusion.org

Frame Naming

The frame naming scheme of DistRen is currently a bit non-standard. If you download your frames to a single folder, the following script will rename your frames to 0000.jpg:

• JOBNUM=9; # replace with your job number
• MAX = 500; # replace with the number of frames you're renaming
• COUNTER=1;
• for ((COUNTER=0; COUNTER < ${MAX}; COUNTER++)); do mv job${JOBNUM}-frame${COUNTER}.jpg $(printf "%0.4d" ${COUNTER}).jpg; done

Monitoring Interfaces

• PHP
  • Web-based server-side monitoring and job submission interface - 80% complete
• J2ME
  • Monitoring Agent Installable on most modern cell phones
  • Project not yet started
• Other
  • Desktop Monitoring Program
    • Project not yet started
  • KDE Monitoring Widget
    • Project not yet started