getconfig

<< Click to Display Table of Contents >>

RayVentory Scan Engine > 12.6 u4 > User Guide > Inventory Agent > Commands 

getconfig

This command will attempt to download a configuration file from a defined host.

 

Inventory Agent will attempt to download from one of the source URLs in the configuration file unless you include an URL after the command. If an URL was specified, then Inventory Agent will not try any other URLs on error.

 

After a successful download, Inventory Agent will attempt to apply its schedule to the systems scheduler (delete previously defined scheduled tasks and create new scheduled tasks). Further, usage metering related registry settings will also be applied and the file whitelisted.xml for the usage metering service is written if needed.

 

You can force Inventory Agent to try to apply the schedule in the current configuration file (see command schedule). You need to add a source URL by adding a line for the setting configDownloadSource to the configuration file.

 

Example of downloading a configuration file from a location specified in the configuration file (from command-line):

rvia getconfig

 

Example of downloading a configuration file from a specific URL:

rvia getconfig http://192.168.123.123:951/rviaconfig/special.cfg

 

Example of two download sources in the configuration file:

configDownloadSource=http://192.168.123.123:951/rviaconfig/special.cfg

configDownloadSource=http://192.168.123.123:951/rviaconfig/default.cfg

 

Bear in mind that RayVentory Scan Engine will always host a basic configuration file (which sets basic auth credentials and upload- and download locations, according to the RVSE configuration) at

http://<yourhostname>:<configured-port>/rviaconfig/default.cfg

or

https://<yourhostname>:<configured-port>/rviaconfig/default.cfg

 

The configuration can be managed from the Settings screen.

 

Mind that you can use the settings configDownloadUser and configDownloadPassword to specify credentials for basic authentication during download. See command encrypt for details.

 

You can specify a proxy (including credentials) by the setting resultUploadProxyURL for the upload.

 

Example:

configDownloadProxyURL=https://proxyUser:proxyUserPassword@172.16.1.1:8080/

 

To pass additional arguments to curl for download, use the setting configDownloadCurlArgs.

 

papercliper

Note:

For large numbers of Inventory Agent instances, you should use configDownloadMaxDelay to delay individual downloads to a maximum of the specified number of seconds. That will spread the network load over the time domain.