GrabDuck

KreaTV IP-STB Documentation

:

On this page the basic configuration required to get the KreaTV Starter Kit up and running is described. The KreaTV Starter Kit typically consists of:

  • One (or more) KreaTV IP-STB
  • The KreaTV Infocast Server software
  • A general-purpose STB boot image (the Evaluation boot image)
  • The Cactus boot image (Demonstration TV viewer)
  • Example portals and some sample pages written in SVG/HTML and Javascript
  • Some utilities, like the logclient tool
  • The Boot Image Building Kit (allows you to build a custom boot image from components)
  • Documentation

Installation

Download and install the Java Runtime Environment (JRE). You can find it here.

Be sure to change directory to the starter kit directory or else the following will not work.

Install the RPMS in the rpms/ folder, as root type: rpm -Uvh rpms/*.rpm.

This will install necessary rpms, for example:
  • rpms/kreatv-evaluation-bootimages-emea-3.8.3.16-01.i386.rpm
  • rpms/kreatv-infocastconfig-emea-1.0-01.i386.rpm
  • rpms/kreatv-infocastserver-3.0-01.i386.rpm
  • rpms/kreatv-logtools-1.18-01.i386.rpm
  • rpms/kreatv-utils-2.2-01.i386.rpm
The file rpms/unpack-rpm.sh can be used to extract the contents of an rpm package.

Upgrade instructions

To make an upgrade from an older version of the Starter-kit you may first need to remove the old installation.

To find out what you have installed on your system type: rpm -qa|grep kreatv. You will see a listing that looks something like this:

kreatv-evaluation-bootimages-emea-3.7.3.5-01
kreatv-infocastserver-3.0-01
kreatv-infocastconfig-emea-1.0-01
kreatv-logtools-1.2-01
kreatv-utils-2.2-01

As an example you can remove the package "kreatv-utils-2.2-01". Type as root:

rpm -e kreatv-utils-2.2-01

Note that some packages are dependent on others and then you have to remove them at the same time. To completely remove the Infocastserver, the config files and the bootimages as root type:

rpm -e kreatv-infocastserver-3.0-01 kreatv-evaluation-bootimages-emea-3.7.3.5-01 kreatv-infocastconfig-emea-1.0-01

Post installation check list

Here is a list of things you need to check after the Infocast Server has been installed for the first time:

  • The server PC needs an IP number (preferrably static IP)
  • The server needs a default gateway configured, even if there is no other network connected.
  • You need to setup static IP on the IP-STB, or use an existing DHCP server in the network.
  • You need to make sure multicast traffic from the server to the IP-STB is let through by the network.
  • Check that the Infocast service is installed properly, e.g. by starting the service (service infocastserverd start) and checking that it is actually running (service infocastserverd status).
  • If you plan to use the Infocast Server PC as portal (web) server, check that a HTTP server is installed.

Basic configuration

This is the configuration changes you need to do (from the default installation configuration) to get an IP-STB up and running:

  1. Install the KreaTV demo portal, or your own portal pages, on a web server (this can be the same PC as the Infocast Server).

    Note! The IP-STB can still run without a web based portal available, by using only the demo applications included in the Evaluation Kit boot image.

  2. Make sure the HTTP service is running and the pages can be reached, e.g. by using a standard web browser.
  3. Edit the file whitelisturls.xml to match the URL and path where the portal is. The IP-STB will display the first entry in this file upon startup. Check the link for further details.
  4. If the IP-STB need to use a HTTP proxy to reach the portal (or Internet), edit the file proxylist.xml to reflect this. Check the link for further details.
  5. Edit the file homepageurl.txt to match your desired www home page. The web application will start on this page when pressing the WWW button. If Internet connectivity is not available, it's recommended to set this blank (i.e. have an empty file).
  6. Edit the file channeltable.txt to match your multicast TV channels. This is used by the TV application included in the boot image. Check the link for further details.

IP-STB start up

When all the above steps are finished, do the following to start the IP-STB:

  1. Restart the Infocast service (service infocastserverd restart) to make it read the configuration changes you have made.
  2. Make sure it's running OK (service infocastserverd status)
  3. Connect the IP-STB, configure the correct IP (if using static IP) and TV output on the IP-STB.
  4. Watch the "dots" on screen, they will describe the different steps during the boot process. These are very useful for troubleshooting.
  5. Start using the IP-STB by pressing MENU key to see the different applications included in the evaluation kit boot image.