AWB Installation

AWB Installation

Following are the instructions for installing AWB and friends from source. If you are running Ubuntu, then you can try the Asim/Awb apt repository instructions.

Note: these are preliminary instructions and need to be improved!

Installation environment

A variety of tools and libraries are needed to install awb. Here are the instructions on how to install them on a few different distributions:

• Ubuntu
• Centos

Awb and Asimcore installation

The following instructions illustrate checking out the HEAD of the subversion tree. To check out a stable versions or other branch substitute trunk/ with branches/, e.g., branches/v11.09.

Check out awb and build

% mkdir ~/awb-install
% cd ~/awb-install

// Turn off SSL verification in git to clone repositories over https.
// This is required to be  done only once till we get a new SSL certificate
% git config --global http.sslverify false

% git clone https://asim.csail.mit.edu/git/awb awb
% cd awb

// create the necessary Makefiles etc.
// Enable Qt4 only if you have Qt4 and PerlQt4 installed
% ./configure --prefix=/usr/local --enable-qt4=yes

(* check for errors, missing dependencies *)

// FIXME: configure script fails to check for libpopt-dev 
// FIXME: configure script fails to check for 'scons' installation
// FIXME: configure script sometimes reports perlqt as missing when its not missing

% make

(* check for errors, again *)

% sudo make install
% sudo make install-src    // this is necessary, not optional!

Build and install asimcore

% cd ~/awb-install

% git clone https://asim.csail.mit.edu/git/asimcore asimcore

% cd asimcore
% ./configure --prefix=/usr/local --enable-qt4=yes
(* check for errors, missing dependencies *)

% make
(* check for errors again *)

% sudo make install
% sudo make install-src

Create and populate a benchmark area

% sudo mkdir /usr/local/share/benchmarks

TBD: Populate the benchmark area

Errata

AWB has some difficulties with network installations of Perl in regards to Qt. In particular,

kfleming@argon5:~/awb-install/asimcore$ awb
perl: symbol lookup error: /usr/lib/perl5/auto/Qt/Qt.so: undefined symbol: Perl_Gthr_key_ptr

can happen if the local version of Perl disagrees with the network version about Perl internal threading options. This happens because AWB hard codes the local perl path, irrespective of the version of Perl it targets (though it does find and use the network version for other purposes). To patch this, edit the asimstarter script:

# system perl library, where Qt.so gets installed
#$perlqt_search_path="/usr/lib/perl5";
$perlqt_search_path="/afs/csail.mit.edu/group/csg/tools_lx86_64/condor/perl/5.10.1/lib/site_perl/";

where the search path above is wherever your network Perl happens to live.

LEAP installation for FPGA designs.

% cd ~/awb-install

% git clone https://asim.csail.mit.edu/git/leap leap

% cd leap
% ./configure --prefix=/usr/local --enable-qt4
(* check for errors, missing dependencies *)

% make
(* check for errors again *)

% sudo make install
% sudo make install-src

% cd ~/awb-install

% git clone https://asim.csail.mit.edu/git/leap-platforms leap-platforms

% cd leap-platforms
% ./configure --prefix=/usr/local
(* check for errors, missing dependencies *)

% make
(* check for errors again *)

% sudo make install
% sudo make install-src


% cd ~/awb-install

% git clone https://asim.csail.mit.edu/git/leap-multifpga leap-multifpga

% cd leap-multifpga
% ./configure --prefix=/usr/local
(* check for errors, missing dependencies *)

% make
(* check for errors again *)

% sudo make install
% sudo make install-src

Next step

The next step is the user’s AWB setup