Set up Image Service

Table of Contents

Introduction
Acquisition Profile

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 Profile

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.

Image acquisition profile defines the following properties:

Table 1. Properties common for every storage provider
Property	Description
Title	A human-readable profile identifier
Storage Provider	The storage provider type
Root Path	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.

Table 2. Azure Storage specific properties
Property	Description
Storage Account Name	The username/account name
Storage Account Key	The corresponding password/access key for the storage account above.
Container Name	Which storage container to use. A Storage Account can have multiple Containers used for different purpose, e.g. `source-images`

Figure 2. Example Acquisition Profile / Azure

Table 3. AWS specific properties
Property	Description
Access Key Id	Access Key Id
Access Key	The corresponding password/access key.
Bucket name	Which bucket to use. Multiple buckets can be accessible with the same access key for different purpose
Region	AWS Region to use for data storage.

Figure 3. Example Acquisition Profile / AWS

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