NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

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

...

The caNanoLab Software License applies.

Setting the Ant Build Properties

Setting Properties

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

Step 1.  Download caNanoLab from GitHub

...

Property

Description

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 created prior to starting the application. If working on Windows platform, use either double-back slashes or a single forward slash / as the file separator.

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. caNanoLab 2.1 and beyond does not support LDAP authentication. Set this to false.

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 that the user specified above, for example, go!234.

database.system.user

The system database user name with privileges to create a database, create tables, and grant user accesses to a database, for example, root.

database.system.password

The password for the system database that the user specified above, for example, rootpass.

jboss.server.dir

The Wildfly server directory, for example:
C:/apps/wildfly-8.2.0.Final/standalone

 

Installation and Deployment

...

Installing and Deploying caNanoLab 2.1.1

Follow these steps to build and deploy caNanoLab 2.1.1.

Step 1. Deploy Database Changes for Migrating to CSM 5.2

Execute the following scripts in the order specified below.

Create the following table:

CREATE TABLE favorite_data (
favorite_data_id bigint(20) DEFAULT NULL,
data_id bigint(20) DEFAULT NULL,
data_type varchar(200) DEFAULT NULL,
data_name varchar(200) DEFAULT NULL,
login_name varchar(200) DEFAULT NULL,
protocol_file_id bigint(20) DEFAULT NULL,
pubmed_id bigint(20) DEFAULT NULL,
editable tinyint(1) DEFAULT '0',
description text,
protocol_file_title varchar(200) DEFAULT NULL );

...

  https://github.com/CBIIT/common-security-module/blob/master/software/common/resources/db/db-upgrade/mysql/MigrationScript5.0MySQL.sql

...

 

...

 https://github.com/CBIIT/common-security-module/blob/master/software/common/resources/db/db-upgrade/mysql/MigrationScript5.1MySQL.sql+

Execute the following script to reset password for all the accounts:

update csm_user set password = 'zJPWCwDeSgG8j2uyHEABIQ==';
update csm_user set first_time_login = 1;

Migrate encryption from 4.x CSM database

CSM 5.0 has introduced using AES encryption to encrypt CSM User information while storing it in CSM_USER table. If you are upgrading CSM from 4.x to 5.x, apart from migrating the database, you will need to run encryption migration. This step expects that the PASSWORD column values in CSM_USER are not altered from the original values created through the CSM API.

...

ant -Dproperties.file=upgrade.properties migration:run.

...

Step 2. Upgrade to caNanoLab 2.1.1

Follow these steps to install and deploy caNanoLab.

...