Deploying Zeus Websites

Crop-specific sites may be loaded on user browsers by accessing the same, one, ICIS-Zeus application and with the crop name as a parameter in the URL(if this is not specified, the crop 'rice' is the default). So if you have more than datasource, the system will check each one of them to see if the crop is supported and query from all datasources that can produce the data needed in the particular query context.

So if you have more than 1 datasource for the same crop, the system will query from all datasources and present the results for each one of them.

There are cases wherein for a single crop, there is more than 1 database and certain databases are restricted to a set of users. In these cases, you will need separate ICIS-Zeus (or Zeus-Germplasm) installations for each level of access.

Step 1: Install Apache, PHP, MySQL and Graphviz

Some notes on mysql installation:

• Adjust the maximum number of connections to accomodate the expected number of simultaneous users for the website

On Graphviz:
On debian linux OS, this can be easily done with apt-get.
For windows, installer may be downloaded from its website.
The dot.exe is what is needed and have to be in the path

Step 2: Set up the ICIS databases

Step 3: Install Java SDK, Apache Ant, Tomcat and SVN Client

Step 4: Checkout, configure and deploy the Pedigree Viewer Web Application

Step 5: Checkout, configure and deploy the ICIS/Zeus Web Application

anonymous access is also pssible by using:
                username:anonsvn
                password:anonsvn

##
# build properties
##

# --- where is the (outside) directory for docs
#dist.docs.dir =


## Contact Email Address
## Value for contact.email required

#contact.email = <email address of the person to contact by website users>
pedigree.url = http://koios.generationcp.org/pedigreeviewer/index-show.jsp

## Link to Users Manual, Web Application Bugs and Feature Requests Trackers
## Value for the links needed and used in replacing tokens in
## - src/web-customsite/config/about.html.template.
## - src/web-customsite/config/faqs.html.template.
## Default values provided. Please do not remove these.
## If appropriate values are not yet available, the links may be changed by
## manually modifying the links in the about.html
## and faqs.html pages after deployment:

users_manual.link = http://pantheon.generationcp.org/index.php?option=com_content&task=view&id=87&Itemid=74
bug_tracker.link = http://cropforge.org/tracker/?func=add&group_id=110&atid=556
feature_requests_tracker.link = http://cropforge.org/tracker/?func=add&group_id=110&atid=557

## Location of common javascripts (common across all Zeus web apps)
## Default value is the project name Zeus-Extjs located one folder up.
## Change this value to the location of common files Zeus-Extjs
## You will need to check out the Zeus common files from pantheon SVN.
## The repository location is
## /Belenus/projects/Zeus/Commons/Zeus-Extjs
## example for windows:
## common.web=C:/eclipse/workspace/Zeus-Extjs

#common.web = E:/dev/eclipse-galileo/workspace3/Zeus2-Extjs

## Location of the Tomcat servers
## Web application may be deployed to development and/or production tomcat server
## If deploying to a tomcat server: Your own target tomcat installation directory
## may be specified here through the property 'custom.tomcat.home'
## If deploying to a tomcat (beta) server: Your own target tomcat installation directory
## may be specified here through the property 'custom.tomcat.beta.home'
## Default value for both properties is the directory specified by
## your environment variable TOMCAT_BASE
## example for windows:
## custom.tomcat.home=C:/Tomcat5.5-stable
## custom.tomcat.beta.home=C:/Tomcat5.5-beta

#custom.tomcat.home = <location of production server files>
#custom.tomcat.beta.home = <location of development server files>


## Web Application Names
## If deploying to a tomcat server: provide value for app.name
## If deploying to a tomcat(beta) server: provide value for app.beta.name
## Default value has the prefix "ICIS" appended to the project version number
## e.g. ICIS-1.4.0-alpha
## The web application can also be named "ROOT" if you wish it deployed as
## the default Tomcat application

#app.name=<production webapp name>
#app.beta.name=<beta webapp name>


## This is to set a property to a value that is the same as value for "appBase"
## specified in your <tomcat base>/conf/server.xml
## This is used in pedigree configuration (to specify where pedigree
## cache and images will be stored)
## If deploying to a tomcat server: The value for property webapps.dir will be used.
## The default Value is "webapps" - the default value for tomcat installations
## An example of how this is used:
## if the webapps.dir value is "webapps"(the default value),
## the pedigree cache and images will be stored, respectively, in: 
## <tomcat installation dir>/webapps/<app.name value>/pedigree-cache
## <tomcat installation dir>/webapps/<app.name value>/pedigree-cache-graphs

#webapps.dir = <your own appBase if different from default value ("webapps")>

...
#custom.tomcat.beta.home=<location of development server files>
...
#app.beta.name=<beta webapp name>

•   Go to src/web-customsite/config

•   Copy ICISDataSource.xml.template to  ICISDataSource.xml
•  Copy ICISDataSourceTemplate.xml.template to  ICISDataSourceTemplate.xml

•   Specify the datasources you would like to be used using this file.
  

•   For each data source, there are elements that need to be assigned values (e.g. datasource name, id, description, database name, etc.). Enter values to these. 

the ant target 'initmaven' starts the download of jar files/libraries specified as dependencies of the project. Allow for sufficient time to download jar files from repository (especially after a checkout - this may take minutes dependeing on your internet connectivity)

In December 2009, downloading jar files (i.e. initmaven) results to bad archived files and non-compilable code. In case this happens you can download the jars repository here:

http://koios.generationcp.org/download/jar_files/

Unzip and put in ~/.m2/

ant deploy-customsite-beta (will deploy to tomcat.home)