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
|