Ontology and Policy Management
   
 

COI-Tools Distribution

The tool consists of few integrated components which require separate installation, preferably in the below sequence:

1. Install in any chosen location the KAoS Distribution.

Set up the environment variable KAOS_HOME to the directory where the KAoS is installed

2. Install the latest release of the CmapTools (last updated - 06/21/2007 ) for Windows (Linux, Mac or Solaris can be made avialble on request).

When installing choose option to not instal any icons on your desktop or any other place. COI-Tools do not use them and their presents can confuse you in the future.

Set up the environment variable CMAPTOOLS_HOME to the directory where the CmapTools is installed

3. Install in any chosen location the COI-Tools distribution (last updated - 06/22/2007 ).

4. Execute the ant script (its default target) from the folder scripts/coe-init from the COI-Tools installation

5. You can choose from three options to store models of your COIs:

  • Local storage - the same computer on which the tools are installed. If you choose this options you have to execute ant script (its default target) in the folder scripts/local-coi-storage-init from the COI-Tools installation.
  • Existing COI Cmapserver at IHMC. If you choose this options you have to configure a new Place in CmapTools after you start it. Choose Places from the menu on the left and click on the icon in the right corner Add Place. In the form choose Add a place which is not on the list and use norma.ihmc.us (if not reachable please use numeric ip address: 72.236.182.134) for the Internet Host Name, 4447 (default) for the Port Name and 8082 for the Web Server Port Name. This should add a new place IHMC COI to your list of places in CmapTools.
  • Private Cmapserver on any host in your network. Install the Cmapserver (last updated - 01/09/2007 ) for Windows (Linux, Mac or Solaris can be made avialble on request). Set up the environment variable CMAPSERVER_HOME to the directory where the Cmapserver is installed. Also install COI-Tools installation (see point 4) on the same host and execute the ant script (its default target) in the folder scripts/private-server-coi-storage-init from the COI-Tools installation.

6. Install the JBI release 1.2.6 client part on the same machine

Set up the environment variable JBI_HOME to the directory where the JBI is installed.

7. To run the COI-Tools suite use the following sequence:

  • start KAoS executing the ant script in the folder scripts/coi with target run-coi-kaos from the COI-Tools installation,
  • start COI-Tools executing the ant script in the folder scripts/coi with default target from the COI-Tools installation,
  • to run demo COI configuration run ant script in the folder scripts/jbi-demo from the COI-Tools installation,
  • you can connect to and monitor the demo COI of METOC community of interest started using scripts/jbi-demo by selecting the option Monitor Implemented COI on the KoreaAirForceMETOCCOIActor from the Implemented COIs at IHMC (see point 5) in your running COI-Tools. If you are asked for the KAoS http address please update the ip address in the following url to the one matching the computer on which you running KAoS DS: http://127.0.0.1:8081/examples/servlet/TCPServlet and provide it to CMapTools.

8. To enable storing and reviewing of COI configuration history do the following:

Prerequisites:

Install Subversion version 1.3.0 or later. Note: Ensure your subversion install includes the Java HL client adapter, Otherwise, you can download and install the java adapter separately.

Setup:

  • Create an empty SVN repository (using the file-based repository type, not BerkleyDB). Sample command: svnadmin create --fs-type fsfs "c:/path-to-subversion/subversion/svnrepo"
  • Checkout the empty repository to either:
    • 'My Cmaps' for a client install or 'serverRootFolder' for a server install.
    • Server sample command: svn checkout "file:///c:/path-to-subversion/subversion/svnrepo" "c:/path-to-root/serverRootFolder"
    • Client sample command: svn checkout "file:///c:/path-to-subversion/svnrepo" "c:/path-to-mycmaps/My Cmaps"
    • Note: Do not commit the contents of the serverRootFolder or 'My Cmaps' to Subversion manually. When the server or client starts-up it will automatically update the Subversion repository with the contents of the root folder and all subfolders.
  • Edit the configuration settings to enable version control and set the Subversion location information.
    • Server file: serverconfig.txt
    • Client file: cmaptools.cfg
  • Enable SVN version control. audit.svn.enabled=true
  • Set the URL to the Subversion repository audit.svn.repository.trunk.url=file\://C\:/path-to-subversion/subversion/svnrepo
  • Add the subversion/bin/ and subversion/javahl/ paths via VM arg -Djava.library.path or LD_LIBRARY_PATH environment variable