This document is a guide to upgrading to MediaCentral Platform Services (MCS) 2.2 from a
previous version of MCS or Interplay Central Services (ICS). It also includes instructions on
migrating the UMS database from a production system to a test system.
Note: For a list products qualified for use with MCS 2.2, and the supported RHEL operating
system, see the Avid MediaCentral Platform V2.2 ReadMe.
Note: The Gluster version changed and additional Gluster packages are required as of MCS 2.0.
See “Obtaining Gluster” in the MediaCentral Platform V2.2 ReadMe.
Avid® recommends that you read all the information in this upgrade guide thoroughly
before installing or using the corresponding software release.
Important: Search the Avid Knowledge Base at http://www.avid.com/support
up-to-date ReadMe, which contains the latest informatio n that might have become
available after the documentation was published. The MCS 2.2 documentation can be found
here:
How to Use this Guide ............................................................................................................................... 4
Operating System ....................................................................................................................................... 4
Update Installation versus Full Installation ................................................................................................ 5
Obtaining the MCS Installation Package .................................................................................................... 5
Copyright and Disclaimer ......................................................................................................................... 45
3
Overview
How to U se this Guide
Operating System
Upgrading to MediaCentral Platform Services (MCS) 2.2 for MediaCentral, Media
Composer | Cloud, and Interplay | MAM, involves the migration of settings and data along
with the software upgrade. Depending on the upgrade path you are faced with, the
migration of settings and data is manual or automated. When upgrading from the earliest
versions of Interplay Common Services (ICS) the upgrade involves significant changes to the
hardware topology of the system.
Note: Beginning with version 2.0, the term “MediaCentral Platform Services” replaces
“Interplay Central Services.” In addition, the term “MediaCentral Play back S ervice” replaces
“Interplay Central Playback Service.”
There are two main upgrade paths to MCS 2.2, depending on the currently installed
operating system:
MediaCentral Services 2.2 U pgr a ding Gui de
• RHEL 6.5 – If this is the currently installed OS, the upgrade is non-destructive and
largely automated. Manually backing up system settings and MCS Database is not
required, but recommended.
• RHEL 6.3 and earlier – The upgrade involves a clean installation of RHEL 6.5 and
MCS. Manually backing up system setti n gs and MCS databasebefore the upgrade
and restoring them after is mandatory.
When the upgrade path involve s a RHEL version change, you must also manually
back up any private keys associated with SSL certificates received from a Certificate
Authority, if CA-signed certificates are in use. In the case of a cluster, you must
manually re-create the cluster and reconfigure cache replication (if used).
This guide documents the overall upgrade process for the supported upgrade scenarios. It
must be used in conjunction with the MCS 2.2 Installation and Configuration Guide. For
clustering, you might find it helpful to refer to the most recent edition of the MCS Clustering Guide too – for validation of the cluster post-installation, for example.
For each step in the overall upgrade process, this document offers the following guidance:
• Includes the step-by-step instructions for the step
- or -
• Cross-references a section in the MCS 2.2 Installation and Configuration Guide
In the second case, the heading of the re levant section in the MCS 2.2 Installation and
Configuration Guide is provided. Since direct page references are unreliable, you must scan
the table of contents in that guide to find the heading and page.
MCS 2.2 requires RHEL 6.5. In addition, whether performing an upgrade or a full installation,
the MCS installer requires the RHEL 6.5 ISO to be mounted, so you must obtain the RHEL 6.5
4
MediaCentral Services 2.2 U pgr a ding Gui de
ICS/MCS Version
RHEL Version
ICS 1.2.3 – 1.5
RHEL 6.2
ICS 1.6 – 1.8
RHEL 6.3
ICS 1.8.1 – MCS 2.2
RHEL 6.5
Update Installation versus Full Installation
Obtaining the MCS Installation Package
Obtaining Gluster
Security Updates
An Important Note on SSL Cer tificate Passwords
ISO. This is true, even when performing an upgrade where t he operating system does not
change.
Note: Red Hat has issued a security advisory for RHEL 6.5. See “Security Updates” on page 5.
For convenience, the following table lists the ICS/MCS releases and corresponding RHEL
versions.
The MCS 2.2 release can be installed as a full installation that performs a clean installation of
RHEL, overwriting the system disk. In this case, you prepare a USB key, insert and reboot
from it. For an existing MCS installation with a supported RHEL version, it can be installed as
an upgrade. In this case, you prepare the USB key and trigger the installation script
manually. You do not reboot from it. The installation package and USB key preparation is the
same in both cases.
The MCS 2.2 release is available directly on the Avid Download Center.
If are installing Gluster, note that since MCS 2.0 a new version of Gluster is required, and
additional Gluster packages.
For package names and download instructions, please consult the MediaCentral Platform
2.2 ReadMe.
Important: Red Hat has issued security advisories for RHEL 6.5. Once you have installed the
operating system, please take a moment to resolve the security vulner abi l i ties. For
instructions, see the “Security Updates” section in t he MediaCentr al Platform 2.2 ReadMe.
Interplay Central uses the Secure Sockets Layer (SSL) for its server to browser connections.
Default passwords are used by the system to automatically generate and use self-signed
5
MediaCentral Services 2.2 U pgr a ding Gui de
Upgrading Media | Index and Multi-Zone Deployments
certificates. Customized certificates can also be used, including those that have be en issued
by a Certificate Authority (CA).
When customized or CA-signed certificates are used, the MCS 2.2 Installation and Configuration Guide explains that the SSL passwo rds must be written to the user-available
Application Properties file in the following directory:
Caution: The user-available Application Properties file is backed up and restored by the systembackup script. The system-reserved Application Properties file is not backed up. If the SSL
passwords are in the wrong file, SSL configuration will be broken by the upgrade.
To avoid mishaps, double-check the contents of the system-reserved Application Properties
file before proceeding with the upgrade.
To double-check the system-reserved Application Properties file:
1. List the contents of the Application Properties file reserved for use by the system:
less /opt/avid/avid-interplaycentral/config/application.properties
2. Look for the following two lines (they might not be next to each other):
The obfuscated passwords shown above (in bold) are the default system pa sswords.
3. If the passwords you see match the above, this is correct, and nothing more needs to be
done.
4. If the passwords you see are different, it indicates the file has been edite d. This is
incorrect, and you must copy the two modified lines into the following file (you might
need to create the file):
Copying the modified lines to the user-available Application Properties file ensures they
are preserved during the upgrade.
If your deployment is configured f or Media | Index and multi-zone, note the following:
6
MediaCentral Services 2.2 U pgr a ding Gui de
Resetting Layouts After Upgrading from V2.0 to V2.2
Resetting Layouts After Upgrading from ICS V1.6 or Earlier
Setting Gluster Volume Ownership Permanently
•Upgrade Slave Zones First: If you cannot bring all zones off-line at once, upgrad e
the slave zone(s) before the master zone.
Note that an upgraded slave zone system no longer has access to the centralized
user management service (UMS), which is owned by the m aster zone. Users in the
upgraded slave zone can continue to log in —the local, read-only copy of the UMS
database is used — but you cannot crea te new users.
•Delete the Media| Index System Data Index: The system data index contains
information on registered systems and localization strings for display fields. In
initialized systems it also contains production data. If Media Index is configured, you
must delete the system data index in the master zone before the upgrade. Note that
deleting the system data index restores a clean index state. For instructions, see the
Avid Media | Index Configuration Guide.
Three panes used in MediaCentr a l UX v2.0 were dropped as of MediaCentral UX v2.1:
• Markers pane: redesigned as Logging pane.
• Layouts pane in Users Layout: re p l aced by drag-and-drop functionality.
• Search pane in Users Layout: replaced by Filter field.
After Media Central UX is upgraded to v2.2, users who had signed out of V2.0 with these
panes open will see them when they si gn in again, with the message: “No View
implementation found for type undefined” in the pane. Users need to reset the panes.
To reset the outdated panes, do one of the following:
• Close the outdated panes.
• Reset the layout by selecting Reset Layout from the Layout selector.
After upgrading from Interplay Central Services V1.6 or earlier, use rs who had previously
signed in will see the Assets pane and Search panes fro m their most recent session.
However, the Assets tabs and Search panes are not usable.
This problem does not occur when upgrading from ICS V1.7 to MediaCentral Platform V2.2.
To reset the Assets pane and Search panes, do one of the following:
• Close all open Assets tabs and Searc h p a n es and reopen them.
• Reset the layout by selecting Reset Layout from the Layout selector.
Recall that the following two directories must be owned by user maxmin and have group id
set to maxmin:
cache/gluster/gluster_data_download
7
MediaCentral Services 2.2 U pgr a ding Gui de
cache/gluster/gluster_data_fl_cache
The directories above are associated with RHEL directories (/cache/fl_cache and
/cache/download) used to store files for http-based streaming, such as media converted to
FLV for file-based playback. They are also used to store media converted to Mpeg2TS for
playback on iOS devices. The download directory contains links to simplify iOS playback.
With Gluster 3.4.0.8, restarting the Gluster daemon (glusterd) results in user ID and group
ownership of the Gluster volumes being changed from maxmim to root, which breaks
playback on iOS devices. Thus if a cluster node is rebooted, playback issues can arise .
To prevent issues for an existing cluster, you must configure the two Gluster cache volumes
to use the same UID and GID as the maxmin user, as described in the following procedure.
Note: This procedure should be done after the upgrade. It is only necessary for cluster
deployments using Gluster.
To set Gluster volume ownership so it does not change:
On each node in the cluster perform the following steps (slave first, mast e r second, load
balancing at any time):
1. Stop Pacemaker:
service pacemaker stop
2. Stop Corosync:
service corosync stop
3. Obtain the user ID of the user maxmin (this might be different on each machine):
id -u maxmin
4. Change the user ownership of the gluster volume to maxmin using the user ID:
gluster volume set gl-cache-dl storage.owner-uid <uid>
gluster volume set gl-cache-fl storage.owner-uid <uid>
In the above commands, do not type the a n gl e brackets. Enter the number obtained in
the previous step.
Note: Do not alter the gl-cache-mcam (multicam) volume. It uses the default root ownership.
5. Obtain the group ID of the user maxmi n (this might be different on each machine):
id -g maxmin
6. Change the group ownership of the gluster volume to maxmin using the gro up ID:
gluster volume set gl-cache-dl storage.owner-gid <gid>
gluster volume set gl-cache-fl storage.owner-gid <gid>
Note: Do not alter the gl-cache-mcam (multicam) volume. It uses the default root ownership.
8
MediaCentral Services 2.2 U pgr a ding Gui de
Upgrading Paths
Upgrading from 1.2.x or 1.3.x to MCS 2.2
Upgrading to MCS 2.2 for Interplay Central
7. Verify the success of the ownership changes:
ls –la /cache/gluster
Should return:
drwxrwsrwx 3 maxmin maxmin 4096 Jan 12 09:51 gluster_data_download
drwxrwsrwx 5 maxmin maxmin 4096 Jan 12 09:51 gluster_data_fl_cache
drwxr-xr-x 3 root root 4096 Feb 5 08:33 gluster_data_multicam
8. Restart the GlusterFS service:
service glusterd restart
9. Verify the ownership changes are sticky:
ls –la /cache/gluster
Should return same as before:
drwxrwsrwx 3 maxmin maxmin 4096 Jan 12 09:51 gluster_data_download
drwxrwsrwx 5 maxmin maxmin 4096 Jan 12 09:51 gluster_data_fl_cache
drwxr-xr-x 3 root root 4096 Feb 5 08:33 gluster_data_multicam
10. Change ownership of any files residing in gluster_data_download and
gluster_data_fl_cache:
This is only absolutely necessary on systems that h ave already been running, where the
Gluster daemon reset ownership to root.
11. Start Corosync:
service corosync start
12. Start Pacemaker:
service pacemaker start
This section presents the upgrade paths for specific deployment options.
For Interplay Central and/or ICPS 1.2.x and 1.3.x upgrade options, please consult your Avid
representative.
Since ICS 1.3 — which introduced the har dwar e consolidation and software service
colocation on Linux server s — in many respects MediaCentral Platform Services an d
9
MediaCentral Services 2.2 U pgr a ding Gui de
Upgrading to MCS 2.2 for Media Composer | Cloud
Upgrading to MCS 2.2 for Interplay | MAM
Special Note: Upgrading from MCS 2.0
MediaCentral are the same thing. MediaCentral uses all MediaCentral Platform Services,
and its version number increase s in lock step with MediaCentral Platform Services.
For upgrading instructions:
• “Upgrading a Single Server RHEL 6.5 System to MCS 2.2” on page 10
• “Upgrading a Cluster RHEL 6.5 System to MCS 2.2” on page 12.
• “Upgrading a Single Server RHEL 6.3 System to MCS 2.2”on page 16.
• “Upgrading a Cluster RHEL 6.3 System to MCS 2.2” on page 21.
.
The latest version of the Media Composer | Cloud plugin requires at least ICS 1.3. Upgrading
to MCS 2.2 for Media Composer | Cloud does not add any new functionality, but you do get
the benefit of the latest bug fixes.
For upgrading instructions:
• “Upgrading a Single Server RHEL 6.5 System to MCS 2.2” on page 10
• “Upgrading a Cluster RHEL 6.5 System to MCS 2.2” on pa ge 12.
• “Upgrading a Single Server RHEL 6.3 System to MCS 2.2”on page 16.
• “Upgrading a Cluster RHEL 6.3 System to MCS 2.2” on page 21.
.
For Interplay MAM compatibility with MCS please refer to the MediaCentral Platform 2.2 ReadMe.
For upgrading instructions:
• “Upgrading a Single Server RHEL 6.5 System to MCS 2.2” on page 10
• “Upgrading a Cluster RHEL 6.5 System to MCS 2.2” on page 12.
• “Upgrading a Single Server RHEL 6.3 System to MCS 2.2”on page 16.
• “Upgrading a Cluster RHEL 6.3 System to MCS 2.2” on page 21.
.
If you are upgrading from MCS 2.0, note the following. As part of some cluster deployments,
the MediaCentral Platform Services 2.0 Installation and Configuration Guide provided
instructions for replicating the cluster file caches using Gluster, an open source software
solution. The instructions include creating a metadata cache directory for Interplay | MAM
deployments with MPEG-1 browse proxies.
The use of Gluster to replicate metadata has been deprecated due to its negative impact on
performance. Please delet e the Glu sterF S me tad ata v olume from all your server nodes in all
affected deployments. Once complete, metadata inform ation is loaded into RAM and is no
longer replicated across other nodes.
10
MediaCentral Services 2.2 U pgr a ding Gui de
Upgrading a Single Server RHEL 6.5 System to MCS 2.2
Installing MCS 2.2 Using the Update Installation
For instructions, consult the Avid KB article “Removing the GlusterFS Metadata Cache
Replication Volume” at the following link:
For systems already running RHEL 6.5, the upgrade to MCS 2. 1 is an update installation
involving the following procedure:
¨ Installing MCS 2.2 Using the Update Installation
Expected downtime: 30 min.
To install MCS 2.2 using the update installation:
1. Prepare and insert the MCS 2.2 installation USB key.
In the MCS 2.2 Installation and Configurat i on G ui de, see “Preparing the MCS Installation
USB Key”.
Note: If the RHEL image cannot be put not on the USB key — that is, if it is not local to the
installation package — mount the RHEL as a loop device image to/sysinstall before
proceeding:
mount -o loop <Path_to_Image>/<RHEL_Image>.iso /sysinstall/
2. Mount the USB key and change to the USB mount point.
In this document, see “Appendix C: Mounting an d Unmounting the USB Key
” on page
34.
3. Log in as root and dump the curre n t database:
avid-db dumpall
Although the upgrade is non-destructive, it is a good idea to backup the MCS database.
Note: Be sure to use the dot-slash (“./”) notation, which tells Linux to look for the installation
script in the current directory. Otherwise you will receive the following error message:
-bash: install.sh: command not found
11
MediaCentral Services 2.2 U pgr a ding Gui de
Upgrading a Cluster RHEL 6.5 System to MCS 2.2
For security, Linux does not include the “current” directory (“.”) in its PATH variable. You
must specify the path, even when you are in the directory where the script or command is
located.
During the installation process, progress is displayed (details have been omitted, for
clarity):
Cleaning repos:
Cleaning up Everything
Those familiar with the Linux yum update process will recognize the pattern of the
update.
The update completes with an indication of success:
INSTALLATION FINISHED
6. Check the installation was successful using the ics_version script:
ICS installer: 2.2 (Build xx)
Created on <installer creation date>
Note: The System ID is an 11-digit number used in support calls. You enter it via the
MediaCentral UX user interface. See the MCS 2.2 Installation and Configuration Guide.
Note: For precise version numbers for this release, see the MediaCentral Platform 2.2
ReadMe.
7. Unmount the USB key.
In this document, see “Appendix C: Mounting an d Unmounting the USB K ey
” on page
34.
Installing MCS 2.2 on a cluster already running MCS compatible with RHEL 6.5 is a simple
automated update of the affected packages. All MCS system settings are preserved. There is
no need to manually backup and/or restore any MCS system settings. All nodes must be
brought off-line to perform the upd a te.
The cluster update involves the fo llowing steps:
¨ Identifying the Master, Slave and Load-Balancing Nodes
¨ Bringing the Cluster Off-line
12
MediaCentral Services 2.2 U pgr a ding Gui de
Identifying the Master, Slave and Load-Balancing Nodes
Bringing the Cluster Off-line
¨ Updating the Cluster
Expected downtime: 1 hr. for 2 servers, + 30 min. for each additional server.
To identify the master, slave, and load-balancing nodes:
Recall that there are three types of nodes in a cluster: master, slave, and load-balancing.
The master “owns” the cluster IP address. The slave assumes the role of master in the event
of a failover. Any extra nodes play a load-balancing role, but can never take on the role of
master.
1. Identify the master node of the cluster. Log into any machine in the cluster as root and
type:
crm_mon
2. In the output of that command, look for the line containing “AvidClusterIP”—this service
runs on the master server.
For example, if the crm_mon command output contains the line:
AvidClusterIP (ocf::heartbeat:IPaddr2): Started ics-1
…the master server is ics-1.
3. To identify the slave, look for the line containing “Master/Slave Set”.
For example, if the crm_mon command output contains the lines:
The master node should not be in standby when you back up the database.
1.Log in to the master node as root and dump the current database:
avid-db dumpall
13
MediaCentral Services 2.2 U pgr a ding Gui de
Updating the Cluster
Although the update is non-destructive, it is a good idea to backup the MCS database.
2. Begin bringing the cluster off-line by putting the load-balancing nodes into standby
mode:
crm node standby <node name>
3. Next, put the slave node into sta n db y mode:
crm node standby <node name>
4. Finally, put the master node int o s tandby mode:
crm node standby <node name>
You can upgrade the nodes in any order you like. However, be sure to bring them back
online in the correct order, as indicated in the instructions.
To update the cluster:
1. Prepare and insert the MCS 2.2 installation USB key.
In the MCS 2.2 Installation and Configurat i on G ui de, see “Preparing the MCS Installation
USB Key”.
Note: If the RHEL image is not on the USB key — that is, if it is not local to the installation
package — mount the RHEL image as a loop device to/sysinstall before proceeding:
mount -o loop <Path_to_Image>/<RHEL_Image>.iso /sysinstall/
2. Mount the USB key and change to the mount poi n t.
In this document, see “Appendix C: Mounting an d Unmounting the USB K ey
Note: Be sure to use the dot-slash (“./”) notation, which tells Linux to look for the installation
script in the current directory. Otherwise you will receive the following error message:
-bash: install.sh: command not found
For security, Linux does not include the “current” directory (“.”) in its PATH variable. You
must specify the path, even when you are in the directory where the script or command is
located.
During the installation process, progress is displayed (details have been omitted, for
clarity):
Cleaning repos:
14
Loading...
+ 31 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.