This article is intended for those looking to fire up a [MongoDB](https://www.mongodb.org/) data store on OSX and outlines how to install and manage a MongoDB instance using [Homebrew](http://brew.sh) and [launchd](https://wiki.freebsd.org/launchd). This set up is not intended for production, is not secured (I'll cover that in a future post) and should be used only for local development. 

## Prerequisites:
You're going to need Homebrew. If you don't have it installed yet, you can get set up following the steps outlined in [OSX Package Management with Homebrew](http://blakepetersen.io/homebrew-osx-package-management/).

## 1. Update Homebrew
Before anything else, always update Homebrew. 
```bash
$ brew update
```

## 2. Install MongoDB

There's a couple options you can pass when installing MongoDB using Homebrew, but to get the standard build on your system, run the following command.

```bash
$ brew install mongodb 
```

To include SSL/TLS support in the build, pass the '--with-openssl' flag with the command.

```bash
$ brew install mongodb --with-openssl
```

To install the development release, pass the '--devel' flag.

```bash
$ brew install mongodb --devel
```

You can check to see whether MongoDB installed by checking the version like so...

```bash
$ mongod --version
```

It should return `db version v3.0.7`, for example.

## 3. Fire Up MongoDB

Before we can light this up, we need to ensure MongoDB has a place to store it's data. By default, it seeks to put this data in the `/data/db` folder. Chances are, if you don't already have MongoDB installed, you don't have this folder on your system. To add it, run the following command...

```bash
$ mkdir -p /data/db
``` 

Once that's all set, you can start MongoDB using the `mongod` command. 

```bash
$ mongod
```

It should blast out a number of lines, the last should state something along the lines of `waiting for connections on port 27017`. If you see this, you're on the right track and can use MongoDB right now! This simple mode is great for quick debugging as you will see logs reported here. Unfortunately, as soon as you kill the terminal window, MongoDB and the console log dies too. 

To persist MongoDB beyond your terminal window, all you have to do is fork a child process; run `mongod` with the `--fork` and `--logpath` flags. If you're using `--fork`, you need to specify `--logpath` otherwise it will bark at you. Plus, you wanna log things, right? ;]

**Run MongoDB Daemon-style like a champ:**
```bash
$ mongod --fork --logpath /usr/local/var/log/mongodb/output.log
```

You should see the following if it starts up correctly.

```bash
about to fork child process, waiting until server is ready for connections.
forked process: 24997
child process started successfully, parent exiting
```

Killing the MongoDB process is pretty easy too, but you may need to flip some rocks if you lose your post-it. When you fire up the child process, take note of the process ID or PID as it will be how you terminate the process later. In the above example, the PID is `24997`. 

If you don't know the PID, you can run `top` in your terminal and look for `mongod` in the command column. The number just to the left of `mongod` is the PID you're looking for. You can use ctrl+c to hop out of top. 

Equipped with the PID, run the following command replacing `24997` with your own.

**Kill MongoDB like a boss:**
```bash
$ kill -9 24997
```

If you check top again, `mongod` is no longer running. 

## 4. Launch on Boot

If you find you're using MongoDB pretty frequently, you may want to add it to launchd which will start it up every time your system boots. To do this, symlink the mongodb plist file into `~/Library/LaunchAgents` to launch when your current user logs in or `~/Library/LaunchDaemons` to start when any user logs in. 

Current User:
```bash
$ ln -sfv /usr/local/opt/mongodb/*.plist ~/Library/LaunchAgents
```
All Users:
```bash
$ ln -sfv /usr/local/opt/mongodb/*.plist ~/Library/LaunchDaemons
```

An added benefit of using launchd to manage your MongoDB agents/daemons, you can now load and unload it at will using `launchctl`. 

```bash
$ launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.mongodb.plist
$ launchctl load ~/Library/LaunchAgents/homebrew.mxcl.mongodb.plist
$ launchctl unload ~/Library/LaunchDaemons/homebrew.mxcl.mongodb.plist
$ launchctl load ~/Library/LaunchDaemons/homebrew.mxcl.mongodb.plist
```
## 5. Gooey Applications
I have two goto GUI applications when dealing with MongoDB. Let's power down Terminal and let our beautiful Apple display do it's thing!

##### **LaunchControl** 

[LaunchControl](http://www.soma-zone.com/LaunchControl/) is an amazing tool for visualizing and managing launchd agents and daemons outside the command line. I tend to also lean on this heavily when swapping between versions of PHP. Super handy!

##### **Robomongo**
[Robomongo](http://robomongo.org/) is a tool used to view and manage MongoDB databases and collections. It offers a lot of flexibility and provides an invaluable window into what your application is actually doing with your data. I first started using Robomongo on Ubuntu as it was the only cross-platform solution out there for this, and came to find it's pretty much the best GUI MongoDB management tool on any platform. 

---

###### Sources

- https://docs.mongodb.org/manual/tutorial/install-mongodb-on-os-x/
- http://stackoverflow.com/questions/5596521/what-is-the-correct-way-to-start-a-mongod-service-on-linux-os-x
- https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/launchctl.1.html

Install and manage a MongoDB data store on OSX using Homebrew and launchd.

How To: Set Up MongoDB on OSX with Homebrew and launchd

I'm sure you can relate to this scenario -- You fire up a fresh Ubuntu server with intention of running a node app on it. 

You install NodeJs and npm using Aptitude...

```bash
sudo apt-get updaxte
sudo apt-get install nodejs npm
```

Everything installs correctly, but when you run node-based scripts, you get the following...

```bash
sh: 1: node: not found
```

... with a whole lot of errors along with it. 

What the heck? Node was literally just installed, how is it that it can't be found? 

The issue rests with another application called 'node' that comes pre-installed on Ubuntu. To avoid conflicting with this application, the command to launch NodeJS uses 'nodejs' instead of 'node'.

To check if this is truly the case in your situation, simply run 'nodejs' in shell and it should show the NodeJS command prompt ($>, hit ctrl+c twice to hop out). If you aren't getting the Nodejs prompt, you likely don't have NodeJS installed at all, go ahead and try to install using the commands above. 

Once we've confirmed this is the case, all we have to do is tell the system, "We appreciate your concern, but want the command 'node' to launch NodeJS and not that other application". This is done by symlinking the command 'node' to 'nodejs' using the following command...

```bash
sudo ln -s "$(which nodejs)" /usr/bin/node
```

That's it! Try running your NodeJS application and and it should now be working. 

NodeJS doesn't work with 'node' but does with 'nodejs', run `sudo ln -s "$(which nodejs)" /usr/bin/node`

Node: Not Found? But I Just Installed It!

HHVM or HipHop Virtual Machine is an virtual machine that executes code written in PHP or Hacklang using a just-in-time (JIT) compilation approach to realize greater performance than would otherwise be achievable. 

In this post, I will be running through how to install and set up HHVM on an Ubuntu 14.04 Server set up using an Apache Virtual Hosts configuration. In the end, you will be able to run traditional and HHVM-based PHP-powered web applications side-by-side on the same system.

## Install HHVM
We don't need to all get fancy compiling anything, so we will simply install the prebuilt HHVM packages for Ubuntu 14.04 (64-bit). Run the following...

```bash
wget -O - http://dl.hhvm.com/conf/hhvm.gpg.key | sudo apt-key add -
echo deb http://dl.hhvm.com/ubuntu trusty main | sudo tee /etc/apt/sources.list.d/hhvm.list
sudo apt-get update
sudo apt-get install hhvm
```
*Source: https://github.com/facebook/hhvm/wiki/Prebuilt-Packages-on-Ubuntu-14.04*

Next, we need a way to hook HHVM into our Apache web server. This is done using FastCGI, which we will need to install. Luckily, HHVM provides a shell script to set this up. Run the following...

```bash
sudo /usr/share/hhvm/install_fastcgi.sh
```

Also, to ensure HHVM fires up at boot, run this...

```bash
sudo update-rc.d hhvm defaults
```

## Configure HHVM and Apache Virtual Hosts
The install script will ask you to restart both HHVM and Apache. Don't just yet, otherwise your site visitors will be seeing some 404 action coming their way. Instead, open hhvm_proxy_fcgi.conf and comment the single ProxyPassMatch line that's in there.

```bash
sudo nano /etc/apache2/mods-available/hhvm_proxy_fcgi.conf
```

```apacheconf
# ProxyPassMatch ^/(.+\.(hh|php)(/.*)?)$ fcgi://127.0.0.1:9000/var/www/$1
```

This stops all PHP/Hack scripts from being routed through FastCGI, this will allow you to choose which web applications you'd like to send through HHVM. If you're only running a single web application in your web server root, you don't need to do this, but I feel it's a smart move regardless. 

Right now HHVM is running but has no way for scripts to be handed off to it. We need to add the ProxyPassMatch configuration to the Virtual Host Configuration for the web applications we'd like HHVM to power. Add this to each Virtual Host instance in each configuration file (both secure and non-secure traffic covered in the example below.). 

```bash
sudo nano /etc/apache2/sites-available/hhvm.example.com.conf
```

```apacheconf
# HHVM Example - hhvm.example.com

<VirtualHost *:80>

	ServerName hhvm.example.com
    
	DirectoryIndex index.php
	DocumentRoot /var/www/sites/hhvm.example

	ProxyPassMatch ^/(.+\.(hh|php)(/.*)?)$ fcgi://127.0.0.1:9000/var/www/sites/hhvm.example/$1

</VirtualHost>
<VirtualHost *:443>

	ServerName hhvm.example.com
    
	DirectoryIndex index.php
	DocumentRoot /var/www/sites/hhvm.example
	
	SSLEngine On
	SSLCertificateFile 	 /etc/ssl/certs/hhvm.crt
	SSLCertificateKeyFile 	 /etc/ssl/private/hhvm.key
	SSLCACertificateFile  /etc/ssl/certs/hhvm.ca.crt

	ProxyPassMatch ^/(.+\.(hh|php)(/.*)?)$ fcgi://127.0.0.1:9000/var/www/sites/hhvm.example/$1

</VirtualHost>
```

#### *Pro-Tip*
You can also designate another port to explicitly use HHVM if you'd like to quickly A/B test the performance gains. To do this, simply open the port in /etc/apache2/ports.conf

```apacheconf
Listen 8080
```

Then in your Virtual Host configuration, create another instance with the new port specified and add the ProxyPassMatch configuration to the one you'd like to run HHVM on. 

```apacheconf
<VirtualHost *:80>

    ... 

</VirtualHost>
<VirtualHost *:8080>

    ... 

    ProxyPassMatch ^/(.+\.(hh|php)(/.*)?)$ fcgi://127.0.0.1:9000/var/www/$1

</VirtualHost>
```

## Restart Apache and HHVM
Now, we are ready to kick Apache and HHVM in the head. Restart both services...

```bash
sudo service apache2 restart
sudo service hhvm restart
```
The web application should load as you would normally expect, only a bit quicker. 

### *I'm getting 503'd!*
If you jumped over to your web application only to be greeted with a 503 error, this means you just need to fire up the daemon manually this first time or restart. Subsequent restarts will automatically fire this up.
```bash
hhvm --mode daemon -vServer.Type=fastcgi -vServer.Port=9000
```

## Testing
It's not immediately apparent whether your code is being passed through HHVM. There are a few ways to test this. 

### Client-Side
The easiest way to check if HHVM is doing it's thing is to inspect the response headers we get back from our web application. At the bottom of the header list, you will find **X-Powered-By** which should show **HHVM/3.2.0**.

To get to this, you can right click on the page, inspect any element, then click the "Network" tab in the developer tool panel. It will appear to be empty or nearly empty. Refresh the page and it will repopulate fully. Scroll to the top of the list and click the first item, it will be labeled with the domain name (hhvm.example.com in my case). 

### Server-Side
Drop the following into your application root and then access this script. If it returns **PHP**, it's not working. If it returns **HHVM**, you're golden!

```php
<?php 

if (defined('HHVM_VERSION')) {

	echo "HHVM";

} else {

	echo "PHP";

}
```

Install and configure HHVM on an Ubuntu 14.04 Server set up using an Apache Virtual Hosts configuration; run traditional and HHVM-based PHP-powered web applications side-by-side on the same system.

How To: Set Up and Configure HHVM on Ubuntu 14.04

A website can generally be accessed by entering the site's domain directly (domain.com) or by including a leading "www." subdomain. This offers increased usability in that users can enter the site in either way but lowers overall SEO in that web crawlers index both addresses as separate sites and will penalize the site for duplicate content.

This is easily fixed by forcing on or off the "www." subdomain while allowing the users to enter through both addresses. To do this you can modify your .htaccess file in your site's root folder by adding in the following mod_rewrite condition. If you have issues with your permalinks or cache after including this condition, move the snippet to the beginning of the .htaccess file. The codes send a 301 redirect while doing their thing so search engine crawlers know that this is a permanent redirect and to reallocate the pagerank data from the defunct subdomain's pages over to the main domain's matching pages.

__To force site to use "www.": __
```apacheconf
RewriteEngine On RewriteCond %{HTTP_HOST} ^example.com$ [NC] 
RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L]
```

__To force site NOT to use "www.":__ 
```apacheconf
RewriteEngine On RewriteCond %{HTTP_HOST} ^www.example.com$ [NC] 
RewriteRule ^(.*)$ http://example.com/$1 [R=301,L]
```

These two snippets allow for the domain to use other subdomains while forcing the two main domains into either subdomain schema you'd like.The following snippets will force any subdomain that might be inputted into your preferred subdomain schema.

__To force site to use "www.": __
```apacheconf
RewriteEngine On RewriteCond %{HTTP_HOST} !^www.example.com$ [NC] 
RewriteRule ^(.*)$ http://www.example.com/$1 [R=301,L]
```

__To force site NOT to use "www.": __
```apacheconf
RewriteEngine On RewriteCond %{HTTP_HOST} !^example.com$ [NC] 
RewriteRule ^(.*)$ http://example.com/$1 [R=301,L]
```

If you don't have a .htaccess file in your site's root, you can quickly whip one up by opening notepad and saving the file with one of these conditions as ".htaccess" without a file extension. When saving the file, enter the name ".htaccess" and select "All Files" under the save as dropdown and it will save the file without the extension. Once saved, simply place the file in your site's root and the file will immediately begin sending users to the proper domain.

You can test whether the file is working by accessing your site using the opposite address you set your site to default to. If it immediately switches up the subdomain, then everything is working properly. If not, check to make sure the file is saved without an extension (most commonly overlooked error) and the code is exactly as it is above, with your domain replacing niteodesign, of course. If you are still having issues, give your hosting provider a jingle and find out how they go about doing this, as it's pretty important SEO-wise.

People add and remove "www." from URLs like they're optional, so you need to handle both cases. Whatever varition's chosen should send you to the same content as the other but this can lead to content duplication issues. With a few easy edits to your Apache-based site's .htaccess file, you can handle all user and crawler cases ideally.

ʙ ʟ Λ ĸ ᴇ
Good Times in Web Development

how to

How To: Set Up MongoDB on OSX with Homebrew and launchd

Node: Not Found? But I Just Installed It!

How To: Set Up and Configure HHVM on Ubuntu 14.04

How To: Force On/Off "www." Subdomain with .htaccess