This page describes the installation of the Blueriq runtime on the different supported application servers.

Apache Tomcat (6/7)

Apache tomcat can be freely downloaded from http://tomcat.apache.org. This is also the place to look for documentation about the configuration and use of Tomcat. 

After successfull installation of tomcat, copy the Aquima-Server.war to the WebApps folder in your tomcat Installation folder (by default: C:\Program Files\Apache Software Foundation\Tomcat X.X\). Tomcat will automatically start deployment of the war, after successfull deployment Blueriq will be available at: http://<servername>:<Portnumber Tomcat>/Aquima-Server. 

IBM Websphere 7

Information about licensing, installation and configuration of IBM Websphere can be found at  http://www.ibm.com/software/websphere/.

Configure Websphere

After successfull installation of IBM Websphere Blueriq needs a modification of the default configuration of Websphere.

By default Websphere 7 does not support PNG images. Since Blueriq does use PNG images it is required to add the PNG mime type to the Websphere configuration. This can be done by following the steps listed at http://pic.dhe.ibm.com/infocenter/mpadoc/v7r0m0/index.jsp?topic=%2Fcom.ibm.websphere.wemp.doc%2Fconfiguring%2Fconfig_was_png_type_t.html.

Prepare Blueriq Installation

Blueriq plugins are normally placed in the Blueriq Home folder. Unfortunately this will not work with the Websphere Application Server, jar files from plugins will have to the packaged in the Aquima-Server.war

To achieve this:

• Extract the distribution package of the plugin 
• Copy the jar files from the Lib folder to the WEB-INF/Lib folder inside the Aquima-Server.war with a archive tool.
• Copy other resources from the plugin to the root of your Blueriq Home folder.

These steps must be repeated for each plugin you would like to add. After adding a plugin the war file must be redeployed on the Websphere Application Server.

Deployment of  Blueriq Runtime

Blueriq can be deployed in the  Integrated Solution Center, this console is by default available at http://<servername>:9060/ibm/console/, or via https at https://<servername>:9043/ibm/console/.

In the menu on the left hand side of the screen expand Applications and click on New Application.

Click on New Enterprise Application.

Click on the browse button next to the full path field to select your Aquima-Server.war file. Click Next.

Click Next.

In this screen you can select installation options. You do not have to change anything. Click Next.

Click Next.

Click Next.

Enter in the Context Root field a name you want to use as Virtual Directory name. The name will be used in the URL like http://<servername>:<portnumber>/<Context Root Name>.

For example you can use AqiumaServer. Click Next.

Click on Finish to start the installation. After the installation is completed you get the follow message:

Click in Save. You will now redirect to the Enterprise Application screen.

Select the new application by checking the select box and press start.

The deployment is now complete. You can now browse to http://<servername>:<portnumber>/AquimaServer/. By default the port number 9080 is used. 

IBM Websphere 8

JBoss (6/7)