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:

Cinegy MAMS

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

Cinegy MAMS

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

Cinegy MAMS

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

Cinegy MAMS

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

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

Cinegy MAMS

Setup

icon

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

It contains the following tabs:

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

Generic Settings

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

MAM Service Configuration Generic Tab

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:

Reserve connection

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. In case the CAS is installed on another machine or another port is used, the endpoint value should be modified:

    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:

MAMS_cfg_service

Service

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

The status indication uses the following coloring:

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:

service_running

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

windows_service_control_section

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

windows_service

Settings

The following Windows service settings are available:

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

    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:

    Logon_as_user_name_password
    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.

    Service_start_mode
    Note
    		 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:

Logging

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\X.XXX.X.XXX\Logs\. You can change the directory by entering a new path via the keyboard or using the browse button to select the required folder:

    Logging_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.
telemetry_file_logging

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 browse 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.

telemetry_logging

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:

      basic_authentication

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

Managing Databases

This menu provides access to database(s) management.

manage_button

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

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:

manage_list

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:

import_file

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:

import_from

Export to file

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

export_list

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

export_to

Reset settings to default

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

reset_settings

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