From Rivendell Wiki

Installation

A Rivendell installation consists three main packages, MySQL, Apache, and Rivendell. You may substitute another web server but Apache is best supported.

Optional: MySQL USE flag

If we are using a database on another machine, we have the option of a minimal, client-only install of MySQL. If this is the case, you may set a minimal USE flag.

echo "dev-db/mysql minimal" >> /etc/portage/package.use

This step is optional either way.

Fetch Ebuild

The ebuild and patches are in the proaudio overlay. See proaudio wiki for retrieval instructions.

Unmask

Once the ebuild is on your system, unmask the package.

For i686

echo "media-radio/rivendell ~86" >> /etc/portage/package.keywords

For amd64

echo "media-radio/rivendell ~amd64" >> /etc/portage/package.keywords

Now that qt3 has been removed from the main portage tree, you'll need another overlay before emerging RD.

layman -a kde-sunset

Emerge

emerge -Navu rivendell

Post-Emerge

MySQL

If we are using an exsisting database on another machine, see Remote Client Access and continue past this section, if you need a new database, continue here. Create the intial mySQL folders and a root account. Note that this mySQL root account applies only inside of mySQL.

emerge --config mysql

You should be prompted for a password.

To allow access for other machines, see Remote Client Access.

Add the daemon to the default runlevel.

rc-update add mysql default

Start the deamon.

/etc/init.d/mysql start

For a comprehensive, but probably unnecessary introduction to mySQL, see the Gentoo MySQL Startup Guide.

Apache

After Apache in installed, the Rivendell CGI components need to be enabled. Append '-D RIVENDELL' to APACHE_OPTS in /etc/conf.d/apache2, so it looks something like this

APACHE2_OPTS=" ... -D RIVENDELL"

Once that configuration is in place, add apache to your default runlevel and start it up

 rc-update add apache2 default
 /etc/init.d/apache2 start

ALSA

Configure you sound cards for exclusive RD control. There is a graphical applications that lets you pick which sound cards you will be using.

rdalsaconfig

rd.conf

Make an /etc/rd.conf. A sample is at /etc/rd.conf.sample.

Set the Hostname, Loginname, Password, and Database to your existing database. If this is a fresh install, leave the hostname at localhost. By default the mySQL root account can only be accessed from localhost. The login, password, and database can be whatever you want, just make sure you put something in there. Its best not to use the root password you set mySQL up with, you should only need that once, and that's next.

[mySQL]
Hostname=localhost
Loginname=
Password=
Database=
Driver=QMYSQL3

MySQL Database Creation

Now create the database as defined above.

rdadmin

Give it your mysql root password. Once this is done, rdadmin will ask for a user and password. The user is admin and there is no password.

Now you can set the daemons to work.

rc-update add rivendell default
killall caed
killall rdcatchd
killall ripcd
/etc/init.d/rivendell start

You should have a working installation. From here you can a look at the documentation in /usr/share/doc/rivendell for further configuration and the official manual for general operation.

Et Cetera

Jack

The init script that portage installs with rivendell runs the daemons under the permissions of the system user "rivendell". Using jack will require those deamons and jack to run under the same user.

Realtime Priority

Follow the gentoo documentation[1] then make the user rivendell part of a realtime group and restart your daemons.

Serial Ports

RD daemons under default permissions cannnot access serial ports. To change that add the rivendell user to the uucp group and restart the daemons.

groupmems -a rivendell -g uucp

Install under Gentoo