Oliver Gorwits > App-Netdisco-2.010001_003 > App::Netdisco::Manual::Deployment

Download:
App-Netdisco-2.010001_003.tar.gz

Annotate this POD

Website

View/Report Bugs
Source   Latest Release: App-Netdisco-2.026001_002

NAME ^

App::Netdisco::Manual::Deployment - Tips and Tricks for Deployment

Relocating the Installation ^

The installation process installs Netdisco self-contained to your home directory. The target directory can easily be changed by setting the NETDISCO_HOME environment variable, for example:

 export NETDISCO_HOME=/opt/netdisco

Obviously, you'll need to substitute this wherever you see "~" in the installation instructions. The Netdisco application will use this setting itself to locate files and configuration.

Pass Options to the Web Frontend Daemon ^

Simply add any options after the "start" command. See other sections of this document for some examples.

Non-root Hosting ^

Netdisco will assume its web site is hosted at the apex of your server - that is, the document root. To relocate the web application, pass the --path parameter to the web startup script:

 ~/bin/netdisco-web start --path=/netdisco2

Alternatively, can set the path configuration option in your deployment.yml file:

 path: '/netdisco2'

Listening Port for the Web Frontend ^

Pass the --port parameter to any of the web scripts. For example:

 ~/bin/netdisco-web start --port=8080

Listening Address for the Web Frontend ^

Pass the --listen parameter to any of the web scripts. Note that you always must include the port number. For example:

 ~/bin/netdisco-web start --listen=127.0.0.1:8080

Behind a Proxy ^

By default the web application daemon starts listening on port 5000 and goes into the background. This is ideal for hosting behind a web proxy (e.g. Apache with mod_proxy).

After enabling the headers, proxy and proxy_http modules in Apache, a suitable configuration would be:

 ProxyPreserveHost On
 ProxyPass / http://localhost:5000/
 ProxyPassReverse / http://localhost:5000/
 
 ProxyRequests Off
 <Proxy *>
   Order allow,deny
   Allow from all
 </Proxy>

To combine this with Non-root Hosting as above, simply change the paths referenced in the configuration, and set path in your deployment.yml as discussed above. Note there is no trailing slash in the Apache config:

 ProxyPass /netdisco2 http://localhost:5000/netdisco2
 ProxyPassReverse /netdisco2 http://localhost:5000/netdisco2

To delegate user authentication to Apache, use the trust_remote_user or trust_x_remote_user settings. See App::Netdisco::Manual::Configuration for more details.

SQL and HTTP Trace ^

For SQL debugging try the following commands:

 DBIC_TRACE_PROFILE=console DBIC_TRACE=1 ~/bin/localenv starman ~/bin/netdisco-web-fg --workers=1 --disable-keepalive
 DBIC_TRACE_PROFILE=console DBIC_TRACE=1 ~/bin/localenv ~/bin/netdisco-daemon-fg

Further Reading... ^

Other ways to run and host the web application can be found in the Dancer::Deployment page. See also the plackup and starman documentation.

syntax highlighting: