NBIA at TCIA 7.8 Properties

application.base.path.linux

Location where user is installing software on Linux

${user.home}/apps/nbia

application.base.path.windows

Location where user is installing software on Windows

c:/apps/nbia

authentication.type

CSM authentication type; the value should be "ldap" or "ldap-auth"

ldap

database.type

This value specifies whether a MySQL or an Oracle database is being used. Currently only MySQL is supported.

mysql

database.re-create

database.drop-schema

One of these properties must be set to true. 

If re-create is true then the install:database target will wipe out the database instance completely and start from scratch. 

If drop-schema is true, then all the schema and data will be wiped out but the database itself will not be removed.

The username for an administrator of this database. 


This value should correspond to a MySQL username that has full system privileges.

This must correspond to the administrator account defined when MySQL was configured.
For Oracle, this value will be ignored, but the value must be different than the value of database.user.

Depending on how the install is done, or the value of database.re-create this may not be necessary. 
If re-create=true, then this is necessary, otherwise it isn't.

database.server

This value must correspond to the domain name of machine that hosts the Oracle/MySQL database server.

Talk to your database administrator to learn the server name and port.

remotehost.org

database.port

This value must correspond to the port for the database.server.

3306 is the default port, but check with your database administrator to be certain.

3306

database.name

Choose a name for the NCIA MySQL database. This must be different than the UPT database name.

nciadb

database.user

Give the username to access database.name.

nciaop

database.password

Use a password to access database.name for the username identified in database.user

Someth!ngSecure

URL for connection to a database. This is the standard implementation style.

This if fixed. No change required.

jdbc:mysql://${database.server}:${database.port}/${database.name}

URL for connection to a database. This is the standard implementation style.

This if fixed. No change required.

ldap.url

Universal Resource Locator address for LightWeight Directory Access Protocol server.

ldaps://university.edu:636

ldap.basedn

LDAP server holding referrals to other server holding a given distinguished name (DN).

u=nci,o=nih

ctp.server.port

The port that the CTP administration console will run on

23080

ctp.server.http_import_service.port

The port that CTP will accept submissions on.  This port should be configured as the port to export to in the CTP client configuration.

23104

ctp.server.admin.password

The password for the CTP server administrator

S0meth!ngSecurE

ctp.server.king.password

The password for the CTP server super administrator who has privilege to shutdown the server

S0meth!ngSecurE

ctp.server.storage_service.root

The directory where the CTP will store submitted files

storage/root

ctp.server.storage_service.index

The directory where the CTP will store the index for submitted files.  This directory must be the direct parent of ctp.storage_service.root.

storage

ctp.server.require_authentication

Whether or not the authentication is required for data submission (HttpImportService)

yes

ctp.server.verifier.port

The port that CTP will listen for verification requests on. 

Verification requests are queries to the (NBIA) database adapter to confirm that a given image was submitted successfully.

 23304

ctp.client.port

The port that the CTP administration console will run on (for the client)

24080

ctp.client.http_import_service.port

The port that CTP will accept submissions on.  This port should be configured as the port to send to in the FileSender.

24104

ctp.client.dicom_import_service.port

The port that CTP will accept submissions on.  This port should be configured as the port to send to in the FileSender.

24304

ctp.client.export_service.port

The port that CTP will export submissions to (to the server).  This should match up with the import service port on the server side.

24204

ctp.client.admin.password

The password for the CTP client administrator

S0meth!ngSecurE

ctp.client.king.password

The password for the CTP client super administrator who has privilege to shutdown the server

S0meth!ngSecurE

gov.nih.nci.ncia.imaging.server.url

Publicly visible URL for the Tomcat container hosting NBIA.

This URL should contain the proxy name instead of the host name if there is a proxy.

If this property is not configured properly, then thumbnails images may not appear in the web application search results.

http://locahost:45210

\\\\\\\\cbiofs502.nci.nih.gov\\\\nciaimages\\\\,\\\\\\\\cbiofs502.nci.nih.gov\\\\nciaproddataset\\\\dataset_p01\\\\,\\\\\\\\nfs-ncia-d.nci.nih.gov\\\\nciadevdataset\\\\dataset_d01\\\\

gov.nih.nci.ncia.zip.location

Location to place zipped files created by the NBIA web application for download.

/data/ncia_data/ncia_ftp

gov.nih.nci.ncia.ftp.location

Location to place files for download through an external FTP server. 

/data/ncia_data/ncia_ftp

gov.nih.nci.ncia.grid.local.node.name

If remote search is enabled, this is the name that will be used in the search form to search THIS node.

There is a separate property that governs the name of this node but as  viewed from other instances of NBIA. 

It is likely that these two properties should agree, but it isn't mandatory.

See: grid.poc.tech.researchCenter.displayname

NCI-1

gov.nih.nci.ncia.ui.uid.display.length

Determines the max character length of data representation in the UI tier

100

gov.nih.nci.ncia.ftp.url

FTP server URL used for informing users about where to download the larger size files

localhost

gov.nih.nci.ncia.installationSite

This property determines whether the installation is at ncicb or somewhere else (other). 

This governs certain aspects of the UI such as where the link to reset a password will point to.

ncicb, other

gov.nih.nci.ncia.admin.email

The email address of the user administrator

ncicbmb@mail.nih.gov

This is the URL that the Download Manager will use to retrieve DICOM images from. 

This should typically be the same host and port of the Tomcat server. 

The webapp context and file path should always be the same unless deployment has been customized.

enabled_guest_account

Whether or not public search will be enabled for this instance.

yes or no

guest_username

If enabled_guest_account=yes then this is the name of the CSM user that will blessed as the user for all public searches. 

This user should likely only be provisioned to be associated with PUBLIC protection elements.

nbia_guest

enable_classic_download

If this is set to no, then only the WebStart based Download Manager will be available to all users. 

If this is set to yes, then the "classic" download feature will still be available that allows downloading zip
 files of DICOM images through HTTP and/or HTTP

yes or no

If User wants to see Collections such as MR, CT, US etc in the Simple Search Page. By default it's set to false.

local.grid.uri

For a given installation, this is the URL to the grid service FOR THAT INSTALLATION itself.
 
If this is not set properly, and remote search is enabled, then the local node will appear twice in the
 list of searchable nodes. 

Once for the "local" search, and additionally for its grid interface (if it is registered with the index service).

http://imaging.company.com:45210/wsrf/services/cagrid/NBIAService

show.collection.search.criteria

If set to false, the collection criteria selection control will not appear in the classic search UI. 

This should only be set to false if a given instance of NBIA has, and only will ever have, 
only one collection/project to search through.

true or false

discover.remote.nodes

If set to false, the NBIA web application will not attempt to discover other instances of NBIA to search through the caGrid Index Service.

In other words, no remote nodes will appear at the top of the classic search page if this is set to false.

true or false

mail.smtp.server

Location of mail server to send emails for application to forward emails to users, notify users of the location of the download files

mail.university.edu

jar-signing.keystore.location

The location of the keystore to find a key to sign the download manager jars with. 

If (file://\\If) generate-selfsigned is set to true, then this location will be where the installation process CREATES the keystore. 

Otherwise (file://\\Otherwise), the keystore should already exist at this location.

c:/keystores/nbia_keystore

jar-signing.keystore.password

The password for the keystore pointed to by keystore.location.

If (file://\\If) generate-selfsigned is set to true, then this password will be set when the installation process CREATES the keystore.  \ (file://\\Otherwise)

Otherwise, the password should apply to the existing keystore.

something_secure

jar-signing.keystore.alias

The alias for the key to use when signing the download manager jars.

If (file://\\If) generate-selfsigned is set to true, then this alias will be set when the installation process CREATES the key and keystore. 

Otherwise (file://\\Otherwise), the alias should exist in the existing keystore.

alias1

jar-signing.execution.time

Whether to sign the jars at build time or install time.  If not at NCICB, this value should always be install.

build or install

jar-signing.generate-selfsigned

If set to true, the install process will generate a self-signed certificate to sign the jars with. 

If (file://\\If) false, there must be an existing certificate to use when signing.

true or false

exclude.start.servers

exclude.ctp

exclude.ctp-client

exclude.database

exclude.ctp.client.backup

exclude.ctp.server.backup

exclude.nbia-api

https://wiki.nci.nih.gov/display/NBIA/NBIA+Help+Topics#NBIAHelpTopics

For MySQL database:

com.mysql.jdbc.Driver

For Oracle database:

oracle.jdbc.driver.OracleDriver

For MySQL database:

${mysql.driver.jar}

For Oracle database:

${oracle.driver.jar}

For MySQL database:

${mysql.driver.jar.src.url}

For Oracle database:

${oracle.driver.jar.src.url}

ubuntu.downloader.installer.path

force.downloader.upgrade

A flag to send to NBIA Data Retriever for disabling "Remind me later" button

false

user.agreement.file.location

If set to True, this property shows the Protection Element tab in UAT. If this property is set to True, it is recommended that ctp.block.creating.newCollectionSite should also be set to true. This requires that a new collection and site must be created first before managing these elements in UAT.

If set to False, this property hides the Protection Element tab in UAT. An NBIA hosting site may chose to set this property to False if the are generating the Protection Element  automatically during the DICOM submission process.

Note: Configure the properties uat.enable.creating.newCollectionSite and ctp.block.creating.newCollectionSite together using one of the following two scenarios.

1. Set both uat.enable.creating.newCollectionSite and ctp.block.creating.newCollectionSite to False if you want users to submit DICOM data and then let the User Authentication Tool (UAT) create the Protection Element automatically, based on the collection and site in the submission.
2. Set both uat.enable.creating.newCollectionSite and ctp.block.creating.newCollectionSite to True if you want to create a new collection and site using UAT before users submit DICOM data for that collection and site. This bypasses the NBIA database adapter that would have normally created a new collection and site in the database based on the submission.

If set to True, this property prevents a new collection and site from being created automatically when DICOM data is submitted.

If set to False, this property creates a new collection and site when DICOM data is submitted.

See note above for more information.