Equilibrium MediaRich Installation Guide

MediaRich is digital asset processing software that automates image, animation, sound, and digital video production and enables on-demand delivery to virtually any website or device.

The MediaRich engine is not available for SaaS customers.

Windows Installation  

This article describes the MediaRich Server 3.9 installation on Windows.

NOTE: The procedure below was tested using MediaRich Server 3.9. The process may have changed for other versions of MediaRich Server, so please reference Equilibrium's documentation for the most up-to-date instructions. See Supported Transcoding Engines for more information on the versions supported with the latest stable release of NetX.

 

Prerequisites

Before you begin, please ensure that you possess the following:

  1. Familiarity with Windows Server operating systems and server administration.
  2. An operational instance of Windows 2012 R2 or newer.
  3. A valid MediaRich license.
  4. Experience administering the NetX application.

 

Installing MediaRich

  1. Locate the MediaRich server installation file.

  2. Unzip the zip archive.

  3. Now double-click on "MediaRichCORE_Setup.exe" file to open it.
  4. Depending on AntiVirus/System protection software may provide an alert stating that this installation file cannot be validated. Ignore the warning and proceed with the installation.
  5. The installation wizard will appear. Click Next to continue.

  6. Select the path of the installation. Only change the installation path if it is absolute necessary. Click Next to continue.

  7. Choose a Windows Service account that will run the MediaRich services. If you aren't sure what this is or do not want to specify an account, just leave the defaults and click Next.
  8. Wait for the installation to complete.
     




License Installation

 

The username and password will be automatically filled-in. 

Next, install the MediaRich server license. Select "Install a License File" button and this will open windows folder window. Browse through the folder and select the correct MediaRich license file.

 

Please read the full license and "Accept":

Go through the README document and select "OK":

Now you should see the "green" icon next to "License File". Click on "Start Server" to start the MediaRich core server.

With all three icons green, you have successfully installed MediaRich. You can now close the console by clicking the "Quit" button below.

NetX Configuration

The NetX configuration includes copying necessary files from NetX to MediaRich server installation folder and setting up the NetX configuration (exogen-config).

Copy the Net MediaRich script file into the MediaRich installation

Copy the NetX.ms (for zoom) and imageportalmrscript.ms (for image processing only, not needed for zoom) files into MediaRich server folder. To do so, find the file(s) in your NetX installation (eg: "C:\Program Files \netx\{name}\webapps\ROOT\WEB-INF\bin\mediarich" — the folder might slightly different on your installation). Then, copy the ".ms" file(s) into the MediaRich Installation folder " C:\Program Files (x86)\Equilibrium\MediaRichCore\Shared\Originals\Scripts ". This MediaRich installation path is the same if you had selected the default path for installation. Please select if it is installed in a different path.

While copying the MediaScript (.ms) files, you might see this below screen. Please select "continue"

 

Folder location : C:\Program Files (x86)\Equilibrium\MediaRichCore\Shared\Originals\Scripts

Finally, restart the MediaRich server using the MediaRich CORE Administrator panel.

Set NetX properties

The following properties are associated with configuring MediaRich with NetX: 

Property Description
equilibrium.mediarichHost

Hostname or IP address of your MediaRich server. This is used by NetX to communicate with MediaRich. Note this is not a URL. Do not add an http(s):// or other prefix. This property is required.

Value options: Hostname / IP address

equilibrium.mediarichPort

Only change this if you have changed the default configuration on your MediaRich server.

Value options: Number

equilibrium.installedPlatform

This identifies the OS on which MediaRich is installed, mac (Linux) or win (Windows). 

Value options: mac / win

image.ignoreMediarichZooms

When equilibrium.zoomEnabled is true, this property is set to false and must remain so.

Value options: true / false

zoom.tiles.enabled

When equilibrium.zoomEnabled is true, this property is set to false and must remain so.

Value options: true / false

zoom.tiffTileZoomEnabled

This property must be set to false.

Value options: true / false

equilibrium.enabled

Enable the MediaRich plugin. This property is required.

Value options: true / false

equilibrium.zoomEnabled

Enable MediaRich zoom functionality.

Value options: true / false

equilibrium.clientServer

URL of your NetX server (e.g. https://acme.netx.net:9000); this is only needed if you are using HTTPS or a non-standard port.

Value options: URL

Example of a minimal configuration file (e.g. exogen-config-mediarich.xml) to enable zoom support:

exogen-config-mediarich.xml
<!-- Enable MediaRich support -->
	    <property>
			<name>equilibrium.enabled</name>
			<value>true</value>
		</property>
		<!-- The OS used on the MediaRich server -->
		<property>
	      <name>equilibrium.installedPlatform</name>
	      <value>win</value>
	    </property>
 		<!-- The IP address of the MediaRich server -->
		<property>
			<name>equilibrium.mediarichHost</name>
			<value>192.168.0.108</value>
		</property>
		<!-- Enable MediaRich dynamic zoom -->
		<property>
			<name>equilibrium.zoomEnabled</name>
			<value>true</value>
		</property>


MediaRich dynamic zoom

When MediaRich is configured and the "equilibrium.zoomEnabled" property is "true", you can use MediaRich for dynamic zooming within NetX. Open the asset and move into detail page. Select the double arrow icon for dynamic zoom windows to get open.

NOTE NetX instances with global watermarks will NOT have them applied to MediaRich Zoom.

Now the MediaRich zoom window will open and it should look something like the example, below:

NOTE : A developer license is used with MediaRich server while creating this document. If you have a valid license the watermark won't appear in the asset image.

Clearing the MediaRich cache

It's a good idea to set up a scheduled task or cron job to periodically delete the files in the MediaRich cache directory, as shown below. The path below assumes MediaRich has been installed in C:\Program Files (x86), but your installation may vary.

C:\Program Files (x86)\Equilibrium\MediaRichCore\Shared\Generated\MediaCache\netx\

Was this article helpful?
0 out of 0 found this helpful