Category Archives: Software

Installing and migrating Ubiquity Unifi Controller software

I recently upgraded and expanded the wireless network at the office. We replaced our outdated and failing Linksys WRT54G routers with a set of Ubiquiti Unifi UAP-AC-LITE access points. The process of upgrading the network has been one of the more enjoyable tasks I have been assigned recently and the new wireless system works amazingly well.

This guide outlines installing the Unifi Controller software on an Ubuntu 14.04 server for configuring and managing the access points as well as migration from one controller to another.

Continue reading

Using cron to alert to known error conditions in log file

Recently I’ve been having issues with a VirtualBox machine crashing at random. The only common thread is a line of log file, and so far, google has not been helpful in determining the root cause. This machine is important enough that I need to know when it crashes, but not important enough to actually take the time to fix properly, so I researched and created a command to toss into cron to check the log file for the error line and email me when it finds it.

The command itself is simple. Search the log file with grep, if the search generated results send an email. I tried several iterations of this before finding one that did not email when the search was empty and also did not generate silent errors when empty as well. I run this via cron at 5 minute intervals

To use this command on ubuntu 14.04 you will need to install mailutils and moreutils

Software and versions used or mentioned:
mailutils
mailx
moreutils
ifne

Resources:
Forum post with grep | mailx solution
ServerFault post with ifne solution

Complications of not running SSH on port 22

Traditionally ssh runs on port 22, but that does not mean it has to. Where I work each machine that runs ssh runs it on a different port. I do not know why, but it causes quite a bit of fun when trying to use common ssh based commands that all expect ssh to run on the default port. I have had to figure out more then a few of the workarounds and will share them because I had trouble finding a few of them.

SSH

SSH is easy to connect to a non-standard port, simply use the -p flag followed by the port number. Following is an example:

ssh-copy-id

For those who are not aware, you can create an identity file and copy it to the remote machine to allow you to log in without the need of a password (Link to the guide that taught me). ssh-copy-id assumes that the remote machine is running on port 22 and you have to trick it to change the port. We use the same -p flag as with ssh, but we need to put the whole of the arguments into single quotes for it to work. See the example below:

rsync

rsync has a -e flag for setting which remote shell to use. after the -e flag you put the ssh options like is you were using ssh normally. Be sure to put them inside double quotes or they will get confused with rsync options. See the following example:

scp

SCP is very easy, simply use the -P flag to set the port number, like in the following example:

Updating an iPhone inside VirtualBox

Today at work (I started writing this the same day, but it took a bit longer then I thought to finish), we needed to test a new calendar feature with the various devices our sales reps use.  Android was easy, the entire IT staff have android phones, and most even have an android tablet. iPhone is another matter, no one had an apple device we could test on. Luckily we happened to have a few old iPhone 3 in our storage closet from when we switched phone carriers a few years ago. Unluckily, they were using an old iOS version and no longer activated. Activation and upgrading require iTunes, which runs on Windows, but I sadly run a linux machine. For windows only tasks I run a virtual Windows XP machine in VirtualBox.

VirtualBox can pass USB devices from the host machine to the virtual machine, but doing so requires an extension package. You can download the extension file from Oracle’s website, but there are several versions available. I use VirtualBox v4.1.12. The website says that the 4.1.xxx extension package only works with version 4.1.xxx but it installed properly on my system anyways. You can install extensions from the Preferences panel under File > Preferences (Or Ctrl+G).

VirtualBox Settings

The settings panel for extensions.

Once you have the extension installed, plug in your iPhone. Next, open up the settings panel for your virtual machine and go to the USB tab. Enable the USB controller. You also need to add a new filter for the iPhone. The USB filter will connect the iPhone to the virtual device for you automatically when it is connected. Now we can close the panel and start the virtual machine.

On the right side of the panel are the buttons that allow you to add and remove USB filters

On the right side of the panel are the buttons that allow you to add and remove USB filters

Setting the USB filter for the iPhone

After adding the iPhone filter

With the virtual machine running you can install iTunes and open it up, the iPhone should connect like it would on a physical machine. Once it has finished setting itself up, iTunes should offer any available updates to iOS, let it start the update. About half way through, the update will fail, this is because the iPhone has rebooted into recovery mode, which changes the USB identification. We need to go back to the settings panel and add the recovery mode iPhone to the USB filters.

Setting the USB filter for the recovery mode iPhone

After adding the recovery mode filter

Once that is done, we can manually connect the recovery mode iPhone to the virtual machine to reconnect the iPhone to the virtual machine. This is done by right clicking the USB button at the bottom right of the Virtual Machine and selecting the iPhone from the list. Once this is done iTunes will recognize the troubled iPhone and ask if you want to reset and update it.

Once you select the iPhone, it will have a check in the box to show that it is connected.

Once you select the iPhone, it will have a check in the box to show that it is connected.

At this point iTunes should be able to complete the update. As the iPhone shifts between normal and recovery mode, VirtualBox will use the filters you set earlier to automatically connect the device to the virtual machine, just like if it was a physical box. Once this is done you can remove the USB filters, or leave them as is so you can continue to use iTunes to load music and the like to your iPhone.

Software and versions used:
Oracle’s VirtualBox 4.1.12
Oracle VM VirtualBox Extension Pack 4.1.26
iTunes

Hardware used:
iPhone 3g

Resizing VirtualBox disk images

Recently I had the misfortune of having my windows virtual test machine fill up it’s hard drive. When I had created it, my host system had limited space and I only needed to test things in a windows environment inside a browser, so it got a small hard disk image. One day, while installing a new program, it simply ran out.

I could make a new virtual machine and re-install  but that requires configuration, whereas resizing only takes time.

In command line, navigate to the directory with the troubled system’s hard disk image. Since I had exported and imported this machine when I moved from a desktop to my nice new (to me) laptop my disk image was in vmdk format, but you need a vdi format to resize. So first we convert the disk:

Once cloned, you can resize the vdi you just made. Please note that the size is in MB.

The disk is now resized, but not attached to our virtual machine. I simply edited the virtual machine to point to the resized copy. Alternatively you can convert the image back into vmdk and copy it over the original.

(Don’t forget to delete extraneous copies, these files take up a lot of space)

The virtual machine should now have the new resized attached to it and it should be bootable, but the windows install can still only use the original size. We need to alter the partition to make it use the full disk. For this we need to boot into a live Linux disk with GParted. I used the Ubuntu 12.04 install CD, but GParted also have a live image available if you lack an already downloaded disk. Once you have saved the partition, you can shutdown the live disk and reboot into windows, which now has access to the entire resized hard disk image.

Software and versions used:
Ubuntu 12.04 LTS 64-bit (Xubuntu Desktop)
VirtualBox 4.1.12
Xubuntu Desktop 12.04 LTS Live CD
GParted