1. Home
  2. isg
  3. macos

Roles

These are the roles that are needed:

  • Admin

ISG on Mac OS

This section contains everything you need to know about installing and managing the iconik Storage Gateway (ISG) on MacOS.

ISG is supported on the latest three MacOS versions, older versions are unsupported but may work. It is a Universal binary supporting both Intel and Apple Silicon (M1/M2)

Local transcoding

Local transcoding is required for viewing your content in the web browser

For local transcoding to work you will have to install ffmpeg, ghostscript and ImageMagick. Make sure they are in the path for the user running the service. If you do not want local transcoding you can skip this section and go directly to the Installation next.

To get frame accurate playback in other browsers than Safari you also need mp4mux from Bento4

https://www.bento4.com/downloads/

Unpack the correct package, and copy the mp4mux binary to /usr/local/bin

To write xmp metadata which can be used in our adobe integration to the proxy files you need Exiftool

https://exiftool.org/install.html#MacOS

You can also install all packages via Brew: https://brew.sh/ and then run:

brew install ffmpeg imagemagick bento4 poppler ghostscript exiftool

Note: Xcode is required to install brew. You can download and install Xcode from the App Store.

Download and install the Iconik Storage Gateway

https://downloads.iconik.io/IconikStorageGateway-latest.pkg

This will install the ISG and the Mac Tray application. The first time it will automatically start the Setup Wizard.

  1. The first step will ask you to log in to iconik using the Web interface. Once that is done and you approved the application to use your credentials, go back to the installer.
  2. Then select "Setup new iconik Storage Gateway" and press Next
  3. Give it a name that makes it possible to identify it (Default is your computers name followed by ISG)
  4. Select the Local folder that you want to scan and press Next
  5. This will set the ISG up to use Local transcoding and not keep the original files locally. If you want to use any other settings, please click "Advanced Settings.." and that will take you to the Storage configuration page (See also Creating storages).
  6. When you are done with your advanced settings press Finish

The Tray application is visible as an iconik icon in your top navigation bar on you Mac, where you can access the menu to start/stop the service, as well as getting to the configuration and viewing the logs.

Advanced configuration without the Tray application

ISG will install its config files in /Library/Application Support/Cantemo/IconikStorageGateway where you will find config.ini

Unload the service for now.

sudo /bin/launchctl unload "/Library/LaunchDaemons/com.cantemo.IconikStorageGateway.plist"

Edit config.ini to look like this (See Setting up how to get the correct values)

[main]

app-id = 22f34c6e-268e-11e7-ac53-6c4008b85488
storage-id = 15fa3f68-7693-11e7-bf0c-02420a021013
iconik-url = https://app.iconik.io/
auth-token = eyJhbGciOiJIUzI1NiIsImlhdCI6MTUwMTU3NjAyNCwiZXhwIjoxNTAxNjE5MjI0fQ.eyJpZCI6IjMzMjFkMjIyLTc2OTMtMTFlNy1hN2EyLTAyNDIwYTAyMTAxYSJ9.sgag4OQb19J9qT1IAdKZYAqbpIoai7oW60Mahye7o8s
sleep-time = 10
max-transcoding-jobs = 1
file-upload-parallel-uploads-num = 4
file-download-parallel-downloads-num = 4
log-filename = /Library/Logs/Cantemo/IconikStorageGateway/default.log

Start the service

sudo /bin/launchctl load "/Library/LaunchDaemons/com.cantemo.IconikStorageGateway.plist"

Logs

For following the log file, you can use the following command:

sudo tail -f /Library/Logs/Cantemo/IconikStorageGateway/default.log

Additional logs are available here, organised by Storage ID:

/Library/Logs/Cantemo/IconikStorageGateway/

Control access to files and folders on Mac

These Mac folders require special rights: Desktop, Downloads and Documents folders. You can control this in System Settings under Privacy & Security > Files and Folders. Turn the ability to access files and folders in a required location for iconik Storage Gateway application.

More information on Mac official help pages.

Installation guides per platform:

More information for Administrators