Step 2c: Install PuTTy.

PuTTy is an open source SSH client for Windows. The Go! environment uses PuTTy to run commands in the Go! virtual appliance. The user may also use PuTTy to open a command shell on the Go! virtual appliance. PuTTY can be installed by running putty-0.60-installer which can be found on the "goembedded" share of the virtual appliance in the Windows_Installs directory. Once installed, a private SSH key for the Windows host needs to be generated, and the public portion of that key needs to be added to the Go! virtual appliance. The key configuration is done as follows.

First open Start->All Programs->PuTTY->PuTTYgen from the Windows start menu. Then for "Type of key to generate", select SSH-2 RSA, and press the "Generate" button, as shown below.


Next, you must save the private key into a file using the "Save private key" button. Before you save the file, at your discretion, enter a passphrase. If you enter a passphrase for the key, then you must run an SSH authentication agent that will automatically provide the passphrase when needed. PuTTy's SSH agent is called Pageant. See PuTTy documentation on how to use Pageant. Some people might find it acceptable to leave the passphrase empty, in which case, Pageant does not need to be running.

Now, we must update the PuTTy saved session for goembedded. To do this, open PuTTY, click on goembedded in the "Saved Sessions" section and press the "Load" button as follows:


Next, in the left hand pane of the "PuTTY Configuration" screen labelled "Category", click on the "+" sign next to "SSH" under "Connection", then click on "Auth". Now, change the private key file in the "Private key file for authentication" prompt to the full path name you selected when you saved the private key file above. In the left hand "Category" pane, press on "Session" (you may have to scroll back up to the top), and change the "Host Name (or IP address)" field to the hostname (or IP address) of your virtual appliance, and press the "Save" button. Note that the ''hostname.local.'' name is a Zeroconf style hostname. Zeroconf has been enabled in the virtual appliance, so the appliance should be accessible using Zeroconf hostnames without having to have your virtual appliance added to a local DNS server. In order for this to work you must have Bonjour for Windows from Apple installed, which is a Windows zeroconf daemon.


Then we must add the public portion of the key to the go user authorized_keys file in the Go! virtual appliance. To do this connect to Usermin with your web browser at https://''IP Address'':20000 (eg. and login as the go user. Then from the left panel menu, select Login->SSH Configuration to display the "SSH Configuration" in the right panel. Then select "Authorized Keys" followed by "Add a new SSH 2 authorized key". Now you can cut and paste the public info, from the PuTTy Key Generator screen into the appropriate fields of the "Add Authorized Key" panel, and press the "Create" button. You will see that there was an existing key defined before you added your new key. You should delete this key, as everyone will know it, and could use it to login to your virtual machine.


After this step is complete, you should be able to login to the Go! virtual appliance without having to enter a password. Test this by starting PuTTY, then load the goembedded save session you just modified, and press the "Open" button. You should ssh login to the virtual appliance without entering a password or userid. This must work in order for Eclipse integration with the virtual appliance to work properly, so you should test this.

Step 2d: Tweak Eclipse Preferences.

There is one default Eclipse preference that will cause us problems when we start new projects. Eclipse default settings will automatically start a project build as soon as we add a new project to Eclipse, and it will try to use the MinGW tools for the build. This will cause problems, because after we add a project, we must customize the Eclipse build to use the virtual appliance as MinGW is installed just for the Eclipse indexing process. So, to turn off automatic building, open Go! Eclipse from Windows Start->All Programs->Go!->Go! Eclipse. Select your workspace directory to get to the main Eclipse screen. Then press Window->Preferences from the Eclipse main menu bar. In the left panel of the "Preferences" screen, press on the small arrow beside "General" to open the General sub-menu, and then click on "Workspace". Uncheck "Build automatically" and, at your discretion, check "Refresh automatically" and "Save automatically before build". Now press the "Ok" button, and close Eclipse.


Step 2e: Install Python and QMTest.

Python is a great scripting language that no embedded device should be without. Thus, the Go! embedded distribution includes Python for the embedded device root file systems. Thus, the python development environment for Windows needs to be installed by executing python-2.6.4.exe and pywin32-214.win32-py2.6.exe from the "goembedded" share of the Go! virtual appliance. The Go! Eclipse IDE already includes the Pydev Python plug-in for your convenience. QMTest is a test case management tool that will assist developers to create and execute test suites on their devices. Run qmtest-2.4.1.win32.exe from the "goembedded" share to install QMTest. Make sure you run the QMTest installer as administrator or it will fail, so in Windows 7, press CTRL and SHIFT, and right click on the executable, then select "Run as administrator".

When you are ready to continue, press the Next link below.

Next >>

Last edited Feb 23, 2010 at 5:51 AM by castone, version 3


No comments yet.