--- name: "ramanage.conf.5" section: "5" platform: "linux" package: "argus-client" version: "1:5.0.2+git20250321.41f65e2-2" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/ramanage.conf.5" --- # ramanage.conf.5(5) ramanage configuration options ## NAME **ramanage.conf** - **ramanage** configuration options ## SYNOPSIS **ramanage.conf** ## DESCRIPTION The following options control the behavior of the compress, upload and delete commands. These are set in @sysconfdir@/ramanage.conf or in a file referenced by the -f option. On Windows systems, these can be set in the 64-bit registry. See the WINDOWS REGISTRY section below for details. ## RAMANAGE\_LOCK\_FILE ramanage is designed to be run from [rastream(1)](/rastream/1.md). rastream will spawn one process for each file it closes, as the files are closed which will lead to multiple ramanage processes. To prevent all processes from consuming CPU and/or network resources simultaneously, a lock file can be specified which will ensure that only one ramanage process is working at any given time. The filename must be specified using posix conventions, meaning forward slashes between directories even on Windows systems. Currently, Cygwin is used for building Windows binaries and therefor the filenames must also adhere to the layout of Cygwin's "filesystem". On Unix systems, /var/lib and /var/lock are common places for this sort of file. ## RAMANAGE\_COMPRESS\_EFFORT Set the gzip compression effort. Allowed range is 1-9 inclusive. Currently not implemented. ## RAMANAGE\_COMPRESS\_METHOD Set the compression algorithm. Only gzip is supported. Currently not implemented. ## RAMANAGE\_COMPRESS\_MAX\_KB Limit the amount of data from the archive that can be compressed in one run of ramange. If compression is enabled, ramanage will always compress the file after the -r option, regardless of size. After, if archive processing is enabled, ramange will start with the oldest uncompressed file in the archive and will compress files until it reaches this limit. If no limit is specified or is set to zero, ramanage will continue until the entire archive is compressed. Must be a positive integer value. ## RAMANAGE\_UPLOAD\_USE\_DNS Look for a service record in DNS pointing to the QoSient collection system. The service record (SRV) name has the format \_argus\_upload.\_tcp.*domainname*. ramanage uses the resulting hostname and port values to find the collector. Priority and weight are ignored. Valid values are "yes" and "no". ## RAMANAGE\_UPLOAD\_USE\_DNS\_DOMAIN Look in DNS for a service record in this domain. Use in conjunction with RAMANAGE\_UPLOAD\_USE\_DNS. Valid values are valid domain names. Omit the trailing dot/period. ## RAMANAGE\_UPLOAD\_SERVER If not using a DNS service record to locate the collector, provide the numeric IPv4 or IPv6 address here. ## RAMANAGE\_UPLOAD\_DIR Upload (PUT) files into this directory on the collector. QoSient collectors default to /uploads. ramanage assumes no default directory. ## RAMANAGE\_UPLOAD\_USER When using BasicAuth, authenticate with this username. ## RAMANAGE\_UPLOAD\_PASS When using BasicAuth, authenticate with this password. Note that if an external curl binary is used, the password will appear on the commandline. ## RAMANAGE\_UPLOAD\_AUTH Set the authenticate type for HTTPS uploads. Leave blank for BasicAuth or set to "spnego" for Kerberos V5. ## RAMANAGE\_UPLOAD\_MAX\_KB Limit the amount of data from the archive that can be uploaded in one run of ramange. If upload is enabled, ramanage will always upload the file after the -r option, regardless of size. After, if archive processing is enabled, ramange will start with the oldest file in the archive and will upload files until it reaches this limit. If no limit is specified or is set to zero, ramanage will continue until the entire archive is uploaded. Must be a positive integer value. ## RAMANAGE\_UPLOAD\_DELAY\_USEC Delay uploads by some random time limited by this value. It is assumed that many systems will be uploading data to the same QoSient collector at the same time (since most systems have some sort of time synchronization, like NTP). Stagger the uploads some by waiting for an unpredictable time. Disable by setting to zero. ## RAMANAGE\_PATH\_ARCHIVE Specify the location of the local Argus file archive (mandatory). The filename must be specified using posix conventions, meaning forward slashes between directories even on Windows systems. Currently, Cygwin is used for building Windows binaries and therefor the filenames must also adhere to the layout of Cygwin's "filesystem". ## RAMANAGE\_PATH\_STAGING Specify the location of the local Argus file staging directory (mandatory). This is where files will be moved after upload. File remain in this directory until they are deleted, according to the ramange configuration. The filename must be specified using posix conventions, meaning forward slashes between directories even on Windows systems. Currently, Cygwin is used for building Windows binaries and therefor the filenames must also adhere to the layout of Cygwin's "filesystem". ## RAMANAGE\_RPOLICY\_DELETE\_AFTER Delete files in the staging and archive directories after the duration specified here in days. Must be a positive integer. ## RAMANAGE\_RPOLICY\_COMPRESS\_AFTER Compress files in the staging and archive directories after the duration specified here in days. Must be a positive integer. Set to zero to compress immediately. ## RAMANAGE\_RPOLICY\_MAX\_KB Delete the oldest files in the archive if more than this amount of storage is used. Currently not implemented. ## RAMANAGE\_RPOLICY\_MIN\_DAYS Keep at least this many days worth of argus data in the archive, even if this exceeds the storage requirements set in RAMANAGE\_RPOLICY\_MAX\_KB. Currently not implemented. ## RAMANAGE\_RPOLICY\_IGNORE\_ARCHIVE Set to "yes" if only the file specified by -r should be processed. Defaults to "no". ## RAMANAGE\_PROCESS\_ARCHIVE\_PERIOD ramanage is designed to be run from [rastream(1)](/rastream/1.md). rastream will spawn one process for each file it closes, as the files are closed which will lead to multiple ramanage processes. To prevent the archive compression and upload phases from running in close succession as a result, specify how often it is permissible to compress/upload/delete files in the archive. Value must be a non-negative integer and has units of seconds. ## RAMANAGE\_CMD\_COMPRESS Set to "yes" to enable file compression. Defaults to "no". ## RAMANAGE\_CMD\_DELETE Set to "yes" to enable file deletion. Defaults to "no". ## RAMANAGE\_CMD\_UPLOAD Set to "yes" to enable file uploads. Defaults to "no". ## WINDOWS REGISTRY If present, configuration items in the Windows registry will be preferred over those in configuration files. These are stored in HKLM:\\SOFTWARE\\QoSient\\ArgusClients\\ramanage. Configuration items have the same names as those in configuration files and have a type of either SZ for string values, or QWORD for numeric values. To view current settings from PowerShell, ``` C:\> Get-ItemProperty HKLM:\SOFTWARE\QoSient\ArgusClients\ramanage ``` Create the registry key if not present: ``` C:\> New-Item -Path HKLM:\SOFTWARE -Name QoSient C:\> New-Item -Path HKLM:\SOFTWARE\QoSient -Name ArgusClients C:\> New-Item -Path HKLM:\SOFTWARE\QoSient\ArgusClients -Name ramanage ``` Configuration values can be added to the ramanage key from PowerShell with the Set-ItemProperty cmdlet. Numeric values require the -Type parameter. To enter string values, omit the type parameter. ``` C:\> Set-ItemPropery -Path HKLM:\SOFTWARE\QoSient\ArgusClients\ramanage ` -Type QWord ` -Name RAMANAGE_RPOLICY_DELETE_AFTER ` -Value 180 C:\> Set-ItemPropery -Path HKLM:\SOFTWARE\QoSient\ArgusClients\ramanage ` -Name RAMANAGE_CMD_UPLOAD ` -Value yes ``` The regedit program (not regedit32) can be used to create the ramanage key and its properties if a graphical interface is preferred. ## SEE ALSO [**ramanage**(1)](/ramanage/1.md), [**rastream**(1)](/rastream/1.md) ## COPYRIGHT Copyright (c) 2000-2024 QoSient. All rights reserved.