Client Configuration Update via Command Line

The updateconfig command line operation can be used to update a previously provisioned client with the latest information from a management server (ePO or OpenDXL Broker).

Note

ePO-managed environments must have 4.0 (or newer) versions of DXL ePO extensions installed.

The updateconfig operation performs the following:

  • Retrieves the latest CA certificate bundle from the server and stores it at the file referenced by the BrokerCertChain setting in the [Certs] section of the dxlclient.config file.
  • Retrieves the latest broker information and updates the [Brokers] and [BrokersWebSockets] sections of the dxlclient.config file with that information.

Basic Example

For example:

java -jar dxlclient-0.2.6-all.jar updateconfig config myserver

Note

Ensure that the -all version of the dxlclient .jar file is specified.

For this example, config is the name of the directory in which the dxlclient.config file resides and myserver is the hostname or IP address of ePO or an OpenDXL Broker.

When prompted, provide credentials for the OpenDXL Broker Management Console or ePO (the ePO user must be an administrator):

Enter server username:
Enter server password:

If the operation is successful, output similar to the following should be displayed:

INFO: Updating certs in config/ca-bundle.crt
INFO: Updating DXL config file at config/dxlclient.config

To avoid the username and password prompts, supply the appropriate command line options (-u and -p):

java -jar dxlclient-0.2.6-all.jar updateconfig config myserver -u myuser -p mypass

Note

Ensure that the -all version of the dxlclient .jar file is specified.

Additional Options

The update operation assumes that the default web server port is 8443, the default port under which the ePO web interface and OpenDXL Broker Management Console is hosted.

A custom port can be specified via the -t option.

For example:

java -jar dxlclient-0.2.6-all.jar updateconfig config myserver -t 443

Note

Ensure that the -all version of the dxlclient .jar file is specified.

If the management server’s CA certificate is stored in a local CA truststore file – one or more PEM-formatted certificates concatenated together into a single file – the update operation can be configured to validate the management server’s certificate against that truststore during TLS session negotiation by supplying the -e option.

The name of the truststore file should be supplied along with the option:

java -jar dxlclient-0.2.6-all.jar updateconfig config myserver -e config/ca-bundle.crt

Note

Ensure that the -all version of the dxlclient .jar file is specified.

Routing client configuration update operation through a proxy

If the remote call to a provisioning server (ePO or OpenDXL Broker) used during a client configuration update must be routed through a proxy, then use standard Java system properties to declare the https proxy host, port, user name, and password. (https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html)

For example:

java -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=3128 -Dhttps.proxyUser=proxyUser -Dhttps.proxyPassword=proxyPassword -jar dxlclient-0.2.6-all.jar updateconfig config myserver