Install under Gentoo
From Rivendell Wiki
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)--->
