HouseMon 0.9.x on OS/X Mavericks (Binary Installation)

In prior posts I covered a binary installation of HouseMon 0.9.x on Linux and HouseMon 0.9.0 on windows. In this post we will do a similar installation, but for Mac OS/X.
I will be installing on OS/X 64bit Mavericks.

Like the prior installs, I’ll try and use as many standard tools as possible whilst keeping the installation steps all similar across all the os’s.

OS/X does not come with wget installed by default, but the standard curl of Mountain Lion / Mavericks will suffice.

OK, we can now properly begin.

A Simple Binary Installation

We are going to do the following:
* Grab the latest Housemon + support files and install them beneath your home folder.
* Grab an appropriate binary file for your platform and install it in Housemon.
* run Housemon

This will mean you should not have to build anything and it should work out of the box.

Open a shell prompt, and change to your home folder:

$ cd ~

Backup any master.zip that may be present

$
$ # dont worry about missing file
$ mv master.zip master.zip.bak 

Next we fetch the latest housemon files from github. We dont need the source code, just the website and config files but we will keep it all together for simplicity’s sake.

$ curl -L -J -O "https://github.com/jcw/housemon/archive/master.zip"

Now we will unzip, creating a housemon-master folder. Again, we use unzip because its supplied by default.

$ unzip housemon-master.zip

We will create a specific Housemon folder, and copy files into it, we could rename the housemon-master we just created, but its good as a backup source.

$ mkdir housemon
$ cp -r housemon-master/* housemon

Remove the housemon master.zip file.

$ rm housemon-master.zip

Get the associated jeebus files.

$ curl -L -J -O "https://github.com/jcw/jeebus/archive/master.zip"

Unzip to create a jeebus-master folder:

$ unzip jeebus-master.zip

Again, will create a specific Jeebus folder, and copy files into it, we could rename the jeebus-master we just created, but its good as a backup source.

$ mkdir jeebus
$ cp -r jeebus-master/* jeebus

Remove the jeebus .zip file:

$ rm jeebus-master.zip

Lastly we will download the appropriate ready built binary for our os/platform. These instructions are for a os/x 64bit intel o/s, so we will
be downloading the darwin_amd64 binary. Use the appropriate link for your platform:

I’ll be providing these binary (tutorial) builds via bintray.com:

$ curl -L -J -O "http://dl.bintray.com/thedistractor/HouseMon/darwin_amd64/housemon-chocolate"

Finally, we rename the file we just downloaded and put it into our newly created housemon folder:

$ mv `find . -maxdepth 1 -type f -name 'housemon-*'` ./housemon/housemon 
$ chmod +x housemon/housemon

Note: A default housemon installation will only bind to localhost, so if your on a headless device (without a GUI), you will not be able to access the housemon http interface remotely. To resolve this create a config.txt in the housemon folder as follows:

$ echo "HTTP_PORT = 0.0.0.0:5561" > ~/housemon/config.txt

Change into the housemon folder and run:

$ cd housemon
$ ./housemon

You will now be able to access your device remotely using the url http://your.device.ip.address:5561/

NB:If you want to tell what version you are using, use -h flag:

./housemon -h

You should see something like:

HouseMon (0.9.1-jcw.chocolate+b001) + JeeBus (0.9.0) + Flow (0.4.0) 2014-05-17T11:35:35+01:00

In this default configuration, housemon will simply replay a sample file, collect and process this data and present the information within the ‘readings’ page on the web interface.

Here is the full bash script (with some bits commented out – tweak as needed):

#!/use/bin/bash
cd ~
#dont worry about missing file
mv master.zip master.zip.bak 
curl -L -J -O "https://github.com/jcw/housemon/archive/master.zip"
unzip housemon-master.zip
mkdir housemon
cp -r housemon-master/* housemon
rm housemon-master.zip
curl -L -J -O "https://github.com/jcw/jeebus/archive/master.zip"
unzip jeebus-master.zip
mkdir jeebus
cp -r jeebus-master/* jeebus
rm jeebus-master.zip
#replace the next line with the appropriate download link for your platform.
curl -L -J -O "http://dl.bintray.com/thedistractor/HouseMon/darwin_amd64/housemon-chocolate"
mv `find . -maxdepth 1 -type f -name 'housemon-*'` ./housemon/housemon 
chmod +x housemon/housemon
echo "HTTP_PORT = 0.0.0.0:5561" > ~/housemon/config.txt
#cd housemon
#./housemon
Advertisements
Posted in housemon, housemon tutorials

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: