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 Data Loader utility loads deployment-specific certificates, keystores, DNS entries, and Agent settings into a specified Direct Java RI Configuration Service.
The user is required to specify the target deployment domain and domain IPv4 address at runtime, as explained below.
Command Line
The utility is invoked on the command line:
$ ./dataloader.sh --help
Usage:
dataloader [--help -d <name> --dip <address> -i <path> --wsh <name> --wspd <path> --wsp <num>]
--help Print help information.
-d (--domain) name Domain name to load data for.
--dip (--domainip) address Domain IPv4 address to load data for.
-i (--in) path Path to the input directory or archive file from which to read certificates/keys.
--wsh (--wshost) name Web service (config-service) host.
--wspd (--wspath) path Web service (config-service) path.
--wsp (--wsport) num Web service (config-service) port number.
Required Options
-d (--domain) name Domain name to load data for.
--dip (--domainip) address Domain IPv4 address to load data for.
Optional Options
-i (--in) path Path to the input directory or archive file from which to read certificates/keys.
- The default value of the -i (--in) option is: <script path>/../out/datagen/<domain>-data.zip
--wsh (--wshost) name Web service (config-service) host.
- The default value of the --wsh (--wshost) option is: <domain name>
--wspd (--wspath) path Web service (config-service) path.
- The default value of the --wspd (--wspath) option is: /config-service/ConfigurationService
--wsp (--wsport) num Web service (config-service) port number.
- The default value of the --wsp (--wsport) option is: 8081
Example
$ ./dataloader.sh -d localhost --dip 127.0.0.1
Connected to data service (http://localhost:8081/config-service/ConfigurationService).
Loaded 27 entries into data service (http://localhost:8081/config-service/ConfigurationService).
Loaded 5 setting(s) into data service (http://localhost:8081/config-service/ConfigurationService).
Loaded 54 DNS record(s) into data service (http://localhost:8081/config-service/ConfigurationService).
Deployment
- Note: The Data Loader utility always performs a minimum amount of changes.
- It will only add new data entries if an identical entry does not already exist.
- It will only modify existing data entries when/if they match the associated key (i.e. the domain name for a DNS A record) of a loading entry, but not its value.