Personal tools
You are here: Home → Community → Help Center → How-tos → Install the server version of PillarOne.RiskAnalytics

Install the server version of PillarOne.RiskAnalytics

This how-to explains how to install PillarOne.RiskAnalytics on a Windows machine running in the server mode. Linux users should be able to abstract and apply similar steps for their OS. The server version provides additional multi user functionality.

Prerequisities

Hardware requirements depend on the number of concurrent users and the complexity of models and their usage. We recommend 2 GB of RAM and lots of fast disk space to store results. For a test installation 1 GB of RAM will work fine.

The following third party software is required:

  • Java Runtime Environment
  • An object relational database supported by Hibernate. This example is using MySQL.
  • A Java Web Servlet container. This example is using Apache Tomcat.

 

Step by step

  1. Install a Java Runtime Environment
  2. Install MySQL 5.1.
    We didn't yet test the recently released version 5.5.
    • Make sure to select utf-8 during the installation of MySQL
    • If there is a failure on the last installer screen it might be necessary to set the admin password manually by using the following command
    • Open the MySQL command line and execute the commands described in DataSource.groovy environment mysql (currently as of line 37).
    • Prepare the database to enable indices and pagination by executing applying this script. Make sure to replace DATABASE_NAME with p1rat beforehand.
  3. Install Apache Tomcat
    1. Download a recent apache tomcat. Make sure to select an Windows Service Installer version. (download page)
    2. During the installation chose the 'Host Manger' in addition to the predefined chosen components.
    3. Fill in the other dialogs and finish the installation.
    4. Open the start menu, Apache Tomcat 6.0
      • Right click on Configure Tomcat and select Run as Administrator from the context menu.
        Tomcat Memory Settings
      • Adjust the memory settings in the Java tab
        • add -XX:MaxPermSize=256m in the textfield Java Options
        • set initial memory pool as 1024 and maximum as 2048
    5. Click on the button at the bottom Apply.
    6. Start Tomcat using the corresponding button in the General tab
    7. Open http://localhost:8080/ in a browser. If a different port was selected during the installation the url has to be modified accordingly.
    8. Click on the link Manage Server in the left column
    9. Click on the link Server Status and check the available memory
  4. Deploying RiskAnalytics
    This step has to be done also to update an existing server version.
    1. If Apache Tomcat is running, stop it using the Configure Tomcat dialog
    2. Download a recent version of the RiskAnalytics.war file available in the release section.
    3. Copy this webarchive to C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps
      If an equally named war file/folder is already available in the webapps folder it has to be removed.
    4. Remove the version number from the file name
    5. Restart Apache Tomcat 6.0 using the Configure Tomcat dialog
    6. The content of the war file will be extracted to a folder with the same name
    7. Check http://localhost:8080/manager/html to make sure if everything is working fine. If Start is not available as link, but Stop is available as link all is fine and its possible to access the application on http://localhost:8080/RiskAnalytics
      Tomcat Webapplication Manager

 

Further Hints

  • You may need to change the firewall settings to make RiskAnalytics accessible from other computers within your intranet.
  • Be aware to setup a proper backup for the database.
  • Feel free to raise your questions in the forum.
Document Actions