plainblack.com
Username Password
search
Bookmark and Share
Subscribe

Gateway

The "gateway" value in the WebGUI configuration file has two possible uses:

  1. It tells WebGUI what path it is running under, like "http://example.com/the_webgui_site/..."
  2. It allows you to run multiple WebGUI instances under the same domain.

To run WebGUI under a different path from "/", you change the "gateway" value to the path you desire, and put the WebGUI Apache configuration into a <Location> block, like so:

WebGUI Config:

"gateway" : "/the_webgui_site/",

Apache Config:

<Location /the_webgui_site>
    SetHandler perl-script
    PerlInitHandler WebGUI
    PerlSetVar WebguiConfig www.example.com.conf
</Location>

To run multiple WebGUI instances under the same domain, you must create a new site (name it uniquely, we'll only be changing the domain name later). Then, open the new config file you just created, and change the "sitename" to be the domain you want, and change the "gateway" to be the gateway you want. Finally, add a location block in the Apache config to handle the new site.

So to have two WebGUI instances, one under "http://example.com/home" and the other under "http://example.com/away":

WebGUI Config Site 1 (example.com_home.conf):

"sitename" : [ "example.com", "www.example.com" ],
"gateway" : "/home/",

WebGUI Config Site 2 (example.com_away.conf):

"sitename" : [ "example.com", "www.example.com" ],
"gateway" : "/away/",

Apache Config:

<Location /home>
    SetHandler perl-script
    PerlInitHandler WebGUI
    PerlSetVar WebguiConfig example.com_home.conf
</Location>
<Location /away>
    SetHandler perl-script
    PerlInitHandler WebGUI
    PerlSetVar WebguiConfig example.com_away.conf
</Location>

Keywords: config domain gateway

Search | Most Popular | Recent Changes | Wiki Home
© 2018 Plain Black Corporation | All Rights Reserved