ContentManager 3.0 UsersGuide
ContentManager 3.0 UsersGuide
Software Release
Release 3.0
Notice
Information contained in this guide is subject to change without notice or obligation. While every effort has
been made to ensure that the information is accurate as of the publication date, Harmonic assumes no liability
for errors or omissions. In addition, Harmonic assumes no responsibility for damages resulting from the use of
this guide.
Company Address
Harmonic Inc.
4300 North First Street
San Jose, CA 95134 U.S.A.
Phone (inside the U.S.): +1 (800) 788-1330
(outside the U.S.): +1 (408) 542-2500
Fax: +1 (408) 542-2511
Technical Support: +1 (408) 585-5200
Fax (Sales and Technical Support): +1 (408) 490 7390
Web Site: www.omneon.com
E-mail (Sales): sales@omneon.com
E-mail (Support): support@omneon.com
ii User’s Guide
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Locating the Latest Documentation on the Omneon Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Useful Information when Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Setting Reservations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Viewing File Slice Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Viewing Logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
2 User’s Guide
Introduction
Omneon MediaTools are low cost, easy-to-use utilities, designed to ensure greater operability for
broadcast customers. ContentManager™ is tightly integrated with the Omneon MediaGrid System,
which runs on Windows, Mac OS, and Linux platforms.
The ContentManager application is used for setting, reviewing and changing attributes on associated
files, directories, and user permissions of the MediaGrid. Note that ContentManager automatically
detects if the MediaGrid system uses RAID (ContentServer 3000/ContentStore 3160) or replication
(ContentServer 1000/2000 series) architecture and presents a different set of options for each.
You can use ContentManager to:
• View and edit Access Control Lists (ACLs): View and edit the user and group access for a
single clip, file or directory. You can also select multiple items and apply changes to each. Refer to
Access Control Lists (ACLs).
• Set and change replication factors (for MediaGrid replication systems, ContentServer
1000/2000, only): Set a file- or directory-level replication factor for data protection and access
bandwidth purposes to ensure data is replicated an appropriate number of times (up to 14). Refer
to Replication for Files and Directories.
• Connect to multiple MediaGrid systems: You can connect to multiple MediaGrid systems
simultaneously.
• Set Quotas or Reservations in a MediaGrid System: With Quotas, you can set a size limit on
directories in a MediaGrid system. With Reservations, you can reserve disk space for directories in
a MediaGrid system.
• Troubleshoot system issues: A comprehensive logging feature provides the details needed to
troubleshoot system issues. Activity logs record all information related to file and user operations.
This guide provides installation and operating instructions in the following sections:
• Installing ContentManager
• Using ContentManager
2 User’s Guide
• Fax: +86 10 6581 9190
• Email: chinasupport@omneon.com
• http://www.omneon.com/service-support
• ftp://ftp.omneon.com/Updates/Omneon/Current/
For support in Asia Pacific (other territories):
• Telephone: +65 6542 0050
• Fax: +65 6548 0504
• Email: apacsupport@omneon.com
• http://www.omneon.com/service-support
• ftp://ftp.omneon.com/Updates/Omneon/Current/
Company Address
Harmonic Inc.
4300 North First Street
San Jose, CA 95134 U.S.A.
4 User’s Guide
• What brand of Automation, if any, is being used for control?
• Is the Automation using VDCP or API for communication control?
• What other third party device (for example, Tandberg* or Snell and Wilcox*) is involved?
IMPORTANT: Do not perform the following procedures unless directed by Omneon Technical Support.
2. Reproduce problem.
3. Collect the following log files: /var/log/system.log and /var/log/kernel.log.
6 User’s Guide
The Omneon MediaGrid provides logs files for all of the core services. Omneon Technical support
may wish to view one of these logs to determine the root cause of the problem. The following three
log files are used most often when troubleshooting. These files are located on the ContentDirector at
/var/log/omneon/remote.
• ssmd: SliceServer Manager
• mdscore: MetaData Server
• startup: Core Omneon MediaGrid Services Startup and Shutdown
This section provides information about installing ContentManager. The following topics are covered:
• System Requirements
• System Compatibility
• Software Installation
• ContentManager Licensing
IMPORTANT: A File System Driver and Microsoft .NET Framework version 2.0 must be installed on your
system to use ContentManager. Refer to Software Installation for instructions.
System Requirements
Prior to installing ContentManager, your PC must conform to the following minimum requirements,
and must be connected by Ethernet to your facility’s LAN:
• Pentium 4 or equivalent CPU
• At least 1 gigabyte (GB) of RAM
• 20GB hard drive
• At least 5 Megabytes of free disk space
• Windows® XP Professional
• MediaGrid Windows FSD (File System Driver) 2.1 installed*
• Microsoft .NET Framework version 2.0 installed*
• Display resolution should be set to 1152 x 864 minimum
• 100 BaseT (Gigabit Ethernet recommended)
*Refer to the Software Installation instructions.
System Compatibility
ContentManager 3.0 is compatible with Omneon MediaGrid Release 3.0 and later.
IMPORTANT: Make sure to download the version that matches your computer's processor. If your Windows
computer uses a 32-bit processor, download WinFSD-v3.0.0.0-32bit.exe/WinFSD-v3.0.0.0-32bit.msi. If your
Windows computer uses a 64-bit processor, download WinFSD-v3.0.0.0-64bit.exe/WinFSD-v3.0.0.0-
64bit.msi.
10 User’s Guide
IMPORTANT: You must have administrator privileges to install the Omneon MediaGrid FSD on
Windows
Prior to installing the Omneon MediaGrid FSD for Windows, make sure of the following:
• No application is running on the computer.
• No network shares are open on the computer. If installing the Omneon MediaGrid FSD
forWindows from a network location, always copy the installation file to a local directory before
beginning the installation.
• All network drive maps to an Omneon MediaGrid server are unmapped. To do this, right-click the
mapped network drive and then select the “Disconnect” menu option.
• Uninstall the previous version of the Omneon MediaGrid FSD for Windows if you are upgrading
from a prior version. Select Start > Control Panel > Add or Remove Programs to remove the
previous version. Restart your computer if instructed to do so.
1. Log on to the system as administrator.
2. Navigate to the location of the WinFSD<version#>.msi file on the client platform.
3. Double-click the WinFSD<version#>.msi icon to begin the installation.
4. Follow the instructions to install the software on the client platform.
5. Restart the computer to complete the installation.
1. Go to www.microsoft.com and then search for “.NET Framework 2.0” to locate the installer.
2. Follow the steps to download and install .NET Framework version 2.0 on your system.
Installing ContentManager
Complete the following steps to install the ContentManager application on your PC.
2. Locate the ContentManager executable file icon from the ContentManager.zip folder.
ContentManager Licensing
A license file (provided by Omneon) supplies the licenses for the ContentManager components. This
file is installed on the Omneon SystemManager computer.
One license is required for each instance of ContentManager that is in use. These are “floating
licenses” so any connected computer can run the application, until the total number of purchased (and
licensed) copies are active.
For example: If you have purchased four ContentManager licenses and you have installed the product
on 20 computers, you can run up to four instances of ContentManager at any one time. The remaining
16 installations cannot run the tool until one of the first four exits.
12 User’s Guide
A variety of dialog boxes may appear at startup time if the application encounters licensing issues (for
example, the license server is down, the license file cannot be found, all licenses are used, etc.). The
figure below shows examples of some of the possible messages you may encounter.
Follow the directions in these dialog boxes and/or contact your Network Administrator as required to
resolve any issues that arise. Contact Omneon Sales to purchase additional licenses.
This section covers the operation of the Omneon ContentManager application. Refer to the
Introduction for an overview of the ContentManager features. Choose from the following topics:
• Starting ContentManager
Instructions on starting the ContentManager application and mounting a MediaGrid system.
• User Interface and Menu Overview
An introduction to the ContentManager Main application window and a description of each menu
and its commands.
This section also includes detailed instructions on using the ContentManager features, including:
• Access Control Lists (ACLs)
• Replication for Files and Directories
• Directory Quotas
• Directory Reservations
• Viewing File Slice Information
• Viewing Logs
Starting ContentManager
This section provides instructions on starting and using ContentManager.
3. Enter the IP address or host name of the license server on the FLEXlm License Finder screen and
then click Next.
16 User’s Guide
4. ContentManager accesses the license server and verifies availability of licenses. If licenses are available,
the following screen displays:
Mounting a MediaGrid
The MediaGrid system that ContentManager browses must be joined to your Windows domain to
edit access control lists and replication factors. See “Joining a MediaGrid Cluster to a Windows
Domain” in the MediaGrid Installation and Configuration Guide for more information.
2. Enter the path to the MediaGrid in the following format: \\[dnsname]\[file system]
3. Click the OK button.
18 User’s Guide
Main Window
The ContentManager Main window provides a central control panel for selecting the directories and
files for which you want to edit ACLs and replication factors. The figure below shows a sample Main
window.
NOTE: For MediaGrid RAID systems (ContentServer 3000/ContentStore 3160), the Rep column, which
shows replication factor, in the main window will not display.
Menu Bar
The Menu Bar provides menus for File, Edit, View, Tools, and Help, which are used to operate the
ContentManager application. Refer to File Menu, Edit Menu, View Menu, Tools Menu, and Help
Menu for complete details.
Toolbar
The Toolbar provides shortcuts for commonly used ContentManager tasks.
Tree View
The Tree View, shown in the left-hand pane of the Main window, displays all the available MediaGrid
systems. This is where you select the files or directories for modification of ACLs and replication
factors on specific MediaGrid systems. You can connect to multiple MediaGrid systems
simultaneously and browse each for directories or files to edit.
Contents Pane
The Contents Pane shows all of the files and subdirectories present on the selected MediaGrid
directory. The leftmost folder shown in the Tree View is the MediaGrid root directory.
Click the Details View or List View Toolbar icons to show or hide the file and directory details. Click
any of the Contents Pane column headings to sort the contents by the column selected.
20 User’s Guide
Note that Soft links are shown in green text in the Contents Pane. Place the mouse pointer over a soft
link to view the path of the file to which the soft link refers.
The contents pane displays the following information:
• Name: the name of the file or directory.
• Type: the type of file (for example, .m2v, .aiff, .mov, .mxf, .log).
• Class: No longer supported.
• Rep (for MediaGrid replication systems, ContentServer 1000/2000 series, only): the file’s or
directory’s current replication factor. An asterisk is placed next to a directory’s replication factor if
the replication factor is inherited. You can change the replication factor directly in the Contents
Pane by double-clicking the number in the Rep column and then entering a new number.
• ACL: This column shows whether an ACL exists for the file or directory. YES is shown if an ACL
exists (either Deny or Allow); dashes (---) display if the ACL is Inherited.
• Slice Size: the slice size of the file.
• Size: the size of the file.
• Quota: the size limit that has been set on a MediaGrid directory.
• Reservation: indicates the amount of space reserved on a MediaGrid directory.
• Modified: the date the file or directory was last modified.
File Menu
The File menu contains the following options:
Edit Menu
The Edit menu contains the following options:
22 User’s Guide
• Invert Selection: Click to reverse what is selected in the Contents pane. For example, if there are
10 files in the Contents pane and only one is selected, click Invert Selection to deselect the file
and select the other nine files.
View Menu
The View menu contains the following options:
• Refresh: Click to display the latest view of the accessible files and directories.
• List: Click to display the selected MediaGrid’s contents without details.
• Details: Click to see each file’s and directory’s details (Type, Rep, ACL, Size, Modified).
• Modify Clip Essence Files: Click to determine the action taken on the essence files when a
.mov is modified.
• Current Log: Click to display the current log file.
• Debug On: Click to display debug messages in the log file.
• Verification Reports: Click to open the Verification Reports dialog box. This dialog box
displays the logs created from running the Verify Replication tool. For information on the
Verify Replication tool, refer to the Tools Menu.
Tools Menu
The Tools menu contains the following options:
• Verify Replication : Click to open the Verify Replication dialog. This tool checks every file in the
selected folder(s) to verify whether the actual replication factor matches the requested replication
factor.
Note: For MediaGrid RAID systems, the Verify Replication tool can be used to identify missing
slices.
24 User’s Guide
To verify the selected folders recursively (which includes all sub folders), check Recurse on
subdirectories, otherwise leave that option blank, and then click Start to begin verifying.
Files with incorrect replication factors are listed in the white pane of the dialog. Double-click the file
with incorrect replication to view the View Slices dialog box for the selected file. Refer to Viewing
File Slice Information for more information.
• Show All Quotas: Click to display the All Quotas dialog box.
This dialog box shows all the quotas on the file system. To edit the quota, either double-click the item
shown in the Path column, or select it and click View Info.
• Show All Reservations: Click to display the All Reservations dialog box, shown below.
Help Menu
The Help menu contains the following options:
• Show Help: Click to open ContentManager help.
• From the Licensing dialog box, click the Reset License Server button to clear the license
server. ContentManager must be restarted to enter a new license server. You may want to
note the current license server before resetting this information.
• About: Click to show the version, date and copyright information for ContentManager.
26 User’s Guide
Windows Explorer allow you to create Acces Control Lists (ACLs) to set user- and group-level
security for the various Omneon MediaGrid files and directories. These ACLs are stored on the
ContentDirector. Once ACLs are created, when users attempt to access files, MediaGrid checks
access against the ACL for each file. ACLs provide security preferences for each individual Access
Control Entry (ACE).
The Omneon MediaGrid system receives user and group information from the Active Dirctory or
LDAP server. It also uses the domain controller to authenticate the users. The ContentManager and
the MediaGrid Windows FSD access this user and group information when you use either of them to
create ACLs. The ContentManager application and MediaGrid Windows FSD also receive the ACLs
when either mounts an Omneon MediaGrid file system, and then they contact the ContentDirector to
resolve user names.
ACL Attributes
The following attributes can be defined for files and directories:
• File: includes the following operations
• FileRead: Allows the file to be read.
• FileWrite: Allows the file to be changed, appended or truncated (but not necessarily deleted).
• FileExecute: Depending on the client operating system, may allow the file to be executed.
• Directory: includes the following operations:
• List: Allows the names and attributes of files stored in the directory to be read. In order to
access a file, in addition to requiring appropriate permissions on that file, a user needs List
permission to all the parent directories of that file.
• Delete: Allows files to be deleted (from a directory). As with Unix, the file itself need not be
writable.
• Rename: Allows files to be renamed.
• Create: Allows new files and directories to be created.
• FileRead: When inherited by files, allows the file to be read. There is no other effect on the
directory.
• FileWrite: When inherited by files, allows the file to be changed, appended or truncated (but
not necessarily deleted).
• FileExecute: When inherited by files, may allow the file to be executed.
• File or Directory: includes the following operations:
• WriteSysMetaData: Allows changes to a file’s ACL, ownership or replication factor (if
applicable).
• WriteUserMetaData: Allows changes to a file’s “user data” (keys and values).
Setting ACLs
• With ContentManager started, select the file or directory you want to edit. There are three ways to
select a file or directory:
• Select ACL from the Edit menu with the file or directory highlighted.
• Click the ACL icon on the Toolbar with the file or directory highlighted.
• Right-click the file or directory and then select Edit ACL.
The ACL Editor dialog box provides permissions that can be customized for each user. Permissions
that are checked correspond to the Action setting. The above example shows an ACL for a a file. If a
directory is selected, then additional permissions for List, Delete, Rename, and Create are available.
Refer to Access Control Lists (ACLs) for descriptions of each permission.
28 User’s Guide
1. Select the permission for each user by clicking the corresponding check box.
2. Select the Action by clicking the Action field and selecting one of the following:
• Allow: allow the user control of the checked permissions.
• Deny: deny the user control of the checked operations.
• Inherit: use the permissions of the parent directory.
Tip: Press SHIFT-click with the mouse pointer over a check box to select or clear all the check boxes for the
selected access control entry (ACE).
3. Click the Apply button to apply your changes, or click Cancel to cancel any changes and close the
dialog box. Click the OK button to confirm the changes that you made.
30 User’s Guide
• NoneSID: this is the SID for an unauthenticated user, and should not be used to match a
user (“none” is an invalid SID in an ACL).
• GuestSID: “guest” is the ACL equivalent of “none”. A “guest” SID in an ACL only matches
against an unauthenticated user. Use GuestSID to match a user of any session who has not
authenticated.
NOTE: Since it would be rare to allow access only to an unauthenticated user, “guest” is typically only used
for “deny” entries. For example, if you wanted to allow access only to authenticated users, you would have an
ACL of “deny guest”, followed by “allow all”.
To make this ACL effective, “SNV-ENG\guest” should be moved to the top using the Up arrow, as
shown in the following diagram.
Each file and directory can be duplicated within the MediaGrid system to ensure data protection and
for access bandwidth purposes. The number of copies, or the “replication factor,” can be up to 14.
The replication factor is set on the root directory of a file system and then inherited by child
directories. A file inherits the replication factor from its parent directory only at the time of file
creation. Thereafter, changes in replication factor of the directory do not affect pre-existing files.
Once a file is created, the replication factor is specific to each file and must be changed on a file-by-file
basis.
It is recommended that you set the replication factor to at least 2 for data protection of your critical
files and directories. A replication factor of 1 means that there is only one instance of a file or
directory on the MediaGrid system. A failure of any single ContentServer or drive in the system that
stores any part of a file with a replication factor of 1 will render that file unrecoverable.
Follow these steps to set replication factors.
1. Select the file or directory you want to edit. There are three ways to select a file or directory:
• Select Replication from the Edit menu with the file or directory highlighted, or
• Click the Replication icon on the Toolbar with the file or directory highlighted, or
• Right-click the file or directory and then select Edit Replication.
NOTE: The Inherit check box displays when editing a directory’s replication factor, and allows you to set the
replication factor to Inherit.
32 User’s Guide
The number that you enter represents the desired replication factor. Several factors affect the
completion progress; if not completed immediately, the replication factor is reached at the earliest
possible opportunity.
If there are an insufficient number of ContentServers with available storage, the MediaGrid retains the
desired replication factor until this is resolved, either by addition of ContentServers or by deletion of
existing content.
3. Within the Contents Pane, hold down the SHIFT key and then click the group of items that you want
to change.
Directory Quotas
The Quota feature allows a system administrator to set a size limit on all ContentServer directories in
a MediaGrid system. Once set, the disk space used by all files in that directory and in all of its
subdirectories cannot exceed the quota setting. Once full, any operation that could increase the size of
the directory is prohibited.
The following apply to quotas:
• Quotas can only be set or removed by a client with system administrative privileges.
• A maximum of 64 quotas can be set within one file system.
3. Enter the size limit, in gigabytes, that you would like to set for the directory.
4. Click OK.
NOTE: Quota checks are performed when writing to files. Once the quota limit is exceeded, the space used
must be reduced below the quota level before further writes are allowed.
To remove a quota:
1. Select the directory for which you want to remove the quota.
2. Select Quota from the Edit menu, or right-click the directory and then select Quota.
34 User’s Guide
3. Select No Limit and then click OK.
Directory Reservations
The Reservation feature allows a system administrator to “reserve” an amount of disk space for a
directory, which guarantees that all files and subdirectories within the directory have at least that
amount of space available. Once a reservation is set, the file system checks every write, or any other
operation that uses disk space, and validates that the operation will not affect the “reserved” space
(that is, the operation will not create a “reservation conflict”).
The following rules apply to reservations:
• Reservations can only be set or removed by a client with system administrative privileges.
• A directory that has been reserved cannot be deleted or renamed while it carries the reservation.
In order to delete or rename the directory, you must first remove the reservation, and then
perform the operation. Once the operation is complete, the reservation can be reset.
• A maximum of 128 directories can be reserved within one file system.
• A reservation cannot be set on a directory that is either a subset or superset of an existing
reservation. For example, if there is a reservation on /testfs/dir1/dir2, then a reservation cannot
be set on /testfs/dir1, or on /testfs/dir1/dir2/dir3.
• The following will result in a “reservation error” message:
• Attempting to set a reservation on a directory in which there is not sufficient space for that
reservation.
• Attempting an operation, such as writing to or replicating files, that would use more disk
space than is reserved for a directory.
Setting Reservations
To set a reservation:
3. Enter the size limit, in gigabytes, that you would like to set for the directory.
To remove a reservation:
1. Select the directory for which you want to remove the reservation.
2. Select Reservations from the Edit menu, or right-click the directory and then select Edit
Reservation.
3. Select No Reservation and then click OK.
The Slice Counts dialog box presents the following information about the file:
• Slice #: the number of slices in the file. Slice 0 is the first slice in the file, slice 1 is the second, and
so on. The number of slices in a file depends on the size of the file and the slice size of the file.
36 User’s Guide
• Actual Rep: the replication factor based on the number of ContentServers on which the slice
resides.
• ContentServers: the ContentServers (with IDs shown) within a MediaGrid cluster that store the
replication. In the example above, each replication is on three ContentServers: 0, 1 and 2.
• Click Show All to see all of the slices for the selected file.
• Click Show Deficient Slices to see the slices that have replication factors that do not match the
replication factor that you requested, as shown above. Deficient slices typically occur when there
are not enough ContentServers to accommodate the requested replication factor.
A replication can have one of three different background colors, as described below:
• White indicates that the number of slices replicated matches the replication factor.
• Yellow indicates that the number of slices replicated is one less than the replication factor.
• Orange indicates that the number of replicated slices is less than the replication factor by at least
two.
To refresh the list in the Slice Counts dialog box, click Refresh, or press F5.
Viewing Logs
ContentManager activity is recorded and stored in a log file, which is located in a subdirectory of the
ContentManager program. To view the current log file, select Logging from the View menu and then
select Open Log.
You can also view a log file by using Windows Explorer to navigate to the Program Files directory.
Go to the Omneon\ContentManager\logs subdirectory. An example is shown below.
38 User’s Guide
Index
A H
About ContentManager 26 Help Menu 26
ACL Attributes 27
ACL Editor screen buttons 29 I
ACL, Edit Menu 22 Inherit action setting 29
ACLs Installation 9, 11, 12
adding users and groups 29 Invert selection 23
Allow action setting 29
editing 28 L
for multiple files and directories 33 License server, clear 26
how ACLs work 28 Licensing, Help menu 26
setting 28 List 23
Allow action setting 29 Log files 37
Logging levels 38
C
Contact Omneon 2 M
ContentManager Main Window 19
features 1 Main Window, Tree View 20
installing 9, 11, 12 MediaGrid
licenses 12 mounting 17
logs 37 mounting, unmounting from File menu 22
Main Window 19 Menu Bar 19
starting 16 Modify Clip Essence Files 23
D O
Deficient slices 37 Omneon
Deny action setting 29 Technical Support 2
Details, View Menu 23 Q
Directory quotas 1, 34
Quota, Edit Menu 22
Directory, change owner 29
Quotas, setting 34
E
R
Edit Menu 22
Refresh 23
Exit ContentManager 22
Replication factor 32
F actual 37
File Menu 21, 22 for multiple files and directories 33
File, change owner 29 setting 32
FLEXlm License 12 Replication, Edit Menu 22
Reservation, Edit Menu 22
G
Groups, adding to ACLs 29 S
Show Help 26
Slice count 36