Emptytree Seedy Manual
Chapter 2 - Installation

2.1 Requirements

Networked Filesystem

The hosts should be networked and accessible from each other, 10Mb ethernet should be fine. The music filesystem on the main host must be exported to the other hosts with the same path name.

Linux

The cdrom and soundcard parts of the code are Linux and OSS dependent.

PERL >= 5.0

http://www.perl.org/

Gtk 1.2

http://www.gtk.org/

Gtk-Perl 0.7005+

For hosts that will run the user interface. Test with:

     $ perl -MGtk -e 'print $Gtk::VERSION, "\n";'

Install as root with:

     $ perl -MCPAN -e 'install Gtk'

Debian package:

     libgtk-perl

Cdparanoia

For hosts with cdroms. http://www.xiph.org/paranoia

Mpg123

For hosts with soundcards. http://www.mpg123.de/

Encoders

8hz-mp3 or lame. http://www.sulaco.org/mp3/

Optional PERL Modules

Crypt::Blowfish and Digest::MD5. Greatly improves performance. Test with:

     $ perl -MCrypt::Blowfish -e 'print $Crypt::Blowfish::VERSION, "\n";'
     $ perl -MDigest::MD5 -e 'print $Digest::MD5::VERSION, "\n";'

Install as root with:

     $ perl -MCPAN -e 'install Crypt::Blowfish'
     $ perl -MCPAN -e 'install Digest::MD5'

Debian packages:

     libcrypt-blowfish-perl libdigest-md5-perl

Optional Postgresql

Advanced listening features requires the use of Postgresql (see Local Database?, Section 3.2).

2.2 Download and unpack

Latest version should be found at: http://emptytreeSeedy.sf.net/.

Debian Users: Download the .deb version of the release and as root execute:

     $ dpkg -i emptytree-seedy-<version>.deb

Others: Download the .tgz version of the release and as root execute:

     $ tar xvzf emptytree-seedy-<version>.tgz     # unpack the sources
     $ cd emptytree-seedy-<version>               # change to the toplevel directory
     $ perl bin/install                           # install

Other release dependent steps may be necessary, consult the INSTALL file that came with your release.

2.3 Trusted Mode

Emptytree-seedy can run in trusted or untrusted mode. Trusted mode allows machines to interact with each other to start emptytree-seedy daemons and save emptytree-seedy configuration. This is only useful when configuring the system. Trusted mode is inherently insecure. Trusted mode is disabled by default (see Security, Section 5.2).

Execute on every host to enable trusted mode:

     $ emptytree-seedy --trusted

Execute on every host to disable trusted mode:

     $ emptytree-seedy --notrusted

On each host this creates an empty configuration file under the users home directory in the file .emptytree-seedy/<host>/config.pl.

2.4 Password

Emptytree-seedy uses a shared secret password to sign messages sent between its daemons. In order to execute emptytree-seedy at boot time and to save entering a password you can configure the password. This reduces the security of your emptytree-seedy system to read access to that file.

Execute on every host to configure a password:

     $ emptytree-seedy --pwd

On each host this creates a copy of the password in .emptytree-seedy/<host>/pwd.

2.5 Booting for the first time

Before you can start configuring your system every host must run a Service daemon. This reads and writes configuration files and starts other daemons. This is accomplished by executing on every host:

     $ emptytree-seedy --boot

Emptytree Seedy Manual