How to install the AlertMe Perl Interface script.

Prerequisites

The script requires two Perl modules in order to work; the RPC::XML::Client module and the Crypt::SSLeay module. These can be installed using CPAN for your system. You should be able to run AlertMePI on any platform that can run Perl scripts.

UNIX-based systems only at the moment (Linux / OS X), as I've used specific file paths in the script.

Mac OS X

Tested on Mac OS X v10.5.6 - 10.7.2.

• Ensure you have the Apple Developer Tools appropriate to your OS X version installed.
• Install Crypt::SSLeay:

sudo /usr/bin/cpan -i Crypt::SSLeay

• Accept all of the default settings and choose yourself a download server or two from the list. It should download Crypt::SSLeay and install it with no problems.

• Install RPC::XML::Client:

sudo /usr/bin/cpan -i RPC::XML::Client

You should be ready to go.

Installation

This is now automated. All you need to do is download the latest version and set the execute bit on it:

chmod +x alertmepi.pl

Run it from the command line and the first run will prompt you to enter your system password, as it needs to create some files in /etc. It will then prompt you for your AlertMe username and password. These are saved in /etc/alertme and read permission is given to the user that installed it, plus the 'www' group so that it can be used from a web interface. Please change these if you feel you need to.

Should you change your AlertMe login details, you'll need to update your details for alertmepi. This can be done by rerunning the script with the -L flag, which will erase your old details and allow you to enter new ones.

You could optionally create a link to wherever you keep the file in your $PATH to trigger it more directly, eg.

sudo mkdir -p /usr/local/bin

ln -s path/to/alertme.pl /usr/local/bin/alertme

Enjoy!