NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

For more information about the 2.1 updates, see the caNanoLab 2.1 Release Note.

Targeted Developer

The caNanoLab application development is best suited for an experienced Java developer who has some familiarity with the following J2EE and related technologies:

...

General System Requirements

Info
titleWhat is caNanoLab Tested Against?

The

...

Open Source Technologies

...

caNanoLab web application has been tested within NCI CBIIT against Wildfly servers (version 8.2.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.

 

Open Source Technologies

Download each of the following tools 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/ Exit Disclaimer logoImage Added

The caNanoLab web application has been tested within NCICBIIT against Wildfly servers (version 8.2.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.

...

...

...

Obtaining the caNanoLab Source

...

Code

Downloads for caNanoLab are available at caNanoLab GitHub Repository Exit Disclaimer logo. The caNanoLab Software License applies.

...

The caNanoLab source distribution caNanoLab_2.01.zip is downloaded. , and Ant is installed.NOTE

Info
titleNote

In caNanoLab release 2.1, the Ant build script automatically installs the web application.

 

Setting Properties

Follow these steps to set the build and deploy properties required for building and deploying the caNanoLab system.

Step 1.  Extract caNanoLab

Extract the caNanoLab_2.01.zip to a location on your local system, for example, C:\caNanoLab_2.1. 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

...

Edit the Ant properties file, build.properties, at <CANANOLAB_SOURCE>/build by specifying values for the following properties:.

PropertyDescription
file.repository.dir

...

A directory on the system that hosts the Wildfly application server for storing uploaded files, for example, C:/apps/caNanoLab.
NOTE: This directory should be writable by the user that starts the Wildfly server, and this directory should be created prior to starting the application. Use either double-back slashes or a single forward slash / as the file separator if working on Windows platform.
 
  1. admin.email:  The email address that receives requests for new user accounts, for example, the NCICBIIT application support email for the NCICBIIT installation.
 

ldap.authentication.enabled:  A Boolean flag to indicate whether or not to use LDAP for user authentication in caNanoLab, for example, true.

NOTE: Please note that the default value is true. If you are not using LDAP for user authentication, set this value to false and leave properties 4) through 9) blank.

 
  1. ldap.host.url:  The URL of the LDAP server used for user authentication.
 
  1. ldap.searchable.base:  The location in the directory from which the LDAP search begins.
 
              1. ldap.userId.label:  The uid label for LDAP, for example, cn.
 

superadmin.login.name:  The LDAP login name for the user account who is the super admin of the UPT tool. See User Provisioning Tool (UPT) for details on setting up UPT.

 
  1. superadmin.first.name:  The LDAP first name for the user account who is the super admin of the UPT tool.
 
  1. superadmin.last.name:  The LDAP last name for the user account who is the super admin of the UPT tool.
 
  1. database.server:  The name of the server hosting the database, for example, localhost.
 
  1. database.port:  The database port number, for example, 3306.
 
  1. database.user: The database user name used in the caNanoLab application, for example, cananolab_app.
 
  1. database.password: The password for the database user specified above, for example, go!234.
 
  1. database.system.user:  The system database user name with privileges to create a database, create tables, grant user accesses to a database, for example, root.
 
  1. database.system.password:  The password for the system database user specified above, for example, rootpass.
 
  1. jboss.server.dir:  The Wildfly server directory, for example, C:/apps/wildfly-8.2.0.Final/standalone.
  

 

Database Technology

Assumptions and Requirements

...