Page History

...

The benefit of running NPT over a standard install is as follows:

no need to recompile kernels for web100 each time
no need for taylor as updates are maintained by Internet2 (although time will tell if the security updates are sufficiently regular)
relocation of performance host trivial - pop cd into new machine and plug in the USB key - settings should be maintained
- SLAC's reverse traceroute server run's on default on port 3765 (perhaps we should redirect to this host).

Disadvantages

no AFS client (yet?)
security strongly depends on release cycle of boot disk

Overview

This guide will look at

setting up a nptoolkit host
configuring services to suit SLAC, this specifically includes
- syslog logging to a remote host
- setting up the NPT server
- Configuring ntp for SLAC's stratum servers
- setting up bwctl servers
- setting up owamp servers

It will also look at changing the NDT and rev-tracerouter servers to use apache2 instead of their own daemon http listeners.

Children Display

Boot

The Knoppix disk is a live cd. Hard-drive will be used to keep the data thus no particular need for a USB key. However the procedure is mentioned below.

Things have changed slightly since the arrival of pS Performance Toolkit 3.1. After booting disk was downloaded (the page says version 1.7, but the boot cd says 1.8). It was booted in VMWare. It run's linux 2.6.20.10 with web100 hooks.After booting, you can log on with same user name and password i.e. 'knoppix' - no password is required..

USB key usage

Upon inserting a USB key into the connector, you get:

...

Code Block

knoppix@0[~]$ sudo customize.NPtools 
Internet2 Network Performance Tool Customization script
    Tools listed in RED need to be customized
        1. Setup Drive(s) to hold customization files
        2. bwctl
        3. ndt
        4. npad
        5. ntp
        6. owamp
        7. staticIP
        0. exit
4
NPAD server configuration program.  

/usr/local/npad-1.3 /ramdisk/home/knoppix

Importing existing config.xml.

---------------------------------------------------------------
| For each configuration value, you will see brief help       |
| followed by a prompt. Default values are in brackets on     |
| the prompt line.  To accept default values, press Enter.    |
---------------------------------------------------------------



The directory to install the diagnostic server,
including binaries, libraries, and configuration files.
It is recommended to use the default value.

Exec dir [/usr/local/npad-dist]: 


The directory to install web pieces, such as the tester
page and the Java and C clients.  If you are running the
built-in web server (recommended), the default value
should work.  Otherwise you will need to point to a
directory accessible by your web server.

Web dir [/usr/local/npad-dist/www]: 


The user as which the server will run.  We recommend using
a relatively unprivileged user.  If you specify a user
that doesn't exist, 'make install' will create it.

User [npad]: 


The group as which the server will run. We recommend using
a relatively unprivileged group.  If you specify a group
that doesn't exist, 'make install' will create it.

Group [npad]: 


The port that the control channel listens on.  It should be
safe to leave this alone unless you must work within
firewall restrictions, or unless another service is
using this port.

Control port [8100]: 


The bottom of the ephemeral port range used for test
connections.

Port range min [8002]: 


The top of the ephemeral port range used for test
connections.

Port range max [8020]: 


This package comes with a small python-based web server.
If you would like to use the server, enter "yes".
Otherwise you will need to have installed and set
up another web server such as Apache.

Use built-in web server [yes]: 


The port number used by the built-in web server

Built-in web server port [8200]: 


This name should should complete "NPAD server located at ...", and
will be used as the title for your server, as it appears on the
tester page.  You must supply a value.

Site (organization) name [Internet2 Knoppix-based NPAD Server]: Stanford Linear Accelerator Center NPAD Server


The geographical location of your server, probably a city name.
Since pathdiag works best over short distances, this information
will be included on the tester page so users can tell how close
they are to the server.  You must supply a value.

Site location [Please customize]: Menlo Park - CA


The (optional) name of the contact for your site.
This is probably you or the network support team.

Site contact name [RACarlson]: Yee-Ting Li


This is the (optional) email address for your site contact.

Site contact email [rcarlson@internet2.edu]: ytl@slac.stanford.edu

Configuration complete.  You're now ready to 'make'.

make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/pathdiag'

Group npad already exists.  Will not create.

User npad already exists.  Will not create.

Installing...

rm -f /usr/local/npad-dist/config.xml /usr/local/npad-dist/template_diag_form.html
cp config.xml template_diag_form.html /usr/local/npad-dist/
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3'
make[2]: Entering directory `/UNIONFS/usr/local/npad-1.3/diag_server'
cp *.py /usr/local/npad-dist
cp DiagClient.jar diag-client.c /usr/local/npad-dist/www
make[2]: Leaving directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[2]: Entering directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
cp pathdiag.py* pathtools.py* prettyhtml.py* pathlib.py* _pathlib.so mkdatasummary.py *.fmt /usr/local/npad-dist
cp boxes.css help.html /usr/local/npad-dist/www/ServerData

Regenerating report summary...  Done.

make[2]: Leaving directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3'
chown -R npad.npad "/usr/local/npad-dist/www/ServerData"
/ramdisk/home/knoppix
/usr/local/npad-dist/www /ramdisk/home/knoppix
NPAD customization files are being saved to 'sdb1'
/ramdisk/home/knoppix

...

 must supply a value.

Site (organization) name [Internet2 Knoppix-based NPAD Server]: Stanford Linear Accelerator Center NPAD Server


The geographical location of your server, probably a city name.
Since pathdiag works best over short distances, this information
will be included on the tester page so users can tell how close
they are to the server.  You must supply a value.

Site location [Please customize]: Menlo Park - CA


The (optional) name of the contact for your site.
This is probably you or the network support team.

Site contact name [RACarlson]: Yee-Ting Li


This is the (optional) email address for your site contact.

Site contact email [rcarlson@internet2.edu]: ytl@slac.stanford.edu

Configuration complete.  You're now ready to 'make'.

make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Nothing to be done for `all'.
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3/pathdiag'

Group npad already exists.  Will not create.

User npad already exists.  Will not create.

Installing...

rm -f /usr/local/npad-dist/config.xml /usr/local/npad-dist/template_diag_form.html
cp config.xml template_diag_form.html /usr/local/npad-dist/
make[1]: Entering directory `/UNIONFS/usr/local/npad-1.3'
make[2]: Entering directory `/UNIONFS/usr/local/npad-1.3/diag_server'
cp *.py /usr/local/npad-dist
cp DiagClient.jar diag-client.c /usr/local/npad-dist/www
make[2]: Leaving directory `/UNIONFS/usr/local/npad-1.3/diag_server'
make[2]: Entering directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
cp pathdiag.py* pathtools.py* prettyhtml.py* pathlib.py* _pathlib.so mkdatasummary.py *.fmt /usr/local/npad-dist
cp boxes.css help.html /usr/local/npad-dist/www/ServerData

Regenerating report summary...  Done.

make[2]: Leaving directory `/UNIONFS/usr/local/npad-1.3/pathdiag'
make[1]: Leaving directory `/UNIONFS/usr/local/npad-1.3'
chown -R npad.npad "/usr/local/npad-dist/www/ServerData"
/ramdisk/home/knoppix
/usr/local/npad-dist/www /ramdisk/home/knoppix
NPAD customization files are being saved to 'sdb1'
/ramdisk/home/knoppix

NTP

Code Block


knoppix@0[~]$ sudo customize.NPtools 
Internet2 Network Performance Tool Customization script
    Tools listed in RED need to be customized
        1. Setup Drive(s) to hold customization files
        2. bwctl
        3. ndt
        4. npad
        5. ntp
        6. owamp
        7. staticIP
        0. exit
5
NTP server configuration program.  

Manual configuration is currently required.  Please edit the
/etc/ntpd.conf file to create custom versinos.
create custom version for your site.

owamp

Code Block


knoppix@0[~]$ sudo customize.NPtools 
Internet2 Network Performance Tool Customization script
    Tools listed in RED need to be customized
        1. Setup Drive(s) to hold customization files
        2. bwctl
        3. ndt
        4. npad
        5. ntp
        6. owamp
        7. staticIP
        0. exit
6
OWAMP server configuration program.

Manual configuration is currently required.  Please edit the
/usr/local/etc/owampd.conf and /usr/local/etc/owampd.limits files
to create custom versions for your site.

See http://e2epi.internet2.edu/owamp for more details.

Static IP Address

Can be configured from the customize tool. However, i will leave it for now until the machine is installed.

Code Block

knoppix@0[~]$ sudo customize.NPtools 
Internet2 Network Performance Tool Customization script
    Tools listed in RED need to be customized
        1. Setup Drive(s) to hold customization files
        2. bwctl
        3. ndt
        4. npad in RED need to be customized
        51. ntp
        6. owampSetup Drive(s) to hold customization files
        72. staticIPbwctl
        03. exit
5ndt
NTP server configuration program.  

Manual configuration is currently required4. npad
 Please edit the
/etc/ntpd.conf file to create custom versinos5. ntp
create  custom version for your site.

owamp

Code Block


knoppix@0[~]$ sudo customize6.NPtools owamp
Internet2   Network Performance Tool Customization script
 7. staticIP
  Tools listed in RED need to be customized
        1. Setup Drive(s) to hold customization files
        2. bwctl
        3. ndt
        4. npad
        5. ntp
        6. owamp
        7. staticIP
        0. exit
6
OWAMP server configuration program.

Manual configuration is currently required.  Please edit the
/usr/local/etc/owampd.conf and /usr/local/etc/owampd.limits files
to create custom versions for your site.

See http://e2epi.internet2.edu/owamp for more details.0. exit
7
Welcome to the NPToolkit server Static IP configuration program.  This
program will prompt you for the necessary information for your site.

Use Static IP addresses or DHCP [static] :
Enter your IP address [192.168.1.99]  : 
Enter your Netmask value [255.255.255.0]  : 
Enter your gateway's IP address [192.168.1.1]  : 
Enter the network interface identifer [eth0]  : 
Enter your nameserver's IP address (3 max, blank line to exit early)  : 
mount: only root can do that
mount: only root can do that
Static IP customization files are being saved to 'sdb1'
Do you want to start this interface? [Yes] :

Reboot

Let's reboot to see if things stick...

...

Child pages

Versions Compared

Old Version 6

New Version Current

Key

Overview

Boot

USB key usage

NTP

owamp

Static IP Address

owamp

Reboot