Install Rivendell Automation: Part 3 – Install Client

Install Rivendell Automation: Part 3 – Install Client

We’re in the home stretch! The differences between the server and client installation are subtle (and slightly nuanced) but significant. I’ll try to point out the differences as we go along.

1: Install MySQL client and JACK: (the difference here, we’re only installing a MySQL client)

When the installer asks if you want jackd to run with realtime priorities. Say YES!

2: Now, install the Rivendell client software (again, Rivendell client only, which means no Apache web server to delegate importing audio responsibilities to clients — that will be handled by the server):

3: The /var/snd (audio store) is created automatically during the server install, however you need to create it manually on the client — before you configure autonfs — or you’ll have an invisible /var/snd directory that has no local directory to mount to — and no way to create it — because it’s already mounted to an NFS resource. Trust me, it’s all bad if you forget this step:

4: Next, let’s edit rd.conf:

Here, you wanna pay extra attention to the mySQL “Hostname=” value — we’re using the STATIC IP of the SERVER instead of =localhost. Copy the text below to your clipboard. Then, head back over to the terminal and use your arrow keys to move your cursor to the line with the default [mySQL] entry and hit CTRL+K to delete each line below it until the [Identity] section is all that remains. Now, paste the text below, after the [Identity] section in rd.conf — replacing everything from the default [mySQL] section to the end of the file — with the following:

CTRL+O. ENTER. CTRL+X to exit nano.

5: Install the NFS-client:

Mounting NFS shares can add serious drag to boot time, so we’re going to implement the autonfs script that Jeroen Hoek created. This script takes care of mounting your NFS shares automatically after a reboot, instead of relying on /etc/fstab to handle the burden of waiting for the network adapter to load and find the NFS shares, before Linux can finish booting.

6: Copy and paste the code below into an empty text file:

7: There are only 3 parameters that *might* need editing in the # Configuration parameters section: FILESERVER, MOUNTOPS, AND MOUNTS. I’ve commented out the examples with the #(pound) symbol and pasted my working parameters directly below the examples in the script. You will probably only need to edit: FILESERVER (with the STATIC IP of your Server). Edit them to suit your specific environment and save the script as “” – without the quotes – in your home directory.

8: Once that’s done, open a terminal and make it executable with the following:

9: Next, move it to: /usr/local/bin – where it’ll be called by our upstart job.

10: Now, we need to create the upstart job by copy and pasting the following script into another empty text file and saving it in your home directory as: “autonfs.conf” – without the quotes.

11: Then, execute the following command in a terminal:

12: Start the upstart job. When you reboot it will be started for you automatically on each reboot:

This effectively mounts the NFS shares from your Rivendell server into the local /var/snd directory on your Rivendell clients — like Biz Markie — auto-magically. It dramatically reduces the boot time (to :07 seconds — from like :90 — on an SSD) but still takes another 20 seconds or so for the directory to populate after booting. So don’t try to play audio until the shares have mounted, or you could hang RDAirPlay, delaying your startup even longer. I’ve already done it, so you don’t have to… You’re welcome.

Reboot your system and then proceed to PART FOUR: Configure Hosts