Configuration of OpenInsight's Internal Web Server

By default the OEngineServer’s built in Web Server is configured to listen on port 18888. You can change this port by either the OpenInsight IDE from Settings, IDE, Console or via the OI Console.

The engine server can provide web server functionality to serve up static (HTML) and dynamic (O4W) output directly, without requiring Microsoft IIS or Apache. The web server (based on the open-source Jetty server) intentionally provides limited functionality, designed to handle the OI Console and less-heavily-loaded O4W sites with an easy to manage and configure system.

Enabled Web Server (eserver.cfg setting WebServer_Disabled): Select to enable or disable the built-in web server functionality.

Port Number for HTTP requests (eserver.cfg setting WebServerPortNumber): If the web server functionality is enabled, this is the port number on which the web server should “listen.” Default value is 18888.

Name to use in URL to identify host (eserver.cfg setting WebServerCGIProcedure): When using IIS or Apache, clients normally use OECGI3.EXE or OECGI4.EXE (or OECGI3P.PHP or OECGI4P.PHP) to initiate the CGI request that communicates between the web server and the engine server. Since, in this case, the engine server is acting as the web server, there is no actual cgi routine needed to perform the communication. However, the web server must still know when a request is for a static (HTML) page, versus a dynamic (CGI) page, so that it can be properly processed. The WebServerCGIProcedure specifies the name in the url that signifies this is a dynamic page, and thus this should be processed as though it were coming from the cgi procedure. Multiple values may be specified, semicolon delimited. By default, this value is oecgi4.exe;oecgi3.exe

Default Connection Details (eserver.cfg setting WebServerConnection_default): Specifies all the default values needed to “connect” to an OEngine. This list of settings includes application name, user name, password, startup flag, shutdown flag, “listener” routine name, engine name, OI folder, file upload mode, file upload path, and “failure page” URL. These values are identical to those used in the registry for the actual OECGI3/OECGI4.

Virtual Directories (eserver.cfg setting WebServerVirtualDirs): A list of the “virtual directories” that the web server should recognize. These are comparable to the “virtual directories” that are set up in IIS, for example. For each virtual directory, you will need to specify all the values needed to “connect” to an OEngine. This list of settings includes application name, user name, password, startup flag, shutdown flag, “listener” routine name, engine name, OI folder, file upload mode, file upload path, and “failure page” URL. These values are identical to those used in the registry for the actual OECGI3/OECGI4. In addition, you will specify the “default page” (the name of the html document to return if no specific page is specified), and the full path to the actual folder that the virtual directory represents.

The contents of the eserver.cfg file are as follows:

#Fri Feb 13 15:05:11 BOT 2015

UserName=

Mode=

Procedure_1=REVCMD_LISTENER

WebServerConnection_default=EXAMPLES,EXAMPLES,,,,RUN_OECGI_REQUEST,,,,

Password=

//=Process to run for mode -1,0,2 at 'idle check'

Statistics_Directory=stats

Server=

WebServerVirtualDirs=o4w;examples;console

WebServerVirtualPaths=o4w;o4w;o4w

Statistics_Output=localhost\:18090

Statistics_Input=18090

IdleTimeout=15

WebServerConnection_console=SYSPROG,OICONSOLE,SYSPROG,,,RUN_OECGI_REQUEST,,,,

MaxConnections=0

StartupFlags=65

WebServerConnection_o4w=SYSPROG,OICONSOLE,SYSPROG,,,RUN_OECGI_REQUEST,,,,

WebServerConnection_examples=EXAMPLES,EXAMPLESO4W,EXAMPLESO4W,,,RUN_OECGI_REQUEST,,,,

IdleCheck=60

TimerProc=

PortNumber=18088

MaxUpTime=0

ShutdownProc=

MaxEngines=10

Application=

WebServerCGIProcedure=oecgi4.exe;oecgi3.exe

Procedure_=JD3_LISTENER

//CommandPort=18887

EControlPassword=oq19usRJ5UuBvTNyudv/H/7soWoRIq0k

Statistics_Days=14

ShutdownFlags=1

WebServerPortNumber=18888

//WebServerConnection_examples=

MaxRunTime=0

Statistics_ID=MAIN