![]() |
Page History
...
Info | ||
---|---|---|
| ||
Unix/Linux environment, Windows XP environment or Mac OS environment (Configuring environment variables; Installing Ant, JDK, Apache Tomcat and JBoss servers)
|
General System Requirements
The following open source technologies power a caNanoLab release 12.5.4 0 web application:
Open Source Technologies
...
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/
Grid Service
Setting up a caNanoLab grid service is optional. It is recommended that you install the grid service only after you successfully install the web application and become familiar with submitting and searching data through the web application.
Grid Service Downloads
Since release 1.5.2, there are no separate technology downloads required for installing the caNanoLab grid service, and most can obtained automatically during building of the grid service through Ant.
Obtaining the caNanoLab Source
Source Code
Downloads for caNanoLab are available at caNanoLab GitHub Repository . The caNanoLab Software License applies.
Obtaining the caNanoLab Source
Source Code
Downloads for caNanoLab are available at caNanoLab GitHub Repository . The caNanoLab Software License applies.
Ant Ant Build Properties
Assumptions and Requirements
The caNanoLab source distribution caNanoLab_12.50.4.zip zip has been downloaded. Ant has been installed. In caNanoLab release 12.5.40, the Ant build script automatically installs the web application, the database and the grid service.
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_12.50.4.zip to a location on your local system, for example, C:\caNanoLab_12.5.40. This location is referred as <CANANOLAB_SOURCE> throughout the document. Verify that the following five folders exist in the directory <CANANOLAB_SOURCE>:
...
- file.repository.dir: a directory on the system that hosts the JBoss application server for storing uploaded files, for example,
C:/apps/caNanoLab
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 address that receives requests for new user accounts, for example, NCICBIIT application support email for the NCICBIIT installation
- ldap.authentication.enabled: a Boolean flag for whether or not using LDAP for user authentication in caNanoLab, for example, true
Note: Please note that default 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 URL of the LDAP server used for user authentication
- ldap.searchable.base: the location in the directory from which the LDAP search begins
- 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 page 14 for details on setting up UPT
- superadmin.first.name: the LDAP first name for the user account who is the super admin of the UPT tool
- superadmin.last.name: the LDAP last name for the user account who is the super admin of the UPT tool
- database.server: the name of the server hosting the database, for example, localhost
- database.port: the database port number, for example, 3306
- database.user: the database user name used in the caNanoLab application, for example, cananolab_app
- database.password: the password for the database user specified above,
for example, go!234 - database.system.user: 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 password for the system database user
specified above, for example, rootpassjboss.server.dir: the JBoss server directory, for example,
C:/apps/jboss-5.1.0.GA/server/default
Note: The following properties 17) through 34) are only required if you setting up a grid service. These properties contain metadata about the grid service that are required for the grid index server to visually map the location of a grid service in the caGrid portal, and are useful during grid service auto-discovery. If you are not setting up a caNanoLab grid service, you may leave these properties blank.application.base.path.linux: a directory on the Linux system that stores the downloaded external software, such as the Globus WS Core binary files, for example, ${user.home}/apps
Note: This property is currently optional for building the web application and
the database, and is only required for building the grid service on a Linux system. - application.base.path.windows: a directory on the Windows system that stores the downloaded external software, such as the Globus WS Core binary files, for example, C:/apps
- grid.indexserver: the grid index server from which the caNanoLab grid data services can be automatically discovered, for example, http://cagrid- index.nci.nih.gov:8080/wsrf/services/DefaultIndexService, NCICBIIT's production caGrid index server
- grid.service.hostname: virtual host name for the JBoss server hosting the grid service, for example, cananolab.nci.gov
- grid.service.port: port number configured for the JBoss server hosting the caNanoLab grid service, for example, 80
- grid.service.protocol: protocol configured for the JBoss server hosting the caNanoLab grid service, for example, http
- example, rootpass
- jboss.server.dir: the JBoss server directory, for example,
C:/apps/jboss-5.1.0.GA/server/default application.owner: owner of the caNanoLab grid service, for example,
NCICBIITcountry: the country in which the caNanoLab grid service is running, forexample, US
city: the city at which the caNanoLab grid service is running, for example,
Rockville - zipcode: the zip code at which the caNanoLab grid service is running, for example, 20852 state: the state at which the caNanoLab grid service is running, for
- street1: the first part of the street at which the caNanoLab grid service is running, for example, 2115 East Jefferson Street
- street2: the second part of the street at which the caNanoLab grid service is running
- affiliation: the affiliation of the person who is responsible for maintaining the caNanoLab grid service, for example, NCICBIIT.
- email: the email of the person who is responsible for maintaining the caNanoLab grid service, for example, NCICBIIT@pop.nih.gov
- phone: the phone number of the person who is responsible for maintaining the caNanoLab grid service
- first.name: the first name of the person who is responsible for maintaining the caNanoLab grid service last.name: the last name of the person who is responsible for maintaining the caNanoLab grid service.
example, MD
Database Technology
Assumptions and Requirements
...
If you have installed caNanoLab prior to release 1.5.4 against 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 12.5.4 0 in MySQL, review the following database initialization steps, then go directly to 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.
...
If you are installing the caNanoLab application for the first time or want to install a new schema for release 12.5.40, follow the steps below to set up the required MySQL schema objects and the seed data for release 1.52.40.
Initializing the MySQL Database
...
Step | Action |
1 | Execute the Ant build script build.xml located at |
2 | If you are NOT using LDAP for user authentication, you can skip this step. If you Successful execution of the Ant script updates the default UPT super admin with the user name entered in the build properties file on page 4. |
...
NOTE:
If you are installing caNanoLab 12.5.4 0 for the first time or installing a new caNanoLab release 12.5.4 0 schema, you can skip this section.
This installation guide only discusses the steps for migrating from release 1.5.2 3 or 1.5.3 4 in MySQL to release 12.5.4 0 in MySQL. If you have previously installed caNanoLab in MySQL prior to release 1.5.1, you'd have to migrate to release 1.5.1 first, one release at a time. Please see the install instructions for each release at {+}http://gforge.nci.nih.gov/frs/?group_id=69+ for details.
Follow these steps to complete the required data migration from release 1.5.2 3 or release 1.5.3 4 in MySQL to release 12.5.4 0 in MySQL:
Step | Action |
1 | Execute the Ant build script build.xml located at |
2 | If you are NOT using LDAP for user authentication, you can skip this step. If you |
3 | If you are NOT using LDAP for user authentication, you can skip this step. If you
|
...
Step | Action |
1 | Set up an environment variable JBOSS_HOME to point to the JBoss installation directory. |
2 | Execute the Ant build script build.xml located at <CANANOLAB_SOURCE>/target/dist/exploded/cananolab- webapp/caNanoLab.war |
3 | We recommend increasing the JBoss JVM heap size to 1G bytes and permanent generation (permgen) memory space to 256M bytes by updating the file |
4 | When deploying the caNanolab application and the grid service in a production environment, we also recommend updating the default logging behavior of the JBoss server by turning off the unnecessary loggings thus reducing file system requirements for server log files. <priority value="WARN"/> |
...
For more information about how to use the UPT tool for managing user accounts, contact NCICBIIT Application Support at NCICBIIT@pop.nci.nih.gov and request that the caNanoLab technical team give you a demonstration of the UPT tool in the context of the caNanoLab application.
caNanoLab Grid Data Service
Assumptions and Requirements
As noted earlier, please refer to caNanoLab Release 1.5.3 Installation Guide for the technology stack requirements and how to install the caNanoLab grid service.
Contacting Application Support
...