AWB upgrade

AWB upgrade

Over the years the functionality of Architect’s Workbench (AWB) and Asim
(the simulator) have been entwined. We’ve decided to begin the process
of dis-entangling these two projects. Our new position is that AWB is a
generally-useful code configuration utility, and Asim is an example of
an application which uses it.

To begin this process we’ve decided to separate the “asimcore” SVN
repository into “asimcore” and “awb”. awb will be the basic
functionality, whereas asimcore will continue to exist for
performance-modeling specific code.

The first change you will notice is that “asim-shell” is now called
“awb-shell”, it being the shell equivalent of the AWB GUI.

Those of you who have AWB installed will have to take some actions for
this upgrade to go smoothly. The first is to check out the “awb”
repository and install it, over-writing your current installation.

If you do this now, then when we make further changes your installation
will continue to work. Thanks for your patience with this process and
please feel free to contact me with any questions.

There are two ways to do proceed:

Method using AWB
-——————-

If your installation of AWB is still working you can use this method.

1. Put the attached awb.pack file into ~/.asim/repositories.d (you may
   have to create this directory)
2. enter asim-shell
3. do “list repositories”. If you see “awb” listed then you can continue to
   use this method, otherwise use the method below.
4. do “checkout package awb” and exit asim-shell
5. cd /src/awb
6. Do “make install ; make install-src”
7. If the upgrade has completed successfully then you should be able to
   run “awb-shell”. Functionality should be the same as the current asim-shell.
8. Upgrade your asimcore by doing “checkout package asimcore”

If this method does not work for you, try the following:

Method using SVN
-——————-

1. Do “svn checkout https://asim.csail.mit.edu/svn/awb/trunk awb-install”
2. cd awb-install
3. do “./configure —prefix=” where is
   where you want awb installed.
4. do “make ; make install ; make install-src”
5. If the upgrade has completed successfully then you should be able to
   run “awb-shell”. Functionality should be the same as the current asim-shell.
6. Confirm that awb-shell works as follows:
7. awb-shell new workspace test-workspace
8. cd test-workspace
9. awb-shell checkout package asimcore
10. If this allows you to checkout asimcore then your installation is working.

Upgrading workspaces
-————————-

You also will need to upgrade your all existing workspaces. You should
be able to do this by entering awb-shell in each workspace and answering
‘yes’ to the question it asks or by manually checking out awb. If awb-shell won’t
start in the workspace, then you’ll need to manually svn update the
asimcore directory by doing the following:

% cd <workspace>/src/asimcore
% svn update
% ./configure
% make

In the next phase of this conversion, duplicate tools in asimcore will
be removed. If you have workspaces that haven’t been upgraded, then a
manual edit of the awb.config file will be needed.