The Media Management capability in Alfresco is delivered as a zip file containing AMP files, an instance of ActiveMQ, and the content services node infrastructure.
In these topics you will set up ActiveMQ, install the AMP files into an existing Alfresco instance, configure your settings and start Media Management.
Prerequisites for Media Management
There are a number of prerequisite software requirements for Media Management before you start the installation.
You require one of each of the following components.
Requirement | Description |
---|---|
Software |
alfresco-global.properties file. See Configure ActiveMQ for more information about installing ActiveMQ. See Install ImageMagick for more information about installing ImageMagick. |
Alfresco Content Services | Content Services 6.2. See Supported Platforms for more information. |
Java requirements | OpenJDK 11 or later. |
Remote transformation services (optional) | AWS Elastic Transcoder. See AWS and Configuring the Elastic Transcoder content transformer for more information. |
Install the Media Management AMP files
Download and install the Media Management AMP files, and add Media Management properties to your alfresco-global.properties
file. Ensure that you have installed the required external software before installing Alfresco Media Management. See Prerequisites for Media Management for information on what you require before you start the installation.
-
Stop the Content Services server.
-
Unzip the Alfresco Media Management package into a new system directory, for example,
opt/media-management
:alfresco-mm-distribution-1.4.x.zip
The ZIP file contains the following folders:
activemq
: contains ActiveMQ softwareamps-repository
: contains one AMP file to be applied to the Content Services repositoryamps-share
: contains one AMP file to be applied to Alfresco Shareremote-node
: contains content services node software and configuration file If you are using the recommended Media Management architecture, theactivemq
,amps-repository
andamps-share
folders reside on the Content Services server, and you must move theremote-node
folder to your remote server.
-
Install the repository AMP file. Navigate to the
amps-repository
directory and copy the following file to theamps
folder.alfresco-mm-repo-1.4.x.amp
-
Install the Share AMP file. Navigate to the amps_share directory and copy the following file to the amps_share directory.
alfresco-mm-share-1.4.x.amp
-
Delete the
tomcat\webapps\alfresco
andtomcat\webapps\share
folders in the Content Services installation directory. -
Navigate to the
bin
directory and run the Module Management Tool (MMT) file to install the repository AMP files:-
For the Content Services repository:
java -jar alfresco-mmt.jar install ../amps/alfresco-mm-<version>.amp ../tomcat/webapps/alfresco.war
java -jar alfresco-mmt.jar install ..\amps\alfresco-mm-<version>.amp ..\tomcat\webapps\alfresco.war
where
alfresco-mm-<version>.amp
is the specific AMP file that you downloaded. -
For Alfresco Share:
java -jar alfresco-mmt.jar install ../amps_share/alfresco-mm-<version>.amp ../tomcat/webapps/share.war
java -jar alfresco-mmt.jar install ..\amps_share\alfresco-mm-<version>.amp ..\tomcat\webapps\share.war
where
alfresco-mm-<version>.amp
is the specific AMP file that you downloaded.
Check the output to ensure that the AMP files have installed successfully.
-
-
Take a copy of the most recent
tomcat/webapps/alfresco.war<numbers>.bak
file in case you need to uninstall Media Management. -
Define properties relevant to Media Management in your
alfresco-global.properties
file.A sample
alfresco-global.properties
file is shipped in the root folder of the Media Management distribution zip, which defines custom properties. See Configure Media Management for the full list.-
If you have ActiveMQ on a separate server, configure the host and port number for ActiveMQ:
# Messaging broker, default is localhost messaging.broker.url=failover:(tcp://broker1:61616,tcp://broker2:61616)
where
broker
is each ActiveMQ instance that you have configured.You need to set this property only if your ActiveMQ instance is not on the same server as Content Services.
-
Configure FFmpeg and ExifTool if they are not already available on the command line executable path:
# FFmpeg executable path, default is ffmpeg ffmpeg.exe= # ExifTool executable path, default is exiftool exiftool.exe=
-
If you want to preview raw images, set the following properties in the
alfresco-global.properties
file.transformer.strict.mimetype.check=true transformer.strict.mimetype.check.whitelist.mimetypes=image/x-raw-adobe
Set the
transformer.strict.mimetype.check
property totrue
, and use thetransformer.strict.mimetype.check.whitelist.mimetypes
property to add thex-raw-adobe
MIME type to an existing whitelist. -
If you are using shared content workspaces, remote transformations or publishing channels, configure these as specified in Configure Media Management.
-
-
Update the
remote-node/config.yml
file that you extracted from the Media Management installation zip.Specify the ActiveMQ host name and prefetch policy (to ensure that transformations can be processed in parallel):
messaging: broker: url: tcp://localhost:61616?jms.prefetchPolicy.queuePrefetch=1
The content services node uses ImageMagick and FFmpeg and requires that the executable directories are available on the system PATH variable or are specified using
img.exe
andffmpeg.exe
system properties.For more information about the recommended architecture for Media Management, see Media Management architecture. For information about the content services framework, see Content services node architecture.
-
Restart the server.
-
Launch Alfresco Share.
To check that the Media Management AMPs have installed correctly, add a video or image to Share, open the file and check that you can see that the media loading and a Renditions Panel is available.
Uninstalling Media Management
To uninstall Media Management, you need to use the Module Management Tool (MMT) and reinstate certain files.
-
Stop the Content Services server.
-
Use the topic, Uninstall an AMP file, to uninstall the module.
-
If you have used a Media Management content model like IPTC or PBCore, you must clean out your database before restarting Alfresco. See Dynamic deployment approach for more information.
-
Restart the Alfresco server.