Page History

Versions Compared

Key

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

...

This installation guide only discusses the steps for migrating from release 1.5.3 or , 1.5.4, or 1.5.5. in MySQL to release 2.0 in MySQL. If you have previously installed caNanoLab in MySQL prior to release 1.5.1, you need to migrate to release 1.5.1 first, one release at a time. The 1.5.5 installation guide is available at the main caNanoLab wiki page, but previous installation guides are available at the caNanoLab Archive page.

...

Step

Action

Set up an environment variable JBOSS_HOME to point to the JBoss installation directory.

Note: Either Use either double back slashes
// or a single forward slash / should be used as the file separator if working on Windows platform, for example, JBOSS_HOME=C:/jboss-5.1.0.GA (C:\jboss-5.1.0.GA would fail).

Execute the Ant build script build.xml located at
<CANANOLAB_SOURCE>/build with the target deploy:cananolab-webpp.

Example: Issue the following commands to execute the Ant script:

C:\>cd C:\caNanoLab_2.0\build C:\caNanoLab_2.0\build>ant deploy:cananolab-webapp

Successful execution of the Ant script generates the following artifacts that include two deployable web archive war files, configuration files and libraries for running the web application in the JBoss environment, and also places these artifacts in the appropriate directories under <JBOSS_HOME>:

Code Block

 <CANANOLAB_SOURCE>/target/dist/exploded/cananolab- webapp/caNanoLab.war 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/Applica tionSecurityConfig.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/csmupt. csm.new.hibernate.cfg.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/csmupt4 23.csm.new.hibernate.cfg.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/login- config.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploaded/common/mysql- connector-java-5.0.7.jar 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/upt- ds.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/propert ies-service.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/upt- ds.xml 
 
 <CANANOLAB_SOURCE>/target/dist/exploded/common/uptEAR. ear

We recommend increasing the JBoss JVM heap size to 1G bytes and permanent generation (permgen) memory space to 256M bytes by updating the file
<JBOSS_HOME>/bin/run.conf with the following JAVA_OPTS:

Code Block
JAVA_OPTS="-Xms512m -Xmx1024m -XX:PermSize=128m - XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 - Dsun.rmi.dgc.server.gcInterval=3600000"

This configuration file is read when JBoss server starts.

When deploying the caNanolab application 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.

Please locate the file <JBOSS_HOME>/server/default/conf/log4j.xml and add to the beginning of the section Limit categories the following text:

Code Block

<!-- ================ --> 
 <!-- Limit categories --> 
 <!-- ================ --> 
 
 <!-- edited for caNanoLab --> 
 <category name="org.hibernate">
<priority value="WARN"/> 
 </category> 
 <category name="org.springframework"> 
 <priority value="WARN"/> 
 </category> 
 <category name="org.globus"> 
 <priority value="WARN"/> 
 </category> 
 <category name="gov.nih.nci"> 
 <priority value="ERROR"/> 
 </category> 
 <category name="org.displaytag"> 
 <priority value="ERROR"/> 
 </category> 
 <category name="org.directwebremoting"> 
 <priority value="ERROR"/> 
 </category> 
 <category name="net.sf.ehcache"> 
 <priority value="INFO"/> 
 </category> 
 <category name="com.mchange.v2"> 
 <priority value="INFO"/> 
 </category> 
 <category name="org.jboss"> 
 <priority value="INFO"/> 
 </category> 
 <category name="CSM"> 
 <priority value="ERROR"/> 
 </category> 
 <category name="Authorization"> 
 <priority value="ERROR"/> 
 </category> 
 <!—end of edit for caNanoLab -->

...

Content

Space Tools

Versions Compared

Old Version 25

New Version 26

Key