Install under Debian

From Rivendell Wiki

Jump to: navigation, search

This page describes how to install a dedicated server for Rivendell under a debian GNU/Linux system.

Note: The rivendell, jack-init debian packages are available in the Tryphon Debian archiver.

1 Prerequisites
2 Procedure
3 Troubleshooting
4 Links

[edit]

Prerequisites

libqsqlmysql.so

FIXME: A list of the assumptions the process makes about the underlying Debian installation should go here.

[edit]

Procedure

[edit]

Create user

Create a dedicated user (like radio) which will be used to run the jack server and Rivendell applications.

Add it to the audio group :

sudo adduser radio
sudo adduser radio audio

[edit]

Install X

If needed, install x-windows-system package and your favourite window manager You can install a light window manager like WindowMaker (package wmaker).

Check /etc/X11/XF86Config-4 to make sure that your displays in the "screen" section have 1024x768 as one of their resolutions.

[edit]

Install MySQL server

Install the mysql-server package.

Create a rivendell database and an user:

mysqladmin -u root create Rivendell

mysql -u root mysql
mysql> GRANT ALL PRIVILEGES ON Rivendell.* TO radio@localhost IDENTIFIED BY 'radio';
mysql> exit

mysqladmin -u root flush-privileges

[edit]

Install jack

Install the jack-init package. It provides an init.d script which starts jack at startup. Uses the realtime-lsm package to use a realtime jack daemon.

Sample (working) /etc/default/jack:

Please put in a working sample... My current one follows:
Note: riven is my user, not radio.

#
# Defines the user which runs the jack daemon.
# If not defined, the daemon won't be started.
#
# DAEMON_USER=jack
DAEMON_USER="riven"

Sample (working) /etc/jackdrc:

Please put in a working sample... My current one follows:
Note: my soundcard is only 48000, but I have also tried 44100 in this file.

realtime=true
jackd=jackd
driver=alsa
jackh=jack.plumbing
rate=48000

Note: I am asking for working samples becuase unless I have DAEMON_USER="root", jack will not start for me. (zotz)

I can run everything as root but am not happy about it. Please remove these notes when working samples are in place. (or transfer to the discussion page.)

[edit]

Install Rivendell

Install the rivendell package The rivendell group is used. Add our user to this group :

sudo adduser radio rivendell

[edit]

Edit Rivendell configuration

Create and edit the /etc/rd.conf file.

A minimalist version can be :

[Identity]
Password=radio
AudioOwner=radio
AudioGroup=rivendell

[mySQL]
Hostname=localhost
Loginname=radio
Password=radio
Database=Rivendell

[edit]

Create dedicated partition

Create a dedicated partition for /var/snd. Allocate a large partition (via lvm for instance)

[edit]

Start daemons

Start the daemons :

sudo /etc/init.d/jack start
sudo /etc/init.d/rivendell start

And here is a Problem. The Rivendell daemons have to be run by the user defined in /etc/rd.conf ! If you do not, there is no sound !

[edit]

Start RDAdmin

Start RDAdmin and configure Rivendell :o) It seems necessary to use the root mysql login for the first rdadmin initialisation.

you can log in as admin or as user. There is no password by default

[edit]

Troubleshooting

If there are problems you should activate the logfiles of the daemons in rd.conf.

Add this in the logfile:

[Caed]
Logfile=/home/myself/caed.log

Caed takes commands from the TCP Port 5005 and plays the files from /var/snd. The matter of fact, only the daemons of rivendell write direct to this directory. A working caed should write something like this in the logfile:

05/15/2005 - 12:00:50.131 : cae started
05/15/2005 - 12:02:53.207 : LoadPlayback  Card: 0  Stream: 0  Name: /var/snd/000001_001.wav  Handle: 0
05/15/2005 - 12:02:53.213 : PlaybackPosition - Card: 0  Stream: 0  Pos: 0
05/15/2005 - 12:02:53.213 : Play - Card: 0  Stream: 0  Length: 160522  Speed: 1000  Pitch: 0

If you dont have sound with JACK:

1. Make sure the JACK Daemon runs as the same user like the rivendell daemons. For this to work, the Audio devices in /dev/snd/* and /dev/shm/* should have the right permissions. (what should these permissions be?)

2. Start XMMS with the jack plugin to check if jack is working properly.

3. Install qjackconnect, with this programm you can check if caed connects the rivendell outputs to your correct jack audio outputs. If not, you have to edit /etc/rd.conf. Read the JACK.txt file which comes with your Rivendell distribution.

Tip: Jack has a fixed Samplerate. Normally it is set on 48000 or 44100. You should check with rdadmin that the rivendell programms work with the same sample rate, otherwise your sounbd plays a faster or slower.

[edit]