Roles

These are the roles that are needed:

  • Admin

ISG Advanced Options

The iconik Storage Gateway has a number of advanced options that you can tune by editing the configuration file config.ini.

  • Back up config.ini before you make these changes.
  • Configuration options are key value pairs such as proxy-resolution=1920x1080
  • Configuration options should be on individual lines.
  • Restart the ISG after making the changes

config.ini location

OS Location
Linux /opt/cantemo/iconik_storage_gateway/config.ini
Windows C:\Program Files\Cantemo\Iconik Storage Gateway\config.ini
MacOS /Library/Application Support/Cantemo/IconikStorageGateway/config.ini

Please make sure if you are editing on Windows the line endings are of a Unix type

Setting Proxy Format Specification

It's possible to change the proxy format that the ISG will generate for video media. Please note that setting the bitrate too high or low can have a negative impact on the perceived performance of the Web Interface.

Proxy resolution:

By setting the key proxy-resolution you can define the max-dimensions of the proxy created.

  • Minimum value: 640x360
  • Default value: 1280x720
  • Maximum value: 1920x1080

For example:

proxy-resolution=1920x1080

Proxy bitrate

By setting the key proxy-bitrate you can define the max bitrate of the proxy created. Please be aware that setting this higher can cause large file sizes for your proxy.

  • Minimum value: 200000
  • Default value: 3000000
  • Maximum value: 10000000

For example:

proxy-bitrate=4000000

Controlling file transfers and transcodes

Number of parallel uploads and downloads

By setting the key file-upload-parallel-uploads-num you can control how many simultaneous uploads the ISG will do. The default is 4 By setting the key file-upload-parallel-uploads-threads-num you can control how many parallel chunks for each upload is used. The default is 5

file-upload-parallel-uploads-num = 4

file-upload-parallel-uploads-threads-num = 5

By setting the key file-upload-parallel-downloads-num you can control how many simultaneous downloads the ISG will do. The default is 4

file-download-parallel-downloads-num = 4

Number of parallel transcodes

By setting the key max-transcoding-jobs you can control the number of simultaneous local transcodes.

max-transcode-jobs = 2

Enabling debug

Debug is enabled by setting the option debug to true

debug = true

Mediainfo timeouts

If you get timeouts reading media info you can increase that, the default is 60s

extract-mediainfo-timeout = 180

Control the number of checksum workers

Checksumming is both CPU and I/O intense. You can control the number of parallel workers doing checksumming. The default is the number of CPUs on your server

checksum-max-workers = 4

Disable the UUID-suffix on uploaded files

By default the ISG will add a UUID to the end of the file name when uploading to a cloud storage to make sure it does not conflict with any existing files. This can be disabled if you know that only this ISG will write to that cloud storage.

auto-generate-filename-for-remote-upload = false

Overriding format detection

Some times you might have files that gets identified as the wrong type. You can override this by file extension by providing a list

image-extensions-override=.psd,.tiff

video-extensions-override=.mp4,.mxf

audio-extensions-override=.wav,.m4a

this means that regardless of what mediainfo returns they will be sent to the transcoder that handles the type of format you have specified.

Learn More