Collaborative Infrastructure Runtime Installation
=================================================

The CI Runtime is packaged as an installer and will install all
components, scripts and configuration files in a CI directory
of your choosing. An installer is available for Linux, Windows and 
Mac OS X.


Download the CI Runtime
-----------------------

The CI Runtime can be downloaded from:
http://www.agentisolutions.com/download/ci.htm
Note that a username and password are required.
If you do not have a username or password contact 
Ron van Hoof (Ron.vanHoof@nasa.gov) to obtain these.
The following are direct downloads for the various platforms.

Linux:
http://www.agentisolutions.com/ci/runtime/v1.12/linux/setup.bin.gz

Windows:
http://www.agentisolutions.com/ci/runtime/v1.12/win/setup.exe

Mac OS X:
http://www.agentisolutions.com/ci/runtime/v1.12/macosx/setup.zip


Prepare for Installation
------------------------

Before running the installer make sure to have the ACE_ROOT 
environment variable set to the directory in which ACE/TAO
was installed. Note that the current release has been tested
with ACE/TAO 5.6.9/1.6.9.

Linux:
> export ACE_ROOT=<ACE_wrappers directory>
> export ACE_ROOT=/opt/ACE_wrappers

Windows:
1. Open Windows Explorer.
2. Right mouse click on My Computer and select Properties.
3. Select the 'Advanced' tab.
4. Press the 'Environment Variables' button.
5. Under System Variables press the New button and for
   the Variable name enter ACE_ROOT and for the Variable
   value enter the ACE_wrappers directory (C:\ACE_wrappers). 
   Press OK to add the new variable. Press OK again to close 
   the Environment Variables dialog. Press OK again to 
   close the System Properties dialog.
   
Mac OS X:
> export ACE_ROOT=<ACE_wrappers directory>
> export ACE_ROOT=/opt/ACE_wrappers


Install the CI Runtime
----------------------

The installer can be run in three different modes:
1. Graphical Mode (default)
2. Console Mode
3. Silent Mode

Graphical Mode

  Linux:
    > gunzip setup.bin.gz
    > chmod +x setup.bin
    > ./setup.bin
    The setup wizard is started and will guide you through the installation.
    Default installation directory is: ~/CI

  Windows:
    Open the directory to which you downloaded setup.exe
    Double click on setup.exe
    The setup wizard is started and will guide you through the installation.  
    Default installation directory is: C:\CI

  Mac OS X:
    Open the directory to which you downloaded the setup.zip file.
    Double click the zip file to have OS X extract the installer.
    Double click the extracted installer.
    The setup wizard is started and will guide you through the installation.  
    Default installation directory is: ~/CI

Console Mode

  To run the installer in console mode pass the following flags
  as arguments to the installer:
    -i console
    
  Linux:    ./setup.bin -i console
  Windows:  ./setup.exe -i console
  Mac OS X: ./setup -i console
  
Silent Mode

  To run the installer in silent mode and to use the default
  options (i.e. the default installation directory) pass the
  following flags as arguments to the installer:
    -i silent

  Linux:    ./setup.bin -i silent
  Windows:  ./setup.exe -i silent
  Mac OS X: ./setup -i silent
  
  You can also pass a properties file to the installer that
  specifies the options normally requested by the installer:
    -f <properties files>

  Linux:    ./setup.bin -f ./install.properties
  Windows:  ./setup.exe -f ./install.properties
  Mac OS X: ./setup -f ./install.properties

  The install.properties file must have two properties:
    USER_INSTALL_DIR=<directory in which to install the CI>
    USER_SHORTCUTS=Do Not Install


Next Steps
----------

If a C++/native actor needs to be hosted by the CI's hosting
environment on Linux or Mac OS X you must build the native 
CI Interface portion of the CI. See the build instructions for 
details on how to do this. Make sure to copy the file libCIInterface.so
file to the CI's lib directory.