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
This guide details the process for configuring the Direct Certificate Discovery Tool (DCDT, or the Tool) following the completion of one of the Install Guide(s).
Document Conventions
Variables
Replace all instances of the following prior to running commands:
Key | Value Description |
<yourhealthdomain.com> | Your deployment domain. |
<yourhealthdomain.com ip> | Your deployment domain IPv4 address. |
<result mail address> | Result mail address. |
<result mail pass> | Result mail password. |
<result mail host> | Result mail host. |
Requirements
You have completed the Linux Package Install Guide and optionally the Source Build Guide.
Generate & Deploy Tool Data
Generate the Tool data by running the Data Generator utility:
sudo /usr/share/direct/direct-cert-discovery-tool-utils/bin/datagen.sh -d <yourhealthdomain.com>
Deploy the Tool data by running:
sudo unzip -o /usr/share/direct/direct-cert-discovery-tool-utils/out/datagen/<yourhealthdomain.com>-data.zip -d /var/lib/direct/direct-cert-discovery-tool
sudo chown -R tomcat7:tomcat7 /var/lib/direct/direct-cert-discovery-tool
Generate & Deploy Tool Configuration
Generate the Tool configuration by running the Configuration Generator utility:
sudo /usr/share/direct/direct-cert-discovery-tool-utils/bin/configgen.sh -d <yourhealthdomain.com> --ra <result mail address> --rps <result mail pass> --rh <result mail host>
Deploy the Tool configuration by running:
sudo unzip -o /usr/share/direct/direct-cert-discovery-tool-utils/out/configgen/<yourhealthdomain.com>-config.zip -d /var/lib/direct/direct-cert-discovery-tool
sudo chown -R tomcat7:tomcat7 /var/lib/direct/direct-cert-discovery-tool
Load Tool Data
Load the Tool data by running the Data Loader utility:
sudo /usr/share/direct/direct-cert-discovery-tool-utils/bin/dataloader.sh -d <yourhealthdomain.com> --dip <yourhealthdomain.com ip>
Load Tool LDAP Data
Load the Tool LDAP data by running the LDAP Loader utility:
sudo /usr/share/direct/direct-cert-discovery-tool-utils/bin/ldaploader.sh -d <yourhealthdomain.com>
Reload the Tool
Restart the Tomcat 7 service by running:
sudo service tomcat7 restart
Configure James
Stop the James 3 service by running:
sudo service james3 stop
Set the Tool James domains by running:
sudo /usr/share/direct/direct-cert-discovery-tool-utils/bin/james3-setdomain.sh <yourhealthdomain.com>
Start the James 3 service by running:
sudo service james3 start
Add the Tool James users by running:
sudo /usr/share/direct/direct-cert-discovery-tool-utils/bin/james3-addusers.sh <yourhealthdomain.com>