The Axinom Mosaic platform includes the Image Service that allows to upload and manage images. Set up the ingest functionality or the option to upload images from a pre-defined blob storage.

Set up Image Service

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:

settings hub
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.

acquisition settings
Figure 2. Example Acquisition Settings

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

Setting Description

Storage Type

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

Storage Location

A storage URL. In case of Azure Storage, this is the URL for your storage, including the Container name. In the example above, the storage account is examplestoragename and the 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.

(Read) Storage Username

The username/account name

(Read) Storage Password

The corresponding password/access key for the account name above.

Azure Storage Credentials

To retrieve the values for the above settings, go to the Azure Portal and your Storage Account. Navigate to SettingsAccess keys, click Show keys, and get a connection string, similar to the one below:

DefaultEndpointsProtocol=https;AccountName=examplestoragename;AccountKey=pCFqwDE0AwVa3LS4Fg3ypAqHbCFTidv6kbtDbDfGWb2wwRaL7F7kccze3OAVAHLSZn+QwId5SaCMy1vUPWlBIQ==;EndpointSuffix=core.windows.net.

The important values are listed in the table below.

Value Description

AccountName (examplestoragename)

Goes into the (Read) Storage Username field.

AccountKey (<account_key>)

Goes into the (Read) Storage Password field.

AccountName, EndpointSuffix (core.windows.net), and your Storage Container name (source-images)

These would be combined as https://examplestoragename.core.windows.net/source-images, they go onto the field Storage Location.