<< 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.
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. |