ENSIGHT Server Installation Instructions:

1. Select a suitable machine to run the server
• Most unix flavors can work: Linux, AIX, IRIX, Solaris, Darwin (Linux is preferred).
• MS Windows is also possible (Precompiled, Iperf only).
• Testing will NOT consume much CPU or network resources.
• The tests use normal TCP, so tend to share the available bandwidth in a "friendly" manner
• So the machine does not need to be dedicated to testing
• Location: Close to (or on) the real EOS machine, but well accessible by network
• Alternative: Two test machines -- one near real EOS machine, one at network DMZ
• This configuration can help distinguish WAN problems from LAN problems

2. Download the Server -- Options: Datasink, Iperf, nuttcp
• Most are available as source code or Pre-compiled Executable -- for several O/S
• If datasink or nuttcp source code downloaded, compile with cc or gcc
• Datasink: see source file for some machine specific changes
• On Solaris, "cc -lsocket -lnsl datasink.c"
• If iperf source downloaded, use "make" -- see "README" in package
• Download Page: downloads.html

3. Select Parameters
• TCP Port to use: default is OK or choose any other
• TCP Window Size: recommend at least 500 KB

4. Run the server
• Normal user mode; su or sudo is not required
• [path/]datasink [-w wsize] [-p port]     Defaults: TCP port 5500, 56 KB windows
• [path/]iperf -s -D [-w wsize[K M]] [-p port]     Defaults: TCP port 5001, 64 KB windows
• [path/]nuttcp -S [-P port]     Default: TCP port 5000

5. Email me the details of what you have set up: Machine name / IP, server type, TCP port

• My PGP Public Key is available from pgpkeys.hq.nasa.gov:11371

6. Configure any firewalls to allow connections to the server
• I can provide the IP address of the test source(s)

7. [Optional] Install a cron job to try to restart the server (hourly?)
• If the server is still up then the restart will fail (bind: Address already in use )
• But that's OK -- no harm done
• So Redirect the cron output to /dev/null
• Example: "0 * * * * [path/]datasink [-w wsize] [-p port] > /dev/null 2>&1"