Install under Gentoo

From Rivendell Wiki

Jump to: navigation, search

Contents

Installation

An ebuild has been written to use portage to install Rivendell. It can be retrieved here. If you don't know how to manage out-of-tree packages it may be easiest to have lyman sync you with the sunrise overlay that rivendell resides in. Be advised that this puts a lot of other relativly untested packages in your portage tree.

$ emerge -va layman
$ layman -f -a sunrise
$ echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf
$ layman -s sunrise

If you would like support for Audio Science hardware, install the drivers first.

# For i686
$ echo "media-radio/rivendell ~86" >> /etc/portage/package.keywords
# For amd64
$ echo "media-radio/rivendell ~amd64" >> /etc/portage/package.keywords
$ emerge -avu rivendell

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
$ rc-update add mysql default
$ /etc/init.d/mysql start

You should of been prompted for a root password and then started your mysql daemons. For a comprehensive 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.

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

Make sure the hostname is set correctly. The login, password, and database can be whatever you want, just make sure you put something in there.

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 passmord. The default user is admin and there is no password. Now its time to fire up the daemons.

$ rc-update add rivendell default
$ /etc/init.d/rivendell start

You should have at the least a working gentoo 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.

Troubleshooting

MySQL

If you get something like:

# rdadmin
QSqlDatabase: QMYSQL3 driver not loaded
QSqlDatabase: available drivers: (null)

add the mysql USE flag into /etc/make.conf and update your system as explained into the Portage Introduction of the Gentoo Handbook:

# emerge --update --deep --newuse world
# emerge --depclean
# revdep-rebuild
Personal tools