 |
Page History
...
- Java Software Development Kit (JDK) version 6.0: http://www.oracle.com/technetwork/java/javase/downloads/jdk6-downloads-1637591.html
- JBoss version 5.1.0: http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.1.0.GA/
- Jakarta Ant version 1.7.x: http://archive.apache.org/dist/ant/binaries/
- MySQL version 5.1.x: http://dev.mysql.com/downloads/mysql/5.1.html
| Info | ||
|---|---|---|
| ||
In release 1.5.4, we have upgraded the technology stack for the web application, but the technology stack for the caNanoLab grid service has not been upgraded due to the requirements of caGrid 1.3. If you'd like to install caNanoLab grid service, please refer to the caNanoLab Release 1.5.3 Installation Guide for the required technology stack for installing the caNanoLab grid service. |
The caNanoLab web application has been tested within NCICBIIT against JBoss servers (version 5.1.0) hosted on Windows XP and RedHat Linux systems, and against MySQL 5.1.x databases hosted on RedHat Linux systems and Windows XP systems. Prior to release 1.2.1, the caNanoLab web application had been tested against Oracle 9i databases hosted on Sun Solaris systems, and Oracle 10g XE database hosted on Windows XP.
Download each of the tools listed in the bulleted list above and follow the installation instructions provided with each respective product for your environment. Assistance from a MySQL database administrator is expected to properly configure the MySQL database. For MySQL database configuration and maintenance, it is also helpful to download the MySQL workbench (suite of GUI tools) at http://www.mysql.com/downloads/workbench/
...
Extract the caNanoLab_2.0.zip to a location on your local system, for example, C:\caNanoLab_2.0. This location is referred as <CANANOLAB_SOURCE> throughout the document. Verify that the following five folders exist in the directory <CANANOLAB_SOURCE>:
- build
- cananolab-db
- cananolab-grid
- cananolab-webapp
- common
Step 2. Edit Ant Properties
Edit the Ant properties file, build.properties, at
<CANANOLAB_SOURCE>/build by specifying values for the following properties:
- file.repository.dir: a A directory on the system that hosts the JBoss application server for storing uploaded files, for example,
C:/apps/caNanoLab.
Note NOTE: This directory should be writable by the user that starts the JBoss
server, and this directory should be created prior to starting the application. Either double-back slashes
or a single forward slash / should be used as the file separator if working on Windows platform. - admin.email The email : the email address that receives requests for new user accounts, for example, NCICBIIT application support email for the NCICBIIT installation.
- ldap.authentication.enabled: a A Boolean flag for to indicate whether or not using to use LDAP for user authentication in caNanoLab, for example,
true.
Note NOTE: Please note that default the value is true. If you are not using LDAP for user
authentication, please set this value to false and leave properties 4) through 9) blank. - ldap.host.url: the The URL of the LDAP server used for user authentication.
- ldap.searchable.base: the The location in the directory from which the LDAP search begins.
- ldap.userId.label: the The uid label for LDAP, for example,
cn. - superadmin.login.name: the The LDAP login name for the user account who is the super admin of the UPT tool. See page 14 for details on setting up UPT.
- superadmin.first.name: the The LDAP first name for the user account who is the super admin of the UPT tool.
- superadmin.last.name : the The LDAP last name for the user account who is the super admin of the UPT tool.
- database.server: the The name of the server hosting the database, for example,
localhost. - database.port: the The database port number, for example,
3306. - database.user: the The database user name used in the caNanoLab application, for example,
cananolab_app. - database.password: the The password for the database user specified above,
for example,go!234. - database.system.user: the The system database user name that has privileges to create a database, create tables, grant user accesses to a database, for example,
root. - database.system.password: the The password for the system database user
specified above, for example,rootpass. - jboss.server.dir: the The JBoss server directory, for example,
C:/apps/jboss-5.1.0.GA/server/defaultdefault.
Database Technology
Assumptions and Requirements
- The Ant build properties
...
- are set as described
...
- in section, Step 2. Edit Ant Properties.
- A MySQL database
...
- is set up on a system (local or remote) with a system (or root) account.
- The system account
...
- matches properties 9) and properties 10) in
...
- procedure 2 of Step 2. Edit Ant Properties.
For a Previous Installation
If you have installed caNanoLab prior to release 2.0 against an MySQL database, or release 1.2 or , release 1.1.1, or release 1.1 against an Oracle database, and have associated production data in these schemas and you would like to continue to use the same data for caNanoLab release 2.0 in MySQL, review the following database initialization steps, and then go directly to section, Data Migration on page 7.
If you have a previously installed caNanoLab application running on a JBoss server, stop the server before running the database scripts.
...
