Plex on SmartOS

Sat 04 April 2015 by Mike Zeller

Running Plex securely on top of ZFS through the magic of lx branded zones and SmartOS.

Plex logo

  The nice folks at Plex recently released a version of Plex Media Server for SmartOS and other illumos variants. Actually, half of that statement is a lie. While the folks over at Plex are nice, they didn't actually release a version of Plex for the illumos family. Some of you may be thinking whats the point of this blog post? Well I am here to tell you that Plex does indeed run on top of SmartOS. "How?", you may ask. The answer to that is lx branded zones.

  Normally when you provision a zone on SmartOS you specify "brand": "joyent" or "brand": "kvm" in your create payload. What this really tells vmadm(1M), is to create a zone using the joyent|kvm brand. Brands are described by brand(5) as "alternate operating environments for non-global zones". The man page goes on to further explain what this means by stating "In addition, a zone's brand is used to properly identify the correct application type at application launch time." Long story short, the brand is used to setup the zone with a particular environment in mind. Currently in smartos this value may be one of 'joyent', 'joyent-minimal', 'lx', or 'sngl' for OS virtualization and 'kvm' for full hardware virtualization.

  For the purpose of this post we are going to concentrate on the 'lx' brand. An lx branded zone is a zone that provides a container in which the user is presented with a linux environment. The lx brand allows you to run Linux binary applications unmodified without sacraficing the IO performance you generally lose inside of hardware virtualization. It's important to note that the linux kernel itself is missing in this environment. This means you get all the benefits of the SmartOS kernel along with key technologies such as ZFS, DTrace, mdb, and crossbow coupled with your linux binaries. Joyent has spent a lot of time reviving the lx brand work from the old Sun Mircosystems days and bringing it into the modern era with support for things like 64bit, epoll, and inotify. You can find out much more about the lineage of the technology from Bryan Cantrill's talk here.

  Enough background information, lets move on to the fun stuff, aka setting up Plex on SmartOS. For the purpose of this post I will assume you have SmartOS running already or you know how to use it already. The first thing you need to do is make sure that you are on a relatively new platform, the newer the better because new fixes are going into the lx brand work all the time. Secondly you want to import an lx image of your choice. For my purposes I generally prefer ubuntu or debian so thats what I will demonstrate here.

imgadm sources -a https://updates.joyent.com
imgadm import 818cc79e-ceb3-11e4-99ee-7bc8c674e754 # lx-ubuntu-14.04 20150320
imgadm import 116deb8c-cf03-11e4-9b2d-7b1066800a6a # lx-debian-7 20150320

  Next you will need to create a file named plex.json with the following contents.

  Lets discuss quickly the filesystems section of the json file. Basically what this is telling smartos to do is mount in from the zpool named tank some ZFS filesystems and under what path they should be mounted locally to the zone. Since we are in an OS container rather than a hardware virtualized VM our zone will have direct access to the ZFS datasets. In the json file we could also pass in some mounting options such as 'ro' if we wanted to lock down what the zone could do. It's also entirely possible to give the zone delegated access over those filesystems allowing the zone to set properties such as compression or take snapshots. So, you will want to modify the filesystems section to point to any ZFS filesystems you might already have with media in them. You will also want to modify the nics section of the json file to match your networking needs. For example, my Plex zone at home is given a nic on a dmz network.

  Our next step is to actually create the zone.

vmadm validate create -f plex.json
vmadm create -f plex.json
    ....let the zone provision
vmadm list | grep plex

  Now that we have our uuid for the zone we can go ahead and login at this point to poke around and install Plex.

    [smartos ~]# vmadm list | grep plex
    51d28bb3-7b5c-cefe-d7b9-b9683085856e  LX    4096     running           plex
    [smartos ~]# zlogin 51d28bb3-7b5c-cefe-d7b9-b9683085856e
    [Connected to zone '51d28bb3-7b5c-cefe-d7b9-b9683085856e' pts/4]
    Last login: Sat Apr  4 22:17:36 UTC 2015 from zone:global on pts/14
    Welcome to Ubuntu 14.04.2 LTS (GNU/Linux 3.13.0 x86_64)

     * Documentation:  https://help.ubuntu.com/
         __        .                   .
     _|  |_      | .-. .  . .-. :--. |-
    |_    _|     ;|   ||  |(.-' |  | |
        |__|   `--'  `-' `;-| `-' '  ' `-'
                                         /  ;  Instance (Ubuntu 14.04 LX Brand 20150320)
                                         `-'   https://docs.joyent.com/images

    root@plexlx:~#
    root@plexlx:~# uname -a
    Linux plexlx 3.13.0 BrandZ virtual linux x86_64 x86_64 x86_64 GNU/Linux
    root@plexlx:~# cat /etc/issue
    Ubuntu 14.04.2 LTS \n \l
    root@plexlx:~# ls /
    bin   dev  home  lib64  mnt     Music   opt   root  sbin  sys     tmp  usr
    boot  etc  lib   media  Movies  native  proc  run   srv   system  TV   var

  Awesome! We now have a zone running Ubuntu 14.04 with three ZFS filesystems mounted inside of it. Next we have to install the plex media server package.

  Finally all you have to do is setup the server. The way that I usually do this is through a ssh tunnel. Which looks something like ssh -L 8000:localhost:34200 root@192.168.128.25. From here you can point your browser to http://localhost:8000/web. At this point if you do not have a plex account you will need to make one. Then all thats left to do is add the media through the webui and start enjoying some of your content.

Bonus

  Above I mentioned that lx branded zones allowed you to use great tools like DTrace to debug linux applications. Without taking too much of a deep dive into DTrace or plex internals I thought I would just show some basics. The lx branded zones have a special path mounted into their filesystem called /native this is where all the native smartos stuff lives. Running different binaries and tools out of this path is not recommended. However some tools such as dtrace, prstat, pfiles, and pargs are known to work very well. A convenient way to access this is by sticking the tools at the end of your $PATH, export PATH=$PATH:/native/usr/bin:/native/usr/sbin:/native/sbin.

Stability

  Plex has been relatively stable for me on recent releases of SmartOS. I have had one core file generated since standing up my zone. Other than that one crash plex has been stable for me with multiple people streaming content at once. Thats not to say that early on we didnt have issues. There has been some key commits to making Plex stable on SmartOS such as this recent fix on github. The final gotcha seems to be that DLNA support is not working.

Closing Thoughts

   If you are interested in any of the lx work Joyent is doing you can continue to monitor the github page. Its worth mentioning that Joyent started doing this lx brand work in order to make Docker a reality on top of SDC as well as the supported offering called Triton in the Joyent Public Cloud. Expect more blog entries from me in the near future on using Docker with lx branded zones and Triton.

  Finally I want to say thank you to the supportive Plex developers on irc. If there is interest in a native build of Plex for the illumos family(SmartOS, OmniOS, OpenIndiana etc) please voice your opinion here or on twitter. It would be great to have a native build, but until then live the dream and run Plex on lx branded zones!


Sanity Checking with the pid Provider

Mon 28 January 2013 by Mike Zeller

I am not crazy right?

It has been a while since I posted an entry, so I thought I would type up a short post on some fun with the DTrace pid Provider. I was recently working with stud on SmartOS and I wanted to send the logs off to ...

read more

Splunk Performance on SmartOS

Thu 19 July 2012 by Mike Zeller

Debugging splunk performance issues in a live environment.

Since joining Voxer to do performance engineering, I have also become the owner of our splunk instances. We rely on splunk heavily to monitor our infrastructure just as most companies do. It is an important tool especially while doing a code push ...

read more

Compiling and Installing Weechat on SmartOS

Sun 15 July 2012 by Mike Zeller

Weechat on SmartOS (Illumos)

irc handle: papertigers
server: freenode
channels: #illumos #smartos #dtrace #iphonedev #ritlug #plex

weechat running in a smartos zone

EDIT

Weechat can be compiled on recent builds of smartos with recent versions of pkgsrc simply by following the instructions on github.


Recently I have been trying to convert all of my servers to ...

read more

Welcome (Back)

Sat 14 July 2012 by Mike Zeller

Welcome

Lights and Shapes is finally back online.
Rather than using Wordpress again I am using pelican to generate static html.
This blog is going to focus mostly on DTrace, Illumos, SmartOS, and other unix-y things.

Next thing to do with the site is to give it a visual overhaul.

read more