MRT Installation Guide

Version 2.0.0 Alpha

(Draft 11/5/99)

Table of Contents
1. Introduction.....................................................................................................................4 Document Conventions ...................................................................................................4 Related MRT Manuals.....................................................................................................4 Getting Help....................................................................................................................4 2. Obtaining MRT ...............................................................................................................5 Binary Distribution..........................................................................................................5 Building From Source Code ............................................................................................5

Copyright (c) 1997, 1998

The Regents of the University of Michigan ("The Regents") and Merit Network, Inc. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. All advertising materials mentioning features or use of this software must display the following acknowledgement: This product includes software developed by the University of Michigan, Merit Network, Inc., and their contributors. 4. Neither the name of the University, Merit Network, nor the names of their contributors may be used to endorse or promote products derived from this software without specific prior written permission.

2.

3.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

1. Introduction
This chapter introduces the MRT Installation Guide and explains how to obtain further information about MRT.

Document Conventions
The following document conventions are used in the Installation Guide: Commands and keywords are in boldface. User-supplied variables are enclosed in <angle brackets>. Optional elements are shown in [square brackets]. Alternative but required keywords are grouped in {braces} and separated by a vertical bar.

Related MRT Manuals

The following documentation is also available for MRT users (see http://www.merit.edu/mrt/mrt_doc/): User/Configuration Guide Programmer's Manual Tutorial (in preparation)

The MRT web site will also have the most up-to-date documentation and code.

Getting Help
For more information about MRT, send mail to mrt-support@merit.edu. The MRT development team is available to answer questions and provide configuration advice. We are also very interested in bug reports, feature requests, and general feedback. A mailing list, mrt-discuss-request@merit.edu is also available for MRT users to share advice and experiences with the toolkit.

4 Introduction

2. Obtaining MRT
The latest public release of the MRT toolkit is available at: ftp://ftp.merit.edu/net-research/mrt The complete MRT distribution includes a routing daemon, tools, and libraries developed as part of the MRT project, as well as backend Internet performance measurement/statistics tools developed as part of the IPMA project. You can either obtain the MRT binaries, or build the code from source. The file mrt[version].tar.gz includes the source code, while mrt-[version]-[platform].tar.gz includes binaries of routing tools, excluding various IPMA tools. See Chapter 3 for information about building the code from source.

Binary Distribution
The current MRT ftp directory contains the following binaries:
mrt.tar.gz mrt-1.4.9a-linux2.1.63.tar.gz mrt-1.4.9a-freebsd2.2.2.tar.gz mrt-1.4.9a-src.tar.gz mrt-1.4.9.a-sunos5.5.1.tar.gz

Although the binaries are compiled with IPv6 extensions, most of them will run on IPv4-only platforms. Examples of configuration files are found in each tool directory under programs, or in the conf directory in the binary distribution.

Building From Source Code

System Requirements GCC is recommended but other commercial compilers will also work. MRT runs with native POSIX threads (pthreads) on Solaris 2.5 or later. MRT does not work correctly with the MIT Pthreads library. MRT is designed to run under threads-capable operating systems, but the code will run on uni-processor systems lacking thread and shared memory support. Without threads, however, the software's performance will be significantly degraded (but may be sufficient for some situations). Because the IPv6 kernel implementations and API specifications are still in flux, MRT may not run on the latest IPv6 platforms. For updated information, see the MRT home page (http://www.merit.edu/~mrt). On systems running Linux IPv6, MRT may require the inet6 library, and the code will not compile with glibc-2.x. We have compiled and tested MRT on the following systems/environments: Solaris 2.5.1, 2.6 Linux 2.0.x, 2.1.x

5 Building and Installation Procedure

FreeBSD 2.2.x NetBSD 1.x SunOS 4.1.x

MRT provides IPv6 support for: Solaris IPv6 Release 5.3 (Solaris 2.5.1) Linux IPv6 (2.1.x) INRIA IPv6, FreeBSD, NetBSD KAME IPv6

Other users have reported that MRT runs on: IRIX (version?)

The current MRT development platforms are a four-processor SPARCstation 20 running Solaris IPv6 Release 5 on Solaris 2.5.1 with POSIX threads support, and Intel Pentium Pro systems running other IPv6 implementations. Building and Installation Procedure 1. Obtain the source archive and then unzip and untar it. There should be a directory named mrt-<version>.
% cd /tmp % ftp ftp.merit.edu ftp> cd /net-research/mrt ftp> get mrt-<release>-src.tar.gz ftp> quit % cd /usr/local/src % gzip -cd < /tmp/mrt-<release>-src.tar.gz | tar xvf

2. Change (cd) into that directory and run the shell script make-sym-links. This will create a new directory named src.[platform]. Change into this new directory and run ./configure. The make-sym-links script allows the same source directory to build MRT on multiple platforms.
% % % % cd /usr/local/src/mrt-<version> sh make-sym-links cd src.<platform> ./configure

Several options can be specified as parameters to the configure command:

% ./configure --disable-ipv6 % ./configure --disable-thread % ./configure --disable-wall

3. Now run make. After successful compilation, you will have binaries in each of the source directories and src/obj/[platform]/[lib/bin/]. If you don't need all of the MRT tools, delete
6 Building and Installation Procedure

those you don't need under the directory programs before running configure. If you will not be compiling the code on another platform at a later time, you can change the directory to src and run ./configure without running make-sym-links.
% make 4. Run make install. By default, binaries and libraries will be installed in /usr/local/[/lib|/bin].

See the man page for configure if you want to change the default install directory.
% su # make install

5. Many of the tools distributed with MRT have a telnet user interface. You can optionally specify the port on which the tools listen for telnet connections by adding the following lines to /etc/services. Feel free to choose your own port numbers.
mrtd bgpsim 5674/tcp # MRT Routing Daemon 5675/tcp # MRT Routing Simulator

7 Building and Installation Procedure