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.
  • No labels