Configuring iconik Agent
This sections explains what can be configured and how.
The Preferences window can be accessed from the
iconik Agent application menu on macOS and from the
File menu on Windows.
Tap the folder icon to browse for and choose a location that the agent will use for downloads.
If you are running the iconik Storage Gateway it is best to make sure that this is not located under a folder that the iconik storage gateway is monitoring
When enabled, you will be prompted for a download location each time a download is launched from the iconik web. This will override any download location configured under Default Download Location.
The iconik Agent can be configured to preserve custom collection ordering that has been set for a collection in the iconik web interface. When this option is turned on all file and directory names will get a numbered prefix added to the front of the name. This will allow you to use the normal sort by title functionality available in the system file browser to sort the items in a collection. If this option is turned off then no changes will be made to the name of the files and directories.
For the Agent to be able to reveal files on a locally mounted ISG it needs to know where it is located on the local system. It will try to find this location automatically but in case it can't you will need to configure it manually. In this case you should see the following dialog.
Please select the root of the ISG on the local system. This configuration can later be found in preferences under the ISG tab where it can also be changed.
Some configuration options are currently only available by modifying a settings file. This settings file can be found in the following locations:
~/Library/Application Support/iconik Agent
It can also be found by clicking the Show Config File... menu item under the Help menu. This will open a Finder or Explorer window with the configuration file selected.
These are the options that can be configured:
Settings related to downloads are contained in the
downloadSettings section. The following options are controlled using the config file and can currently not be set in the UI.
numParallelDownloads: This key controls how many parallel downloads the iconik Agent will attempt to run. This can be increased but keep in mind that the more parallel downloads the longer it will take for individual downloads to complete. The default value is
Settings related to uploads are contained in the
uploadSettings section. These options are currently only available in the configuration file. Modifying these settings can lead to worse upload performance if set incorrectly and the defaults should work for most users. Note that increasing any of these values will lead to higher memory and CPU load.
numConcurrentUploads: Controls the number of concurrent file uploads that are run. The default value for this setting is
numConcurrentChunks: When uploading a file it is split into multiple parts that are uploaded concurrently. This settings controls how many parts are uploaded concurrently. If you are on a very fast connection increasing this value can lead to faster uploads. Default value is
chunkSize: Controls the minimum size of each part that is uploaded in bytes. Note that this value can be overridden to a larger size by the Agent depending on the storage type and size of the file you are uploading. You should generally not have to change this value. If you are on a high latency connection though, increasing this value could lead to better speeds since there are less connects. Default value for this setting is
Below is a sample configuration
- Log level. The
logLevelkey controls what level of logs will be written to the log file. Available options are:
- Logging in - Logging in to the iconik Agent.