Installation and Testing of NMM (Linux)

Motama GmbH, Saarbruecken, Germany

http://www.motama.com

April 2007

  Copyright (C) 2007,
  Motama GmbH, Saarbruecken, Germany
  http://www.motama.com
 
  Permission is granted to copy, distribute and/or modify this
  document under the terms of the GNU Free Documentation License,
  Version 1.2 or any later version published by the Free Software
  Foundation; with the Invariant Sections being all sections, no
  Front-Cover Texts, and no Back-Cover Texts. A copy of the license
  can be found in the file COPYING.FDL.

  THE DOCUMENT IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE
  DISTRIBUTING THE DOCUMENT BE LIABLE FOR ANY DAMAGES OR OTHER
  LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
  OF OR IN CONNECTION WITH THE DOCUMENT OR THE USE OR OTHER DEALINGS
  IN THE DOCUMENT.

This document gives an introduction on how to install and test the Open Source version of NMM for Linux.

In this document, we assume that NMM package is called nmm-1.0.0.tar.gz and will be extracted to directory /home/bob/nmm-1.0.0 . Please replace these names as appropriate, e.g. with the name of the NMM package that you are actually using.


Table of Contents
1. Requirements
1.1. Hardware Requirements
1.2. Network Configuration
2. Installation of NMM
2.1. Download NMM
2.2. Extract
2.3. Configure
2.4. External Libraries
2.4.1. Option 1: Using precompiled libraries (recommended)
2.4.2. Option 2: Compiling Libraries from Sources
2.4.3. Option 3: Installing Developer Packages
2.5. LD_LIBRARY_PATH
2.6. Configure, Again
2.7. Build
2.8. Install
3. Testing NMM
3.1. Environment Variables
3.2. NMM Registry
3.3. Test Audio/Video Rendering
3.4. Security

1. Requirements

1.1. Hardware Requirements

You need a properly configured operating system, e.g. a Linux on a PC or some other platform. On Linux, most NMM examples and applications require a graphics board with configured Xv extension (refer to the output of xvinfo) and a sound board or chip that can natively playback different sampling rates such as 44.1 kHz. All other hardware, such as cameras, is optional.

1.2. Network Configuration

To allow one running NMM system to access another running NMM system, the port 22801 and the port range 5000-6000 must not be blocked by a firewall.

Furthermore, access to distributed systems is restricted to systems in your LAN or to systems that are defined as alias, e.g. within /etc/hosts . If for example, your are using a system called host1.domain.com , you have to specify host1 in addition to host1.domain.com in /etc/hosts when using or configuring distributed NMM applications. Numeric IP addresses are currently not supported. In addition, hostnames of systems should also be set according to this rule. For example, use host1 instead of some other name.

In addition to this, all hostnames must be written in lower case letters if they are assigned to an NMM application (e.g. as command line argument or within a clic graph description) even if the corresponding hosts include capital letters within their hostname.

Please note that /etc/hosts must also include the hostname and IP address of your system if no DNS server is available. Furthermore, some Linux distributions include the line 127.0.0.2 host1.domain.com host1 into /etc/hosts . In this case you must replace the numeric IP address 127.0.0.2 with the real IP address of your system.