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.