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
$ rm housemon-master.zip
Get the associated
$ curl -L -J -O "https://github.com/jcw/jeebus/archive/master.zip"
Unzip to create a
$ 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"
- Mac OSX (32bit)
- Mac OSX (64bit)
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
NB:If you want to tell what version you are using, use
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