Beaglebone Black : Cloud9 and Bonescript Install Guide


beagleIn my previous post about installing the GateOne terminal emulator, I mentioned that I wanted to replicate the experience and features for the OOTB Beaglebone image of Angstrom only on Ubuntu.  Well, I’m getting a little closer day by day.  This post was originally intended to be the installation of Cloud9 but as I was reviewing my notes, I decided to try getting Bonescript installed as well.  Both installations are contained in this guide.

Since I am fairly new to the BBB, I haven’t spent much time with Cloud9 or Bonescript. I was initially attracted to it because of its power to size ratio and that Ubuntu was an option.  However, I am planning to do some maker projects with the BBB, so I will get to test my handiwork.  Just understand that even though I got them running, I have yet to extensively test them.

Like with WiFi, a lot of people have struggled with getting Cloud9 running and I am no different.  Others mentioned and blogged about their successes but I was unable to replicate their success.  However, I will include the links to a couple blogs where I gathered information and inspiration.  I hope that this method works for you.  Let’s get started.

NOTE:  We will be removing the current version of Node from this instance, so if you have any dependencies on the current installation, you may wish to think twice before you proceed.

Installing the Prerequisites

First, we need to prepare our system for the install.

sudo apt-get install -y build-essential g++ curl libssl-dev apache2-utils git libxml2-dev

Also, we will need to remove node.js if it exists:

sudo apt-get remove nodejs

One of the blogs I used (Sam’s Site) indicated that downloading NVM (Node Version nodejs-logoManager) but I wasn’t able to get this to build correctly.  So I downloaded the latest version of Node and attempted to build it but it didn’t work either.  So, I split the difference between the minimum (v.0.6.16) and the latest (v.0.10.18) and settled with v.0.8.25.  I found it on the nodejs distribution page. I unpacked it, navigated into directory created, and then ran this sequence.  A word of caution: The ‘make’ step takes a while.  I literally burned hours compiling node on the BBB while I was working out which version would work.

./configure
make
sudo make install

After the install completed, rebooted the BBB and then when it came back, I ran the command:

node --version

and the return was:

v0.8.25

Now, that node was installed, I cloned the Cloud9 repository (repo) from here:

https://github.com/ajaxorg/cloud9/

I'm on Cloud9

I’m on Cloud9

I attempted the install instructions by changing directories to Cloud9 then executing:

npm install

This resulted in a miserable failure.  However, since with the node installation came the npm (node package manager), I thought there might be a Cloud9 package and sure enough, there was. So I changed to my home directory and altered my command to:

sudo npm install Cloud9

This actually worked.  However, I was trying a bunch of stuff and it all kind of got messy and I had 3 Cloud9.sh files.  I found them by typing in:

whereis cloud9.sh

The one I was looking for was under ~/node_modules/cloud9. I changed directories to this directory and then executed:

./cloud9.sh

The resulted in the application actually starting, much to my surprise.  However, when I navigate to the site (ex. http://bbb.local:3131), nothing came up.  After going back to the Cloud9 repo page on github, I found the configuration under the Installation and Usage section.  Adding the -l hostname flag will allow you to specify what machine can access the IDE.  You can use a wildcard and allow any machine to access the IDE, like so:

./cloud9.sh -l 0.0.0.0

Going back to my browser and navigating to the BBB on port 3131, The IDE finally came up.  Allowing any workstation to access the IDE can be risky.  You can add some additional security by specifying a username and password:

cloud9.sh -l 0.0.0.0 --username test --password test2

When you open the web page, you will be challenged with a basic auth login modal.

Keep in mind, we are working on a Beaglebone Black, not an NSA network.  However, good security should always be considered.  As with the GateOne app, this one is rather new to me but when I start it up, I see the file structure of my Cloud9 folder.  I will need to figure out how to fine-tune this.

Finally, as promised, the installation of Bonescript was bloody easy.  Change your current directory to your Cloud9 folder and enter:

npm install bonescript

…and shortly, bonescript will be installed as well.  I am not going to explore the configuration or usage of bonescript yet because I simply haven’t used it yet but at least it didn’t blow up in my face when I installed it.

Bonus Round

I did some tidying up to release some space that was taken up from the install process. First I copied the the node folder from my home folder to /opt.  Next, I copied the cloud9 folder from ~/node_modules to /opt.  Then I removed the node, node_modules, tmp, and cloud9 folder from him home folder.  This released more than half of my previously free space.  What I learned here is that if you don’t  plan to use these tools, don’t bother to install them.  They use up precious space and are a bit slow.

I have yet to add cloud9 to my startup process but that shouldn’t be too difficult.  I already have a script that is kicked off from a cron job using the @reboot trick I mentioned in the Ubuntu Guide.  I will simply add this to it.

I hope that if you use the Cloud9 on the Angstrom image and are looking to moving to Ubuntu, you don’t hesitate because of this process.  I found it challenging but I learned about NodeJS, NVM, NPM, and the build/install process which I have not had much experience with before.  It’s fun and a great way to get to know your Beaglebone.  Best of all, if it fails miserably, you can always reimage and go back to the OOTB image anytime.

Let me know if you have any questions or if you discover some neat trick that expands this.  I would love to know more and to hear from you.

Related links:

http://beagleboard.org/Support/bone101/#cloud9

https://c9.io/site/features/

http://www.samclarke.com/2012/07/how-to-install-cloud-9-ide-on-ubuntu-12-04-lts-precise-pangolin/

http://www.alexvictorchan.com/2013/06/19/setting-up-cloud9-locally-on-a-chromebook-pixel-or-any-debian-system/

https://github.com/ajaxorg/cloud9

http://nodejs.org/dist/v0.8.25/

http://nodejs.org/dist/

https://www.google.com/search?q=install+bonescript&oq=bonescript+install+&aqs=chrome.1.69i57j0.6033j0&sourceid=chrome&ie=UTF-8 (Google search resulting in a log of crying and nashing of teeth)

https://npmjs.org/package/bonescript

Advertisements

Beaglebone Black : Cloud9 Running under Ubuntu


I'm on Cloud9

I’m on Cloud9

This is just an update that I have Cloud9 running under Ubuntu on the BBB.  I have had, until recently, no end of trouble getting this working but it’s done.  I am shoring up my notes and I have a few other things to tighten up to get this guide out to you but my goal is to have it up this evening.

UPDATE: It’s done!  Check it out HERE

Beaglebone Black: GateOne Terminal on Ubuntu


ls_logo

Liftoff GateOne on the BeagleBone Black with Ubuntu

If you have been following my series about installing Ubuntu on Beaglebone Black, you might have wondered about some of the stock tools like Cloud9 IDE (an installation guide coming soon) and GateOne that aren’t on the Ubuntu image.  This post will help you to get GateOne installed.

Just a word of caution:  This guide discusses the technical steps in getting the GateOne Terminal Emulator on your BBB.  It does not go into details as to how to configure it, specifically security.  If you attempt to do this, please be aware of the potential security risks involved.

After my last few posts, I was planning to start on the Adafruit.com IO Python Library but I began to think of the other tools that make BBB easy to use out of the box.  The two things that I recall from my first impression experience was the Cloud9 IDE and GateOne Terminal Emulator.  I wanted to at least have the option of these tools.  GateOne has a ton of options that allows you to configure it for just about any need.  Since it’s an OOTB offering with the default Angstrom distro, I figured I would be able to get it running on my Ubuntu install as well.  It’s really easy to do:

You may find it helpful to review the Installation instructions prior to getting started.  When all else fails, RTFM.  Here’s the link:  http://liftoff.github.io/GateOne/About/index.html#installation

We need to do some prep to get ready for the installation.  You will need the following:

  • GIT
  • PIP
  • Python Tornado
  • Source Code for GateOne

Note: Since the BBB is not the never-ending well of space, you should be ever-mindful of how much stuff costs (size) before installing it.  I will discuss some commands to help clean-up previous installs using apt-get later.

Time to get the Beagle Ready

We don’t need to configure git after installation to retrieve the source but if you use git, you should.  Here’s a link for Configuring GIT but it’s optional for this guide. In your BBB terminal, type:

sudo apt-get install git

After this installs, you will be able to download source code from GIT repositories.

Next, we need to install PIP.  PIP is a Python package management app, similar to ‘apt-get.’  We will need this to install Tornado.  Tornado is essentially a Python web server.  To get this installed, we need to install PIP:

sudo apt-get install python-pip

Yay! Now that we’re done with that, let’s get Tornado installed:

sudo pip install tornado

Download and Install GateOne

Now that we have our house in order, we can get busy.  There’s a bunch of ways to get the source, but I found that this is the easiest:  We can clone the code right to your home directory because the install process will put the final product in the /opt directory.

First change to your home directory then clone the code with this command:

git clone https://github.com/liftoff/GateOne.git

This will put a folder called ‘gateone’ in your home directory.  Now let’s get inside this folder and install this puppy:

sudo python setup.py install

Now we will wait for a bit.  There’s a lot happening.  It seemed to take about 5 minutes but I was dodging baby bottles and Wii remotes at the time.

When this is done, you should be ready to give it a try.  Change your directory to /opt/gateone then execute this command:

sudo ./gateone.py

A bunch of feedback it going to dump to the terminal.  If you don;t see red, you should be good.  Give a close look for any error messages.  If all looks good, then it’s time to try it for a spin.  Quick note:  You won’t be able to use it yet but we want to see if it works.  Open up your favorite web browser on a computer on the same network and enter the address:

https://<your BBB IP or BBB hostname>

You should see the familiar charcoal screen.  It’s going to start yelling at you about not having permissions and what not.  We’re about to fix that.  Go back to the terminal and stop the service (ctrl+c).  The problem is that the app has not been given permission to allow your workstation access.  To do this we will add a parameter “–origins=*”  Also, you can add an extra layer of security by specifying a layer of authorization, you can use kerberos, google, or none.  I gave Google a try and it sorta worked but we’ll skip that for now.  First, here’s the command:

sudo ./gateone.py --origins=* --auth=none

Head back to your browser and go to the same address.  You might get an error but just refresh the page and you should see the login prompt.  I tooled around and it seems to work exactly the same as a regular ssh session.  Let’s take look at the Google authorization.   You are going to need a Google account for this.

Stop the app and change the auth parameter like this:

sudo ./gateone.py --origins=* --auth=google

When you go to the page this time, you will instantly be redirected to Google to log in and/or authorize the app.  Do so and you should be redirected back to your GateOne interface.  In my case, it didn’t happen.  I just refreshed and since I authorized, it presented me with the GateOne Login interface.

So, my initial impression was it was really easy to install and give me yet another tool to leverage with the BBB.  This was a quick and dirty install and I look forward to exploring the many options with tool.  I’ll be sure to post my findings here when I find something cool or useful.

I mentioned that I would talk about drive space management using apt-get.  Well, I’m running out of steam but I will say quickly that you can safely delete the source files from the git branch we downloaded to the home folder.  I’ll put up something on apt-get shortly but in the meantime, you can do some reading here:

https://help.ubuntu.com/community/AptGet/Howto#Maintenance_commands

This guide applys to all versions of supported Ubuntu and this link starts you at maintenance.  Keep scrolling down to the removal section.  If you’re nutty or curious, read the whole bloody thing.  🙂

UPDATE:  I found a simple way to start up the gateone.py script on boot.  First, you will need to modify the /opt/gateone/settings/10server.conf file to add/modify the two parameters that we added when running the script manually.  Here’s what they look like:

"auth":"google",
"origins": "*",

Save that and test it with:

sudo ./gateone.py

If everything is good, then run this command I found in the INSTALL.txt, found in the source files folder (remember me saying RTFM?  It applies to me too):

update-rc.d gateone defaults


Here are a couple links for the install files and instructions:

https://github.com/liftoff/GateOne

http://liftoff.github.io/GateOne/About/index.html#installation

https://help.ubuntu.com/community/AptGet/Howto#Maintenance_commands

Software Development Toolbox


Shortly, I will be doing a series of posts for people who want to get a start in building their own web sites but don’t know where to start. This will be aimed towards beginners and non-technical individuals to get you started in creating a web presence. If you have any suggestions for types of technologies you would like to see, please drop me a note