Skip to main content

Octoblu Part 3 - a how to guide on installing Gateblu on Windows

created by Greg Roll

Welcome to part three of my Octoblu series. In my previous posts I detailed how I used the power of Citrix Octoblu to deliver a treat from your retweet. If you missed them you can find Part 1 here and Part 2 here.

In this post I will guide you through the process to install Gateblu on Windows.

If you haven’t already now is a good time to sign up for the Octoblu Beta for free. Visit https://www.octoblu.com and click ‘Get Started’. Once signed up you will have a demo flow that you can play with.

Once you have an Octoblu account you can import the flow we used for our demo. Just click this link app.octoblu.com/design/import/fc82841a-50e6-49e8-b3c0-7d84563b401f then the import button. This is the flow that I will be detailing in this post.

Install Prerequisites

The following prerequisites must be downloaded and installed before installing Gateblu. Below you will find links to installers for Windows 7-10. For this blog I deployed Gateblu on Windows 10 x64 but the instructions should be similar for other versions of Windows. Ensure your installation of Windows is updated before continuing.

Windows 10

Product

Comments

Download

Windows 10 SDK

Install Windows Software Development Toolkit only

https://dev.windows.com/en-us/downloads/windows-10-sdk

GIT

Select Use GIT from Windows Command Prompt

https://git-scm.com/download/win

Python

Select Windows X86-64 MSI Installer (2.7.3)

http://www.python.org/download/releases/2.7.3#download

Windows 8

Product

Comments

Download

Windows 8 SDK

Install Windows Software Development Toolkit only

https://msdn.microsoft.com/en-us/windows/desktop/ff851942.aspx

GIT

Select Use GIT from Windows Command Prompt

https://git-scm.com/download/win

Python

Select Windows X86-64 MSI Installer (2.7.3)

http://www.python.org/download/releases/2.7.3#download

Windows 7

Product

Comments

Download

Windows 7 SDK

Install Windows Software Development Toolkit only

https://msdn.microsoft.com/en-us/windows/desktop/ff851942.aspx

GIT

Select Use GIT from Windows Command Prompt

https://git-scm.com/download/win

Python

Select Windows X86-64 MSI Installer (2.7.3)

http://www.python.org/download/releases/2.7.3#download

Configure Python

Once Python is installed you need to create a new System Environment variable called PYTHON with a value of c:\Python27\Python.exe.

It is important to note that c:\Python27\Python.exe may not be your install location for Python.exe. Double check this before continuing.

Install Gateblu Service

Download the Gateblu Service files from https://gateblu.octoblu.com/docs/windows

Install the Gateblu service by running GatebluService-win32-x64.msi. Restart if prompted to do so.

Configure Gateblu Service

Now that the Gateblu Service is installed append C:\Program Files (x86)\Octoblu\GatebluService to the System PATH variable.

Note: The path value should be set to C:\Program Files\Octoblu\GatebluService on Windows x86 Operating Systems.

Install Gateblu Frontend

Download the Gateblu Installer from https://gateblu.octoblu.com/docs/windows

Install the Gateblu Frontend by running gateblu-win32-x64.exe. After installation a Gateblu shortcut will appear on your desktop.

Install Gateblu Service Support Files

Now the Gateblu is installed we need to install some support files to enable compilation of Octoblu Things. To do this start an administrative command prompt and run the following command line:

C:\Program Files (x86)\Octoblu\GatebluService\npm” install -g node-gyp

If all goes well you should see an output like the following.

 

Claim Gateblu

We are almost there. Now Gateblu is installed and configured we need to register (or claim) Gateblu with Octoblu. Start Gateblu by double clicking the Gateblu icon on your desktop.

Click Claim Gateblu. Your default browser will be loaded. Login with your Octoblu credentials.

Give your Gateblu a name and click Claim. If you click on Connected Things you should see your Gateblu listed.

If you head back to the Gateblu windows application you should now see your Gateblu name displayed and a window that looks something like this.

It is worth noting that all these products are evolving and by the time you complete these steps your interface may look slightly different.

Add Things

Now that Gateblu is configured and claimed in Octoblu it’s time to add some things. There are two ways to add a Thing to Octoblu.

  1. Browse the Things section within the Octoblu Hamburger Menu (Top Left)

  2. Browse the Things section of the Octoblu Designer (Bottom Right)

In this example I will use the hamburger menu but both methods achieve the same outcome.

Click on the hamburger menu in the top left corner then select Things.

You will now be presented with a large array of Things from a Tesla to Google Drive.

Let’s add two Things; HTTP Connector and Twitter Streaming. You may remember these are the two Things I used for the Lego Lolly Dispenser.

One thing to note, before you can add the Twitter Streaming Thing you need a Twitter Developer account, API and Secret Keys. If you don’t have one head over to https://dev.twitter.com/, sign in with your Twitter account then complete the steps documented here https://dev.twitter.com/oauth/overview/application-owner-access-tokens.

Firstly let’s configure the HTTP Connector. Scroll down to the Octoblu section and click HTTP Connector.

Click Connect HTTP Connector. Now click your Gateblu.

Octoblu will display the following.

If you look at Task Manager of your Gateblu machine you will see a few node.exe applications running. These perform the compilation actions for Gateblu.

After a few minutes your Gateblu Thing will be configured. Don’t be surprised if this takes up to 10 minutes. This will be dependant on your internet connection and available compute. Once everything is installed you will be prompted to give your HTTP Connector a name.

Enter a name and click Save. Octoblu will now return to the Octoblu designer where you will see your new HTTP Connector added to the Things section (bottom right corner).

Now we’ve added the HTTP Connector let’s complete the same process as above but this time with the Twitter Streaming thing. You can find this under the Social section.

Give your Twitter Streaming Thing a name, a search query as well as your Twitter API details and click Save. The searchQuery field can be a keyword or hash tag. For more information about Twitter Streaming head over to https://dev.twitter.com/streaming/overview.

Octoblu will now return to the Octoblu designer where you will see your new Twitter Streaming Thing added to the Things section.

If you imported my Octoblu flow you should now see the Twitter and HTTP Connector things are no longer faded out. Now load your Octoblu Windows application and you will see your two added Things.

Now you know how to add things head back over to the Things section and see what other cool Things you can do with Octoblu. It is important to note currently the ChromeCast thing does not work on Windows. Octoblu is aware of this issue and will hopefully have an update out soon.

Windows Auto logon

One last thing you should do is configure Windows to auto login with the account used to install Gateblu as Gateblu starts only after you login. To do this should be similar for Windows 7 to 10.

Press Windows+R to bring up the Run dialog. Enter (without quotes) “control userpasswords2”.

Select the user you installed Gateblu with and then un-tick Users must enter a user name and password to use this computer.

Click OK then enter your password.

Click OK and you’re good to go. I should note here that you should physically secure the computer running Gateblu and set Windows to lock after 1 minute of inactivity.

I hope you enjoyed this post and it set you on the way to your first Octoblu flow.

To stay up to date with oobe follow us on twitter @oobeaus. You can also follow me @oobegreg.

Back