Dundas State Server Overview
The Dundas State Server (StateServer.exe) is used to store upload progress information which can be stored and retrieved using the UploadProgress and Upload components. This data is accessible from anywhere on a network, thereby allowing the State Server to function in a web-farm scenario.
The State Server can also be set up to run as a service (see below for more details).
Perform the following steps to set up the Server:
Move the StateServer.exe to the machine which is to be used to store state information.
You can either run the server as a normal executable or alternatively you can run it as a service. To run it as a service refer to the section immediately following this listing of steps.
Set the following properties or alternatively use their defaults:
To accept a request from any machine on the network do not insert any entries into the "Valid Client's IP Addresses" listbox. However, if you want to restrict which machines on the network can access the server then enter their IP addresses into this listbox. Note that by specifying one or more addresses here only those IP addresses will be allowed to access the State Server.
Set the port number which the server should listen on (this is the port number which you must specify when connecting to the State Server) or use the default port (6723).
The timeout value determines when a request will be timed-out. You can accept the default of 15 seconds or set this yourself.
The "State Valid For" value determines how long state information for a particular upload operation will be stored. You can increase or decrease this value as you see fit.
- The "Max. Connections" value determines how many components can access the State Server at one time. The default value is "20", but you may change this if you so desire.
If you have set up the State Server to run as a service then there will be no GUI to set these properties with. You will need to run the State Server manually (see below), set up your properties and then set the State Server back to running as a service.
To set the State Server up to run as a service you will need to run the executable from the command line with the following switches:
i - Run the Server as a service the next time the machine is booted.
u - Causes the State Server to be uninstalled as a service.
- m - Runs the State Server manually from the command line. Use this option if the server is running as a service and you want to set or change one or more properties.
For example, to set up the State Server to run as a service use the following sytax from the command line (using a fictitious path): "e:\StateServer.exe /i".
For detailed help on how to utilize the State Server in conjunction with the UploadProgress component see Tutorial 4: Implementing a Progress Bar.
See Also: Overview (Progress Bar Component)