SettingUpNettest

-- Main.OscarLopez? - 27 Jun 2001

Preparing

Before installing Nettest, make sure you have openssl-0.9.6 already installed.

Downloading

Download Nettest from http://www-itg.lbl.gov/nettest/ .

Configuring

Untar the .tar.gz file anywhere you would like to.
Move to nettest/src/ and open the configure.in file with your favorite editor.
Change every "gmake" for "make". Save and exit.
Then, in that same directory, type and enter "autoconf".
You are now ready to configure and install Nettest.

There are basically 2 ways that you can configure Nettest:
1) Normal
2) Full Debug

For the Normal configuration, leave everything "as is" and move on to Compiling.
For the Full Debug configuration, you'll have to do a few things.
First, move to nettest/src/nettest/. Open lblnettest.cc and look for "const int debugLevel = 0;". Change the "0" for a "5".
Now go to nettest/src/ping/. Open udpping.cc and look for
"UDPPing::UDPPing( PingTestInfo? testinf ) : MyThread?(), MyDebug?("UDPPING: ", 0 ), mPinginf(testinf)".
Change the "0" for "5".
Now go to nettest/src/common/. Open securetcp.cc and look for
"SecureTcp::SecureTcp() : MyDebug?("SecureTcp?: ", 0), func( NULL ), mCertfilename( "nettest.pem" ), mKeyfilename( "key.pem" )".
Change the "0" for "5".
Now you're ready to compile and install.

Compiling

**The following instructions apply to installing Nettest on a Linux box. If you are installing on something else, please refer to the Nettest documentation.**

Move to nettest/build/linux. Enter the following command: "../../src/configure". You will be promted to ask a series of questions. When asked about making iperf threads answer "yes". Once that finishes, enter the "make all" command. This will build the lblnettest executable. The executable will be located in nettest/release/.

Running

Before running Nettest, there are a few things you need to do. First, you need to create or acquire the security certificates you'll be using with Nettest. Please refer to the Security and Generating/Using Certificates section of the Nettest documentation.
You'll also have to edit the ACLFile? located at nettest/release/. This file MUST be properly written in order for Nettest to work properly. Please refer to the Problems Related to SSL and Certificates section of the Nettest documentation.

Once you have your certificates and the ACLFile? ready you can run lblnettest. For examples on running Nettest please refer to the Running lblnettest section of the Nettest documentation. There you will find all the different ways in which Nettest can be run. If you would like to find out more about all the command line arguments for lblnettest please refer to the Command-Line Arguments section of the Nettest documentation.

Troubleshooting

If lblnettest isn't working properly, and you get messages like "getCanonicalName failed" or other communication errors, try adding the computer you're trying to test with to the /etc/hosts file of the computer who is working as the Master/Requester, or the Server computer, whoever it is that is giving you the communication error.
If that doesn't work, or you're getting different kinds of errors, please refer to the Problems Related to SSL and Certificates section of the Nettest documentation.