AWB example setup GUI

AWB workspace setup using GUI-based tools

All manipulations of a project using the awb tools are done in the context of a workspace. The GUI tool for manipulating an awb worksapce is awb.

Setting up a workspace

First start awb.

% awb

You will probably see the following message about using a default workspace. This is fine, because you haven’t yet created a workspace.

Warning: No valid workspace found!!!
         Check the value of $AWBLOCAL and your ~/.asimrc file
         A default value of /usr/local/etc/asim/ws/HEAD is being used.

Now go to the Admin tab (the tab furthest to the right).

The first text box in the Workspace region contains the directory that contains your workspaces.

• Use the ‘Browse’ button to select the directory to hold your workspaces. In the browse dialog you can create a new directory to hold your workspaces. This is not necessary, but for this example we have created a directory called workspaces to hold our AWB workspaces.

• Then type in the name for a new workspace in the second text box (demo in the example) and click ‘Create’.

• Then click ‘OK’ in the log window.

Populating a workspace

You now should be in the demo workspace (as shown below) and in the Repositories region you can, in sequence, select the ‘leap’ and ‘platforms’ packages and click ‘Checkout’ and then ‘OK’ in the log dialog.

Note: Unfortunately, awb is currently unable to accept an SSL certificate directly (see bug #15), so if your runlog shows a message about an invalid SSL certificate please use a command shell and type the following svn command and type p in answer to the question. Then try the checkout again:

 % svn co https://asim.csail.mit.edu/svn/awb /dev/null
Error validating server certificate for 'https://asim.csail.mit.edu:443':
 - The certificate is not issued by a trusted authority. Use the
   fingerprint to validate the certificate manually!
 - The certificate hostname does not match.
Certificate information:
 - Hostname: CSG
 - Valid: from Tue, 02 Dec 2008 21:59:30 GMT until Wed, 02 Dec 2009 21:59:30 GMT
 - Issuer: CSG, MIT, Cambridge, Massachusetts, US
 - Fingerprint: f9:1c:0f:89:ee:74:fe:2f:f1:0a:ba:e2:0f:ba:71:4e:92:e0:5e:8b
(R)eject, accept (t)emporarily or accept (p)ermanently? p
svn: '/dev/null' already exists and is not a directory

Given your newly populated workspace, you can now go through the sequence to build and run a design either using the command line or GUI.

Using and updating a workspace

To use this workspace in the future you should cd into it, e.g.,

% cd ~/workspaces/demo

After cd’ing into the workspace, awb commands such as awb or awb-shell will operate on the contents of this workspace.

Occasionally, you should use the awb command and return this Admin dialog and in the Packages region you should select Update and click ‘Execute’ to update the contents of your packages to the latest checked in versions.

Next steps

You can now look at the examples of how to build and run a design using the command line or GUI.

Note: You can also do this initial workspace setup using the command line.