Setting Up Your First VPS FAMP Stack

Date published: April 6th, 2012
Posted in FreeBSD | 3 Comments »

by: Diego Montalvo

 

RootBSD VPS instances are installed with a current version of FreeBSD and with SSH access but nothing else. In this tutorial, you will learn how to update the ports tree and install PHP, Apache, and MySQL (FAMP Stack) on your VPS.

 

Logging in as root is disabled so you should login using the provided SSH user name and password provided by RootBSD. Once you have successfully logged into your VPS you may simply “su” to root.

 

Before we begin to install any ports, it is recommended that you update the ports tree so that any port you intend to build is the most current version.

 

Upgrading Ports Tree Using Portsnap

# portsnap fetch update

 

 

Installing Apache 2.2.x

First, we are going to install Apache HTTP Server.

# cd /usr/ports/www/apache22 # make install clean

Choosing the default options will do just fine. Installation will take a few minutes.

Figure 1. Apache Options Screen

Wait for installation to complete.

To run Apache web server from startup append the following to the “rc.conf” file.

apache22_enable=”YES”

Starting and Stopping Apache

apachectl start

apachectl stop

 

Once Apache has been successfully installed you can open your VPS address in a web browser and you should see the following text “It works!”

 

Potential Issues

You may run into some issues when starting Apache for the first time. Two of the most common are hostname and accf_http issues.

 

Hostname issues:

If you start Apache and the server throws back the following error:

httpd: apr_sockaddr_info_get() failed for XXXX

httpd: Could not reliably determine the server’s fully qualified domain name, using 127.0.0.1 for ServerName

You need to set your hostname. This can be done by editing /etc/rc.conf:

hostname=”x.x.xxx” < – Your server’s fully qualified domain name (FQDN).

 

accf_http

You may also get an error that looks like:

[warn] (2)No such file or directory: Failed to enable the ‘httpready’ Accept Filter

This is especially common on FreeBSD systems. To solve the problem follow these steps:

Type the following at the CLI:

# kldload accf_http # echo ‘accf_http_load=”YES”’ >> /boot/loader.conf

Restart Apache. (/usr/local/etc/rc.d/apache22 restart)

 

 

Installing PHP 5.3.x

# cd /usr/ports/lang/php5 # make install clean

Note: Select “Build Apache Module”

Figure 1. PHP 5.3.x Options Screen

Wait for installation to complete.

# php -v will output the version of PHP installed.

 

In order for PHP to parse correctly you must add a few lines to the Apache “httpd.conf” file.

# cd /usr/local/etc/apache22/ # ee httpd.conf

AddType application/x-httpd-php .php AddType application/x-httpd-php-source .phps

Figure 2. Adding lines to Apache “httpd.conf” file

Figure 3. Add index.php before or after index.html

 

 

Installing MySQL

# cd /usr/ports/databases/mysql55-server # make install clean

Choosing the default options will do just fine. Installation will take a few minutes.

Figure 5. Installing MySQL With Default Options

To run MySQL from startup append the following to the “rc.conf” file.

# mysql_enable = “YES”Once MySQL has been installed you can start it using either of the following commands: # /usr/local/etc/rc.d/mysql-server start or # service mysql-server start

It is strongly recommended to set a sysadmin (root) password for MySQL.

# mysqladmin -u root password New Password: <enter password>

 

Additional Modules

Once you’ve installed the main components you may need to install some additional modules for everything to work well together. Three commonly used modules are:

/usr/ports/databases/php5-mysql

/usr/ports/www/php5-session

/usr/ports/graphics/php5-gd

 

For all of these just “cd” to the above directories and run (default options are fine):

# make install clean

Then restart Apache. (/usr/local/etc/rc.d/apache22 restart)

Finished

Once all three components are installed and configured you’re ready to start setting up a database driven site or application. To verify that everything is working correctly you can use a phpinfo test page.

Navigate to your web root (by default /usr/local/www/apache22/data), and enter the following:

# echo “<?php phpinfo(); ?>” > test.php

Now you should be able to open your VPS address in your browser and navigate to test.php (ex: 199.199.199.1/test.php). You should see a page showing your PHP version, as well as info on installed modules (including mysql).

 

Resources
FreeBSD	Http://www.freebsd.org/
Apache Foundation	http://www.apache.org/
MySQL	http://www.mysql.com
PHP Official Site	http://www.php.net/