Building BlackTie

The following instructions indicate how to build the Blacktie components from source. They assume that you are building on one of the following platforms:

• Centos 5.4 64 bit (centosx64)
• Centos 5.5 32 bit (centos55x32)
• Visual C++ 9 32 bit (vc9x32) [Windows XP/2003/2008]

If you are not on one of these platforms, or are building from source, you will need to following the instructions on Building Thirdparty Dependencies. NOTE: Linux users should be fine with one of the CentOS varients even if they are using a newer distribution. SunOS build instructions are in a separate article.

Download build tools

ALL PLATFORMS

1. Download Sun Java SE Development Kit 1.6.0 and ensure the bin folder is in the path: http://java.sun.com/javase/downloads/index.jsp

WINDOWS ONLY

Install Visual C++ 2008 Express Edition (0nly used to provide the compiler and linker on Windows)

The PATH environment variable will need the runtime DLLs in it

C:\Program Files\Microsoft Visual Studio 9.0\VC\redist\Debug_NonRedist\x86\Microsoft.VC90.DebugCRT

The PATH environment variable will also need the VC++ tools in it, do this by executing:

C:\Program Files\Microsoft Visual Studio 9.0\VC\vcvarsall.bat

LINUX ONLY (optional)

Install Valgrind as per the instructions at: http://community.jboss.org/wiki/ MemoryLeaksCheckwithValgrind

You will need to install the gcc-c++ packages: yum install gcc-c++

Build product

Change directory to a location where you would like to check out BlackTie, the folder that you check out will then be referred to as <BLACKTIE_HOME>:

ANON ACCESS

• git clone git://github.com/jbosstm/blacktie.git
• cd blacktie
• git checkout -t origin/<LATEST_TAG>

COMMITTER SVN ACCESS

• git clone git@github.com:jbosstm/blacktie.git

IMPORTANT NOTE: bpa

The build uses a special user defined flag -Dbpa=<PLAT_ARCH>, the value of this parameter is intended to be a readily understandable representation of your platform and architecture. We currently use the following values: centos54x64 (Linux 64 bit), centos55x32 (Linux 32 bit), vc9x32 (Windows 32 bit). You are free to use any value you like, but it must be used for all builds and must match that of the available third party dependencies (from either repository.jboss.org if possible, or built if necessary).

To build

To build with running tests:

1. Change directory into <BLACKTIE_HOME>
2. Ensure JAVA_HOME is set to the JDK install directory
3. Run the JBoss AS server as can be configured for BlackTie by following the instructions at: Deploying BlackTie (DO NOT DEPLOY blacktie-admin-services or stompconnectservice)
4. ./build.[sh|bat] install [-Dbpa=<PLAT_ARCH>] [-Duse.valgrind=true|false] (If you are on Linux and do not want to run the tests under valgrind please supply the -Duse.valgrind=false command line parameter to maven)

Verify the build

To check that the build is successful, you can run the samples which can be found in the binaries (which come from */src/example and examples). Instructions on how to get the examples running from a binary can be found at: Deploying Blacktie