Installation

The INSTALL file in the distribution is much more detailed and up-to-date. This should give you a quick overview, though.

---

Before attempting installation this early in the development, you should have the following knowledge or at least be comfortable with performing the following tasks:

• compiling and installing software, perhaps from src RPMS
• configuring XFree86 -- may not apply if you use a distribution that sets it up for you
• editing inittab
• using the SQLite command line client

Installation and Getting it Running

1. Untar the distribution to /usr/local. It will make a directory named thundaural-XX, where XX is the version number. I suggest you rename or symlink this directory to just thundaural, but this is optional.
2. If you plan on running the server as user other than root, become that user
3. cd into the thundaural directory and type

   $ ./checkdeps --server

   If everything checks out, it will create a configuration file. If not, resolve any dependancies and/or create any directories.
4. move the created configuration file to /etc/thundaural or just leave it in the directory there.
5. Run

   $ ./checkdeps --client

   Resolve any dependancies. Some of the dependancies are on the download page.
6. If you are going to run the jukebox in a dedicated environment, see the startup/README.startup file for details
Otherwise, you can start the server with:

$ cd /usr/local/thundaural
$ ./taserver

And starting the client is just as easy with:

$ cd /usr/local/thundaural/
$ ./taclient-touchscreen

The server takes a --port option to tell it which port to listen on, and --foreground, which keeps it in the foreground. The client takes --host and --port to tell it which server to try to connect to. Host defaults to a machine named jukebox (you might want to edit /etc/hosts) and the port defaults to 9000. The server will take --log stderr, --log syslog, or --log /path/to/file to determine where status and debugging output will go. By default, it all goes to the syslog.

If everything goes smoothly, put an audio CD in the machine's cdrom drive, goto the rip page (the red cdrom icon in the upper right) and hit start.

Alternatively, if the client doesn't start, you can still start a CD rip (and thus an initial database load) by telneting to port 9000 on the machine the server is running on and typing 'rip cdrom'. Typing 'status' will show the current status of ripping. You can type 'help' for a list of commands.

Touchscreen Config

I'm using an Elotouch touchscreen, which has XFree86 drivers. It emulates a mouse. See the elographics(4) man page.

It should be noted that BlueRobot's sphere of influence extends to this part of the internet.

Last modified Sun, Sep 12th, 2010, 13:41:23