One of the tools we use is Jenkins and whilst we get emails and check the Jenkins Dashboard to see if a build has failed,  developers often have a tendency to not check their emails or check Jenkins to see what the state of the build is… As a result it may be hours or even a few days before someone realises the build is not passing…

So it seemed fitting to write some code to get a LED light to blink if the build is failing. To do this you’ll need the following:

• Jenkins with the build you want to monitor setup
• Arduino (I’m using an Uno)
• A LED (though for test purposes if you’re using an Uno pin 13 has a LED built in which should be sufficient)

1. Wire up your LED to one of the pins or do what I did and use the built in LED on pin 13.
2. Write some code in your language of choice to grab the build status from Jenkins and send it serially to the Arduino. I chose to grab the status as JSON, but there are other options available. I used Java and the Spring Framework to schedule a process to run every 5 seconds to grab the Jenkins status and send it across to the Arduino with the main grunt work being the code below:

   package com.delineneo.processor;
   
   import com.delineneo.communication.SerialCommunicator;
   import org.springframework.beans.factory.annotation.Autowired;
   import org.springframework.scheduling.annotation.Scheduled;
   import org.springframework.stereotype.Component;
   import org.springframework.web.client.RestTemplate;
   
   import java.io.IOException;
   
   import static org.apache.commons.lang.StringUtils.contains;
   
   /**
    * Created by IntelliJ IDEA.
    * User: deline
    * Date: 2/03/12
    * Time: 8:33 PM
    */
   @Component
   public class JenkinsStatusProcessor {
       private static final String JENKINS_URL = "http://localhost:8080/job/JenkinsStatus/api/json" ;
       private static final String SUCCESS_BUILD_COLOR = "blue";
       public static final char BUILD_FAIL = '0';
       public static final char BUILD_SUCCESS = '1';
   
       private RestTemplate restTemplate;
       private SerialCommunicator serialCommunicator;
   
       @Scheduled(fixedDelay=5000)
       public void process() {
   
           String jsonString = restTemplate.getForObject(JENKINS_URL, String.class);
   
           boolean buildSuccess = isBuildSuccessful(jsonString);
           try {
               serialCommunicator.send(buildSuccess ? BUILD_SUCCESS : BUILD_FAIL);
           } catch (IOException e) {
               e.printStackTrace();
           }
       }
   
       private boolean isBuildSuccessful(String jsonString) {
           if (contains(jsonString, SUCCESS_BUILD_COLOR)) {
               return true;
           }
           return false;
       }
   
       @Autowired
       public void setRestTemplate(RestTemplate restTemplate) {
           this.restTemplate = restTemplate;
       }
   
       @Autowired
       public void setSerialCommunicator(SerialCommunicator serialCommunicator) {
           this.serialCommunicator = serialCommunicator;
       }
   }
   

   In the process method we grab the status as JSON using Spring’s RestTemplate then search for the build status colours in the string. Blue represents success and I treat any other colour (yellow and red are the other ones) as a failure. We then send either a ’0′ or ’1′ for fail or success respectively.

   You might wonder why we send a char instead of a boolean… Serial write to the Arduino is as an int or byte array, and on the Arduino side read is done either as an int or a char. For example sending ‘A’ will be received via the Arduino as either the char ‘A’ or the int value 65 (the ascii value). This post on bildr gives you a bit more info on why one might choose to read values as and int instead of a char.

3. Write some code for the Arduino to process the received data and set the LED to flashing if the build has failed. The code below listens on the serial port:

   /* JenkinsStatus will turn the LED at pin 13 on/off depending
    * on the value serially read.
    */
   const int BUILD_SUCCESS = 49;
   int inByte;
   int currentPinValue = 0;
   
   void setup() {
       Serial.begin(9600);
       pinMode(13, OUTPUT);
   }
   
   void loop() {
       if (Serial.available() > 0) {
           inByte = Serial.read();
           if (inByte == BUILD_SUCCESS) {
               digitalWrite(13, LOW);
           } else{
               digitalWrite(13, HIGH);
           }
       } else {
           currentPinValue = digitalRead(13);
           if (currentPinValue == HIGH) {
               delay(1000);
               digitalWrite(13, LOW);
               delay(1000);
               digitalWrite(13, HIGH);
           }
       }
   }
   

   In the loop if there’s data to be read we read it then determine if what state the LED on pin 13 needs to be in. The pin needs to be LOW (i.e. off) if the build is passing and HIGH (on) otherwise. Additionally, if there is no data to be read we want to keep the LED in a flashing state if it was set to HIGH (last read indicated build had failed).

So that’s pretty much the long short of it, the full code is available on my Git repo – https://github.com/deline/JenkinsStatus

Some thoughts on how JenkinsStatus could be improved:

• Allow config of Jenkins details via properties files
• Allow more than one Jenkins job to be monitored
• Put in more LEDs for other states

• House going under contract the night before were to check it out
• Number 1′s still left in the kids potty in the bathroom
• House’s that were in a terrible state – carpet that was frayed and separated, walls that were separating, paint jobs that looked like the person wasn’t even trying (it looked like outdoor paint too!)

Let’s say it’s easily noticeable whether a property being sold is a rental or an owner occupied…

Until yesterday… and woah behold when I came home in the evening no internet. Just the same flashing light sequence I’m more than familiar with. Usual tricks didn’t work and I was dreading having to call Optus tech support… Have you even been asked if you’ve power cycled you’re modem 3 times after you’ve already said yes twice? Not to mention the stuff arounds last time as mentioned above. So when it still didn’t work this morning, it was time to take to Twitter as I knew Optus have an account they they respond to.

Posted on the way to work, and got a reply within a few hours, and after providing a bit more info a guy from the social media team rang me – yes a real person! Turns out there were some issues which they knew about but with no ETA (odd that there network status page didn’t say anything). Anyways he said he’d try to keep my in the loop either via Twitter or ring me, and I got a phone call with an update in the afternoon that the issue had been fixed but there was someone else on my street experiencing the same issue so if it wasn’t fixed when I got home to get in touch. As I don’t get home till after the social media team finish for the day the guy updated the account notes with details in case I had to ring tech support for further help (tech support is offshore). Got home and lucky for me the internet was working again. Was it heat related? Don’t know the real answer but I wouldn’t be surprised if it was. The cables running from the house have to tap to the main line, so extreme heat could cause connector issues with expansion and all of joins.

That all aside, I was very happy with the customer service and give a +1 to Optus for embracing social media. The internet has reinvented the way people work, communicate and share. Businesses need to recognise and embrace these changes/technologies as they’re not going to go away. Operating models change over time and Optus is proving that they can address customer service in ways different from traditional means. Will customer service/support by social media become mainstream? Probably not, but it’s a market they have to catch as increasingly more people turn to the web for their needs (e.g. the whole online shopping debacle).

• There will be no harm in asking
• If you put little effort in a task you can expect very little success
• You will be singled out for promotion
  

So here I present a simple solution in Groovy that uses RegEx and Closures to captalise the first letter of each word in a string. I’ll also show you an even neater solution after….

First up:

String testString = 'the quick brown fox jumped over the lazy dog'
String regex = /\b\w*\s?\b/

testString.eachMatch(regex) { match ->
    print match.capitalize()
}

Lines 1 and 2 should be pretty self explanatory. We’ve based our regex of the basis that a word consists of word characters only, may have a space after the last word character and has a word boundary on either side.

Lines 4-6 is where the cool stuff happens, as for each word match we make we want to upper case the first letter and print it out. The method eachMatch takes two arguments a String regex and a closure. From the Groovy docs – ‘A Groovy Closure is like a “code block” or a method pointer. It is a piece of code that is defined and then executed at a later point.’ In the example above we have defined the closure inline with one parameter match – parameters are listed before the ->. The closure calls capitalize on the match and prints it out.

We could have easily defined the closure separatley and provided it to eachMethod as such:

Closure capitalize = { match -> print match.capitalize() }
testString.eachMatch(regex, capitalize)

Seems pretty easy right? Not many lines of code and quite succinct about what is happening. Well as is often the case, I did a little Google and here’s an even easier solution:

String testString = 'the quick brown fox jumped over the lazy dog'
print testString.split(' ').collect{ it.capitalize() }.join(' ')

In the end my solution was a first attempt into using Groovy to solve a problem without having much exposure to the language whilst at the same time trying not to use my Java mindset. After seeing the alternative solution on the Internet it kind of shows that if you know what to use Groovy can make things even simpler as it’s definitely cleaner without using the RegEx.

The first step though was to get Groovy installed on my Mac. So I thought I’d put a post up mainly for anyone new to developing on a Mac. Whilst I’ve had my Mac for a year or so, I hadn’t really had it setup for anything other than Java until recently, and there were definitely some things that were a little different to what I was used to on Windows as well from my prior limited stint in Ubuntu land.

These instructions are based on a setup for OS X. I’d imagine the setup may be similar on any other version?

1. Java should already be installed on your machine. Confirm this by opening up a Terminal and typing in ‘java -version‘.
2. Download the binary Zip release of Groovy from the Groovy site.
3. Extract the contents into /usr/local – e.g. my install location is /usr/local/groovy-1.7.6/. You will probably need to need to use the sudo command for the extract as you will need to be superuser to write to the location.
4. Check if a file called environment.plist exists in the following location /Users/YOUR_USER_NAME/.MacOSX. If it doesn’t create it.
5. Open environment.plist in the Property List Editor
6. Add an entry for JAVA_HOME if not present, ensure the value is the location of your Java installation. This should be /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home
7. Add an entry for GROOVY_HOME if not present and ensure the value is the location Groovy is installed. E.g. /usr/local/groovy-1.7.6
8. Add an entry for PATH if not present, and ensure the Groovy bin and Java bin directories are present by adding  $JAVA_HOME:$GROOVY_HOME/bin
9. Log out and re log back in for the changes to take effect.
10. Check that everything is all setup correctly by opening a Terminal and running groovy -version which should show you which version of Groovy is installed.

Seemingly the internet is against what Mr Harvey is saying, the term ‘Dear Gerry Harvey‘ even making one of the top local trends for Twitter and I actually agree with the majority in this respect. Sure I do shop online (internationally and locally), but I also do shop in traditional bricks and mortar stores as well.

What makes me shop online? It’s definitely not because I don’t have to pay GST on my international purchases. In fact I couldn’t really care less if the GST was slapped onto my international purchases as it wouldn’t have played much of a difference in the end anyway. The reasons I shop online are pretty straightforward:

• Price is significantly cheaper. And by this I mean an amount big enough to make it worthwhile. If this is the only factor in the purchase, GST plays little part, as tacking on 10% for the import is going to make little difference if anything. E.g. 10% of $1000 is $100, but if you’re saving 50%, you’re still $400 better off. If the end saving is only a small margin say $100 or less (in the case of international purchases), I often will just end up buying it from a local retailer, as it’s too much effort with shipping, delivery, extra charges etc.
• Product range. Let’s face it most of the goods stocked by retailers in Australia don’t cover a wide range. E.g. walk into any brand name technology retailer and they most likely won’t have the most recent products on display/sale, or with clothing try finding petite sized clothing in Australia, again a limited range.
• Customer service. I choose to avoid certain stores where I can because customer service is poor or missing. Lack of staff to help with purchases, staff who don’t know what they’re trying to sell, staff who just want their commission. E.g. I was in a major sport retailer in the past year needing to buy some soccer gear. I checked the product out myself, picked my size myself then a staff member comes over asking if I need help. I decline and let them know I’m okay as I’ve already worked out what size was right. They then proceed to stick their ‘sticker’ on the box, so when I purchase the sale gets credited to them (even though they clearly did not help me in deciding on my purchase).
• Convenience. Why would I go to a physical store if I know exactly what I want and can buy it online and get it delivered in the next 1-2 days? This is especially true if any of the above listed factors also apply. And this is not just for international purchases, as I’ve purchased from local retailers online before mainly because of the price and product range factors. And let’s bear in mind that I do pay GST for these purchases.

And whilst I have listed the above factors for online shopping I do have experiences where I have chosen to go to a physical retailer/store because my past experiences were positive. Sure I may be paying a little more in the end, but I leave a happy customer and the experience was better than had I done it online.

I think the big retailers need to reassess their operating model and the market they are operating in today. It’s vastly different to 10 years ago with the uptake and advent of technology. And it’s not not possible as there are many local retailers out there (some even with physical stores), who are surviving and have got my business if I need to look for a certain product. They’ve served me well each time, so why would I change and spend my time hunting across Sydney for a particular product?

And let’s face it, it’s not just online shopping that is taking a chunk of the big retailers customer base. Pick any digital camera on sale at a big retailer in the Sydney CBD. Go to all the major retailers in the CBD area (between Town Hall and Circular Quay), and check their prices. Now go visit all the other stores in the same area that sell digital cameras. I guarantee you will find a better deal in an actual store for either a newer or the same model.

The general gist of things has you defining a series of channels of which the endpoint may be the entry or exit to the system. One endpoint may be the entry point to another channel. E.g. in the following A<——–>B is a channel with A as the input and B as the output endpoints. B<——–>C is another channel where the output B from the A<——–>B channel is the input and C the output.

A<——–>B<——–>C

To really see how it all hangs together I’ve knocked together a little working example to integrate with Twitter using the built in Twitter Adapter. The app basically polls Twitter with a search on a hashtag, adds a field to the header then passes the message on to a service to be dealt with – in this case we are just going to print out to System.out. Sounds complicating, but Spring makes it easy – take a look at src/main/resources/twitter-integration.xml.

<channel id="inboundMentionsChannel"/>
<channel id="inputServiceActivatorChannel"/>

This defines the channels, note that we haven’t actually specified what the endpoints are yet…

 <twitter:search-inbound-channel-adapter query="#springintegration" channel="inboundMentionsChannel">
 <poller fixed-rate="5000" max-messages-per-poll="3"/>
 </twitter:search-inbound-channel-adapter>

 <header-enricher input-channel="inboundMentionsChannel" output-channel="inputServiceActivatorChannel">
 <header name="headerField1" value="dummy header value"/>
 </header-enricher>

This is the interesting stuff where we link all the endpoints and channels together. Lines 1-3 define the inbound adapter (endpoint) which connects the system with Twitter. This is a search-inbound-adapter that polls for a twitter search using the specified query – in this case the hashtag #springintegration.

Lines 4-7 defines a header enricher. This allows us to pop values into the message header that can be used downstream. For this example we’re just populating a field called ‘headerField1′ with a dummy value. We’re not actually going to use this field for anything in the example but I wanted to show how easy it was to add info to the message header. The header enricher also has an input channel and output channel specified. As you may have worked out the input to the header enricher is from the endpoint of the ‘inboundMentionsChannel’, which in this case will contain the results from the Twitter search. And the outbound channel is to a service activator which references the TwitterService bean (bean is autowired).

If you take a look at TwitterService.java you’ll see that it prints out to System.out and adds the tweet to a list. Running the test case TwitterIntegrationTest.java you can check that the output matches the expected tweet search result count of 3.

twitter-integration.zip

I’d put off the migration for ages as there is no quick and easy way to migrate from Drupal to WordPress. You have no choice but to run SQL commands. On top of that I still had my original WordPress blog that I wanted to ‘keep’. I’d never bothered to migrate these into my Drupal site, but now I was going back to WordPress I wanted them all in the same site.

So for anyone on the web thinking of making the move back (or to)… here are the steps that I followed… Do make sure you take a backup of your database before hand though, as whilst these steps seemed to work successfully for me, they may not necessarily work for everyone. Hence take these steps as a guide only…

1. Take a look at Convert – Import A Drupal 6 Based Website To WordPress v2.7 and follow the instructions there. Some differences for my setup is that I installed WordPress (Version 3.0.3) instead and didn’t bother to delete the Drupal tables as I was going to get my data back into Prod a different way.
2. Check your development WordPress install and ensure it looks right
3. OPTIONAL STEP: If you have a previous WordPress site that you want to keep content from as well, use the Export function in the previous install to download a WordPress export file. Import this into your new WordPress site using the Import function.
4. On your development WordPress use the Export function to download a WordPress export file. This export files will contain all the data you want to use in your new site. E.g. in my case this was all my Drupal content plus the content from my original WordPress site.
5. Install WordPress to your Production server
6. Use the Import functionality to import the export file you downloaded in Step 4.
7. Check that your Production WordPress looks correct.