Set up Image Service

Table of Contents

Introduction
Acquisition Settings

Introduction

By default, Image Service is already set up to allow uploading and managing images. However, an extra setup is needed if you wish to use the Ingest functionality with images or programmatically upload images from a pre-defined blob storage using the RabbitMQ EnsureImageExists command.

To configure the required acquisition settings in the Management System, open your Management System UI in a web browser. From the home screen, navigate to Settings and find this section:

Figure 1. Image acquisition under Settings

Acquisition Settings

These settings define how the Image Service can acquire the source image files when they are referenced by a relative path during Ingest or when using the EnsureImageExists command processing.

Figure 2. Example Acquisition Settings

The table below describes the settings that you see under Image Acquisition.

Setting Description

Setting	Description
Storage Type	The storage provider type. Currently, we support Azure Storage (`Azure Storage Account`). More options will become available in the future.
Container Name	In case of Azure Storage, this is the Container Name. In the example above, container name is `source-images`. This is the storage location where the image files are taken from.
Storage Root Folder	An optional value that is used to define some sub-folder from which the images should be downloaded. If no value is specified, the images are acquired from the root storage location. If a value is specified, it must be a single folder name or a path, e.g `folderName/anotherFolder`. In this example, the images are acquired relatively to this folder.
Account Name	Azure storage account name
Account Key	Storage account access key for the account name specified above.

Storage Type

The storage provider type. Currently, we support Azure Storage (Azure Storage Account). More options will become available in the future.

Container Name

In case of Azure Storage, this is the Container Name. In the example above, container name is source-images. This is the storage location where the image files are taken from.

Storage Root Folder

An optional value that is used to define some sub-folder from which the images should be downloaded. If no value is specified, the images are acquired from the root storage location. If a value is specified, it must be a single folder name or a path, e.g folderName/anotherFolder. In this example, the images are acquired relatively to this folder.

Account Name

Azure storage account name

Account Key

Storage account access key for the account name specified above.

Tip	We recommend to create your storage using Mosaic Hosting Service. Alternatively, you can create storage using Microsoft Azure Portal.