Headphones on SmartOS

.README.md

Headphones on SmartOS

Introduction

Documentation on installing and setting up Headphones on a SmartOS base64 14.3.0 zone. These instructions assume a fresh zone creation of image 62f148f8-6e84-11e4-82c5-efca60348b9f.

Prerequisites

Make sure to copy the following line by line and confirm that each runs successfully. All of the following are run from the root shell.

pkgin -fy up
pkgin -y fug
pkgin -y in py27-sqlite3 py27-pytz git
groupadd -g 500 head
useradd -m -c "Headphones User" -u 500 -g head head
passwd -N head
sed -i 's/^TZ=.*$/TZ=America\/Los_Angeles/' /etc/default/init

Installation

sudo su - head
cd
export TZ=America/Los_Angeles
echo "export TZ=America/Los_Angeles" >> .profile
git clone https://github.com/rembo10/headphones.git headphones
cd headphones
python Headphones.py -v

At this point Headphones should be running in the foreground. Following are instructions for getting the SMF service up and running. Test the server by seeing if the web interface is accessible using the information below. Then press CTRL+c to exit the process and CTRL+d to exit the su sub-shell.

Install SMF Service

Perform the following from the root account to turn headphones into a managed service.

curl -sk https://gist.githubusercontent.com/baetheus/734e60bfe7e0657cef07/raw/headphones.xml > $HOME/headphones.xml
svccfg import $HOME/headphones.xml
svcadm enable headphones

Accessibility

The service should now be available at http://<hostname/ip>:8181

Configuration is located at /home/head/headphones/config.ini.

Commentary

Since I run each of my services on their own zone with a static ip and dns configuration, I like to change the port binding to 80 on my internal home network. Thus, the net_privaddr privilege has been added to the service to allow binding to privileged ports. Additionally, if you're like me and are running your media server on smartos or another illumos derivative, you might want to look into using lofs to map your media filesystem to multiple zones. This is the reason for manually picking uid and gid for the head user and group. Feel free to contact me if you have questions on this process. Or hit up #smartos on the Freenode irc network.

Changelog

20150407

• Updated links to point to baetheus user instead of slashtact.

20150208

• Initial Gist
• Added SMF file

headphones.xml

<?xml version='1.0'?>
<!DOCTYPE service_bundle SYSTEM '/usr/share/lib/xml/dtd/service_bundle.dtd.1'>
<service_bundle type='manifest' name='export'>
  <service name='site/headphones' type='service' version='0'>
    <create_default_instance enabled='true'/>
    <single_instance/>
    <dependency name='network' grouping='require_all' restart_on='error' type='service'>
      <service_fmri value='svc:/milestone/network:default'/>
    </dependency>
    <dependency name='filesystem' grouping='require_all' restart_on='error' type='service'>
      <service_fmri value='svc:/system/filesystem/local'/>
    </dependency>
    <exec_method name='start' type='method' exec='/opt/local/bin/python /home/head/headphones/Headphones.py --nolaunch --daemon' timeout_seconds='60'>
      <method_context>
        <method_credential user='head' group='head' privileges='basic,net_privaddr'/>
        <method_environment>
          <envvar name='PATH' value='/usr/local/sbin:/usr/local/bin:/opt/local/sbin:/opt/local/bin:/usr/sbin:/usr/bin:/sbin'/>
          <envvar name='HOME' value='/home/head'/>
        </method_environment>
      </method_context>
    </exec_method>
    <exec_method name='stop' type='method' exec=':kill' timeout_seconds='60'/>
    <property_group name='startd' type='framework'>
      <propval name='duration' type='astring' value='contract'/>
      <propval name='ignore_error' type='astring' value='core,signal'/>
    </property_group>
    <stability value='Evolving'/>
    <template>
      <common_name>
        <loctext xml:lang='C'>Headphones</loctext>
      </common_name>
    </template>
  </service>
</service_bundle>