Preparation

1. This demonstration application has been tested using a Bash shell on Linux (Redhat Enterprise Linux 4 or similar) with ControlTier 3.1.
   Note

   You can also use a pre-built VMware Headlines virtual machine and use the VMware player.
2. It is assumed that ControlTier 3.1 has been successfully installed using the self-contained directory convention for which this is the recommended default properties file:
   Note

   If you would like to install ControlTier elsewhere than the default location, change instances of "${user.home}/ctier" to the directory of your choice in your default.properties file.

   ###############
   #
   # default.properties
   #
   ###############
   #
   #  This file contains the install properties for ControlTier
   #  Server and Client.
   #
   ###############
   
   
   ###############
   #  Tomcat
   ###############
   
   #  the value of CATALINA_BASE (e.g. /usr/local/tomcat)
   env.catalina_base = ${user.home}/ctier/workbench
   
   #  the value of CATALINA_HOME (e.g. /usr/local/tomcat)
   env.catalina_home = ${user.home}/ctier/pkgs/apache-tomcat-4.1.36
   
   #  the listen port used by Tomcat (Tomcat default is 8080)
   server.tomcat.port = 8080
   
   # the hostname used by tomcat
   server.tomcat.hostname = localhost
   
   #  the application context path for the webdav app
   server.tomcat.webdav.path = webdav
   
   #  the listen port used by the Report server. (Default is 1055)
   server.reports.port = 1055
   
   # Should the installer replace the Xerces jars included with Tomcat
   # with newer versions required by ControlTier Server?  
   # If you choose not to, ControlTier Server will not function.
   # See: http://open.controltier.com/Docs/tomcat41-filesonly.html#Update+Tomcat+Libraries
   
   tomcat.replace-xerces-jars = true
   
   ################
   # User access
   #
   # Tomcat uses the "tomcat-users.xml" file to define users, passwords and roles.
   #  
   # ControlTier Server and Client require that the users with access to 
   # the server belong to certain named "roles" that are not present in the 
   # default Tomcat installation.
   # 
   # If you want the installer to provide a new ControlTier ready 
   # tomcat-users.xml file for you (and backup your existing file), set the
   # following property to be "true". It is RECOMMENDED that you set this
   # to "true" unless you have modified the tomcat-users.xml file yourself.
   
   users.install-default = true
   
   # If you choose to maintain your old tomcat-users.xml file, then be sure that 
   # the user named below belongs to these roles: "user,admin".
   # See: http://open.controltier.com/Docs/tomcat41-filesonly.html#Configure+Tomcat+Realm
   ################
   
   # the name of the default ControlTier user
   tomcat.user.name = default
    
   # the password of the default ControlTier user
   tomcat.user.password = default
   
   ################
   # ControlTier Server
   ################
   
   #If the following directories don't exist, the installer will create them
   
   # RDF datastore path
   server.rdfdata.path = ${env.catalina_base}/rdfdata
   
   server.dav.basedir = ${env.catalina_base}/webapps/webdav
   
   ################
   # ControlTier Client
   ################
   
   # Base install of AntDepo, ANTDEPO_BASE.  (e.g.: $HOME/antdepo_base)
   env.antdepo_base = ${user.home}/ctier/antdepo
   
   # Location of AntDepo home, ANTDEPO_HOME.  (e.g.: $HOME/antdepo-version)
   env.antdepo_home = ${user.home}/ctier/pkgs/antdepo-1.3
   
   # Hostname used by the ControlTier client. This is the
   # name that will appear in Workbench. ${server.tomcat.hostname} sets this
   # value to the hostname specified in the Tomcat section above.
   client.hostname = ${server.tomcat.hostname}
   
   ################
   # Client email settings
   ################
   
   # recipient addresses to send email (comma separated)
   framework.email.tolist = root
   
   # email address appearing in message "from" field
   framework.email.from = root
   
   # email address replies should go to
   framework.email.replyto = do-not-reply
   
   # The antdepo email relay host. must be a functioning smtp relay server
   framework.email.mailhost = mail
   framework.email.mailport = 25
   
   # User/pass info if the smtp server requires it
   framework.email.user =
   framework.email.password =
   framework.email.ssl = true
   
   # Fail if there is an error
   framework.email.failonerror = true
   
   ################
   # Client SSH settings
   ################
   
   # Path to the SSH private key
   framework.ssh.keypath = ${user.home}/.ssh/id_rsa
   		

3. The default object definitions distributed with the demonstration assume the existence of the CTIER_ROOT environment variable. Add the variable to "~/.ctierrc" setting it to wherever you decided to install ControlTier (e.g. "export CTIER_ROOT=~/ctier").
4. Make sure that your version of Ant is 1.7.0

Choose an installation track by selecting source, seed or project archive ...