Installing and running the COSMOS Demo and Prerequisites

The COSMOS Demo is a good place to start for adopters that want to explore what COSMOS has to offer in the way of functionality and facilities. The COSMOS Demo download provides the COSMOS UI and exemplar Data Managers that allow the adopter to query sample data from a variety of sources.
This section provides instructions for installing and running the demo program that is provided in the COSMOS build.
  1. Install Tomcat 5.5.26. The directory where the Tomcat server is installed will be referred to as the <tomcat_install_dir> in this document.
  2. Download Axis2 war file for Tomcat from the Apache Software Foundation. Download the zip file for WAR (Web Archive) Distribution.
  3. Download the BIRT project.
  4. Download DOJO.
  5. Unzip the demo zip file downloaded from COSMOS Download to a directory. You will see a directory called cosmos-demo. This directory will be referred to as <cosmos-demo> in this document.
  6. If you are using the Aperi MDR, you will need to install and setup Aperi as follows
    1. Download the Aperi Storage Resource Manager version 0.4.1 from Aperi downloads.
    2. Follow the instructions at Aperi install instructions. You MUST choose Derby as your database.
    3. After successfully installing Aperi, you may wish to run some Aperi probes to populate your database with storage information (refer to the "Aperi post-installation instructions" section of the install instructions).
    4. Alternatively you can use the sample Aperi database located at <cosmos-demo>\database\Aperi. To install the sample Aperi database, replace your <aperi-installation-folder>\db folder with the contents of the <cosmos-demo>\database\Aperi folder.
    5. Note that the Aperi MDR is preconfigured to access the default Aperi derby database (at localhost and port 1527). If you have chosen another location, you will need to modify the <tomcat>\webapps\axis2\WEB-INF\services\AperiMdr\META-INF\services.xml file to change the DERBY_HOST and DERBY_PORT parameters.
    6. Before using the Aperi MDR, start the Aperi derby database. For example: type start derby from the <Aperi install>\db directory.