Active Network Transcoder

IPMN—Interactive Protocol for Mobile Networking

User Document

Raid Zaghal

Media Communications and Networking Research Laboratory

Department of Computer Science - Kent State University

Jan 2005

Introduction:

This document contains the information needed to create a simulated voice session between a mobile node (client) and a correspondent node (server). The client and the server can be any real Internet endpoints running over IPMN[1]. The client runs over (IPMN-client), and the server runs on (IPMN-server). First we show how to obtain and install IPMN (client and server), and then we will show how to obtain and install the voice application on both endpoints.

Part A. Installing IPMN-client

1- Install FreeBSD (release 4.5) on the client machines. To obtain and install this release go to http://www.freebsd.org. This site contains all information needed to obtain and install FreeBSD. For more information read the release notes and the installation guide from the site.

2- Login on your FreeBSD machine with root privileges and move to the root "/" directory.

3- Go to "http://www.medianet.kent.edu/ipmn/dist" to obtain the IPMN-client sub-kernel. Download two files: “ipmn_cli_v1.0_freebsd.tar.gz” and "unistd.h".

4- Use the gunzip command to extract the distribution's zip file. This should give the tar file “ipmn_cli_v1.0_freebsd.tar”.

5- Type “tar xvf ipmn_cli_v1.0_freebsd.tar” to untar the file. This will produce a directory called “cliBSD”. Inside this directory you will find six tar files: “cli_kern”, “cli_net.tar”, “cli_netinet”, “cli_netinet6”, “cli_netkey”, and “cli_sys”.

6- Type “tar xvf cli_kern.tar” to untar the first file, this will produce a directory “kern”. Repeat the same command to untar the other five tar files. Now you should have six directories: kern, net, netinet, netinet6, netkey, and sys.

7- Copy the contents of each directory to its kernel counterpart as follows:

"cp ./kern/* /usr/src/sys/kern/*".

"cp ./net/* /usr/src/sys/net/*".

"cp ./netinet/* /usr/src/sys/netinet/*".

"cp ./netinet6/* /usr/src/sys/netinet6/*".

"cp ./netkey/* /usr/src/sys/netkey/*".

"cp ./sys/* /usr/src/sys/sys/*".

8- Replace the “unistd.h” file with the version that you downloaded by running:

"cp ./unistd.h /usr/include/unistd.h"

9- Compile and install the updated FreeBSD kernel by running the following commands:

- cd /usr/src/sys/i386/conf

- cp GENERIC MYKERNEL

- cd /usr/src

- make buildkernel KERNCONF=MYKERNEL

- make installkernel KERNCONF=MYKERNEL

10- Reboot the machine.

Part B. Installing IPMN-server

1. Install FreeBSD (release 4.5) on the server machines.

2. Login on your FreeBSD machine with root privileges and move to the root "/" directory.

3. Go to "http://www.medianet.kent.edu/ipmn/dist" to obtain the IPMN-server sub-kernel. Download two files: “ipmn_srv_v1.0_freebsd.tar.gz” and "unistd.h".

4. Use the gunzip command to extract the distribution's zip file. This should give the tar file “ipmn_srv_v1.0_freebsd.tar”.

5. Type “tar xvf ipmn_srv_v1.0_freebsd.tar” to untar the file. This will produce a directory called “srvBSD”. Inside this directory you will find six tar files: “srv_kern”, “srv_net.tar”, “srv_netinet”, “srv_netinet6”, “srv_netkey”, and “srv_sys”.

6. Type “tar xvf srv_kern.tar” to untar the first file, this will produce a directory “kern”. Untar the other five tar files in the same way. Now you should have six directories: kern, net, netinet, netinet6, netkey, and sys.

7. Repeat steps 7 to 10 of part A.

Part C. Installing the Client Voice Application

[TBA]

Part D. Installing the Server Voice Application

[TBA]