Innovative Computing Labs (icl.cs.utk.edu)
Netsolve (icl.cs.utk.edu/netsolve)
Windows Client Distribution
-----------------------------------------------
Contents
--------
1.  Package Description
2.  Package Contents
3.  Installation
4.  Uninstallation
5.  Finding out what the agent host name is
6.  Setting a new agent host name
7.  Testing your installation
8.  Using Netsolve from Matlab
9.  Using the tools
10. Bug reports
-------------------------------------------------
1.Package Description:
	This is the Windows version of the Netsolve client distribution. 

2.Package Contents:
	NETSOLVE_DIR refers to the directory where you unzipped the distribution

NETSOLVE_DIR\
	This contains the readme file and an installation script
NETSOLVE_DIR\lib
	This contains the netsolve client library 
NETSOLVE_DIR\matlab
	This contains the matlab binaries
NETSOLVE_DIR\tools
	This contains various tools for managing netsolve
NETSOLVE_DIR\testing
	This contains various sample binary test programs that you can run to 
        verify your installation

3.Installation:
	a. cd NETSOLVE_DIR
	b. netsolve_install
		The above program installs the following key in the 
                windows registry
HKEY_LOCAL_MACHINE\Software\netsolve\proxy_port = "0"
HKEY_LOCAL_MACHINE\Software\netsolve\agent = "netsolve.cs.utk.edu"
HKEY_LOCAL_MACHINE\Software\netsolve\install_dir = "NETSOLVE_DIR"

4. Uninstallation:
	a. cd NETSOLVE_DIR
	b. netsolve_install -uninstall
		The remove the above keys from the registry
	c. delete NETSOLVE_DIR

5. Finding out what the agent host name is:
	a. cd NETSOLVE_DIR\tools
	b. getagent

6. Setting a new agent host name:
	a. cd NETSOLVE_DIR\tools
	b. setagent [agent host name]
	If the agent host name is not specified on the command line 
you will be prompted for a host name. You will have the option of 
specifying a name or accepting the current agent name set in the registry.

7. Testing your installation:
You can use the various programs in the NETSOLVE_DIR\examples directory to 
test your netsolve installation. Remember valid netsolve agent and server should 
already be running. Also the required problems should be installed on the 
servers. Here is a list of example programs and the problems they make use of

a. c_test - chartest,doubletest,inttest,stringlisttest
		stringtest,totaltest		
b. farming_test - doubletest
c. sequence_test - mpass,vpass,pass,multipass

A sample run with c_test
	a. use setagent to point to the correct agent host
	c. run c_test.exe

8. Using Netsolve from Matlab:
	A user new to Netsolve will find the Matlab interface very simple. 
The matlab interface is in NETSOLVE_DIR\matlab. To access the interface
	
	a. start up Matlab
	b. click on File->Set Path...
	c. add the NETSOLVE_DIR\matlab directory to the path
	
The interface consists of 4 netsolve calls
	netsolve.dll
	netsolve_nb.dll
	netsolve_err.dll
	netsolve_errmsg.dll

Testing
	a. netsolve('?') 
		This should print out the agent and servers currently available
	b. netsolve
		This prints the problems that can be solved.
	c. help on any call can be obtained by typing just the call on the matlab
		prompt

9. Using the tools:
	There are various tools in the NETSOLVE_DIR\tools directory that allows 
        you to explore the netsolve meta computing system available to you.
	a. netsolveconfig.exe [agent_name]
		provides a list of agents and servers as seen by agent_name
	b. netsolveproblems.exe [agent_name]
		provides a list of problems that can be solved within the
                netsolve framework as seen by agent_name

10. Bug reports:
	netsolve@cs.utk.edu