This installation guide provides information on,
This document describes the distribution packages available in WSO2 Business Activity Monitor - the binary distribution and the source distribution for more advanced users. It is followed by simple instructions on how to install and run WSO2 Business Activity Monitor using the binary distribution and how to build WSO2 Registry using the source distribution.
The following distribution packages are available for download.
1. Binary Distribution : Includes binary files for both MS Windows and Linux operating systems as a zip file. Recommended for normal users.
2. Source Distribution : Includes the source for both MS Windows and Linux operating systems as a zip file that is used to build the binary files. Recommended for more advanced users.
Java SE Development Kit | 1.6.0_21 or later (For instructions on setting up the JDK on different
operating systems, visit http://java.sun.com)
To build WSO2 Business Activity Monitor from the Source distribution, it is necessary that you have JDK 1.6.0_21 or later and Maven 2.1.0 or later |
Apache Ant - To run samples that accompany the BAM distribution | Ant script is provided for each sample that will simulate another server pumping events into BAM. This would simplify the process of trying out BAM, reducing the overhead of running more servers. Ant 1.7.0 version is recommended. |
Apache Maven- To build BAM from Source | To build the WSO2 Business Activity Monitor from its source distribution, you will need Maven 2.1.0 or later |
Web browser- To start the BAM Management Console | The Management Console requires you to enable JavaScript of the Web
browser, with MS IE 6, 7, 8 and 9. In addition to JavaScript, ActiveX
should also be enabled with IE. This can be achieved by setting your
security level to medium or lower.
NOTE: On Windows Server 2003, it is not allowed to go below the medium security level in Internet Explorer 6.x and the default medium security setting with IE does not allow sufficient level of JS or ActiveX support for the management console to run. |
Memory | Minimum memory 1GB |
Disk | The installation will require ~200MB excluding space allocated for log files and Databases. |
Operating System | Linux, MS Windows. As the WSO2 Business Activity Monitor is a Java application, it will generally be possible to run it on other operating systems with a JDK 1.6 runtime. |
The following steps will take you through the linux/unix distribution installation.
i) ./wso2server.sh {console | start | stop | restart | status | dump | version}
ii) ./daemon.sh {console | start | stop | restart | status | dump}
Usage: wso2server.sh [command]
command:
The following steps will take you through the installation for the MS Windows operating system.
Java SE Development Kit | 1.6.0_21 or later (For instructions on setting up the JDK in different operating systems, visit http://java.sun.com) |
Apache Maven- To build Registry from Source | To build the WSO2 Business Activity Monitor from its source distribution, you will need Maven 2.1.0 or later |
Operating System | Linux, Solaris, MS Windows - XP/ Vista (Not fully tested on Windows Vista) |
Maven:
The WSO2 Business Activity Monitor build is based on Apache Maven. Hence, it is a prerequisite to have Maven (version 2.1.0 or later) and JDK (version 1.6.0_21 or later) installed in order to build WSO2 Business Activity Monitor from the source distribution. Extensive instructions on Maven builds are available on the Maven site.
Please refer to the Maven Getting Started Guide for more information on Maven
Once Maven is properly installed, you can start building the WSO2 Registry.
This will create the complete release artifacts including the binary and source distributions in the modules/distribution/target/ directory which can be installed using the above instructions.
Note: The first time you run Maven it will automatically download the dependent .jar files. Therefore, the first run will take more time.
WSO2 Business Activity Monitor samples are available at BAM_HOME/samples directory. The instructions to run sample are given in README file of the respective samples.