Universal Media Server, Headless, on CentOS 7

Sun 30 November 2014

The following was originally posted on my personal blog, mikeshoup.com. There may be some formatting issues. Please post in the comments if anything looks funky.

Universal Media Server originally started as a fork of PS3 Media Server. It is a great DLNA server for Linux. It has a large device support among other features. In our home, it is used to stream from our media server in the basement to the PS3 in the living room.

The following steps will get it installed in a headless fashion on CentOS 7. They should also be easily adapted for any recent versions of Fedora. The biggest difference from this guide and others I’ve seen is I provide a service file for systemd.

Install Prerequisites

  1. Install EPEL's and Nux's repositories. Visit each project's website for the latest release, but the following should work::

    $ sudo yum install http://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-2.noarch.rpm
    $ sudo yum install http://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-1.el7.nux.noarch.rpm
    
  2. Install programs needed for transcoding::

    $ sudo yum install mplayer mencoder ffmpeg mediainfo
    
  3. Install Java. You have two choices here. Install the appropriate openjdk package, or get the latest RPM from Oracle's website. I've found Oracle's java release works best with UMS.

Install the files for UMS

  1. Download a tarball of the latest version from UMS' website to your home directory.

  2. Extract the tarball, and move it to /opt. Create a symlink from /opt/ums-#.#.# to /opt/ums. This allows you to add new versions and just replace the symlink, preserving the old installs if you want.:

    $ tar zxf UMS-4.2.2-Java7.tgz
    $ sudo mv ums-4.2.2 /opt
    $ sudo ln -s /opt/ums-4.2.2 /opt/ums
    
  3. Copy the config files to /etc/ums. This makes more sense than keeping them with the UMS files.:

    $ sudo mkdir /etc/ums
    $ sudo cp UMS.conf WEB.conf /etc/ums
    
  4. Create a user, ums, to run the UMS application under. This user will need permissions to read the media files, as well as write permissions to the folder for the config files and the application files. Don’t set a password, use /opt/ums for the home directory, and use /sbin/nologin for the shell.:

    $ sudo useradd -d /opt/ums -s /sbin/nologin ums
    $ sudo chown -R ums:ums /opt/ums-4.2.2
    $ sudo chown -R ums:ums /etc/ums
    
  5. Now, open up /etc/ums/UMS.conf in your text editor. Go through and adjust the parameters as necessary for your setup.

SystemD Configuration

SystemD is the init system in CentOS 7 and the more recent versions of Fedora. It will be utilized to start UMS on startup, as well as provide easy logging of events.

  1. Create the file /etc/systemd/system/ums.service. This gives systemd information about how to start UMS. It should have the following contents:

    [Unit]
    Description=Universal Media Server
    
    [Service]
    Type=simple
    Environment="UMS_PROFILE=/etc/ums/UMS.conf"
    User=ums
    Group=ums
    ExecStart=/opt/ums/UMS.sh
    
    [Install]
    WantedBy=multi-user.target
    
  2. Next, instruct systemctl reload its configuration, then enable, and start the service::

    $ sudo systemctl daemon-reload
    $ sudo systemctl enable ums
    $ sudo systemctl start ums
    
  3. Provided everything started fine, there should be no output from systemctl after starting it. You can utilize systemctl to verify everything started correctly:

    $ sudo systemctl status ums
    ums.service - Universal Media Server
       Loaded: loaded (/etc/systemd/system/ums.service; enabled)
       Active: active (running) since Sun 2014-11-30 19:12:20 MST; 32min ago
     Main PID: 12912 (java)
       CGroup: /system.slice/ums.service
               └─12912 java -Xmx768M -Xss2048k -Dfile.encoding=UTF-8 -Djava.net.p...
    
  4. Systemd captures all the output from UMS and stores it in its journal. You can access all that information with journalctl. This is extremely useful if there are problems. To view all messages from UMS, you could use the command: sudo journalctl _SYSTEMD_UNIT=ums.service

Open the firewall

Unless you've already mucked with the defaults, the CentOS firewall should be up and running, and likely only allowing port 22/tcp in. You will need to open some holes in the firewall.

Let's first look at the ports that UMS uses::

$ sudo netstat -pln | grep java
tcp        0      0 0.0.0.0:9001            0.0.0.0:*               LISTEN      12912/java
tcp        0      0 10.0.0.204:5001         0.0.0.0:*               LISTEN      12912/java
udp        0      0 0.0.0.0:1900            0.0.0.0:*                           12912/java

Unless you've changed anything, by default, those are 5001/tcp, 9001/tcp and 1900/udp. Port 9001/tcp is optional. Enable it if you want to browse your media via a web browser. Let’s utilize the firewall-cmd utility to poke the holes:

  1. Determine the active zone for your network interface. In the command below, the zone in use is internal. Yours will likely be the default, which is public. Notate it, and use it for the next commands:

    $ sudo firewall-cmd --get-active-zones
    internal
       interfaces: eth0
    
  2. Open the ports on the zone, and reload the firewall:

    $ sudo firewall-cmd --add-port=5001/tcp --zone=<zone> --permanent
    success
    $ sudo firewall-cmd --add-port=9001/tcp --zone=<zone> --permanent
    success
    $ sudo firewall-cmd --add-port=1900/udp --zone=<zone> --permanent
    success
    $ sudo firewall-cmd --reload
    success
    
  3. Verify the ports are open:

    $ sudo firewall-cmd --list-ports --zone=<zone>
    5001/tcp 9001/tcp 1900/udp
    

Congrats! You're done! Launch your DLNA client (or PS3 as it were) and make sure things are working. Utilize journalctl to gather diagnostic information if things aren't working right.

Update: I’ve made some changes in the systemctl setup and noted that port 9001 is optional. These were at the advice of Vallimar on the UMS forums. Thanks!