Global Application Options
The global.asa file is used to set up application variables referenced in the classic ASP code of SOLO Server. The web.config file contains the application settings used for the ASP.NET code of SOLO Server. The searching rules for these files are specified by your configuration of IIS and web directory structure. Refer to the installation topic for more information.
The SOLO.config file also contains application settings for SOLO Server. The location of this file is specified in the Web.config file under the application settings SOLOConfigPath, HttpRequestValidatorConfigurationPath, HttpErrorHandlerConfigurationPath. Typically the same SOLO.config file is used for all 3 variables.
Starting with SOLO Server Build 1.6.0.72, all classic ASP application variables are read from the web.config file. This avoids duplication of parameters and the chance of conflict and confusion.
How The Global.asa Application Variables are Initialized
Include Directive - At the very top of the global.asa file, outside of the Application_OnStart subroutine, a server side include to StartSOLO.inc is included. This script handles reading values from the web.config and SOLO.config file and loading them into the respective application variables. The syntax for this include is as follows:
- <!--#include file="StartSOLO.inc"-->
In cases where the SOLO Serverroot is a subdirectory of the web root, the file must be referenced with a relative path. For example, if SOLO Server is installed in the "SOLO" subdirectory off of the web root, the syntax would be as follows:
- <!--#include file="SOLO/StartSOLO.inc"-->
Single Application Variable - A single application variable needs to be defined inside of the Application_OnStart subroutine of global.asa. The Application("SOLOWebConfigPath") variable must contain the full path and name of the Web.config file used by your website.
LoadApplicationConfigurationThe final entry in the Application_OnStart event is a call to LoadApplicationConfiguration. This method is located in the StartSOLO.inc file descibed earlier, and loads the application variables that are derived from the web.config and SOLO.config files.
Changing Values in web.config
If any changes are made to the web.config file, be sure to save global.asa, so that IIS sees a new timestamp on this file. When it does, it will run the Application_OnStart subroutine to re-load configuration parameters from web.config. Alternatively, you may reset IIS or recycle the application pool to force the new parameters to be read.