Category Archives: Rivendell

  • 0

Nice demo of Rivendell with StereoTool

StereoTool is a very competent Jack enabled Audio Processor / FM stereo / RDS  Generator that runs on a decent 64Bit PC with a 192 kHz sample rate sound card.  Here is a YouTube demo of Rivendell feeding StereoTool through Jack. You can see the components working, and then the setup in KXstudio Catia patchbay.
[lyte id=”XufDQLV6ZrM” /]

Nice! Where else can you get a complete radio station in a box?  Just add transmitter and antenna.


Network Setup for Rivendell and NetJack

The physical connections between computers running Rivendell and/or NetJack should be done with a bit of thought.  There are some special considerations in any network that carries real time audio or files that must be served on an exact schedule.  This “real time” requirement is different than most computer needs where a document or web page can be served at some time in the future, as long as it is soon.   Audio streams and playout systems need their data NOW.

Rivendell requires Internet access for its rdcatch feature, as well as to access audio files, logs, ssh management, icecast servers. ftp servers and podcast servers, etc.  A Jack server should have access to the internet for the same reasons, plus network time, printers, sending email alerts, etc.  I will call this a connection to the “Office Network” since it includes mostly non-real time traffic.

The safest way (I have thought of) is to have the Rivendell Server(s) connect to two separate networks.  One network, the “Office Network” carries all the normal traffic, connection to the internet, uploading of logs, printing reports, VoIP, etc..  The other network I call the “Music Network” carries only NetJack zita-njbridge traffic, NFS traffic for audio files, and MySQL traffic and some network management traffic.  Rivendell also requires that the Ethernet addresses for these purposes are STATIC, meaning that they are maintained permanently and  setup manually.  The “Office Network” could be automatically assigned using DHCP, or can be STATIC, although there are good reasons that the server interface to the “Office Network” should be STATIC also.

Below is a graphic showing a possible configuration of a Rivendell – zita-njbridge system in  a small radio station, or station cluster.  It is not yet set up for redundancy to provide high reliability, but later additions will permit this:

Network Layout
Rivendell – zita-njbridge Music and Office Networks###

Please note that this network will not work as shown.  The office network switch would have to be a layer 3 switch or router with routing for internet addresses or the two DHCP lines to the Rivendell Workstations should not be connected.   Internet connectivity to the Rivendell workstations can be achieved using a Squid Proxy (pretty good) or Double NAT (not such a good idea)

The “Music Network” should use Gigabyte Ethernet interfaces on the computers and switch.  It should use Cat-5e or Cat-6 cables in a unique color to distinguish it from the office network.  If patch panels are used, they should be separate panels from the office network to avoid confusion.  As you can see, only the machines that have real time functions are connected to this net.  There could be a Network Attached Storage device on this network also, but it should not be used for backups, etc.; only for music and playout traffic should be on this network.

In this installation I have arbitrarily assigned the “Music Network” to a class C non-routable set of addresses:

Parameters -192.168.60.0  netmask 255.255.255.0  Gateway 192. 168.60.1 (The server) Broadcast 192.168.60.255.

This means that any device on the “Music Network” assigned an address beginning with 192.168.60. will be a member of this network.  It does not require a router, just a switch since the knowledge of the members of this network and the needed data routes will be known by each of the computers involved.  This network could possibly have 254 devices attached, but you would never want that many.

The “Office Network” is a conventional internet connected network configured to be efficient for its size.  It carries all the regular business and computer traffic of the operation, in addition to providing audio file upload services and possibly streaming sources for Internet Streaming. Conventional network design considerations are appropriate here.  A small station could possibly use the firewall – router provided by the Internet Service Provider (ISP), or another solution with more than one ISP and a load balancing router, a router using DD-Wrt or other open source router software, or Cisco or other “heavy iron” solution.

Not shown here, but for radio stations that need to deliver programming to remote transmitters, there may be a third ethernet interface on the Rivendell Server for an “STL Network” whose exclusive purpose is program delivery, transmitter control and communications to the station transmitters.  The traffic on this network should be separated from the other networks. This network will interconnect using dedicated microwave channels, landline T-1, and/or other methods of data transport  requiring well thought out routing protocols for high reliability.


Don’t Edit /etc/security/limits.conf

There are a number of sites that say to edit /etc/security/limits.conf.

The Cadence package from the KXStudio repository  automatically makes the entries for Jack in

/etc/security/limits.d/audio.conf and establishes the proper settings on installation.

The package automatically sets up Jack2 except for choosing the soundcard,  sample rate, buffer size, etc which you have to choose in the configuration menu of the application.

Qjacktl also sets these same parameters in its configuration menu.  They talk to each other, so you won’t screw things up by switching back and forth.  It is just that Cadence and Catia (Patchbay) are much easier to understand, and are prettier.

The debian.tryphon.eu  (This package no longer exists)   Rivendell package automatically sets them up in

/etc/security/limits.d/rivendell.conf

The priority and memory reservation for Jack are set in a file /etc/security/limits.d/audio.conf installed by kxstudio or qjackctl.  It is a good idea after installing to check that it has been installed.  It sets priority and memory reservations for the members of the  ‘audio’ group that should run jackd.  Files should be added here to set those applications with special needs for priority.

If you are using clamav malware and virus sniffer, its user should have a low priority “nice” level greater than 1 for its systemwide searches.  This is not automatically set, so you will need to make a  /etc/security/limits.d/clamwin.conf  file to limit clamwin’s consumption of resources.

The general philosophy with jack is to protect application’s priority by protecting the transport.  If you have a busy audio processor or something else that MUST run in realtime you might want to add a file for it in  /etc/security/limits.d/  reserving its necessary memory and a negative nice value closer to zero than that of Jack and Rivendell.   This is only needed if you have overruns or gaps or frequency or time shifts that are otherwise unexplained.

Another source of problems can come from hard drive partitions that are filled up.  Beware of backup programs, log files, etc. in a partition that is pretty full.  Ubuntu studio hangs up waiting for disk writes that never complete.


Hardware for Audio – Server and Workstation

The Playout Station

A Rivendell playout (Radio automation) box with with Jack2 and zita–njbridge can be incredibly simple thanks to edgeradio 99.3 FM in Hobart, Tasmania, Australia.  A raspberry pi 3B+ or raspberry pi 4 with the raspberrian sd card and a good two channel or  four channel sound USB interface or an Octo 8 sound card hat from audio injector.   You will need a robust power supply, preferably battery backed with shutdown.  The raspberry pi Rivendell Playout can be used as a full automation system when attached to a server containing an NFS media store and a MySQL (Mariadb) database.   Alternately, it can be a stand alone playout for advertisments and liners on a hyper-local station or feed that takes its main programming from a network or service.  It is well suited for a station that stitches together podcasts and other programming that does not require large storage. The raspberry pi has no real time clock, so it is important to set up ntp (see Raspberry Pi -Rivendell post ) to a local server to acquire correct time quickly.  The Raspberry PI doesn’t have a good audio output, so it is necessary to add a hat or USB sound device.

If you need Rivendell to do more than a simple automation, but want to add audio processing, virtual console, etc., you should use should use a reliable  PC with a motherboard with an X64 processor  with two to four cores, Several Gigs (4+?) of Memory, and if it is to be used with a server for audio storage and database, you only  need 120 Gigs of SSD.     In a playout or editing environment, an SSD is important for fast boot, low noise  and fast loading of applications. The $50 a little SSD costs is well worth it.  An additional hard drive is useful to keep keep work files in the /home folder.  If you have a good server, you don’t need a big hard drive for the workstations unless you want to duplicate the library and database on the workstation (this is tricky because they need to be kept synced) and you would need to write a script to make the switchover quickly.

If you work with a server, you need a good quality Gigabit network card which you will set up for static addressing.

You need a good sound card fully rated for ALSA compatibility.  I have used PCI (PCI and PCIe cards don’t work with the PI) and USB  M-Audio hardware with good results, particularly the Delta 1010 cards and the all of the 17xx cards work well too.  Ubuntu studio 20.04 has also learned to play nice with M-Audio Fast Track 8R USB rack mounted box. (earlier versions did not), as well as nearly every other USB quality sound card from Beringer, Presonus, M-audio.  Pick ones that have balanced input and output and quality microphone amplifiers (If you have mikes)  Rivendell loves the Audio Sciences cards in PC computers, but they are pricey.

If the workstation computer is physically in the studio, you also want one with high volume LOW NOISE fans. This is where the Raspberry PI shines.  The little fan to cool a PI can be very quiet.   Bigger PC cabinets seem to have quieter fans than micro cases because they use larger 120 mm fans that move more air with slower blades. Use a good quality power supply and UPS.  The UPS should be connected to the computer USB  port and setup with USB drivers for that brand for graceful shutdown when the power goes out, and stays out.

The current version of Rivendell playout has a fixed window size so don’t go crazy on monitor resolution or the control window will be too small.  (I have heard that this is likely to change in the next major revision).   Your video card does not need to be anything special, motherboard cards work fine.  rdAirplay will work with a touchscreen, and there are many that work with Ubuntu, but not all.  Your touchscreen mileage may vary.  You are looking for high reliability, not blazing performance. Do not overclock.

Rivendell works with audio switchers such as the Broadcast Tools SS 8.2, and with digital IO cards that talk by RS-232 serial ports.  It would be nice if the motherboard had an RS-232 port, but a high quality USB-RS-232 converter will work.  There are cheap converters that are tricky to make work because they need a special driver that might not be available in Linux.  The machines that will be running RdCatch and RdAirplay will need this if you need these outputs to switch satellite receivers and such.  (You may be able to avoid audio switches if you have enough inputs and outputs on your soundcard when running Jack2.)  Rivendell macros can run jack_connect and jack_disconnect commands.

I am looking for a suitable case for the Pi with the Octo

The Server

A server for Rivendell should have excellent computing  performance to the workstation, and should have six or more cores on an X64 chip, with eight or more gigs of memory.  Hard drives should start with a 128 Gig SSD for the operating system, and at least 2 TB of high quality raid hard drives to use in ZFS ‘raid’ mode for audio and database.  The new ZFS file system for the large raid drives allows for flexible organization of the data volumes.  ZFS data compression on a fast machine will both increase the hard drive capacity and speed.

You should have two or three Gigabyte Ethernet ports on this machine.

It theoretically could be a “headless” machine, but some of the audio applications just really need GUI interfaces.  Sharing a monitor, mouse and keyboard with a KVM switch (Don’t confuse with KVM virtualization discussed elsewhere) to share Keyboard Video and Mouse  with another machine (such as a standby server) would be useful.    Be careful that the KVM switch and the motherboard have the same mouse and keyboard connectors.  USB to DIN adapters generally don’t work on KVM switches. No fancy video card is needed.  Some allow switching audio as well, but you will be limited to 3.5 mm jacks from the onboard sound cards which may not be easily accessible in Jack.

If this will be the “master control for audio” it will need a good ALSA compatible sound card with as many output channels as you will have outputs and inputs.  The server should have at least a  USB removable drive or a Network Attached Storage device of the same size or bigger than the RAID drive for backups.  You may have trouble finding servers that are quiet enough for the average station.  If you will be running the servers in a server closet, I recommend recently pulled 2U to 4u servers with dual power supplies. They will, however, be much too noisy for an office or studio environment.  You probably can’t afford them new, but used are inexpensive, just make sure you get multiprocessor X64 machines with enough memory.  Check whether the drive interface is SCSI or eSATA.  Make sure you can get a SSD with the drive interface you choose.  Many servers come without drives.  Make sure you get the caddys with the server and you can get new drives at a reasonable price.  You probably don’t want to use the hardware raid, as the ZFS file system in Ubuntu 20.04  is much more flexible, provides RAID functionality as well as data compression and encryption.

Your “music” ethernet network should be built with good Cat6 cables – any that go through the ceilings or floors should be ‘plenum’ rated.  Use high quality gigabit switches.  You probably can do without managed switches unless you have a lot of workstations, and then we have to tune things that I haven’t had to do yet.  There are plenty of surplus managed gigabit switches available, but they make a lot of noise.

It is possible to set up a server standby system for Rivendell, where you have two identical servers for Rivendell and the audio store or the database are kept up to date on both.  This way a failure will not put you off the air until a new server can be configured.  Similarly, you should keep your workstations as close to identical as possible  so you can switch over quickly in the case of an equipment failure.  Fred Gleason of Paravel Systems is the guy to hire if you want to get this to play.

If you are doing hot standby  servers, it would make sense to have two independent UPS systems – one for each server, and a ups for each workstation.  (Or, if you have dual power supply servers, one for each power supply in the two servers) The idea is “no single point of failure”!  This is where the use of a real router (not bestbuy specials, but ubiquity or cisco) become important.

When you set up Ubuntu on these machines make sure you choose to add .mp3 codec and use ZFS file system with LZ4 compresson.  The account you use to setup will be the main “SUDOER” account.  Use a real password and require it to be entered.  It might make sense to encrypt the main account’s /home folder.

I have not been successful in running Rivendell reliably in a straight Ubuntu LTS environment.  Back “in the day” there were a number of Rivendell boxes working in Europe on Ubuntu 14.04 and 16.04, but Centos7 is so baked into Rivendell, it just makes sense to run it in a virtual box under Linux Kernel Virtualization  (KVM).  Too many of the libraries do not align between what Rivendell expects and what Ubuntu provides, particularly the QT version.  Centos7 is not a very good jack2 host – jack itself works well, but few of the jack utilities work or work reliably in the Centos7 Environment.  We can do all the fancy stuff in Ubuntu and the bread and butter automation in the business oriented Centos7 world.

The server might be called on to do more than switch audio, serve the databases, and stream.  You may want to run the station’s phone system using Freeswitch, or at least the phone interfaces to the studio.  It makes sense to put these into separate “boxes” using Linux Kernel Virtualization  (KVM) or the more sophisticated OpenStack. If you are thinking about using openstack, you will need at least one processor per “node” so an eight processor computer for the server makes sense, along with lots of memory, as each node has its “own” memory.