Cinegy Media Asset Management Service

Reading time ~7 minutes

The Cinegy Media Asset Management Service is a backend element that serves as a gateway for Cinegy products (such as Cinegy Convert, Cinegy Workspace, etc.) to access Cinegy MAM via the CAS (Cinegy Archive Service).

Installation

Select the MAMS.Setup.msi file from the downloaded installation package and run it to start the installation. Follow the setup wizard instructions:

At the next step read and accept the license agreement and proceed to the next step:

Define the installation folder or leave the default one and proceed to the next step:

At the next step press the "Install" button to start the installation.

A progress bar will show the progress of the installation process.

Press the "Finish" button to complete the installation and exit the setup wizard:

Setup

To launch the Cinegy MAM configurator, go to Start > Cinegy > Cinegy MAM Service (64 bit) configurator. The following configuration window appears:

It contains the following tabs:

Generic
Windows service
Logging

You can also use the "Manage" menu to manage database(s).

Generic Settings

In the "Generic" tab, you can define current Cinegy MAMS and Cinegy CAS connection settings:

Modify the port used by the service according to your requirements. After that, hover the mouse cursor over the crossed "Not secured" message and press the "Reserve" button in the "ACL" section:

In the "Default CAS connection settings" configuration group, define the following parameters:

Endpoint – default configuration is set to connect to the CAS (Cinegy Archive Service) installed locally on the same machine (localhost) and use the default port 8082. If the CAS is installed on another machine or a different port is used, the endpoint value should be modified accordingly:

http://[machine name]:[port]/ICinegyDataAccessService/
where:
- machine name – specifies the name or IP address of the machine where the CAS is installed;
- port – specifies the connection port configured in the CAS settings.
Domain – the name of the domain you are using.
Login – the name under which the connection to Cinegy Archive will be established.
Password – the logon password.

Windows Service

To run the Cinegy MAM service as a Windows service, go to the "Windows service" tab of the configurator and specify all the necessary parameters:

Service

The service display name and description are filled in by the system.

The status indication uses the following coloring:

Color indication	Service status
	Service is not installed
	Service is not started
	Service start is pending
	Service is running

Color indication

Service status

gray

Service is not installed

red

Service is not started

yellow

Service start is pending

green

Service is running

service_install_button

Press the "Install" button in the "Installation" field to install the Cinegy MAM service as a Windows service.

service_start_button

Once the service is installed, it should be started manually by pressing the "Start" button in the "State" field.

The current service state is displayed in the configurator:

The service can be uninstalled, stopped or restarted by pressing the corresponding buttons:

The service can also be managed as a standard Windows service:

Settings

The following Windows service settings are available:

Log on as – use the drop-down list to define service logon mode:

Note	This option should be selected depending on the user’s permissions assigned locally by the system administrator. The configurator requests elevated permissions where necessary (to reserve endpoint, for example). Otherwise, it should be run under normal user.

With the "User" option selected, the required field becomes highlighted with a red frame; press the button to expand the "Log on as" settings and enter the user name and password in the corresponding fields:

Note	Please keep in mind that the Windows service settings cannot be saved until all required fields are filled in; the red indicator shows a tooltip explaining the reason why settings cannot be applied.

Start mode – use the drop-down list to define service start mode.

It is recommended to use "Automatic (Delayed)" service start mode, which enables automatic service start immediately after all the main system services have been started.

Logging

The Cinegy MAM service logging parameters are defined in the "Logging" tab of the configurator:

The logging parameters are split into the following groups: File Logging, Telemetry File Logging and Telemetry.

File Logging

Define the settings for a log report saved to a text file.

Logging level – use the drop-down list to define one of the following available log levels, ordered from the highest to the lowest severity:
- Off – disable file logging.
- Fatal – logs for failures, like data loss scenarios that require immediate attention and can lead the service to stop.
- Error – logs for errors, exceptions and failure in the current activity or operation, that might still allow the service to continue running.
- Warn – logs for unexpected events in the service flow, like errors, exceptions or conditions that do not cause application crash. It is the default log level.
- Info – logs for general application flow and progress tracking with long-term value.
- Debug – logs for short-term and fine-grained information used for development and debugging.
- Trace – logs for information used for debugging that may contain sensitive application data.
Log folder – define the destination folder for storing log files. By default, logs are written to the C:\ProgramData\Cinegy\Cinegy MAM Service\XX.X.XXX.XXXXX\Logs\. You can change the directory by entering a new path via the keyboard or using the button to select the required folder:

Telemetry File Logging

Define the settings for a log report saved to a text file by using the telemetry cluster.

Caution

Administrative user rights are required to set up the Telemetry logging functionality.

To configure telemetry file logging, define the following parameters:

Logging level – use the drop-down list to define one of the following available log levels, ordered from the highest to the lowest severity: Off, Fatal, Error, Warn, Info, Debug and Trace.
Log folder – define the destination folder for storing log files. By default, logs are written to the folder where the Cinegy MAM service is installed. You can change the directory by entering a new path via the keyboard or using the button to select the required folder.

Telemetry

The telemetry notifications are logged into Grafana portal deployed inside the Cinegy Telemetry cluster that allows securing customer data by organization ID and provides a direct access to the exact data stored.

To access the telemetry portal, specify the following parameters:

Logging level – use the drop-down list to define one of the following available log levels, ordered from the highest to the lowest severity: Off, Fatal, Error, Warn, Info, Debug and Trace.
Organization ID – specify the Organization ID, unique for each customer.
Tags – set the system tags to filter telemetry results.
Url – enter the link to access the telemetry portal. The default value is https://telemetry.cinegy.com.
Credentials – use the drop-down list to define the credentials to access the telemetry portal:
- None – no credentials are required.
- Basic authentication – select this option and enter the username and the password to access the telemetry portal:

Having specified all the required parameters, press the "Apply" button to save changes.

Managing Databases

This menu provides access to database(s) management.

Press the "Manage" button; the following drop-down list with all available options appears:

Import from another version

Use the "Import from another version" option to import all settings from previously installed and configured Cinegy MAM service versions and apply settings to the current one:

Select the required version from the list. You will be asked to confirm your decision. Press the "Yes" button to save and apply the imported settings to the current version.

Import from file

The "Import from file" option allows importing previously exported or settings file from previous versions in XML format:

Use the "Load settings from" window that appears to import settings file from the selected folder. All log and settings files of previously installed Cinegy MAM service versions are stored in separate folders named according to the Cinegy MAM service version. Navigate to the C:\ProgramData\Cinegy\Cinegy MAM Service and select the required version to import the specific settings file:

Export to file

With the help of the "Export to file" option it is possible to export all current settings to an XML file:

On the "Save settings as" window that appears, define the file name and save the settings file to the selected folder:

Reset settings to default

Select the "Reset settings to default" option to return to the default settings:

Having specified all the required settings, press the "Apply" button to save changes.