Install under Gentoo

From Rivendell Wiki

Jump to: navigation, search

Contents

Retrieve Install Scripts

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

Unmask and Install

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

Install Rivendell

emerge -avu rivendell

If you get an error about X11-/libs/qt:3 being masked, just unmask it (don't worry, qt3 is stable).

echo "x11-libs/qt:3" >> /etc/portage/package.unmask

Mysql

All rivendell needs to create its database is the root password for your mysql server. If you got a fresh install of Mysql along with Rivendell, initial setup is easy.

emerge --config mysql

You should be prompted for a root password.

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.

Post Installation Configuration

First edit /etc/rd.conf. The most important options are at the top;

[Identity]
AudioOwner=
AudioGroup=

Set owner and group to the user account that you will use to run the rivendell applications, not the user that you think will run the daemons.

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

Make sure the hostname is set correctly. You would do well to replace localhost so that you can copy and paste this section to your other machines. The login, password, and database can be whatever you want, just make sure you put something in there. Its probably best not to use the root password you set mysql up with, you should only need that once, and that's next.

Now create the database as defined above.

rdadmin

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

If you want other RD workstations with a common database, edit /etc/mysql/my.conf to allow network access and give the workstations the same RD database configuration.

/etc/mysql/my.conf

# security:
# skip-networking
bind-address                            = 192.168.1.1

If you were planing to use alsa, now is a good time to configure your cards.

rdalsaconfig

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 I would suggest you take a look at the documentation in /usr/share/doc/rivendell for further configuration and the official manual for general operation.

User Permissions

The init script that portage installs with rivendell runs the daemons under the permissions of the system user "rivendell". For a alsa only system, this is the authors recommendation. Using jack will require jack to run under the same user, but know that running RD daemons under a non-system user violates good system security pratices.

Perfomance Tweaks

This tip applies across all flavors of linux, but gentoo is one of the few where picking your I/O scheduler is standard operating procedure. When building a kernel from source, you are given four options for I/O sheduling; Anticipatory, Deadline, CFQ, and no-op. These are four distint mechanisms for scheduling reads and writes to block devices that are beyond the scope of this article. It is the authors recommendation that anticipatory and no-op are not used on rivendell machines, and that deadline is in use on the fileserver/mysql database machine.

Configuration is found in kernel options under "Enable the block layer --->" "IO Schedulers --->".

< > Anticipatory I/O scheduler
<*> Deadline I/O scheduler
<*> CFQ I/O scheduler
Default I/O scheduler (Deadline)--->
Personal tools