Single Content Streamer setup and usage

(eth1 as primary interface)

Product: SnapTV content server
Software Version: 2.22.0
Date: 2016-09-28

Usage

In a single server environment, the SnapTV content server is prepared for watching movies via the "easy" interface in a browser or a wireless device. This is provided via a LAN which can include wireless access points. The eth1 port of the server is is connected to the LAN. Internet access should be provided via the LAN.

STBs should be connected to a separate network which doesn't include any wireless access points. The eth0 port of the server is used for this purpose.

Network setup

The server is shipped with a setup like this

~$ cat /etc/network/interfaces 
auto lo
iface lo inet loopback

auto eth0
iface eth0 inet static
    address 10.0.0.5
    netmask 255.255.255.0
    up ip route add 224.0.0.0/4 dev eth0

auto eth1
iface eth1 inet static
    address 192.168.1.20
    netmask 255.255.255.0
    gateway 192.168.1.1
    dns-nameservers 192.168.1.1

Both networks are set up with static addresses. Before connecting eth1 to LAN, the static IP address must possibly be changed to fit with the addresses ranges used within this LAN. This must be done by logging in via keyboard and screen directly to the server. See System Administration Guide in the Manuals section for factory credentials.

After the correct setup is done by editing /etc/network/interfaces, the eth1 port can be restarted with

sudo ifdown eth1; sudo ifup eth1

Then the eth1 port can be connected to the LAN and you should have access to the server via a browser.

http://<IP>       - easy  interface
http://<IP>/admin - admin interface

Configuration remap

The configuration have to be remapped to the new eth1 address. Access the server via the web interface and open the admin menu

System configuration -> Network -> Configuration remap

Observe the old IP and remap to the new static eth1 IP.

Now, the server should be set up correctly for operation in your LAN environment.

Other configurations in a single server environment

These settings deviates slightly from the standard setup used in a clustered environment1.

The eth1 interface must be set up to be primary interface2

~$ cat /opt/snaptv/etc/snaptv-base/hostconfig.xml
<?xml version="1.0"?>
<hostconfig>
  <net>
    <interface name="eth0"/>
    <interface name="eth1" primary="true"/>
  </net>
</hostconfig>

In the config-file /etc/init/snaptv-infoservice.conf, an override option must be added in the line

exec snap-infoservice

The option is

--override-primary-iface <IP of eth0>

That is, the same IP that is set up for eth0 in /etc/network/interfaces, for example 10.0.0.53.

  1. With a clustered environment we mean a system which consists of several SnapTV servers which are clustered through the mechanism found in the admin menu System Configuration -> Cluster and connected via the eth0 ethernet ports ↩

  2. In a clustered environment, eth0 have to be the primary interface. Please also note that the configuration should be remapped to the IP address of the primary interface. ↩

  3. The option isn't needed if eth0 is the primary interface which is the case in a clustered environment ↩