73d2fffc35
Squashed commit of the following: commit a031e3f388af144cb6d729e4b16b174a7caf6de9 Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 17:50:55 2013 +0100 new version - 2.012005 commit a0215a83fb2cd9f3040cfd04e239a1a40367e056 Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 17:47:28 2013 +0100 set last arpnip timestamp commit 824d311a2503cc91a117d4cc5949b0aca0cabdc9 Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 17:28:14 2013 +0100 test release - 2.012003_001 commit d06316eb1ae6a035a2fefd1edd06bfa6ffe38fa8 Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 17:26:44 2013 +0100 Improved handling of automatic macsuck/arpnip after initial discover commit d7c1e7948f22487c0564a884ce94d109a2cdc13c Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 13:21:51 2013 +0100 add rev. proxy timeout to suggested config commit 040065a50fec4669740ae48ff18352ef7ff3fde1 Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 13:14:15 2013 +0100 remove done job from local queue regardless of exit status commit d0f1d105459c047cc7156d1b4ef897ad27f965bb Author: Oliver Gorwits <oliver@cpan.org> Date: Fri Aug 16 13:12:45 2013 +0100 fix no_auth to work with new Auth::Extensible plugin
102 lines
3.3 KiB
Plaintext
102 lines
3.3 KiB
Plaintext
=head1 NAME
|
|
|
|
App::Netdisco::Manual::Deployment - Tips and Tricks for Deployment
|
|
|
|
=head1 Relocating the Installation
|
|
|
|
The installation process installs Netdisco self-contained to your home
|
|
directory. The target directory can easily be changed by setting the
|
|
C<NETDISCO_HOME> environment variable, for example:
|
|
|
|
export NETDISCO_HOME=/opt/netdisco
|
|
|
|
Obviously, you'll need to substitute this wherever you see "C<~>" in the
|
|
installation instructions. The Netdisco application will use this setting
|
|
itself to locate files and configuration.
|
|
|
|
=head1 Pass Options to the Web Frontend Daemon
|
|
|
|
Simply add any options after the "C<start>" command. See other sections of
|
|
this document for some examples.
|
|
|
|
=head1 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 C<--path>
|
|
parameter to the web startup script:
|
|
|
|
~/bin/netdisco-web start --path=/netdisco2
|
|
|
|
Alternatively, can set the C<path> configuration option in your
|
|
C<deployment.yml> file:
|
|
|
|
path: '/netdisco2'
|
|
|
|
=head1 Listening Port for the Web Frontend
|
|
|
|
Pass the C<--port> parameter to any of the web scripts. For example:
|
|
|
|
~/bin/netdisco-web start --port=8080
|
|
|
|
=head1 Listening Address for the Web Frontend
|
|
|
|
Pass the C<--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
|
|
|
|
=head1 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 C<mod_proxy>).
|
|
|
|
After enabling the C<headers>, C<proxy> and C<proxy_http> modules in Apache, a
|
|
suitable configuration would be:
|
|
|
|
ProxyPreserveHost On
|
|
ProxyPass / http://localhost:5000/ retry=0 timeout=5
|
|
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 C<path> in your C<deployment.yml> as
|
|
discussed above. Note there is no trailing slash in the Apache config:
|
|
|
|
ProxyPass /netdisco2 http://localhost:5000/netdisco2 retry=0 timeout=5
|
|
ProxyPassReverse /netdisco2 http://localhost:5000/netdisco2
|
|
|
|
To delegate user authentication to Apache, use the C<trust_remote_user> or
|
|
C<trust_x_remote_user> settings. See L<App::Netdisco::Manual::Configuration>
|
|
for more details.
|
|
|
|
=head1 SSL Support
|
|
|
|
There is no SSL support in the built-in web server. This is because it's not
|
|
straightforward to support all the SSL options, and using port 443 requires
|
|
root privilege, which the Netdisco application should not have.
|
|
|
|
You are instead recommended to run C<netdisco-web> behind a reverse proxy as
|
|
described elsewhere in this document. Apache can easily act as an SSL reverse
|
|
proxy.
|
|
|
|
=head1 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
|
|
|
|
=head1 Further Reading...
|
|
|
|
Other ways to run and host the web application can be found in the
|
|
L<Dancer::Deployment> page. See also the L<plackup> and L<starman>
|
|
documentation.
|
|
|
|
=cut
|