EJB Installation

EJB Installation on Linux

Installation Instructions

To use this server, you must configure your Linux kernel for System V IPC facilites and the generic SCSI driver. Configuring IP multicast is also desireable, but not necessary. Do this before the next step of installation, see the Linux Documentation Project if you want to know how to do this.
If you use the Redhat Package Manager, download and install the Ensemble and EJB RPMs. Here are the links:

Become root and go to the directory where you downloaded the packages and type:

% su

# rpm -i ensemble-0.40-1.rpm

# rpm -i ejb-0.9-1.rpm

This installs the Ensemble utilities and development libraries, the EJB binaries, and creates a directory for maintaining information about your collection of CDs. The EJB server binaries are setuid to daemon, but the other binaries run as the user.

If you don't use RPM, consider using it. Look at www.rpm.org for details. Otherwise, install from the source distribution. Source code is also available as ejb0.9.tar.gz. To compile the src, you will need to go through three steps.

First, you will need to install the OCaml compiler. This compiler is available from INRIA, and you will need version 1.05 or higher. Follow the directions to install this compiler.
Next you will need to install Ensemble, which is available from Cornell. The distribution contains byte compiled binaries, as well as sources. Follow the directions at the Ensemble home site to install Ensemble.
Finally, follow the directions in the EJB source to install it. This should just require something like:

% make opt
% su
# make install

Create your audio directory.

If you wish to save CD audio audio to your disk, you need to first create a directory where EJB will store the data. The directory should have group daemon. This directory will need to be quite large--each recording of a CD takes 150-170MB of disk space. Multiple directories can be managed. Remember the directory name(s), as you will need them in the next step when configuring EJB. For example, some people use /tmp/audio for their audio directory:

% su
# df /tmp
# mkdir /tmp/audio
# chgrp daemon /tmp/audio
# chmod 775 /tmp/audio

Edit the EJB configuration file. To use EJB, you will first need to start the server. During installation, you installed the configuration file /etc/cdda.conf. You should check over this file to see if the configuration settings are correct.
Run cdda_server.

It is necessary to have the server running in order to use the ejb front-end. Only one such server should be run per machine. Once the server us started, it runs in the background and waits for requests from other remote servers and local clients.

While the server is running, it locks the /dev/cdrom device, preventing the tray from opening. If you want to insert a CD, the tray can be opened from within an ejb client process. Most of the options are provided during installation, but you may modify the server behavior by using the following options:

-cdda <dir>: this option specifies a directory that can be used to store user configurations and CDDB entries.

-dir <dir>: this option specifies an additional directory for storing audio data. This option may be used multiple times (and may be in addition to directories listed in /etc/cdda.conf).

-nocdrom: do not access the cdrom device on the machine. This is advisable when the machine does not have a cdrom drive.

-noaudio: do not access the sound card on this machine.

Now that the server is running you can run the graphical front-end of the system. Type:

This should bring up a graphical interface to the system. This interface is described in rest of this documentation.

Testing status

We have tested EJB on Gateway Pentium Pro machines, with ATAPI cdrom drives, and Soundblaster 16 audio cards, as well as the HP Vectra XU 5/133, with a Toshiba SCSI cdrom drive, and Soundblaster AWE 32 audio card.