Palegray.net - Code, Linux/BSD, Tech, and more
Home Projects Tutorials Forums About Contact

Automate::nppm::ubuntu-10-04

Automate::nppm splash screen on Ubuntu 10.04 LTS.

Automate packages provide a console-based, interactive way to configure complete server solutions. This package installs and configures nginx/Perl-FastCGI/PHP-FastCGI services on a Linux system. Each web site you host with this package will be run under its own Linux system user, and will support Perl-FastCGI and PHP-FastCGI for dynamic content. Optionally, the package will configure self-signed SSL certificates for each site. Given the fact that modern web browsers on modern operating systems feature full support for SNI, all configured sites will share the same public IPv4 IP address.

If you don't have a server of your own, check out Linode, my favorite server provider.

Create/Update DNS Records

You must create DNS records for each domain you wish to host, and you should have (at minimum) "A" records pointing each domain to your server's IP address. If you're using a Linode VPS and you are using the Linode DNS Manager interface to manage DNS for your domains, you may refer to the Linode Library article on DNS configuration with the Linode Manager for easy instructions.

Installation

Log into your system as the "root" user. If you are running the 32-bit (x86) version of Ubuntu 10.04, issue the following commands to obtain, unpack, and run the software.

wget https://www.palegray.net/projects/automate/nppm/download/nppm-ubuntu-10-04-x86-v1.0.1.tar.bz2
bunzip2 nppm-ubuntu-10-04-x86-v1.0.1.tar.bz2
tar -xf nppm-ubuntu-10-04-x86-v1.0.1.tar
cd nppm-ubuntu-10-04-x86-v1.0.1
./install

If you are running the 64-bit (x86_64) version of Ubuntu 10.04, issue the following commands to obtain, unpack, and run the software.

wget https://www.palegray.net/projects/automate/nppm/download/nppm-ubuntu-10-04-x86-64-v1.0.1.tar.bz2
bunzip2 nppm-ubuntu-10-04-x86-64-v1.0.1.tar.bz2
tar -xf nppm-ubuntu-10-04-x86-64-v1.0.1.tar
cd nppm-ubuntu-10-04-x86-64-v1.0.1
./install

Once you've provided the requested configuration values, nginx will be properly configured to host the specified web sites on your server.

Usage Notes

Your websites are available under the "/srv/www" directory. Each site has an nginx config file, located beneath the "/etc/nginx" directory. Additionally, each site has a separate init script, located beneath the "/etc/init.d/" directory.

Source Code

The full source code for this package is available here: nppm-ubuntu-10-04-v1.0.1-source.tar.bz2. You may also obtain the software via git by issuing the following command.

git clone http://git.palegray.net/Automate/nppm-ubuntu-10-04

Bugs

Please report any bugs or feature requests to Phil Paradis <pparadis@palegray.net>.

License

Copyright © 2010, Philip C. Paradis <pparadis@palegray.net>
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PHILIP C. PARADIS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

This software uses the Term::ReadKey Perl module. The "README" for this module contains the following text related to copying:

"Term::ReadKey 2.13 - Change terminal modes, and perform non-blocking reads.
Copyright © 1994-1999 Kenneth Albanowski. Unlimited distribution and/or modification is allowed as long as this copyright notice remains intact."