Debian package distribution

You need to have a Java Runtime Environement 1.4 or 1.5 installed, see Java under Debian. Other dependencies are available via packages present into the Debian releases.

The FreeCast debian package is available on the Tryphon Debian archiver. Follow the archiver configuration instructions and install the FreeCast package:

[host:~] sudo apt-get install freecast  
Reading Package Lists... Done
Building Dependency Tree... Done
The following extra packages will be installed:
  libcommons-cli-java libcommons-collections3-java libcommons-lang-java libcommons-logging-java
The following NEW packages will be installed:
  freecast libcommons-cli-java libcommons-collections3-java libcommons-lang-java libcommons-logging-java
0 upgraded, 5 newly installed, 0 to remove and 1 not upgraded.
Need to get 3016kB of archives.
After unpacking 3618kB of additional disk space will be used.
Do you want to continue? [Y/n]

Content

Table 3.2. Debian distribution content

Filename Description
/etc/freecast contains configuration files, see the section called “Configuration”
/var/log/freecast contains log files as by freecast daemons
/etc/init.d/freecast-tracker the init.d script to control the FreeCast tracker daemon
/etc/init.d/freecast the init.d script to control the FreeCast node
/etc/default/freecast-tracker default values for the FreeCast tracker daemon
/etc/default/freecast default values for the FreeCast node
/usr/share/doc/freecast/userguide contains this user guide
/usr/share/doc/freecast/examples/audio contains configuration sample files for an audio stream
/usr/share/doc/freecast/examples/video contains configuration sample files for a video stream
/usr/share/doc/freecast/examples/tracker contains configuration sample files for the tracker
/usr/share/doc/freecast/examples/jws contains configuration sample files for a JavaWebStart™ deployment, see Chapter 7, JavaWebStart™ deployment

The FreeCast debian package respects the Debian policy. So FreeCast binaries are available in /usr/bin and in the default PATH, see the Reference Pages.

Getting started

If you want to deploy your own FreeCast network, you just need to provide a root node configuration.

[host:~] sudo cp /usr/share/doc/freecast/examples/audio/freecast-node-root.xml /etc/freecast/
[host:~] sudo /etc/init.d/freecast-tracker start                
[host:~] sudo /etc/init.d/freecast start

You can follow the FreeCast daemons activity via the log files into /var/log/freecast:

[host:~] tail -f /var/log/freecast/freecast.log /var/log/freecast/freecast-tracker.log

Relay node

If you just want to deploy a FreeCast relay node, you need to disable the FreeCast tracker daemon (see /etc/default/freecast-tracker) and to provide a node configuration with the tracker to be used.