Version 2.0Upgrading Guide -...

37
Avid MediaCentral ® Platform Services Version 2.0 Upgrading Guide Document Version: 1.0.1 This document is a guide to upgrading to MediaCentral Platform Services (MCS) 2.0 from a previous version of Interplay Central Services (ICS). Depending on which version you are upgrading from, the upgrade process varies. It also includes instructions on migrating the UMS database from a production system to a test system. Note: MediaCentral Platform Services 2.0 supports MediaCentral 2.0, Media Composer| Cloud (latest plug-in for Media Composer 6.5.x, and 7.0.x, and 8.0.1, and NewsCutter 10.5.x and 11.0.x). Note: The Gluster version has changed and additional Gluster packages are required for MCS 2.0. See “Obtaining Gluster” in the MCS 2.0 Installation and Configuration Guide. Important Information 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 for the most up-to-date ReadMe, which contains the latest information that might have become available after the documentation was published. The MCS 2.0 documentation can be found here: http://avid.force.com/pkb/articles/en_US/readme/Avid-MediaCentral-Version-2-0- Documentation Revision History Date Revised Version Changes Made July 17, 2014 1.0.0 First publication. July 21, 2014 1.0.1 Added instructions to turn off DRBD during cluster upgrade.

Transcript of Version 2.0Upgrading Guide -...

Page 1: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

Avid MediaCentral®

Platform Services Version 2.0 Upgrading Guide

Document Version: 1.0.1

This document is a guide to upgrading to MediaCentral Platform Services (MCS) 2.0 from a previous version of Interplay Central Services (ICS). Depending on which version you are upgrading from, the upgrade process varies. It also includes instructions on migrating the UMS database from a production system to a test system.

Note: MediaCentral Platform Services 2.0 supports MediaCentral 2.0, Media Composer| Cloud (latest plug-in for Media Composer 6.5.x, and 7.0.x, and 8.0.1, and NewsCutter 10.5.x and 11.0.x).

Note: The Gluster version has changed and additional Gluster packages are required for MCS 2.0. See “Obtaining Gluster” in the MCS 2.0 Installation and Configuration Guide.

Important Information 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 for the most up-to-date ReadMe, which contains the latest information that might have become available after the documentation was published. The MCS 2.0 documentation can be found here: http://avid.force.com/pkb/articles/en_US/readme/Avid-MediaCentral-Version-2-0-Documentation

Revision History

Date Revised Version Changes Made

July 17, 2014 1.0.0 First publication.

July 21, 2014 1.0.1 Added instructions to turn off DRBD during cluster upgrade.

Page 2: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

2

Contents Important Information ....................................................................................................................... 1

Revision History .................................................................................................................................. 1

Contents ..................................................................................................................................................... 2

Overview .................................................................................................................................................... 4

How Do I Use This Guide? .......................................................................................................................... 4

What Operating System Do I Need? .......................................................................................................... 4

Update Installation versus Full Installation ................................................................................................ 4

Obtaining the MCS Installation Package .................................................................................................... 5

Obtaining Gluster ....................................................................................................................................... 5

Security Updates ........................................................................................................................................ 5

An Important Note on SSL Certificate Passwords ...................................................................................... 6

Mounting and Unmounting the USB Key ................................................................................................... 7

Deleting the RAID 5 .................................................................................................................................... 9

Backing Up and Restoring System Settings and the ICS/MCS Database .................................................. 12

Upgrading from 1.2.x or 1.3.x to MCS 2.0................................................................................................ 15

Upgrading to MCS 2.0 for Interplay Central ............................................................................................ 16

Upgrading to MCS 2.0 for Media Composer | Cloud ............................................................................... 16

Upgrading to MCS 2.0 for Interplay | MAM ............................................................................................ 16

Upgrading a Single Server System from 1.4.x–1.8.x to 2.0 ...................................................................... 17

Backing Up System Settings and Installing MCS 2.0 ............................................................................. 17

Restoring System Settings and Migrating User Settings ...................................................................... 18

Verifying and Configuring Date and Time Synchronization Settings .................................................... 19

Logging in and Backing Up the New System Settings........................................................................... 20

Upgrading a Cluster System from 1.4.x–1.8.x to 2.0 ............................................................................... 21

Identifying the Master, Slave and Load-Balancing Nodes .................................................................... 21

Backing Up Master Node System Settings and Bringing Down the Cluster ......................................... 22

Upgrading the Master Node ................................................................................................................. 23

Restoring System Settings and Migrating User Settings on the Master Node ..................................... 24

Verifying and Configuring Date and Time Synchronization Settings .................................................... 25

Upgrading the Slave Node and Load-Balancing Nodes ........................................................................ 26

Setting up the Cluster and Cache Replication ...................................................................................... 27

Validating the Cluster and Backing Up the New System Settings ........................................................ 27

Page 3: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

3

Reconfiguring ICS for Interplay | MAM or Media Composer | Cloud in an Upgrade from ICS 1.7 or Earlier ................................................................................................................................................................. 28

Reconfiguring MCS for Use with Interplay | MAM .............................................................................. 28

Reconfiguring MCS for Use with Media Composer | Cloud ................................................................. 29

Backing Up and Restoring SSL Private Keys ............................................................................................. 29

Appendix A: Frequently Asked Questions................................................................................................ 31

Appendix B: Migrating the UMS Database to a Test Node ...................................................................... 32

Migrating the 1.6.x (or later) UMS Database ....................................................................................... 32

Migrating the 1.4.x/1.5.x UMS Database ............................................................................................. 33

Appendix C: Glossary ............................................................................................................................... 35

MediaCentral ........................................................................................................................................ 35

Media Composer | Cloud ..................................................................................................................... 35

Interplay | MAM................................................................................................................................... 35

MediaCentral Platform Services (MCS) ................................................................................................ 35

Interplay Central Playback Service (ICPS) ............................................................................................. 35

MCS System Settings ............................................................................................................................ 36

MCS Platform Settings .......................................................................................................................... 36

MCS Database ...................................................................................................................................... 36

MediaCentral User Management Database ......................................................................................... 36

Corosync ............................................................................................................................................... 36

Distributed Replicated Block Device (DRBD) ........................................................................................ 36

Copyright and Disclaimer ......................................................................................................................... 37

Page 4: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

4

Overview Upgrading to MediaCentral Platform Services (MCS) 2.0 for MediaCentral, Media Composer | Cloud, and Interplay | MAM, in some cases involves significant changes to the hardware topology of the system. In all cases it 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.

Note: Beginning with version 2.0, the term “MediaCentral Platform Services” replaces “Interplay Central Services.” In addition, the term “MediaCentral Playback Service” replaces “Interplay Central Playback Service.”

Note: An upgrade to MCS 2.0 is a fresh software installation. Scripts are provided to back up and restore ICS/MCS system settings and the MCS Database so you do not have to manually reconfigure the system. However, you must 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).

How Do I Use This Guide? This guide must be used in conjunction with the MCS 2.0 Installation and Configuration Guide. If you are upgrading a cluster, you might find it helpful to refer to the MCS 2.0 Clustering Guide too – for validation of the cluster post-installation, for example.

In this guide, the different supported upgrade scenarios are described, and the overall upgrade process is documented. However, for each step in the overall upgrade process, this document either:

· Includes the step-by-step instructions for the step, or

· Cross-references a section in the MCS 2.0 Installation and Configuration Guide

In the second case, the heading of the relevant section in the MCS 2.0 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.

What Operating System Do I Need? MCS 2.0 requires RHEL 6.5. The MCS installer requires the RHEL 6.5 ISO to be mounted, so you must obtain the RHEL 6.5 ISO.

Note: Red Hat has issued a security advisory for RHEL 6.5. See “Security Updates” on page 5.

Update Installation versus Full Installation The MCS 2.0 release is a full installation that replaces the operating system and overwrites the system disk. It is not available as an upgrade installation.

Page 5: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

5

Obtaining the MCS Installation Package The MCS 2.0 release is available directly on the Avid Download Center.

Obtaining Gluster If are installing Gluster, note that MCS 2.0 requires a new version of Gluster, and additional Gluster packages. Navigate to the download directory at gluster.org containing the GlusterFS version supported by MCS 2.0:

http://download.gluster.org/pub/gluster/glusterfs/3.4/3.4.0/RHEL/epel-6Server/x86_64

Download following packages:

¨ glusterfs-3.4.0-8.el6.x86_64.rpm

¨ glusterfs-cli-3.4.0-8.el6.x86_64.rpm

¨ glusterfs-fuse-3.4.0-8.el6.x86_64.rpm

¨ glusterfs-geo-replication-3.4.0-8.el6.x86_64.rpm

¨ glusterfs-libs-3.4.0-8.el6.x86_64.rpm

¨ glusterfs-server-3.4.0-8.el6.x86_64.rpm

Note: If the specified version of Gluster is no longer available, contact your Avid representative.

Security Updates Red Hat has issued a security advisory addressing the OpenSSL vulnerability known as the “Heartbleed” bug. A complete description of the security vulnerability and solution is available at the Red Hat web site:

https://rhn.redhat.com/errata/RHSA-2014-0625.html

To obtain and install the RHEL OpenSSL security update:

1. Verify the precise package name needed at the Red Hat network “Important: openssl security update” web page:

https://rhn.redhat.com/errata/RHSA-2014-0625.html

Look in the “Red Hat Enterprise Linux Server (v.6)” area for an RPM with the following name:

openssl-1.0.1e-16.el6_5.14.x86_64.rpm

2. Go to the Red Hat customer portal downloads page:

https://access.redhat.com/site/downloads

3. At the bottom of the page, click on the RPM Package Search link.

Page 6: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

6

https://rhn.redhat.com/rhn/channels/software/Search.do

4. Log in to your Red Hat account as directed and search for the package by name, then download the RPM to a safe repository (e.g. the MCS installation USB key).

Note: If the RPM Package Search feature returns no results, enter the RPM name in the Red Hat web site general search field and try again.

It is recommended that you create a directory called openssl at the root level on the USB key, and copy the RPM package to it.

5. Once you have installed RHEL and MCS, remount the USB key and install the OpenSSL security update:

rpm -Uvh /media/usb/openssl/openssl-1.0.1e-16.el6_5.14.x86_64.rpm The above command assumes you have the USB key mounted at /media/usb.

The system responds with output similar to the following:

warning: openssl-1.0.1e-16.el6_5.14.x86_64.rpm: Header V3 RSA/SHA256 Signature, key ID fd431d51: NOKEY Preparing... ####################################### [100%] 1:openssl ########################################## [100%]

6. Once the installation is complete, verify its success using the Linux rpm command:

rpm -qa | grep openssl

7. The system returns the name of the installed package.

An Important Note on SSL Certificate Passwords 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 certificates. Customized certificates can also be used, including those that have been issued by a Certificate Authority (CA).

When customized or CA-signed certificates are used, the MCS 2.0 Installation and Configuration Guide explains that the SSL passwords must be written to the user-available Application Properties file in the following directory: /opt/avid/etc/avid/avid-interplay-central/config/application.properties

This should not be confused with the system-reserved Application Properties file, in the following location: /opt/avid/avid-interplay-central/config/application.properties

Caution: The user-available Application Properties file is backed up and restored by the system-backup 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.

Page 7: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

7

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-interplay-central/config/application.properties

2. Look for the following two lines (they might not be next to each other):

system.org.ops4j.pax.web.ssl.password=OBF\:1lfc1n7n1l1618qm18qo1kxw1n3v1lc6 system.org.ops4j.pax.web.ssl.keypassword=OBF\:1lfc1n7n1l1618qm18qo1kxw1n3v1lc6

The obfuscated passwords shown above (in bold) are the default system passwords.

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 edited. This is incorrect, and you must copy the two modified lines into the following file (you might need to create the file): /opt/avid/etc/avid/avid-interplay-central/config/application.properties

Copying the modified lines to the user-available Application Properties file ensures they are preserved during the upgrade.

Mounting and Unmounting the USB Key At various times during the upgrade, you will need to mount the USB key. Refer to the instructions below when the need arises.

To mount and unmount the USB key:

1. Insert the USB key into the MCS server.

2. Verify the name of the device using the dmesg command:

dmesg Linux information relating to hardware appears on the screen.

Information for the USB key will appear near the end of the output, near the list of SCSI devices. The name of the USB key is found inside square brackets (e.g. sdc). This is the name you use to mount the key.

3. If needed, create a mount point for the USB key:

mkdir /media/usb

4. Mount the USB key at the mount point you just created:

mount /dev/sdc1 /media/usb

Page 8: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

8

Note the name of the USB key, sdc (in this case), takes a 1 (one) in the mount command. This simply indicates a partition exists on the USB key. When the USB key was formatted, the partition was created.

The USB key is now mounted and available for use.

5. Verify the USB key has been mounted:

df -h Information is displayed about all mounted filesystems and devices, and should include information about the USB key, similar to the following (other output has been omitted, for clarity):

Filesystem Size Used Avail Use% Mounted on /dev/sdc1 7.5G 5.3G 2.2G 71% /media/usb

6. To change to the mount point:

cd media/usb

7. To unmount the USB key when finished, ensure you are not currently on it by changing directories:

cd

Note: In Linux the cd command without any arguments takes you directly to the user’s home directory. If you are logged in as root, it takes you to the /root directory. You must be off the USB key to unmount it.

8. Unmount the USB key:

umount /media/usb The USB key is now available for use in another server.

If you receive an error message that the USB device is busy, it typically indicates the Linux ISO on the USB key was automounted. Verify what is mounted using the df -h command and/or the mount command. Then, dismount the Linux ISO first, followed by the USB device:

umount /sysinstall umount /media/usb

9. Remove the USB key from the server.

Removing the USB key prevents accidental rebooting and re-imaging of the system disk.

Page 9: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

9

Deleting the RAID 5 When upgrading from one version of RHEL to another, it is recommended that you delete the RAID 5 prior to installing the new OS and MCS software. Deleting and re-creating the RAID 5 eliminates (in advance) problems with cache permissions that can arise as a result of the RHEL update.

For information on re-creating the RAID 5, in the MCS 2.0 Installation and Configuration Guide, see “Setting Up the RAID Level 5 Cache Drives”.

To delete the RAID 5 prior to an upgrade in which the OS changes:

1. Umount and remove the USB key (if you have not already done so) then reboot the server.

2. Press any key when prompted (spacebar recommended) to display the HP ProLiant “Option ROM” messages.

Page 10: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

10

3. As soon as you see the prompt to enter the Option ROM Configuration for Arrays utility, press F8.

Note: The prompt to press F8 can flash by very quickly. If you miss it, reboot and try again.

4. From the Main Menu, select Delete Logical Drive and press Enter.

Page 11: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

11

5. Select the RAID 5 and press F8 to delete.

6. A warning appears asking you to confirm your choice. Press F3 to delete the RAID.

7. The RAID 5 is removed, and can now be re-created.

In the MCS 2.0 Installation and Configuration Guide, see “Setting Up the RAID Level 5 Cache Drives”.

Note: As indicated in the MCS 2.0 Installation and Configuration Guide, once you have re-created the RAID 5 and have returned to the Main Menu, do not press <Esc> to exit since this reboots the server. Wait until you have inserted the USB key and are ready to perform the upgrade.

Page 12: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

12

Backing Up and Restoring System Settings and the ICS/MCS Database

Before performing an upgrade it is recommended — and sometimes required — that you back up the ICS/MCS server system settings using the system-backup script. Depending on the upgrade path, you may also be required to restore the backed up system settings after.

The system-backup script provided for this task backs up important files and directories, including NIC card settings, DNS settings, and so on. In addition, the script calls the avid-db command, which dumps and backs up the contents of the ICS/MCS database. The ICS/MCS database contains ACS (Avid Common Services, “the bus”), UMS (User Management Service) and ICPS (Interplay Central Playback Services) data. It collects all this information and backs it up to the USB key itself.

Note: In a cluster, the IC/MCSS database is replicated across the master and slave node, but it is only mounted on the master. Thus, the ICS/MCS database is only available for dumping and backup on the master node.

If you are backing up multiple nodes in a cluster, rename the backup file for each node before proceeding to the next node. If you do not rename the backup file obtained from the master node, it will be overwritten by the backup from a non-master node and the contents of the ICS/MCS database will be lost (including user information).

The following table lists the files and directories backed up and restored by the system-backup script.

Note: RHEL user names and passwords (such as the root user) are not backed up or restored by the system-backup script. After the upgrade, logging in as “root” requires the default password. For the default root user password, contact your Avid representative.

Directory/File Description

/etc/sysconfig/* Network settings

/etc/fstab (restored in /root) Filesystem settings

/etc/resolv.conf DNS config file

/etc/ntp.conf Network Time Protocol config file

/etc/snmp/snmpd.conf Simple Network Management Protocol (network monitor)

/usr/maxt/maxedit/etc/* Maxedit settings (used by ICPS)

/etc/udev/rules.d/70-persistent-net.rules NIC card settings

/usr/maxt/maxedit/share/MPEGPresets/MPEG2TS.mpegpreset

Defines encoding for iOS playback

Page 13: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

13

Directory/File Description

/etc/localtime Time zone info

/etc/sudoers List of users with sudo privileges

/opt/avid/etc/avid/avid-interplay-central/ssl/jetty.keystore

/opt/avid/etc/avid/avid-interplay-central/config/application.properties

Jetty keystore and SSL certificates and usage passwords.

Pacemaker configuration (restored as /root/pcmk.conf)

Pacemaker configuration

/etc/corosync/corosync.conf Corosync config file

/etc/drbd.d/r0.res DRDB config file

ICS/MCS database ICS/MCS database (ACS, UMS and ICPS data). This includes user information.

RHEL user names and passwords *** Not backed up. ***

To back up the system settings and ICS/MCS database:

Note: When backing up the master node in a cluster, it must not be in standby mode. When backing up other nodes, they can be in standby.

1. Mount the USB key containing the system-backup script.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

2. Change to the mount point. For example:

cd /media/usb

3. Back up the ICS/MCS settings and database using the backup script.

./system-backup.sh –b

Note: The following message indicates the system-backup script has already been run on the current machine:

File /root/pcmk.conf exists. Do you want to overwrite it?

Type “yes” or “y” to overwrite the file and continue with the backup.

A backup file is written to the USB key:

/media/usb/sys-backup/ics_setup_files.tar.gz Since the system-backup script also calls the avid-db command, a backup of the ICS/MCS database is also written to the following directory (on the ICS/MCS server):

Page 14: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

14

/var/lib/avid/db/dumps The backup file on the server has a name has the following form:

ALL-YYYYMMDD_HHMMSSZ.sql.gz.cr

Note: Note the time stamp appended to the file name uses the Universal Time Code (UTC), not the local time.

The following message indicates success:

Backup setup successful!

4. Make a copy of the backup file using the Linux cp command. For example:

cp –r sys-backup sys-backup-<nodename> The above command copies the directory containing the backup file just created. The backup file itself (ics_setup_files.tar.gz) remains unchanged inside the directory.

Note: Making a copy of the backup file is good practice, and is particularly important if you are backing up multiple nodes in a cluster. Only the master node backup contains a complete set of backup information (including end-user data). If you do not make a copy of the master node backup file, it will be overwritten by the backup from a non-master node.

5. Once the settings are backed up, it is good practice to unmount and remove the USB key to avoid accidentally rebooting, resulting in a re-image of the system disk.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

To restore the system settings and ICS/MCS database:

1. Mount the USB key containing the system-backup script.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

2. Change to the mount point. For example:

cd /media/usb

3. If you made a copy of the backup file, copy it back to its original location.

cp -r sys-backup-<nodename> sys-backup

4. Restore the ICS/MCS settings and database using the backup script.

./system-backup.sh –r You are asked to confirm the restoration of the ICS/MCS database:

Would you like to restore the database now? (y/n)

5. Type “y” (without the quotes) to confirm the action.

You are asked to confirm the shutting down of the Avid services:

Page 15: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

15

All Avid services will be shut down before performing a database restore operation. Would you like to continue? [yes/no]

6. Type “yes” (spelled out in full, without the quotes) to confirm the action.

Note: Be careful when typing your response to this question. Typing anything other than “yes” results in the script exiting without restoring the ICS/MCS database. Other items are restored, but not the ICS/MCS database.

Services are shut down, the ICS/MCS database is restored, and services are restarted.

The ICS/MCS database service is stopped, and you are prompted to restore the database.

The following message indicates success:

Restoration done! Your old fstab settings were saved in /root/fstab Please remove the USB key and reboot the server.

Note: The filesystem table (fstab) file contains information to automate mounting volumes at boot time. It is not restored automatically.

7. Open the restored filesystem table (/root/fstab) to examine it for reference purposes.

· The restored filesystem table (/root/fstab).

· The current filesystem table (/etc/fstab).

Note: The filesystem table cannot be automatically restored to the original location, since some entries are assigned UUIDs dynamically by Linux. These can change from one RHEL installation to the next, even if they underlying hardware remains the same. Nevertheless, it is convenient to examine the restored filesystem table, for reference.

For example, in an MCS system with a RAID 5 cache volume, the restored filesystem table contains an entry similar to the following:

/dev/mapper/vg_ics_cache-lv_ics_cache /cache ext4 rw 0 0

Note: For Interplay | MAM system the filesystem table contains an entry to automatically mount the Interplay | MAM filesystem.

8. Once the settings are restored, unmount and remove the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

Upgrading from 1.2.x or 1.3.x to MCS 2.0 For Interplay Central and/or ICPS 1.2.x and 1.3.x upgrade options, please consult your Avid representative.

Page 16: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

16

Upgrading to MCS 2.0 for Interplay Central Since ICS 1.3 — which introduced the hardware consolidation and software service colocation on Linux servers — in some respects MediaCentral Platform Services and MediaCentral are the same thing. MediaCentral uses all MediaCentral Platform Services, and its version number increases in lock step with MediaCentral Platform Services.

For upgrading instructions:

· “Upgrading a Single Server System from 1.4.x–1.8.x to 2.0”on page 17.

· “Upgrading a Cluster System from 1.4.x–1.8.x to 2.0” on page 21.

Upgrading to MCS 2.0 for Media Composer | Cloud The latest version of the Media Composer | Cloud plugin requires at least ICS 1.3. Upgrading to MCS 2.0 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 System from 1.4.x–1.8.x to 2.0”on page 17.

· “Upgrading a Cluster System from 1.4.x–1.8.x to 2.0” on page 21.

Upgrading to MCS 2.0 for Interplay | MAM The latest versions of Interplay | MAM (4.2.x and 4.3.x) are not compatible with MediaCentral Services 2.0.

The following table describes Interplay | MAM and ICPS/ICS compatibility.

Interplay | MAM Version ICPS/ICS Version

Interplay MAM 4.2.3 Interplay Central Services 1.6/1.7

Interplay MAM 4.3 Interplay Common Services 1.4.1

Interplay MAM 4.3.x Interplay Central Services 1.6/1.7/1.8

Interplay | MAM (other) For MCS 2.0 compatibility with other Interplay | MAM releases please consult an Avid representative.

Note: ICS 1.3 is not supported by any version of Interplay | MAM.

For upgrading instructions:

· “Upgrading a Single Server System from 1.4.x–1.8.x to 2.0”on page 17.

· “Upgrading a Cluster System from 1.4.x–1.8.x to 2.0” on page 21.

Page 17: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

17

Upgrading a Single Server System from 1.4.x–1.8.x to 2.0 The upgrade to MCS 2.0 is a fresh software installation involving the following procedures:

¨ Backing Up System Settings and Installing MCS 2.0

¨ Restoring System Settings and Migrating User Settings

¨ Verifying and Configuring Date and Time Synchronization Settings

¨ Logging in and Backing Up the New System Settings

Note: Before proceeding, back up any private key used to generate a Certificate Signing Request. In this document, see “Backing Up and Restoring SSL Private Keys” on page 29.

Expected downtime: 30 min.

Backing Up System Settings and Installing MCS 2.0 To back up system settings and install MCS 2.0:

1. Prepare and insert the MCS 2.0 installation USB key.

In the MCS 2.0 Installation and Configuration Guide, see “Preparing the MCS Installation USB Key”.

2. Mount the USB key and change to the mount point.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

3. Back up the current system settings and ICS/MCS database using the backup script.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

4. Unmount and remove the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

5. Boot into the HP BIOS, enter the “Option ROM Configuration for Arrays” utility and destroy the RAID 5.

In this document, see “Deleting the RAID 5” on page 9.

6. While still in the utility, re-create the RAID 5.

In the MCS 2.0 Installation and Configuration Guide, see “Setting Up the RAID Level 5 Cache Drives”.

Destroying and re-creating the RAID 5 eliminates (in advance) problems with cache permissions that can arise as a result of the RHEL update.

7. Insert the USB key and boot from it to install RHEL and MCS.

8. Once installed, remove the USB key and reboot as prompted.

Rebooting after the OS upgrade causes the RHEL Text Mode Setup Utility (“Choose a Tool”) screen to appear, providing access to set-up menus.

Page 18: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

18

9. Quit the RHEL Text Mode Setup Utility and log in to RHEL.

10. Check the installation was successful using the ics_version script:

ics_version Service version numbers are returned as follows:

UMS Version: 2.0.x.x IPC Version: 2.0.x.x ICPS Version: 2.0.x.x ICPS manager Version: 2.0.x.x ACS Version: 2.0.x.x ICS installer: 2.0 (Build XX) Created on <installer creation date>

Note: For precise version numbers for this release, see the MediaCentral Platform 2.0 ReadMe.

11. Install the RHEL security update.

In this document, see “Security Updates” on page 5.

Restoring System Settings and Migrating User Settings To restore system settings and migrate user settings:

1. Re-insert and re-mount the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

2. Restore the system settings and MCS database using the restore script.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

Note: It is possible that error messages similar to the following will be output to the shell:

/usr/maxt/maxedit/cluster/resources/_common.sh errors

Ignore the messages and type the following and press Enter to complete the command:

service avid-all stop

You do not need to stop the error messages to type the above command. You can type it even as the error messages are output to the terminal.

3. Unmount and remove the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

4. Open the restored filesystem table (/root/fstab) to examine it for reference purposes.

· The restored filesystem table (/root/fstab).

· The current filesystem table (/etc/fstab).

Page 19: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

19

Note: The filesystem table cannot be automatically restored to the original location, since some entries are assigned UUIDs dynamically by Linux. These can change from one RHEL installation to the next, even if they underlying hardware remains the same. Nevertheless, it is convenient to examine the restored filesystem table, for reference.

For example, in an MCS system with a RAID 5 cache volume, the restored filesystem table contains an entry similar to the following:

/dev/mapper/vg_ics_cache-lv_ics_cache /cache ext4 rw 0 0

Note: For Interplay | MAM system the filesystem table contains an entry to automatically mount the Interplay | MAM filesystem.

5. Reboot and note the restored host name at the login prompt (e.g. ics-dl360-1).

6. Log in as root and migrate the user settings from the UMS database to the USS database (new in 2.0):

/opt/avid/bin/avid-uss-import –p Avid123 The above command needs to be invoked once only. In the case of a cluster, it is invoked on the master node only.

The system returns the following:

Loading properties.. Fetching zone UUID.. Importing settings for zone UUID: 00000000-0000-0000-0000-000000000000 Importing setting_domain_class.. Importing setting_class.. Importing setting_instance.. SUCCESS

Verifying and Configuring Date and Time Synchronization Settings To verify and configure the date and time synchronization settings:

1. Log in and check the date and time are correct, and adjust if needed:

date In the MCS 2.0 Installation and Configuration Guide, see “Verifying the Date and Time”.

2. Though time zone information was restored, you must re-create the symbolic link RHEL needs to make use of it:

ln –sf /usr/share/zoneinfo/<yourzone> /etc/localtime If you need to verify the zone in use prior to re-creating the symbolic link:

cat /etc/sysconfig/clock For more information, in the MCS 2.0 Installation and Configuration Guide, see “Setting the Time Zone”.

Page 20: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

20

3. Verify the availability of the in-house NTP server, synchronize the System Clock, and set up a cron job to keep the clock synchronized.

In the MCS 2.0 Installation and Configuration Guide, see “Synching the System Clock”.

Logging in and Backing Up the New System Settings To perform final configurations and back up the new system settings and MCS database:

1. Log in to Media Central UX, accept the license agreement, and verify user migration and role assignments.

2. If you are deploying ICS for Interplay | MAM or Media Composer | Cloud, you must update Interplay Central configuration settings.

In this document, see “Reconfiguring ICS for Interplay | MAM or Media Composer | Cloud in an Upgrade from ICS 1.7 or Earlier” on page 28.

3. Finally, back up the system settings and MCS database.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

Page 21: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

21

Upgrading a Cluster System from 1.4.x–1.8.x to 2.0 The cluster upgrade to MCS 2.0 is a fresh software installation involving the following procedures:

¨ Identifying the Master, Slave and Load-Balancing Nodes

¨ Backing Up Master Node System Settings and Bringing Down the Cluster

¨ Upgrading the Master Node

¨ Restoring System Settings and Migrating User Settings on the Master Node

¨ Verifying and Configuring Date and Time Synchronization Settings

¨ Upgrading the Slave Node and Load-Balancing Nodes

¨ Setting up the Cluster and Cache Replication

¨ Validating the Cluster and Backing Up the New System Settings

Note: Before proceeding, back up any private key used to generate a Certificate Signing Request. In this document, see “Backing Up and Restoring SSL Private Keys” on page 29.

Expected downtime: 1 hr. for 2 servers, + 30 min. for each additional server.

Identifying the Master, Slave and Load-Balancing Nodes

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:

Master/Slave Set: ms_drbd_postgres [drbd_postgres] Masters: [ ics-1 ] Slaves: [ ics-2 ]

Page 22: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

22

…the slave server is ics-2.

4. To identify the load-balancing nodes, look for the line containing “Clone Set”.

For example, if the crm_mon command output contains the lines:

Clone Set: AvidAllEverywhere [AvidAll] Started: [ ics-1 ics-2 ics-3] …the extra server in this case is ics-3.

Backing Up Master Node System Settings and Bringing Down the Cluster

To back up the master node and bring down the cluster:

Note: The master node should not be in standby when you back up the system settings and database using the system-backup script. If it is in standby, only the system settings will be backed up – not the database. Other nodes can be in standby. On the slave node the database is present, but not mounted. Load balancing nodes do not have a database.

1. Prepare and insert the MCS 2.0 installation USB key into the master node.

In the MCS 2.0 Installation and Configuration Guide, see “Preparing the MCS Installation USB Key”.

2. Mount the USB key and change to the mount point.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

3. Back up the current system settings and ICS/MCS database using the backup script.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

Be sure to create a copy of the master node backup directory using the Linux cp command. For example:

cp -r sys-backup sys-backup-<nodename>

Note: It is important to copy the master node backup directory and rename it. Only the master node backup contains a complete set of backup information (i.e. both system settings and database). If you do create a copy of the master node backup file, it will be overwritten by the backup from a non-master node and you will lose the user database, amongst other information.

4. Begin bringing the cluster off-line by putting the load-balancing nodes into standby mode:

crm node standby <node name>

5. Next, put the slave node into standby mode:

crm node standby <node name>

Page 23: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

23

6. Finally, put the master node into standby mode:

crm node standby <node name>

7. Unmount the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

Upgrading the Master Node

To upgrade the master node:

1. Unmount the USB key (if you have not already done so).

In this document, see “Mounting and Unmounting the USB Key” on page 7.

2. Boot into the HP BIOS, enter the “Option ROM Configuration for Arrays” utility and destroy the RAID 5.

In this document, see “Deleting the RAID 5” on page 9.

3. While still in the utility, re-create the RAID 5.

In the MCS 2.0 Installation and Configuration Guide, see “Setting Up the RAID Level 5 Cache Drives”.

Destroying and re-creating the RAID 5 eliminates (in advance) problems with cache permissions that can arise as a result of the RHEL update.

4. Insert the USB key and boot from it to install RHEL and MCS.

5. Once installed, remove the USB key and reboot as prompted.

Rebooting after the OS upgrade causes the RHEL Text Mode Setup Utility (“Choose a Tool”) screen to appear, providing access to set-up menus.

6. Quit the RHEL Text Mode Setup Utility and log in to RHEL.

7. Check the installation was successful using the ics_version script:

ics_version Service version numbers are returned as follows:

UMS Version: 2.0.x.x IPC Version: 2.0.x.x ICPS Version: 2.0.x.x ICPS manager Version: 2.0.x.x ACS Version: 2.0.x.x ICS installer: 2.0 (Build XX) Created on <installer creation date>

Note: For precise version numbers for this release, see the MediaCentral Platform 2.0 ReadMe.

Page 24: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

24

8. Install the RHEL security update.

In this document, see “Security Updates” on page 5.

Restoring System Settings and Migrating User Settings on the Master Node

To restore system settings and migrate user settings on the master node:

1. Insert and Mount the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

2. Restore the system settings and MCS database using the restore script.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

Note: It is possible that error messages similar to the following will be output to the shell:

/usr/maxt/maxedit/cluster/resources/_common.sh errors

Ignore the messages and type the following and press Enter to complete the command:

service avid-all stop

You do not need to stop the error messages to type the above command. You can type it even as the error messages are output to the terminal.

3. Unmount and remove the USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

4. Open the restored filesystem table (/etc/fstab) to examine it for reference purposes.

· The restored filesystem table (/root/fstab).

· The current filesystem table (/etc/fstab).

Note: The filesystem table cannot be automatically restored to the original location, since some entries are assigned UUIDs dynamically by Linux. These can change from one RHEL installation to the next, even if they underlying hardware remains the same. Nevertheless, it is convenient to examine the restored filesystem table, for reference.

For example, in an MCS system with a RAID 5 cache volume, the restored filesystem table contains an entry similar to the following:

/dev/mapper/vg_ics_cache-lv_ics_cache /cache ext4 rw 0 0

Note: For Interplay | MAM system the filesystem table contains an entry to automatically mount the Interplay | MAM filesystem.

5. Verify if DRBD is set to run at system startup:

chkconfig –-list drbd

Page 25: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

25

There are two dashes (“--“) with no space between them , in the above command.

6. If set to run, disable DRBD (since it will interfere with setting up the cluster):

chkconfig drbd off

7. Reboot and note the restored host name at the login prompt (e.g. ics-dl360-1).

8. Log in as root and migrate the user settings from the UMS database to the USS database (new in 2.0):

/opt/avid/bin/avid-uss-import –p Avid123 The above command needs to be invoked on the master node only.

The system returns the following:

Loading properties.. Fetching zone UUID.. Importing settings for zone UUID: 00000000-0000-0000-0000-000000000000 Importing setting_domain_class.. Importing setting_class.. Importing setting_instance.. SUCCESS

Verifying and Configuring Date and Time Synchronization Settings

To verify and configure the date and time synchronization settings:

1. Log in (if you have not already done so) and check the date and time are correct, and adjust if needed:

date In the MCS 2.0 Installation and Configuration Guide, see “Verifying the Date and Time”.

2. Though time zone information was restored, you must re-create the symbolic link RHEL needs to make use of it:

ln –sf /usr/share/zoneinfo/<yourzone> /etc/localtime If you need to verify the zone in use prior to re-creating the symbolic link:

cat /etc/sysconfig/clock For more information, in the MCS 2.0 Installation and Configuration Guide, see “Setting the Time Zone”.

3. Verify the availability of the in-house NTP server, synchronize the System Clock, and set up a cron job to keep the clock synchronized.

In the MCS 2.0 Installation and Configuration Guide, see “Synching the System Clock”.

Page 26: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

26

Upgrading the Slave Node and Load-Balancing Nodes

To upgrade the slave node (and load-balancing nodes):

1. Insert and mount the MCS 2.0 installation USB key.

In this document, see “Mounting and Unmounting the USB Key” on page 7.

2. Back up the system settings using the backup script.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

Be sure to make a copy of the backup file using the Linux cp command. For example:

cp -r sys-backup sys-backup-<nodename>

3. Upgrade the node.

In this document, see “Upgrading the Master Node” on page 23.

Be sure to delete, then re-create the RAID 5.

Be sure to install the RHEL security update.

4. Restore the system settings and MCS database using the restore script.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

Be sure to examine the contents of the restored filesystem table (/root/fstab) and copy any needed entries into the current filesystem table (/etc/fstab) as indicated in the instructions.

Be sure to unmount and remove the USB key when complete.

5. Verify if DRBD is set to run at system startup:

chkconfig –-list drbd There are two dashes (“--“) with no space between them , in the above command.

6. If set to run, disable DRBD:

chkconfig drbd off

7. Reboot and note the restored host name at the login prompt (e.g. ics-dl360-2).

8. Verify the time, date and time synchronization settings.

In this document, see “To verify and configure the date and time synchronization settings” on page 25.

9. Repeat the process for any load-balancing nodes.

Page 27: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

27

Setting up the Cluster and Cache Replication

To set up the cluster and cache replication:

1. On the master and slave node, establish database replication between the master node and slave node using the drbd_setup script.

In the MCS 2.0 Installation and Configuration Guide, see “Setting Up DRBD”.

2. On the master node, configure the cluster and start the cluster services using the setup-corosync and setup-cluster scripts.

In the MCS 2.0 Installation and Configuration Guide, see “Starting the Cluster Services”.

Don’t forget to restart the following services (as indicated in the instructions):

service acs-messenger restart service avid-aaf-gen restart service avid-mpd restart

Note: Restarting the Interplay Pulse (avid-mpd) service is only needed if Interplay Pulse (separate installer) is installed on the system.

3. Join each non-master — the slave and load-balancing nodes — to the cluster using the setup-corosync script.

In the MCS 2.0 Installation and Configuration Guide, see “Joining the Cluster”.

Once again, restart the acs-messenger, avid-aff-gen and avid-mpd services.

4. If you are deploying a RAID 5, set up cache replication using Gluster.

In the MCS 2.0 Installation and Configuration Guide, see “Replicating the Cluster File Caches using Gluster”.

Validating the Cluster and Backing Up the New System Settings

To log in and validate the cluster:

1. Log in to Media Central UX, accept the license agreement, and verify user migration and role assignments.

2. If you are deploying ICS for Interplay | MAM or Media Composer | Cloud, you must update Interplay Central configuration settings.

In this document, see “Reconfiguring ICS for Interplay | MAM or Media Composer | Cloud in an Upgrade from ICS 1.7 or Earlier” on page 28.

3. Validate the cluster.

In the MCS 2.0 Installation and Configuration Guide, see “Part V: Post Installation”.

Page 28: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

28

In particular:

· Verify ACS bus functionality (acs_query)

· Verify cache directory permissions (ls -la /cache)

· Secure the system (change root and Administrator passwords)

· Monitor cluster status (crm_mon)

· Test the cluster email service (service postfix status & mail -v <address>)

4. Once the cluster is running to your satisfaction, back up the system settings and MCS database on each node.

In this document, see “Backing Up and Restoring System Settings and the ICS/MCS Database” on page 12.

5. The cluster is ready for use.

Reconfiguring ICS for Interplay | MAM or Media Composer | Cloud in an Upgrade from ICS 1.7 or Earlier

In previous releases, the MCPS Player embedded in the MediaCentral | UX UI required its own user name and password for communicating with the MCS server (from which it receives video). In MCS 2.0 this is no longer the case. As of ICS 1.8 the MCPS Player uses the credentials of the logged-in user.

As a result, if you have deployed MCS in support of Interplay | MAM or Media Composer | Sphere, and are upgrading from ICS 1.7 (or earlier) you will need to reconfigure MCS to support these applications.

Reconfiguring MCS for Use with Interplay | MAM

To reconfigure MCS for use with Interplay | MAM:

1. With the server (or cluster) up and running, log in to MediaCentral | UX as an administrator level-user, using the host name or IP address of the server or cluster.

2. Select Users from the Layout selector.

3. Create a special role for the Interplay | MAM user by clicking on the Create Role button in the Roles pane.

4. Click the Create Role button.

5. In the Details pane, type the properties for the new role:

· Role name (e.g. MAM)

· Advance License · Do not assign the MAM role any layouts

Page 29: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

29

6. Click Apply to save your changes.

The new MAM role is added to the Roles pane.

7. Create a MAM user by clicking the Create User button.

8. In the Details pane, type the properties for the new user:

· User name (e.g. MAM)

· Password

· Uncheck “User must change password at next sign-in”

· Check “User cannot change password

9. Drag the MAM role from Roles pane to the Role section of the Details pane for the new user.

10. Click Save to save your changes.

The new MAM user is added to the User Tree, as a top-level user.

For more information on creating users and roles, see the “Interplay Central Administration Guide”.

Reconfiguring MCS for Use with Media Composer | Cloud

To reconfigure MCS for use with Media Composer | Cloud

1. With the server (or cluster) up and running, log in to MediaCentral | UX using the host name or IP address of the server or cluster.

2. Select System Settings from the Layout selector.

3. In the Settings pane, click Player.

4. Enter the user name and password reserved for Sphere (e.g. sphere).

5. Click Apply to save your changes.

Backing Up and Restoring SSL Private Keys Upgrading can be a “true” (non-destructive) upgrade, or can involve a fresh install of RHEL. For fresh installs, the system-backup script has been provided to back up and restore system settings related to ICS, including SSL data (the Jetty keystore and certificates it contains). However, if you stored the private key (jettyPrivateKey.key) file in in the root user home directory (/root) be sure to back it up manually before the upgrade. Backing up private key files is good practice, whatever the type of upgrade being performed.

Page 30: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

30

Note: If the private key was not backed up elsewhere, it is doubly important to back up the keystore before performing the upgrade. The private key is used to generate Certificate Signing Requests (CSRs).

For more information, in the MCS 2.0 Installation & Configuration Guide, see “Appendix B: Handling SSL Certificates”.

To back up and restore the Jetty keystore:

1. Locate the separate private key file used to generate the Certificate Signing Request (if any).

The default name is jettyPrivateKey.key. During its creation, it was suggested you store it in the following directory:

/root

2. Copy the private key to a safe location (off the ICS server), restoring it at an appropriate step in the upgrade.

Page 31: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

31

Appendix A: Frequently Asked Questions

What is the difference between the system-backup script and the avid-db utility? The system-backup script is used to back up and restore important ICS system settings and is found on the USB installation key. The avid-db utility is used to back up and restore the ICS database (including user information), and is found in the /opt/avid/bin directory.

What About MediaCentral Distribution Service (MCDS)? If you are upgrading from Interplay Central 1.4 or later, MCDS is already separately installed and configured, and the settings configured for it are backed up and restored as part of the upgrade process.

Note: Interplay Central 2.0 requires MCDS 3.1. In the MCS 2.0 Installation & Configuration Guide, see “Installing the MediaCentral Distribution Service”.

What Do I Do With the Unused Hardware After an Upgrade from 1.2.x? (Interplay Central only) If you are upgrading from Interplay Central 1.2.x to MediaCentral 2.0, some hardware used in 1.2.x is no longer required in 2.0. You can decommission this hardware entirely, though you may want to repurpose it for other uses. Here are some suggestions:

· Repurpose the former Interplay Central middleware servers to run ICDS (required by Interplay Central). In this case, uninstall Interplay Central. If necessary, update Avid Service Framework (ASF), the Windows ISIS client, and then the ICDS package that came with your ICS installation package.

· If the former Interplay Central middleware servers are AS3000s, you may want to repurpose them as Interplay Transcode engines, or some other Interplay service engine. Consult an Avid representative for options.

Page 32: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

32

Appendix B: Migrating the UMS Database to a Test Node ICS maintains a database containing information for the following subsystems:

· ACS - Avid Common Services

· ICPS - Interplay Central Playback Services

· UMS - User Management Services

In some situations you might need to extract just the UMS data. For example, you may want to update the ICS database of a test system with user names and passwords, roles, and so on, from a ICS system in a production setting. This appendix provides the procedures for doing so.

Migrating the 1.6.x (or later) UMS Database To extract the UMS database from an ICS 1.6.x (or later) system, use the avid-ums-backup and avid-ums-restore utilities:

avid-ums-backup <backup-filename> [-pp <postgres password>] [ -pu <postgres user>]

avid-ums-restore <backup-filename> [-pp <postgres password>] [-pu <postgres user>]

The tools for working with the UMS database are located in the following directory:

/opt/avid/bin

To extract the UMS database from an ICS 1.6.x (or later) system:

1. Log in to the master node as root and dump the UMS database:

avid-ums-backup <backup-filename> [-pp <postgres password>] [-pu <postgres user>] For example:

avid-ums-backup backup.sql -pu postgres

The system responds with an indication of success:

UMS database was backed up successfully.

2. Move the file to the server of interest in preparation for restoring it to the MCS 2.0 system.

To restore the UMS database to an MCS 2.0 system:

1. Log in to the master node as root

2. Stop the UMS service:

Page 33: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

33

service avid-ums stop In the case of a cluster, issue the following command instead:

crm resource stop AvidUMS

3. Restore the UMS database:

avid-ums-restore <backup-filename> [-pp <postgres password>] [-pu <postgres user>] For example:

avid-ums-restore backup.sql -pu postgres Once you confirm the restore operation, the operation begins. It can take a minute or two.

The system responds with an indication of success:

UMS database was restore successfully.

4. Confirm the UMS service was restarted by the avid-ums-restore utility:

service avid-ums status In the case of a cluster, issue the following command instead:

crm resource status AvidUMS

Migrating the 1.4.x/1.5.x UMS Database To extract the UMS database from an ICS 1.4.x/1.5.x system and load it into an MCS 2.0 system, you must use PostgreSQL tools directly, at both ends.

To extract the UMS database from an ICS 1.4.x/1.5.x System:

1. Log in to the master node as root and dump the UMS database:

pg_dump –U postgres uls > uls_backup.sql

2. Move the file to a safe location (off the server) in preparation for restoring it to the MCS 2.0 system.

To restore the ICS 1.4.x/1.5.x UMS database to the MCS 2.0 system:

5. Log in to the master node as root

6. Stop the UMS service:

service avid-ums stop In the case of a cluster, issue the following command instead:

crm resource stop AvidUMS

Page 34: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

34

7. Drop the current UMS database from the ICS database:

psql –U postgres –c "drop database uls;"

8. Create a new UMS database:

psql –U ulsuser postgres –c "create database uls;"

9. Import the ICS 1.5 UMS database:

psql –U ulsuser uls < uls_backup.sql

10. Start the UMS service:

service avid-ums start In the case of a cluster, issue the following command instead:

crm resource start AvidUMS

Page 35: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

35

Appendix C: Glossary This section defines some terms used in this document.

MediaCentral MediaCentral is the set of web-based and mobile applications that are powered by MediaCentral Platform Services. MediaCentral can be configured to work with Interplay, ISIS, and iNEWS to provide video editing, story editing, and logging solutions for broadcasters and newsrooms.

Prior to Interplay Central 1.3, the middleware and user management services ran separately on Windows servers.

Media Composer | Cloud Media Composer | Cloud is a Media Composer and NewsCutter plug-in that enables remote editing workflows. From any remote connection, you can log into a remote Interplay/ISIS and upload media from the field, as well as playback media residing on the remote ISIS. MCPS/MCS are used to provide the remote playback capability.

Interplay | MAM Interplay | MAM is a media archive solution, extensible to serve several media lifecycle workflows from ingest to distribution. MCPS/MCS are used to provide web-based playback of media proxies registered in the MAM database.

MediaCentral Platform Services (MCS) MediaCentral Platform Services (MCS) is the set of software services that work together to power MediaCentral. Additionally, MCS provides video playback for Media Composer | Cloud and Interplay | MAM.

With the release of Interplay Central Services (ICS 1.3) in December 2012, all ICS (now MCS) services run on the same Linux server. This includes MediaCentral middleware, MediaCentral user management, and the MediaCentral Playback Service (MCPS).

Interplay Central Playback Service (ICPS) MediaCentral Playback Service (MCPS) is one of the MCS services. It provides video playback of video assets for MediaCentral | UX, Media Composer | Cloude, and Interplay | MAM clients. MCPS can decode Avid MXF data on ISIS and many other standard file formats on standard and proprietary storage systems.

Prior to ICS 1.3 (and with it Interplay Central 1.3) the ICPS service ran on its own Linux server.

Page 36: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

36

MCS System Settings In this document, the upgrade procedures refer to backing up and restoring MCS system settings. These settings include server network configuration, OS user settings (e.g. the root user password), SSL certificate configuration, load balancing configuration, and the video player configuration.

MCS Platform Settings MCS platform settings are the settings you configure in the MediaCentral | UX administration UI (e.g. the connections to Interplay, ISIS, and iNEWS).

MCS Database In this document, the upgrade procedures refer to backing up and restoring the MCS database. This database stores the MCS platform settings.

MediaCentral User Management Database Since ICS 1.3, the Interplay Central (now MediaCentral) User Management database has been part of the ICS/MCS database. Prior to ICS 1.3, the Interplay Central user management database was a separate database on the Interplay Central middleware servers

This explains why when upgrading from Interplay Central 1.2.x to 2.0, migrating the Interplay Central user management database is required. The migration of the database merges the user management data into the ICS (now MCS) database.

Corosync Corosync is a software service used by MCS to manage MCS software services across a multi-node server cluster. Corosync orchestrates the stopping and starting of software services on nodes in the cluster to obtain a highly available system.

Distributed Replicated Block Device (DRBD) DRBD refers to block devices designed as a building block to form high availability (HA) clusters. DRBD can be understood as network based RAID (level 1). In MCS, DRBD is used to replicate the MCS database, allowing for a more reliable failover in more severe software and service failures.

DRBD was introduced in ICS 1.4—configuring DRBD is a required step for cluster setups only.

Page 37: Version 2.0Upgrading Guide - Avidresources.avid.com/SupportFiles/attach/ICS/MCS_V2_0_Upgrading... · ¤ glusterfs-server-3.4.0-8.el6.x86_64.rpm . Note: If the specified version of

MediaCentral Services 2.0 Upgrading Guide

37

Copyright and Disclaimer Product specifications are subject to change without notice and do not represent a commitment on the part of Avid Technology, Inc.

The software described in this document is furnished under a license agreement. You can obtain a copy of that license by visiting Avid's Web site at www.avid.com. The terms of that license are also available in the product in the same directory as the software. The software may not be reverse assembled and may be used or copied only in accordance with the terms of the license agreement. It is against the law to copy the software on any medium except as specifically allowed in the license agreement.

No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose without the express written permission of Avid Technology, Inc.

Copyright © 2013 Avid Technology, Inc. and its licensors. All rights reserved.

Attn. Government User(s). Restricted Rights Legend

U.S. GOVERNMENT RESTRICTED RIGHTS. This Software and its documentation are “commercial computer software” or “commercial computer software documentation.” In the event that such Software or documentation is acquired by or on behalf of a unit or agency of the U.S. Government, all rights with respect to this Software and documentation are subject to the terms of the License Agreement, pursuant to FAR §12.212(a) and/or DFARS §227.7202-1(a), as applicable.

This product may be protected by one or more U.S. and non-U.S patents. Details are available at www.avid.com/patents.

Trademarks

Adrenaline, AirSpeed, ALEX, Alienbrain, Archive, Archive II, Assistant Avid, Avid Unity, Avid Unity ISIS, Avid VideoRAID, CaptureManager, CountDown, Deko, DekoCast, FastBreak, Flexevent, FXDeko, iNEWS, iNEWS Assign, iNEWS ControlAir, Instinct, IntelliRender, Intelli-Sat, Intelli-sat Broadcasting Recording Manager, Interplay, ISIS, IsoSync, LaunchPad, LeaderPlus, ListSync, MachineControl, make manage move | media, Media Composer, NewsCutter, NewsView, OMF, OMF Interchange, Open Media Framework, Open Media Management, SIDON, SimulPlay, SimulRecord, SPACE, SPACEShift, Sundance Digital, Sundance, Symphony, Thunder, Titansync, Titan, UnityRAID, Video the Web Way, VideoRAID, VideoSPACE, VideoSpin, and Xdeck are either registered trademarks or trademarks of Avid Technology, Inc. in the United States and/or other countries.

All other trademarks contained herein are the property of their respective owners.

MediaCentral Services v2.0 Upgrading Guide• 21 July 2014

• This document is distributed by Avid in online (electronic) form only, and is not available for purchase in printed form.