Sapphire Application Server Configuration File

The configuration file has this format:

[/<name of application server 1>]
session_affinity=[0 or 1]
program=<path>
file_path=<path>
host=<host1>:<ports>
host=<host2>:<ports>
host=<host3>:<ports>
	.
	.
host=<hostn>:<ports>
[/<name of application server 2>]
session_affinity=[0 or 1]
program=<full path to application server executable>
file_path=<full path to files used by the application 
server>
host=<host1>:<ports>
	.
	.
host=<host2>:<ports>
	.
	.
host=<host3>:<ports>
	.
	.
host=<hostn>:<ports>

<name of application server> is the unique name of the application server built from a Sapphire project. Note that there is a / before all of the application server names. This name is compared with the PATH_INFO sent by a browser to determine if this is the app server to run.

On a UNIX system the name of the application server is typically

/[project name].cgi

<host> is the host that the application server is running on.

<ports> are the ports that the specified app server(s) will listen to. You can specify ports in 3 different ways :

• individual - comma separated values. Each number is a port that a different server will listen to. An example is 8888,20000

• ranged - a range of ports in the format lowport - highport where
  • lowport is the number of the first port a server is listening on
  • highport is the highest port a server is listening on.

An example is 8000-8003. This example says that there is a server running at ports 8000,8001,8002 and 8003.

• start + num - a starting port and the number of servers that listen to ports.

8000 4 means that there is a server running at ports 8000,8001,8002 and 8003

Rules

• The name of the application server must start with a `/'. This is because the web server extension uses the PATH_INFO supplied by the HTTP server as a look up into the configuration file. For example if the name of your project is tut2 you must enter /tut2.cgi into the name field.

• The host of the server must be accessible from the host that the web server is running on.

• The host of the console must be accessible from the manager, and vice versa

• The port must be unique to the host the application server is running on.

• The program must point to the full path to the executable file that is the application server.

• The name of the executable file (for example tut2.cgi) must the same as the name of the application server and it is case sensitive. Failure to have these values match may cause problems running your application server.

[/tut2.cgi]
session_affinity=0
program=/usr/sapphire/projects/tut2/tut2.cgi
file_path=/usr/website/sapphire/tut2
host=marquez:8888 3
host=cezanne:8888,8889,8890
host=picasso:8888-8890
[/shoppingCart.cgi]
session_affinity=0
program=/usr/sapphire/projects/shoppingCart.cgi
host=marquez 10000
host=cezanne 10000
host=picasso 10000
host=marquez 10001
host=cezanne 10001
host=picasso 10001

This configuration file defines two server applications tut2 and shoppingCart.

• tut2 runs on ports 8888,8889 and 88890 on three different hosts (marquez, cezanne and picasso)

• shoppingCart runs on ports 10000 and 10001 on three different hosts.