Reminder: Do not include any PHI or PII in Confluence. If you require 508 accessibility assistance or any other support for this system, then please send an email to onc-jira-questions@healthit.gov
Introduction
The Configuration Generator utility generates deployment-specific versions of the property files used by the web application portion of the Direct Certificate Discovery Tool.
The user is required to specify the target deployment domain and the result mail sender information at runtime, as explained below.
Command Line
The utility is invoked on the command line:
$ ./configgen.sh --help
Usage:
configgen [--help -d <name> -o <path> --ra <address> --rps <pass> --rh <host> --rp <num>]
--help Print help information.
-d (--domain) name Domain name of the deployment.
-o (--out) path Path to the output archive file.
--ra (--resaddr) address Result mail address.
--rps (--respass) pass Result mail password.
--rh (--reshost) host Result mail host.
--rp (--resport) num Result mail port.
-rs (-resssl) Result mail SSL usage.
Required Options
-d (--domain) name Domain name of the deployment.
--ra (--resaddr) address Result mail address.
--rps (--respass) pass Result mail password.
--rh (--reshost) host Result mail host.
Optional Options
-o (--out) path Path to the output archive file.
- The default value for the -o (--out) option is: <script path>/../out/configgen/<domain>-config.zip
--rp (--resport) num Result mail port.
- The default value of the --rp (--resport) option is: 465
-rs (-resssl) Result mail SSL usage.
- The default value of the -rs (-resssl) option is: true
- Note: As of revision 514, the Tool's Java Mail properties include mail.smtp.socketFactory.fallback=true.
- This means that, if enabled, SSL will be tried first and if it fails, regular SMTP will be subsequently tried using the same port.
Example
$ ./configgen.sh -d localhost --ra dcdt@localhost --rps p4ssw0rD! --rh localhost
Successfully wrote output file: out/configgen/localhost-config.zip
Deployment
Extract the generated zip file to the directory set by the dcdt.config.dir system property value, which is passed into the web application container.