InterplayAdminGuide V2 5 PDF
InterplayAdminGuide V2 5 PDF
InterplayAdminGuide V2 5 PDF
Legal Notices
Product specifications are subject to change without notice and do not represent a commitment on the part of Avid Technology,
Inc.
This product is subject to the terms and conditions of a software license agreement provided with the software. The product
may only be used in accordance with the license agreement.
Avid products or portions thereof are protected by one or more of the following United States Patents: 5,309,528; 5,355,450;
5,396,594; 5,440,348; 5,467,288; 5,513,375; 5,528,310; 5,557,423; 5,577,190; 5,584,006; 5,640,601; 5,644,364; 5,654,737;
5,724,605; 5,726,717; 5,745,637; 5,752,029; 5,754,851; 5,799,150; 5,812,216; 5,828,678; 5,842,014; 5,852,435; 5,959,610,
5,986,584; 5,999,406; 6,038,573; 6,057,829, 6,069,668; 6,141,007; 6,211,869; 6,336,093, 6,532,043; 6,546,190;
6,596,031;6,728,682, 6,747,705; 6,763,523; 6,766,357; 6,847,373; 7,081,900; 7,403,561; 7,433,519; 7,441,193, 7,671,871;
7,684,096; D352,278; D372,478; D373,778; D392,267; D392,268; D392,269; D395,291; D396,853; D398,912.
Other patents are pending.
Avid products or portions thereof are protected by one or more of the following European Patents: 0506870; 0635188;
0674414; 0752174; 0811290; 0811292; 0811293; 1050048; 1111910; 1629675. Other patents are pending.
This document is protected under copyright law. An authorized licensee of Avid Interplay may reproduce this publication for the
licensees own use in learning how to use the software. This document may not be reproduced or distributed, in whole or in
part, for commercial purposes, such as selling copies of this document or providing support or educational services to others.
This document is supplied as a guide for Avid Interplay. Reasonable care has been taken in preparing the information it
contains. However, this document may contain omissions, technical inaccuracies, or typographical errors. Avid Technology,
Inc. does not accept responsibility of any kind for customers losses due to the use of this document. Product specifications
are subject to change without notice.
Copyright 2011 Avid Technology, Inc. and its licensors. All rights reserved. Printed in USA.
The following disclaimer is required by Apple Computer, Inc.:
APPLE COMPUTER, INC. MAKES NO WARRANTIES WHATSOEVER, EITHER EXPRESS OR IMPLIED, REGARDING
THIS PRODUCT, INCLUDING WARRANTIES WITH RESPECT TO ITS MERCHANTABILITY OR ITS FITNESS FOR ANY
PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES. THE
ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL RIGHTS.
THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO STATE.
The following disclaimer is required by Sam Leffler and Silicon Graphics, Inc. for the use of their TIFF library:
Copyright 19881997 Sam Leffler
Copyright 19911997 Silicon Graphics, Inc.
Permission to use, copy, modify, distribute, and sell this software [i.e., the TIFF library] and its documentation for any purpose
is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of
the software and related documentation, and (ii) the names of Sam Leffler and Silicon Graphics may not be used in any
advertising or publicity relating to the software without the specific, prior written permission of Sam Leffler and Silicon
Graphics.
THE SOFTWARE IS PROVIDED AS-IS AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR
OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE.
IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT
OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
This Software may contain components licensed under the following conditions:
Copyright (c) 1989 The Regents of the University of California. All rights reserved.
Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph
are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such
distribution and use acknowledge that the software was developed by the University of California, Berkeley. The name of the
University may not be used to endorse or promote products derived from this software without specific prior written
permission. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE.
Copyright (C) 1989, 1991 by Jef Poskanzer.
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission
notice appear in supporting documentation. This software is provided "as is" without express or implied warranty.
Copyright 1995, Trinity College Computing Center. Written by David Chappell.
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission
notice appear in supporting documentation. This software is provided "as is" without express or implied warranty.
Copyright 1996 Daniel Dardailler.
Permission to use, copy, modify, distribute, and sell this software for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in
supporting documentation, and that the name of Daniel Dardailler not be used in advertising or publicity pertaining to
distribution of the software without specific, written prior permission. Daniel Dardailler makes no representations about the
suitability of this software for any purpose. It is provided "as is" without express or implied warranty.
Modifications Copyright 1999 Matt Koss, under the same license as above.
Copyright (c) 1991 by AT&T.
Permission to use, copy, modify, and distribute this software for any purpose without fee is hereby granted, provided that this
entire notice is included in all copies of any software which is or includes a copy or modification of this software and in all
copies of the supporting documentation for such software.
THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTY. IN PARTICULAR,
NEITHER THE AUTHOR NOR AT&T MAKES ANY REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE
MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.
This product includes software developed by the University of California, Berkeley and its contributors.
This software contains V-LAN ver. 3.0 Command Protocols which communicate with V-LAN ver. 3.0 products developed by
Videomedia, Inc. and V-LAN ver. 3.0 compatible products developed by third parties under license from Videomedia, Inc. Use
of this software will allow frame accurate editing control of applicable videotape recorder decks, videodisc recorders/players
and the like.
The following disclaimer is required by Altura Software, Inc. for the use of its Mac2Win software and Sample
Source Code:
19931998 Altura Software, Inc.
This product may include the JCifs library, for which the following notice applies:
JCifs Copyright 2004, The JCIFS Project, is licensed under LGPL (http://jcifs.samba.org/). See the LGPL.txt file in the Third
Party Software directory on the installation CD.
Avid Interplay contains components licensed from LavanTech. These components may only be used as part of and in
connection with Avid Interplay.
Trademarks
003, 192 Digital I/O, 192 I/O, 96 I/O, 96i I/O, Adrenaline, AirSpeed, ALEX, Alienbrain, AME, AniMatte, Archive, Archive II,
Assistant Station, AudioPages, AudioStation, AutoLoop, AutoSync, Avid, Avid Active, Avid Advanced Response, Avid DNA,
Avid DNxcel, Avid DNxHD, Avid DS Assist Station, Avid Liquid, Avid Media Engine, Avid Media Processor, Avid MEDIArray,
Avid Mojo, Avid Remote Response, Avid Unity, Avid Unity ISIS, Avid VideoRAID, AvidRAID, AvidShare, AVIDstripe, AVX,
Axiom, Beat Detective, Beauty Without The Bandwidth, Beyond Reality, BF Essentials, Bomb Factory, Boom, Bruno, C|24,
CaptureManager, ChromaCurve, ChromaWheel, Cineractive Engine, Cineractive Player, Cineractive Viewer, Color Conductor,
Command|24, Command|8, Conectiv, Control|24, Cosmonaut Voice, CountDown, d2, d3, DAE, Dazzle,
Dazzle Digital Video Creator, D-Command, D-Control, Deko, DekoCast, D-Fi, D-fx, Digi 003, DigiBase, DigiDelivery,
Digidesign, Digidesign Audio Engine, Digidesign Development Partners, Digidesign Intelligent Noise Reduction,
Digidesign TDM Bus, DigiLink, DigiMeter, DigiPanner, DigiProNet, DigiRack, DigiSerial, DigiSnake, DigiSystem,
Digital Choreography, Digital Nonlinear Accelerator, DigiTest, DigiTranslator, DigiWear, DINR, DNxchange, DPP-1, D-Show,
DSP Manager, DS-StorageCalc, DV Toolkit, DVD Complete, D-Verb, Eleven, EM, Euphonix, EUCON, EveryPhase, Expander,
ExpertRender, Fader Pack, Fairchild, FastBreak, Fast Track, Film Cutter, FilmScribe, Flexevent, FluidMotion, Frame Chase,
FXDeko, HD Core, HD Process, HDPack, Home-to-Hollywood, HYBRID, HyperControl, HyperSPACE, HyperSPACE HDCAM,
iKnowledge, Image Independence, Impact, Improv, iNEWS, iNEWS Assign, iNEWS ControlAir, Instantwrite, Instinct,
Intelligent Content Management, Intelligent Digital Actor Technology, IntelliRender, Intelli-Sat,
Intelli-sat Broadcasting Recording Manager, InterFX, Interplay, inTONE, Intraframe, iS Expander, ISIS, IsoSync, iS9, iS18,
iS23, iS36, ISIS, IsoSync, KeyRig, KeyStudio, LaunchPad, LeaderPlus, LFX, Lightning, Link & Sync, ListSync, LKT-200, Lo-Fi,
Luna, MachineControl, Magic Mask, Make Anything Hollywood, make manage move | media, Marquee, MassivePack,
Massive Pack Pro, M-Audio, M-Audio Micro, Maxim, Mbox, Media Composer, MediaFlow, MediaLog, MediaMatch, MediaMix,
Media Reader, Media Recorder, MEDIArray, MediaServer, MediaShare, MetaFuze, MetaSync, MicroTrack, MIDI I/O, Midiman,
Mix Rack, MixLab, Moviebox, Moviestar, MultiShell, NaturalMatch, NewsCutter, NewsView, Nitris, NL3D, NLP, Nova,
NRV-10 interFX, NSDOS, NSWIN, Octane, OMF, OMF Interchange, OMM, OnDVD, Open Media Framework,
Open Media Management, Ozone, Ozonic, Painterly Effects, Palladium, Personal Q, PET, Pinnacle, Pinnacle DistanTV,
Pinnacle GenieBox, Pinnacle HomeMusic, Pinnacle MediaSuite, Pinnacle Mobile Media, Pinnacle Scorefitter, Pinnacle Studio,
Pinnacle Studio MovieBoard, Pinnacle Systems, Pinnacle VideoSpin, Podcast Factory, PowerSwap, PRE, ProControl,
ProEncode, Profiler, Pro Tools LE, Pro Tools M-Powered, Pro Transfer, Pro Tools, QuickPunch, QuietDrive,
Realtime Motion Synthesis, Recti-Fi, Reel Tape Delay, Reel Tape Flanger, Reel Tape Saturation, Reprise, Res Rocket Surfer,
Reso, RetroLoop, Reverb One, ReVibe, Revolution, rS9, rS18, RTAS, Salesview, Sci-Fi, Scorch, Scorefitter, ScriptSync,
SecureProductionEnvironment, Serv|LT, Serv|GT, Session, Shape-to-Shape, ShuttleCase, Sibelius, SIDON, SimulPlay,
SimulRecord, Slightly Rude Compressor, Smack!, Soft SampleCell, Soft-Clip Limiter, Solaris, SoundReplacer, SPACE,
SPACEShift, SpectraGraph, SpectraMatte, SteadyGlide, Streamfactory, Streamgenie, StreamRAID, Strike, Structure,
Studiophile, SubCap, Sundance Digital, Sundance, SurroundScope, Symphony, SYNC HD, Synchronic, SynchroScope,
SYNC I/O, Syntax, TDM FlexCable, TechFlix, Tel-Ray, Thunder, Titansync, Titan, TL Aggro, TL AutoPan, TL Drum Rehab,
TL Everyphase, TL Fauxlder, TL In Tune, TL MasterMeter, TL Metro, TL Space, TL Utilities, tools for storytellers, Torq,
Torq Xponent, Transfuser, Transit, TransJammer, Trigger Finger, Trillium Lane Labs, TruTouch, UnityRAID, Vari-Fi, Velvet,
Video the Web Way, VideoRAID, VideoSPACE, VideoSpin, VTEM, Work-N-Play, Xdeck, X-Form, Xmon, XPAND!, Xponent,
X-Session, and X-Session Pro are either registered trademarks or trademarks of Avid Technology, Inc. in the United States
and/or other countries.
Adobe and Photoshop are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States
and/or other countries. Apple and Macintosh are trademarks of Apple Computer, Inc., registered in the U.S. and other
countries. Windows is either a registered trademark or trademark of Microsoft Corporation in the United States and/or other
countries. All other trademarks contained herein are the property of their respective owners.
Footage
Eco Challenge Morocco Courtesy of Discovery Communications, Inc.
News material provided by WFTV Television Inc.
Ice Island Courtesy of Kurtis Productions, Ltd.
Avid Interplay Engine and Avid Interplay Archive Engine Administration Guide 0130-07640-03 Rev F
October 2011 Created 10/14/11 This document is distributed by Avid in online (electronic) form only, and is
not available for purchase in printed form.
Contents
Symbols and Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
If You Need Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Viewing Help and Documentation on the Interplay Portal. . . . . . . . . . . . . . . . . . . . . 15
Interplay Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Avid Training Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Chapter 1
Chapter 2
Database Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Creating an Interplay Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Avid Interplay Databases, Folders, and Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Limits on the Number of Assets and Objects in the Interplay Database . . . . . . . . . . 36
Creating and Restoring Database Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Types of Interplay Administrator Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Recommendations for Backup Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Scheduling Automatic Database Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Starting a Backup Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Using an Archiving Tool for Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Restoring an Earlier Version of a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Restoring a Complete Backup or a Fast Backup. . . . . . . . . . . . . . . . . . . . . 50
Using the InterplayRestore Tool on the Interplay Engine Server . . . . . . . . 53
Database Restore Session Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Using the BackupArchive Tool to Restore Files . . . . . . . . . . . . . . . . . . . . . 57
Restoring Archived Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
7
Chapter 3
Server Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Changing the Database and Data Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Viewing Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Locking and Unlocking the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Restarting the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Managing Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Installing a Permanent License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
License Types and Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Exporting a License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Troubleshooting Licensing Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Using the License Key Info Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Chapter 4
User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Understanding the Central Configuration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Moving the CCS to Another Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Viewing and Changing the CCS for a Server . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Adding Users to a Central Configuration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Setting User Authentication Providers and Importing Users . . . . . . . . . . . . . . . . . . 98
Setting Avid Unity Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Setting Windows Domain Authentication and Importing Users . . . . . . . . . . . . 101
Chapter 5
Chapter 6
10
Chapter 7
Chapter 8
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Troubleshooting Login Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Troubleshooting Client Connection Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Optimizing Avid Interplay Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Troubleshooting Firewalls and Avid Interplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Troubleshooting the Server Execution User Account . . . . . . . . . . . . . . . . . . . . . . . 204
Creating the Server Execution User Account. . . . . . . . . . . . . . . . . . . . . . . . . . 204
Determining the Server Execution User Name . . . . . . . . . . . . . . . . . . . . . . . . 206
Re-creating the Server Execution User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Shutting Down or Locking the Server Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Chapter 9
Appendix A
Appendix B
Appendix C
Appendix D
Appendix E
Appendix F
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
12
n
n
The documentation describes the features and hardware of all models. Therefore, your
system might not contain certain features and hardware that are covered in the
documentation.
Limited number of client applications per user per machine: A user can run only one
Interplay Access session and one Interplay Administrator session on one machine. This
software does not support terminal/server sessions.
A caution means that a specific action you take could cause harm to
your computer or cause you to lose data.
w
>
14
(Windows), (Windows
only), (Macintosh), or
(Macintosh only)
This text indicates that the information applies only to the specified
operating system, either Windows or Macintosh OS X.
Bold font
Italic font
Press and hold the first key while you press the last key or perform the
mouse action. For example, Command+Option+C or Ctrl+drag.
If the latest information for your Avid product is provided as printed release notes,
they are shipped with your application and are also available online.
If the latest information for your Avid product is provided as a ReadMe file, it is
supplied on your Avid installation CD or DVD as a PDF document
(README_product.pdf) and is also available online.
You should always check online for the most up-to-date release notes or ReadMe
because the online version is updated whenever new information becomes
available. To view these online versions, select ReadMe from the Help menu, or visit
the Knowledge Base at www.avid.com/readme.
3. Check the documentation that came with your Avid application or your hardware for
maintenance or hardware-related issues.
4. Visit the online Knowledge Base at www.avid.com/onlinesupport. Online services are
available 24 hours per day, 7 days per week. Search this online Knowledge Base to find
answers, to view error messages, to access troubleshooting tips, to download updates,
and to read or join online message-board discussions.
15
For Interplay_Engine_name substitute the name of the computer running the Interplay
Engine software. For example, the following line opens the portal web page on a system
named docwg:
http://docwg
2. Click the Avid Interplay Documentation link to access the User Information Center
web page.
To open the Interplay User Information Center from Interplay Access or the Interplay
Administrator:
Interplay Documentation
The following documents describe how to use Avid Interplay:
16
Avid Interplay Software Installation and Configuration Guide describes how to use
the Avid Interplay Installer DVD to install and configure software on the various
systems that make up a Interplay environment.
Avid Interplay Engine Failover Guide describes how to set up a cluster configuration
for the Avid Interplay Engine and the Avid Interplay Archive engine. There is one
version for SR2400 and SR2500 servers and another version for AS3000 servers.
Avid Interplay Engine and Avid Interplay Archive Engine Administration Guide
describes how to administer your Avid Interplay Engine or Avid Interplay Archive
Engine and Avid Interplay database.
Avid Interplay Access Users Guide describes how to use Interplay Access to browse,
search, and work with assets in the Avid Interplay database.
Avid Interplay Assist Users Guide describes how to use Interplay Assist for logging,
archiving, and sending to Playback material in an Interplay environment.
Avid Instinct Users Guide describes how to use the Avid Instinct application to write
iNEWS stories and put together simple audio and video sequences.
Avid Interplay Media Services Setup and Users Guide Avid Interplay Media
Services lets you control and automate Transcode, Archive, and ProEncode services.
Avid Interplay Transfer Setup and Users Guide describes how to use Interplay
Transfer to transfer media to and from another workgroup, send finished sequences to a
configured playback device, ingest media from a configured ingest device, and perform
standalone transfers between workstations.
Avid Service Framework Users Guide describes how to use the logging, monitoring,
and management features of the Avid Service Framework applications.
Avid Low Res Encode Setup and Configuration describes how to set up and configure
an Avid Low Res Encode system. Includes information on updating the bootset, root
disk image, and configuring a Low Res Encode system to work with CaptureManager.
Avid Interplay Capture Users Guide describes how to use Interplay Capture, a
newsroom ingest tool that enables automated recordings.
The latest versions of these documents are available in PDF format on the Avid Knowledge
Base at www.avid.com/onlinesupport.
17
18
For an overview of all Avid Interplay components, see the Avid Interplay Best Practices
Guide.
Source files for the assets, for example, graphics files and Avid media files. The source
files for file assets can be stored on the Interplay Engine or on an Avid shared-storage
system. The source files for Avid assets are always stored on shared storage.
The following illustration shows the metadata database and the source files for file assets
stored on the internal drive of the Interplay Engine server and the source files for Avid assets
stored on an Avid shared storage workspace.
File Assets
Metadata
Database
Media for
Avid Assets
Avid
Shared Storage
For information about all Interplay components and detailed sample configurations, see Avid
Interplay Best Practices.
Avid Assets, File Assets, and Splitting the Database
Interplay manages two different kids of assets. Avid assets are assets that are created by Avid
applications through capture, ingest, import, or transfer. Avid assets include:
Master clips
Subclips
Sequences
Effects
Motion effects
Rendered effects
Group clips
File assets are any assets that are not created by an Avid application. Any file you can create
on your workstation, through applications such as Adobe Photoshop or Microsoft Word, can
be added to the Interplay database and managed by Interplay as a file asset.
20
Media files for Avid assets are always stored on an Avid shared-storage system. Source files
for file assets can be stored on the Interplay Engine or on an Avid shared-storage workspace.
The location that holds file assets is called the file repository.
When you first install Interplay Engine software, the installation program requires you to set
one root folder for the database on a local drive. By default, this root folder holds both the
metadata database and files for file assets. If the Interplay Engine server does not have
adequate local storage for your Interplay database (for example, if your facility stores a large
number of file assets in the Interplay database), you can configure the Interplay Engine to
store only the metadata database on the Interplay Engine. All other database files and folders
can be stored on an Avid shared-storage workspace. This configuration is called a split
database. The following illustration shows a split database.
File Assets
Metadata
Database
Streamed
Properties
Media for
Avid Assets
In a split database, source files for file assets and streamed properties for Avid assets (head
frames and AAF information) are stored on a shared storage workspace. Media files for Avid
assets, such as .mxf files, are always stored on a shared storage workspace.
For more information, see Configuring Interplay for a Split Database on page 209.
Multiple Workgroups
A large production facility can have more than one Interplay workgroup. Each workgroup
must have its own Interplay Engine, database, and shared storage network. Users on
Interplay Access can view and access assets from more than one workgroup and can transfer
them from one to another using a file copy procedure for file assets and Avid Interplay
Transfer for Avid assets. You can also use the Interplay Delivery service to transfer Avid
assets.
21
A facility might also include an Interplay Archive Engine. An Interplay Archive Engine is
configured similarly to an Interplay Engine. An Archive Engine is integrated with a
third-party archive system. An Interplay Archive database is always named AvidAM. An
Interplay database is always named AvidWG.
An Interplay Archive database and an Interplay database use different icons, as shown in the
following illustration from Interplay Access. The archive database is represented by a safe,
and archive folders are represented by boxes.
Interplay online
database
Interplay
Archive Engine
database
For more information about the Interplay Archive Engine, see Avid Interplay Best Practices.
22
In this guide, references to the Interplay Engine also refer to the Archive Engine, unless
otherwise noted.
Central Configuration Server
If a production facility includes more than one Interplay workgroup, you can specify one
Interplay Engine as the Central Configuration Server (CCS). The CCS is an Interplay
Engine module that stores information that is common to all other Interplay Engines. The
CCS provides a means to manage user accounts across multiple workgroups. For more
information, see Understanding the Central Configuration Server on page 93.
Server Execution User
The Server Execution User is a Windows operating system user that runs the Interplay
Engine processes. You specify the user name and password for the Server Execution User
when you install the Interplay Engine on the server. The Server Execution User needs local
administrator rights on the operating system for the Interplay Engine server and read/write
access to the Avid shared-storage file system.
For more information, see Troubleshooting the Server Execution User Account on
page 204.
Avid Interplay as a Client-Server Application
23
Backing up the database. Backing up the database regularly protects your data, allowing
you to restore the database to a saved state in the event of failure. See Creating and
Restoring Database Backups on page 36.
Maintenance tasks, such as locking, unlocking, and restarting the server. See Server
Settings on page 81.
Creating, editing, and deleting user accounts and managing user authorization. See
User Management on page 93.
Configuring client applications and the workgroup. See Site Settings on page 129.
Click the Start button and then select All Programs > Avid >
Avid Interplay Access Utilities > Avid Interplay Administrator.
24
The first time you open the Interplay Administrator, the Server text box is empty. If you
have already logged into a server, the text box shows the last server you logged in to.
2. Select the server you want to work with by doing one of the following:
t
Type the name of the server that you want to log in to. You can also use an IP
address.
Click the arrow for the Server list and select the server name from the list.
The first part of the list shows recent servers, the second part of the list shows
servers that were added manually (not on a local area network), and the third part
shows servers available on your local area network.
t
Click the arrow for the server list and select Add Server. Type a new server name.
25
3. Type a user name and password for an account with administration rights.
On the first start after installing the Avid Interplay Engine, only the user Administrator
exists. Type Administrator in the dialog box. The password is empty by default.
Change the password of the Administrator as soon as possible (see Viewing and
Setting Attributes on page 112).
The Interplay Administrator account is different from the Server Execution User account.
The Interplay Administrator account is used to manage users and the database. The Server
Execution User account is used to run the Interplay Engine processes.
4. Click Connect.
The Interplay Administrator window opens.
If you have any problems logging in, see Troubleshooting Login Problems on
page 201.
26
Each group contains views for managing components of the Avid Interplay Engine. Each
group is described in a separate section of this guide:
27
You can access the entire Help system, including the Search and Index tabs, from any of
those entry points.
28
Click the Log out button in the upper right of the Interplay Administrator window.
The application remains open, with the login screen displayed.
29
30
2 Database Settings
The Database settings allow you to create, configure, and manage the Interpla y database.
The following topics describe how to use these settings:
Renaming a Database
Avid supports only one database for each Interplay Engine. The database must be
named AvidWG, or for an Archive Engine database, AvidAM.
The root folder for a new database is set during the installation of the Interplay Engine
software. By default, the installation program creates one shared folder for both the metadata
database and the source files for file assets (the file repository). The default location is the
2 Database Settings
To identify the actual folder, open a Command Prompt window and type net share.
If the Interplay Engine server does not have adequate local storage for your Interplay
database (for example, if your facility stores a large number of file assets in the Interplay
database), you can configure the Interplay Engine to store only the metadata database on the
Interplay Engine. The file repository and all other database files and folders can be stored on
an Avid shared-storage workspace. This configuration is called a split database.
If you are going to use a split database configuration, the most efficient approach is to
specify how to divide the database before you create it. You specify the locations in the
Server Settings view (see Changing the Database and Data Locations on page 81) and then
create the database in the Create Database view.
The following illustration shows the Create Database view with two locations specified:
32
For complete information on configuring a split database, see Configuring Interplay for a
Split Database on page 209.
To create an Interplay database:
1. In the Database section of the Interplay Administrator window, click the Create
Database icon.
The Create Database view opens.
2. In the New Database Information area, leave the default AvidWG in the Database
Name text box. For an archive database, leave the default AvidAM. These are the only
two supported database names.
3. Type a description for the database in the Description text box, such as Main
Production Server.
4. Select Create default Avid Interplay structure.
After the database is created, a set of default folders within the database are visible in
Interplay Access and other Interplay clients. For more information about these folders,
see the Avid Interplay Access Users Guide.
5. Keep the root folder for the New Database Location (Meta Data).
The metadata database must reside on the Interplay Engine server.
6. Keep the root folder for the New Data Location (Assets).
If you are creating a split database, this entry should show the Avid shared-storage
workspace that you set in the Server Settings view (see Changing the Database and
Data Locations on page 81).
7. Click Create to create directories and files for the database.
The Interplay database is created. For information about the folders and files that
compose the database, see Avid Interplay Databases, Folders, and Files on page 33.
33
2 Database Settings
The database file structure is based on the administrative share that was set during the
Interplay Engine installation. By default, this administrative share is named WG_Database$
and is associated with the folder D:\Workgroup_Databases (S:\Workgroup_Databases for
cluster systems). The $ indicates a hidden share. To identify the actual folder, open a
Command Prompt window and type net share.
This folder contains either the AvidWG or the AvidAM folder. If the server is functioning as
the Central Configuration server, the folder also includes the _InternalData folder. The
following table describes these folders:
Database
Description
_Internal Data
AvidWG
Interplay Engine database: Contains metadata for Avid assets and file
assets, and source files for file assets.
AvidAM
Split Database
If you configured your system to create a split database (either when creating a database or
after installation), an AvidWG folder exists on both the Interplay Engine server and the
shared storage workspace. Only the _Database folder is located on the Interplay Engine
server. The other folders are located on the shared storage workspace. For more information
about working with a split database, see Configuring Interplay for a Split Database on
page 209.
Database Folders and Files
The following table lists the folders that are included in the AvidWG or AvidAM folders.
During normal work, users or administrators do not need to work directly with these folders
and files. All access for normal work is through Avid Interplay products. You need to work
with these files when splitting a database or possibly when troubleshooting a problem.
34
You should exclude the _Database and _PropertyStore folders of each database from
any kind of virus checking because virus checking tools might try to lock the database
files).
_Database
The main database directory, which contains database files and the database
journal. These files contain the database structure and all metadata. All files
within this folder contain binary information and cannot be viewed or edited
with a text editor.
If you are working with a split database, this directory is located on the
Interplay Engine server and other directories are located on a shared storage
workspace.
_Master
The main data directory, which contains the source files for file assets that are
managed by the database (the file repository). This directory contains source
files for all versions of the file assets.
Source files for Avid assets are always stored in Avid media folders on
shared storage. If you are working with a split database, this directory is
located on a shared storage workspace.
Handover Directories:
_Import, _CheckIn,
_PropertyHandover,
_Handover
Whenever a file is copied from the client to the server, the file is first copied
into one of these directories, depending on what operation (check in, import,
and so on) was performed. The server then moves the file from these handover
directories into the _Master directory.
_PropertyStore
The database directory that contains files holding the contents of streamed
properties. Streamed properties include metadata about Avid assets, such as
head frames and AAF information.
_Backup
The data folder that contains backup versions of the database that are created
through the automated backup process (see Scheduling Automatic Database
Backups on page 41).
AvidWG.pro, AvidAM.pro
Folderlocations.xml
A file that informs the server about the location of the _Database directory. If
you set a new location for the file assets, you might need to edit this file. See
Splitting a Database for Existing Interplay Installations on page 215.
_Buckets
35
2 Database Settings
The number of audio and video tracks associated with master clips. For example, a
master clip with two audio tracks and one video track has four database objects: one for
the master clip and one for each audio and video track.
The number of copies of master clips and sequences in different folders in the database.
Each copy represents a copy of the related database objects.
The number of versions of sequences. For example, each version of a sequence contains
separate database objects for the sequence, its master clips, and related tracks.
For information about determining the size of the Interplay database, see Viewing Database
Information on page 60.
Using a professional backup tool to do a complete backup to offline media. This backup
should include both the Interplay backup and the folders that Interplay backup process
does not include.
Creating a complete copy of the complete database using Robocopy or 7-Zip is useful
before doing a major system upgrade. These tools can be used in place of a professional
backup tool. However, keep in mind that performance and stability might suffer.
The following topics provide information about creating and restoring database backups:
36
Description
Fast backups:
- Incremental
Creates copies of database files and streamed properties files that were
added to the database since the last Complete Backup, the last
Incremental Backup, or the last Differential Backup.
- Differential
Creates copies of database files and streamed properties files that were
added to the database since the last Complete Backup. In most cases,
this backup takes longer to perform than an Incremental backup.
- Metadata Only
The _PropertyStore folder is critical if you need to completely restore Avid assets. Avid
recommends that you schedule a Complete backup once a week and a Fast backup
(either Incremental or Differential) daily.
For information on how to restore a database, see Restoring a Complete Backup or a Fast
Backup on page 50.
37
2 Database Settings
AvidWG\_Database
AvidWG\_Database
AvidWG\_PropertyStore
WG_Database$\_InternalData
This folder is automatically backed up once a
week at 1 a.m. on Sunday.
Manual backup
AvidWG\_Master
AvidWG\AvidWG.pro
AvidWG\FolderLocations.xml
See Avid Interplay Databases, Folders, and
Files on page 33 for descriptions of these
folders and files. It is not necessary to back up
AvidWG\_Backup unless you want to make a
backup of automated backups. Other folders
in AvidWG do not need to be backed up
because they are temporary folders that are
automatically recreated.
This type of manual backup might involve tape backup or another kind of backup process.
38
The _Master folder, which holds source files for file assets, is not included in the
automatic backup, which includes only metadata. It must be backed up by another
backup method regularly. Also be aware that the automatic backup process does not
back up Avid media files on shared storage workspaces.
It is extremely important to use the automatic backup process available through the
Interplay Administrator instead of just a tape backup for backing up the _Database and
_PropertyStore folders. Tape backups can be:
Inconsistent: A tape backup of the _Database folder while the server is running can lead
to inconsistent backup files because the server might not have applied all the
transactions to the database yet.
Inconvenient: Because it is not safe to make tape backups of the _Database folder while
the server is running, the server must be completely shut down during tape backup,
causing inconvenience.
Unpredictable and dangerous: The backup might lock the database files. This prevents
the server from reading and writing those files. The database could become damaged.
Enable a daily Avid Interplay database backup. The backup should be set to run once
daily at night, when the server is not being used or usage is lowest. See Scheduling
Automatic Database Backups on page 41.
Check the number of backups to keep setting. The Avid Interplay Engine always
keeps the last Complete backup and any later Fast backups. If you want to keep more
than one Complete backup, change the number of Backups to keep setting to be larger
than the number of scheduled Fast backups. The default setting is 10.
The number of backups to keep includes Complete and Fast backups. When the number
of backups to keep is exceeded, the system deletes the oldest backup after the last
Complete backup. For example, if you schedule Complete backups once a week and
schedule Fast backups every day, the number of backups to keep must be larger than 6.
Otherwise, on the sixth day the system will delete the second-to-last Complete backup.
Determine where to store the automatic backups. By default, the _Backup folder is
located in the Workgroup_Databases folder. Depending on the size of the database, you
might need to change the location to store backups. If you select a custom location, you
can rename the folder from _Backup to another name.
39
2 Database Settings
D:\Workgroup_Databases\AvidWG\_Backup
If you are working with a split database, by default the _Backup folder is located with
the file repository on the shared-storage workspace, for example:
-
\\SharedStorageServer\WorkspaceName\AvidWG\_Backup
Prior to Interplay Engine v1.2.4, storing backups on shared storage was not recommended
because of the large number of small files included in the backup. However, the backup
mechanism included with Interplay Engine v1.2.4 or later significantly reduces the number
of files created in the _PropertyStore folder, which reduces the amount of storage required.
Alternatively, you can store the backups on an external file server. You need to use a
UNC path when you specify the location. Make sure the Server Execution User has
read/write access to this external file server and the backup folder. See Troubleshooting
the Server Execution User Account on page 204.
Cluster systems: The default path is
-
S:\Workgroup_Databases\AvidWG\_Backup
On cluster systems, Avid recommends that you specify \\?\d:\backup as the path for
Interplay backups. (This syntax, with a question mark, is known as a Long UNC or
UNCW path, and allows for more characters than the 260-character limitation of the
short UNC path.) This path will create backups on the local drive of the active node,
rather than the Infortrend, thus avoiding a single point of failure.
SR2400 systems were shipped with 73 GB drives, which are too small for regular backups.
These systems should be upgraded to include larger drives.
Ensure that the backups are working and actually creating backups. To test the
backup, check that the backup subfolders databasename_date_time are being created at
the specified times (according to the backup configuration) and that these subfolders are
not empty. Every backup should create its own subfolder.
For example, on a non-cluster system, your backup folders might be created in the
following location:
-
D:\Workgroup_Databases\AvidWG\_Backup
A backup subfolder might be named AvidWG_2007-05-22_03-00.
40
Enable a different backup mechanism, such as tape backup, for all folders except
the _Database and _PropertyStore folders (see the table at the beginning of this
topic). The _Master folder of each database is the most important for the tape backup.
Do not include the _Database and _PropertyStore folders of each database in the tape
backup.
After a Complete backup, copy the backup folder to offline media to prevent data
loss. You can do this as a separate step or as part of a backup of the complete database to
offline media (see the next bullet). Use a backup tool (such as Robocopy or 7-Zip) that
can handle long path names and does not use excessive bandwidth, to avoid slowing
down activity on the Interplay Engine. (See Using an Archiving Tool for Backup on
page 46).
If you schedule a regular restart of the engine, set it after the regular backup is
created. If you restart the Interplay Engine, you cannot create a backup until at least one
client connects to the engine. This could be a problem if you schedule a restart and
backup at a time when there is little or not activity, such as the middle of the night.
The _Database and _PropertyStore folders of each database should be excluded from
any kind of virus checking (virus checking tools might try to lock the database files).
41
2 Database Settings
c
c
1. In the Database section of the Interplay Administrator window, click the Schedule
Backups icon.
The Schedule Backups view opens.
42
2. In the list on the left side of the view, select the database for which you want to view or
specify automatic backup settings. The current settings are displayed.
3. (Option) In the Backup Information area, change your preferences if necessary.
Backup only if modified is selected by default to save space and avoid duplicate
identical copies. The default number of versions to keep is 10. The Avid Interplay
Engine always keeps the last Complete backup and later Fast backups. For more
information, see Recommendations for Backup Configuration on page 38.
43
2 Database Settings
Select Custom.
b.
Click Browse, and navigate to the location you want. For a shared storage location,
you might need to type the path.
The custom location must be specified as a UNC path. You can also change the name of
the folder from _Backup to another name. See Recommendations for Backup
Configuration on page 38.
5. (Option) In the Fast Metadata Backup area, select Fast Metadata Backup Enabled
(disabled by default).
6. (Option) If Fast Metadata Backup is enabled, you can change the Fast backup frequency.
The default is set to Daily. You can select any number of days on which you would like
to perform Fast backups or you can set a Fast backup for one day a month.
7. (Option) If Fast Metadata Backup is enabled, you can change the Fast backup time by
doing one of the following:
-
Select Once at and change the hour and minutes (within 10 minute intervals) on
which it occurs using the up and down arrows.
Select Every and set the backup to occur at regular intervals starting at midnight.
Use the down arrow to select the interval.
Select Custom and specify custom backup times. Use the up and down arrows to
select the time, and then select Add. Repeat to add more times to perform the
backup. Select a time and then Remove to cancel a backup.
44
Select Once at and change the hour and minutes (within 10 minute intervals) on
which it occurs using the up and down arrows.
Select Every and set the backup to occur at regular intervals starting at midnight.
Use the down arrow to select the interval.
Select Custom and specify custom backup times. Use the up and down arrows to
select the time, and then click Add. Repeat to add more times to perform the
backup. Select a time and click Remove to cancel a backup.
1. In the Database section of the Interplay Administrator window, click the Schedule
Backups icon.
The Schedule Backups view opens.
2. In the list on the left side of the view, select the database for which you want to view or
specify automatic backup settings. The current settings are displayed.
3. At the bottom of the view, click the Start Backup Now... button.
4. Select the kind of backup you want to create. For a description of the different types of
backups, see Types of Interplay Administrator Backups on page 37.
5. Click OK
The backup is created in the location you specified. If you navigate to the location, and the
backup is still being created, the folder name includes the words backup in progress.
45
2 Database Settings
b.
c.
Default Location
D:\Workgroup_Databases\AvidWG
D:\Workgroup_Databases\AvidAM
46
Default Location
D:\Workgroup_Databases\AvidWG
\\SharedStorageServer\WorkspaceName\AvidWG
b.
c.
47
2 Database Settings
11. Use a backup tool to make a copy of the following folders and record their location.
Interplay Engine or Interplay Archive Engine
Folder Name
Default Location
S:\Workgroup_Databases\AvidWG
S:\Workgroup_Databases\AvidAM
Default Location
S:\Workgroup_Databases\AvidWG
\\SharedStorageServer\WorkspaceName\AvidWG
On cluster systems, Avid recommends that you specify \\?\d:\backup as the path for Interplay
backups.See Recommendations for Backup Configuration on page 38.
48
You cannot restore parts of a backup, for example, a specific sequence or folder. You can
restore only a Complete backup or a Fast backup.
How the Restore Tool Works with Streamed Properties Files
Beginning with Interplay Engine v1.2.4, the Interplay backup mechanism consolidates the
streamed properties files (all files in the _PropertyStore folder) into large archive files.
These files are written into the _PropertyStore folder of the corresponding backup folder.
The archive files are named streamed_propx.bar, where x is replaced with an increasing
number starting with 1. The files are about 1 GB each, except for the last one (with the
highest suffix number), which can be smaller. The exact file size varies depending on the
size of the individual streamed property files, because a single streamed property file is
never split up between two .bar files. The backup mechanism also writes a file named
streamed_prop.bin in the same folder. This file contains a directory of all streamed property
files contained in the backup and is used only by the BackupArchive tool (see Using the
BackupArchive Tool to Restore Files on page 57). The .bin file is not required by the
InterplayRestore tool.
The InterplayRestore tool is able to work with both the consolidated streamed property files
as well as a backup created by an earlier version of the Interplay Engine. The tool looks for
the streamed_prop1.bar file in the _PropertyStore folder of the backup. If this file does not
exist, it assumes that the backup was created by an earlier version of the engine and resumes
with the restore procedure in the same way as earlier versions of the restore tool. Otherwise,
it restores the streamed properties from the consolidated .bar files.
How the Restore Tool Renames Folders
When the tool begins the restore, it locks the database and then renames the existing folder
_Database to _Database.1. If you are performing a restore from a Complete backup, the tool
also renames _PropertyStore to _PropertyStore.1.
If a folder _Database.1 already exists, the tool creates _Database.2, and so on up to
_Database.9. The tool uses the first free number between 1 and 9 when it renames the
_Database and _PropertyStore folders. If no number is free, you need to delete some of the
previously renamed folders so that the tool can run.
If the backup restore is not completed (if you kill the process, if the system crashes, if you
get an error message, and so on), you can restore the system to its previous state by deleting
the _Database folder (and possibly the _PropertyStore folder) that the tool created and
renaming _Database.1 to _Database (and _PropertyStore.1 to _PropertyStore).
49
2 Database Settings
After you verify that the backup ran successfully and your database is working correctly, you
can save storage space by deleting the numbered backup folders ( _Database.x and
_PropertyStore.x) created during the restore process.
Restoring a Complete Backup or a Fast Backup
To restore a database, you need to restore a Complete backup, a Fast backup, or both,
depending on the type of backups available. (see Types of Interplay Administrator
Backups on page 37 for a description of each type of backup).
A Fast Incremental Backup and a Fast Differential Backup also contain a _Database
folder and a _PropertyStore folder. If you restore a Differential or Incremental backup,
all backups it depends on must be in the same backup location.
The following backups must be in the same folder:
-
For a Differential backup, the last Complete backup before the backup you are
restoring.
For an Incremental backup, the last Complete backup and the necessary Incremental
or Differential backups between the last Complete backup and the backup you are
restoring.
You do not need all backups between the last Complete backup and the backup you
are restoring. You need the most recent Complete backup, the most recent
Differential backup (if any), and any Incremental backups since the last Complete
or Differential backup.
For example, if a sequence of backups looks like this: c(complete)1 ->
i(incremental)1 -> i2 -> d(differential)1 -> i3 -> i4 -> d2 -> i5 -> i6, to restore i6 the
backups you need in the same folder are c1, d2, i5, and i6. You need these files
because i6 contains the changes since i5, which contains the changes since d2,
which contains the changes since c1.
Deleted streamed properties remain in the _PropertyStore folder until the next
Complete backup.
A Fast Metadata Only backup contains only a _Database folder, and can only be run
manually. A Fast Metadata Only backup is limited in its usefulness. You can use it to
restore the database structure if it becomes corrupted, but it does not restore the contents
of the _PropertyStore folder. To restore the contents of the _PropertyStore folder, you
need to restore the most recent Complete backup, Incremental backup, or Differential
backup, as described above.
The InterplayRestore tool automatically identifies the type of backup that you select.
50
To distinguish between a Fast Metadata Only backup and the other types of backups, open
the backup folder and check if a _PropertyStore folder exists. A Fast Metadata Only backup
does not contain a _PropertyStore folder.
Complete,
Fast Incremental, or
Fast Differential
backup folder
To distinguish between Complete, Fast Incremental, and Fast Differential backups, open the
backup folder and then open the inventory.xml file in Notepad or another text editor. The
type of backup is listed, along with other information.
51
2 Database Settings
Fast Incremental
backup type
Imagine that you have a backup schedule of a Complete backup on Saturday and a Fast
Differential backup every other day of the week. If there is a failure on Friday in which the
_Database folder, the _PropertyStore folder, and other Interplay folders are lost or corrupted,
you need to perform the following steps:
1. Use the InterplayRestore tool to restore the latest Fast Differential backup (from
Thursday).
2. To add metadata missing from the _PropertyStore folder, check in bins created for
projects since the Thursday backup.
3. Use the InterplayRestore tool to restore the _InternalData folder.
4. Restore the _Master folder and other folders through whatever mechanism you use for
backup.
5. Resynchronize media files with shared storage workspaces. In Interplay Access,
right-click the database name and select Resync. For more information, see Resyncing
Media Files with Avid Shared-Storage Workspaces in the Avid Interplay Access Users
Guide or the Interplay Access Help.
52
Without parameters, in which case the tool prompts you for the necessary entries
(interactive mode).
With parameters, in which case the tool runs without prompting, depending on the
number of parameters included. You can use these parameters to create a batch file that
partially automates the restore process.
You can use the InterplayRestore tool to restore the AvidAM or the _InternalData folder. In
the following procedure, substitute AvidAM or _InternalData for AvidWG.
To restore an earlier version of a database from a backup using interactive mode:
1. On the Interplay Engine server, click Programs and select Accessories > Command
Prompt.
2. At the command line, navigate to the folder that contains InterplayRestore. For example,
type:
cd C:\Program Files\Avid\Avid Interplay Engine\Server
You can use the administrative share name WG_Database$ only in a UNC path.
5. The next prompt asks if you are restoring a split database configuration.
If you answer yes, the next prompt asks you to enter the Interplay database asset path,
which is the path to the AvidWG folder on shared storage. Enter a UNC path, for
example:
\\SharedStorageServer\WorkspaceName\AvidWG\
6. At the next prompt, type the backup home directory and press Enter. For example:
D:\Workgroup_Databases\AvidWG\_Backup
53
2 Database Settings
If you are working with a split database, this location is probably on the shared storage
server. For example:
\\SharedStorageServer\WorkspaceName\AvidWG\_Backup
7. At the next prompt, select the correct backup from the numbered list of available
backups. Complete backups are labeled full and Fast backups are labeled increment
difference, or metadataonly. After you select the backup, press Enter.
The restore process begins. For an example of the process, see Database Restore
Session Example on page 56. At the end of the process, a message informs you that
you need to restore the _Master directory manually.
8. Restore your _Master folder through whatever mechanism you use for backup.
The _Master database is not backed up by the automated backup feature of Interplay. See
Recommendations for Backup Configuration on page 38.
9. Unlock the database by using the Lock/Unlock Database view in the Interplay
Administrator.
10. Check to make sure you can access the restored database from Interplay Access, and
that you can preview clip headframes.
11. Delete the _Database.1 and _PropertyStore.1 directories, or whatever numbered backup
directories were created through the restore process. See Restoring an Earlier Version
of a Database on page 48.
To restore an earlier version of a database from a backup by passing parameters to
the tool, do one of the following:
For a non-split database, navigate to the folder that holds InterplayRestore, type the
following, and press Enter:
InterplayRestore /m <database metadata root dir>
/backupdir <database backup dir>
For example:
InterplayRestore /m d:\Workgroup_Databases\AvidWG
/backupdir d:\Workgroup_Databases\AvidWG\_Backup
InterplayRestore prompts you to choose from a numbered list of available backups and
then restores the earlier version. Continue with steps 8 through 11 above.
n
n
54
The parameter /m is a short version of the parameter /metadata. You can view information
on the complete syntax for the tool by entering InterplayRestore /help.
Because the paths for the /metadata and /backupdir parameters are unlikely to change,
you can create a batch file that includes these values, as in the previous example. To restore
the database, run the batch file and select the number of the backup you want to restore.
For a split database, navigate to the folder that holds InterplayRestore, type the
following, and press Enter:
InterplayRestore /m <database metadata root dir>
/assets <split database asset directory>
/backupdir <database backup dir>
For example:
InterplayRestore /m d:\Workgroup_Databases\AvidWG
/assets \\isis\workspace1\AvidWG
/backupdir \\isis\workspace1\AvidWG\_Backup
InterplayRestore prompts you to choose from a numbered list of available backups and
then restores the earlier version. Continue with steps 8 through 11 above.
Because the paths for the /metadata ,/assets , and /backupdir parameters are unlikely
to change, you can create a batch file that includes these values, as in the previous example.
To restore the database, run the batch file and select the number of the backup you want to
restore.
t
If you know the specific backup you want to restore, navigate to the folder that holds
InterplayRestore, type the following, and press Enter:
InterplayRestore /m <database metadata root dir> /backupdir <database
backup dir> /backuptorestore <backup folder for restore>
For example:
InterplayRestore /m d:\Workgroup_Databases\AvidWG
/backupdir d:\Workgroup_Databases\AvidWG\_Backup /backuptorestore
d:\Workgroup_Databases\AvidWG\_Backup\AvidWG_2007-08-20_01-00
InterplayRestore restores the earlier version. Continue with steps 8 through 11 above.
55
2 Database Settings
[2]
[3]
[4]
Choose an entry ( 1 - 4 ):
56
full
full
Assume you choose 1. The tool locks the project so that no one can access the database and
then copies the files:
Beginning restore from
\\isis\workspace1\avidwg\_Backup\AvidWG_2010-06-10_03-05\
This is a Full backup
Restoring split database. Metadata restored to
d:\Workgroup_Databases\avidwg\. PropertyStore Assets restored to
\\isis\workspace1\avidwg
Locked project AvidWG
Copying files into d:\Workgroup_Databases\avidwg\_Database
Copying file AvidWG.dor
...
It leaves the database locked and gives you the following message:
Database AvidWG is still locked because you need to restore _Master
manually, or through your existing tape backup mechanism.
When you are done restoring _Master, use the Lock/Unlock Database view
in Interplay Administrator to unlock the AvidWG database. This will
complete your restore operation.
57
2 Database Settings
The following illustration shows the corresponding files as they appear in the archive file
\AvidWG\_Backup\AvidWG_2008-05-04_01-00\_PropertyStore\streamed_prop1.bar:
The .bar file is a file that you can only open by using the BackupArchive tool.
In previous versions of Interplay, you could use Windows Explorer to view and work with the
streamed properties files in the _PropertyStore backup folder. Because the current backup
mechanism uses archive files, you need this tool to view and work with files in the
_PropertyStore backup folder.
The following procedures describe how to view a list of streamed properties, how to unpack
an archive, and how to extract specific files. If you need to restore the streamed properties to
a database in an emergency situation, contact Avid support.
The complete syntax for using the BackupArchive tool is provided in the in-line help, which
you can display by typing BackupArchive in a Command Prompt window.
To list all streamed properties files in an archive file:
1. On the Interplay Engine, click Programs and select Accessories > Command Prompt.
2. At the command line, navigate to the folder that contains the BackupArchive tool.
58
Do not use the file extension when typing the name of the archive file. For example,
backuparchive /L
\\docisis\workspace3\AvidWG\_Backup\AvidWG_2008-05-04_01-00\_Propert
yStore\streamed_prop
To direct the output of this command to a text file for easier review, add > textfile.txt to
the end of the command.
To unpack all streamed properties files:
Do not use the file extension when typing the name of the archive file. For example, the
following command unpacks all property store files into a temporary folder on the
Interplay Engine:
backuparchive /U
\\docisis\workspace3\AvidWG\_Backup\AvidWG_2008-05-04_01-00\_Propert
yStore\streamed_prop D:\Workgroup_Databases\TempPropertyStore
Do not use the file extension when typing the name of the archive file. To define a
pattern, you can use the standard Windows syntax. For example, the following
command extracts all files whose names include Scr (screenshots) into a temporary
folder on the Interplay Engine:
backuparchive /E /P:*Scr*
\\docisis\workspace3\AvidWG\_Backup\AvidWG_2008-05-04_01-00\_Propert
yStore\streamed_prop
D:\Workgroup_Databases\TempPropertyStoreScreenshots
59
2 Database Settings
The Consistency Check is for support purposes. You should perform this check only if
requested by Avid Technical Support.
Database Object Statistics are displayed only for servers that are running Interplay Engine
version 1.6 or later.
To view the information about a database:
1. In the Database section of the Interplay Administrator window, click the Database
Information icon.
The Database Information view opens.
60
Root folder for database (Meta Data): See Creating an Interplay Database on
page 31.
Root folder for data (Assets): See Creating an Interplay Database on page 31.
61
2 Database Settings
1. In the Database section of the Interplay Administrator window, click the Lock/Unlock
Database icon.
The Lock/Unlock database view opens.
To unlock a database:
Deactivating a Database
Migrating a Database
Deactivating a Database
You might want to prevent users from connecting to a database if the database has been
retired and the files have been moved elsewhere. In other cases, such as when you are
backing up or moving databases, you might need to ensure that no connections can be made
to the database to avoid interference. Deactivating the database removes it from the list of
active databases.
Deactivating a database does not delete the database files. It makes the database
inactive so that users cannot connect to it until it is activated again. The database data
is kept at the location that was specified when the database was created.
To deactivate a database:
1. In the Database section of the Interplay Administrator window, click the Manage
Databases icon.
The Manage Databases view opens.
63
2 Database Settings
64
For a standard database, the .pro file is located in the Workgroup_Databases folder,
represented by the administrative share name WG_Database$ (see Creating an
Interplay Database on page 31).
For a split database, the .pro file is located in the Avid_WG folder on the shared storage
workspace (see Preparing for a Split Database on page 212).
1. In the Database section of the Interplay Administrator window, click the Manage
Databases icon.
The Manage Databases view opens.
2. Do one of the following:
t
In the Database (.pro) file to activate text box, type the full UNC path to the .pro
file. For example:
\\IEServer\WG_Database$\AvidWG\AvidWG.pro
Click the Browse button, log in if prompted, navigate to the .pro file using a
network, select the file, and click Open.
The following illustration shows the path to AvidWG.pro, using the Microsoft Windows
smb network and the administrative share WG_Database$.
Avid recommends keeping the default share name WG_Database$. If you decide on a
different share name, consider that if the name is longer than 12 characters, you cannot
browse to it graphically. If a share name is longer than 12 characters, you need to type the
complete path in the Database (pro) file to activate text box.
Make sure to navigate through a network to select the file (for example, do not navigate
through a mapped network drive). You must use a UNC path.
65
2 Database Settings
Navigating through a network is also required if you are working with a split database.
In this case, the .pro file is located on the shared storage server. The following
illustration shows the path to AvidWG.pro, using an Avid ISIS network and the
workspace where the AvidWG folder is stored. In an Avid Unity MediaNetwork, the
network name is Avid Unity Network.
66
3. Make sure the option Load Database on Activation is selected. Deselect this option
only if directed by Avid support.
4. Click Activate.
The database is activated and loaded. The database name is displayed in the Databases
list and users can connect to the database. If the option Load Database on Activation
is selected, the database is automatically unlocked.
Migrating a Database
You usually need to perform a database migration under the following circumstances:
When you want to remove all users and group-related data from a database. This allows
you to start with new users and groups and maintain the metadata and the data inside the
database.
When you are troubleshooting a problem with customer support. For example, customer
support might ask you to provide a copy of your database.
If you changed the Central Configuration Server (CCS) for a database without first
moving the _InternalData folder. If a database needs to be migrated, the State reads
Database Requires Migration.
67
2 Database Settings
Do not use a database that requires migration; always migrate a database to a CCS. You
cannot administer an unmigrated database.
If a database needs migration, the database icon shows a red box with an X and a yellow
arrow. The database icon appears in several views in the Interplay Administrator,
including the Manage Database Roles view.
(Red box with X and yellow arrow) Database needs migration.
c
c
When you migrate a database, the system deletes all the information inside the
database that was stored from the old CCS, including users, user settings and local
administration settings.
If you plan to migrate an Interplay Engine or Interplay Archive Engine database, turn
off the database backup process before you perform the migration. If you do not turn
off the backup process and it coincides with the migration, your backup will write out
an inconsistent state of the database (half current and half migrated).
To migrate a database to a new CCS:
1. In the Database section of the Interplay Administrator window, click the Manage
Databases icon.
The Manage Databases view opens.
68
2. In the Manage Databases view, click the name of the database that needs migration. The
State reads Database Requires Migration.
A warning explains the consequences of a database migration.
3. Click Migrate Database.
After the migration, the State reads OK. The database now has the CCS users and
administration properties of the new CCS you have set.
Avid recommends that you have telephone support from Avid during the process in
case complications arise.
69
2 Database Settings
If you move a database to a server that points to a different CCS, all the old CCS
information that was stored, including users, user settings, and local administration
settings for the database, will be lost because you will have to migrate the database (see
Migrating a Database on page 67). If you move a database to another server and also
move the CCS, however, this information is preserved. To move both a database and a
CCS, see Moving a Database and Users to Another Server (Non-Clustered Systems)
on page 71.
To move a database to another server (non-clustered systems):
9. On the target server, rename the existing database folder, for example, rename AvidWG
to AvidWG_old.
10. If you are copying a non-split database, copy the zipped file to the target server and
unzip the file to the Workgroup_Databases folder. Make sure the path on the target
server matches the path on the source server.
If you are copying a split database, copy and unzip both zipped files to the correct
locations. Then edit the FolderLocations.xml file to show the correct paths. See
Splitting a Database for Existing Interplay Installations on page 215.
11. Activate the database by using the Manage Databases view (see Activating a
Deactivated Database on page 64).
12. On an Interplay Access client, log in to the new server and verify that all data is
available.
If all data is available, the new database is ready for use.
If necessary, remove the old database from Interplay Access by right-clicking the
database name and then clicking Remove Databases.
13. (Option) On the source server, rename the original database folder to avoid unwanted
future access.
c
c
Avid recommends that you have telephone support from Avid during the process in
case complications arise.
If you move a database to a server that points to a different CCS, all the old CCS
information that was stored, including users, user settings, and local administration
settings for the database, will be lost because you will have to migrate the database (see
Migrating a Database on page 67). If you move a database to another server and also
move the CCS, however, this information is preserved. To move both a database and a
CCS, use this procedure. For more information about a CCS, see Understanding the
Central Configuration Server on page 93.
71
2 Database Settings
13. Lock the server by using the Lock Server view (see Locking and Unlocking the Server
on page 84).
14. Rename the existing _InternalData folder to _InternalData_old.
15. If you are copying a non-split database, copy the zipped file to the target server and
unzip the file to the Workgroup_Databases folder. Copy the _InternalData folder to the
Workgroup_Databases folder. Make sure the path on the target server matches the path
on the source server.
If you are copying a split database, copy and unzip both zipped files to the correct
locations. Then edit the FolderLocations.xml file to show the correct paths. See
Splitting a Database for Existing Interplay Installations on page 215. Copy the
_InternalData folder to the Workgroup_Databases folder.
16. Unlock the server using the Lock Server view.
17. Verify that all users are on the system by opening the User Management view and
viewing the lists of user groups.
18. Activate the database by using the Manage Databases view (see Activating a
Deactivated Database on page 64).
19. On an Interplay Access client, log in to the new server and verify that all data is
available.
If all data is available, the new database is ready for use.
If necessary, remove the old database from Interplay Access by right-clicking the
database name and then clicking Remove Databases.
20. (Option) On the source server, rename the original database folder to avoid unwanted
future access.
Avid recommends that you have telephone support from Avid during the process in
case complications arise.
73
2 Database Settings
If you move a database to a server that points to a different CCS, all the old CCS
information that was stored, including users, user settings, and local administration
settings for the database, will be lost because you will have to migrate the database (see
Migrating a Database on page 67). If you move a database to another server and also
move the CCS, however, this information is preserved. To move both a database and a
CCS, see Moving a Database and Users to Another Server (Clustered Systems) on
page 76.
To move a database to another server (clustered systems):
a.
b.
c.
In the list of resources, select Avid Workgroup Engine Monitor and change the state
to Offline.
Make sure that you change the state to offline for the Avid Workgroup Engine Monitor
resource only, not the entire Avid Workgroup Server group.
d. Close the Cluster Administrator.
5. Locate the database folder on the active node of the source server.
The default path is \\virtual_cluster_name\WG_Database$\AvidWG (or AvidAM for an
Archive Manager). By default, the administrative share WG_Database$ refers to
S:\Workgroup_Databases. For more information, see Identifying the Root Folder of the
Interplay Server Database on page 220.
n
74
If the S drive is not available on the machine, either this is the offline node or the entire Avid
Workgroup Server group was taken offline instead of only the resource.
6. Pack the database folder into a zip file or use Robocopy from the Microsoft Windows
Resource Kit for path names longer than 256 characters.
To save time and storage, you do not need to copy all the backups in the
S:\Workgroup_Databases\AvidWG\_Backup folder. One complete backup and the most
recent Fast backup are sufficient.
If you are moving a split database, create two zip files, one for
S:\Workgroup_Databases\AvidWG and the other for
\\server_name\\workspace_name\\AvidWG.
7. Copy the zipped file or files to a network server, removable media, a laptop, or directly
to the target server.
8. Open the Interplay Administrator, log on to the target server, and deactivate the database
(AvidWG or AvidAM) using the Manage Databases View.
9. On the target server, rename the existing database folder, for example, rename AvidWG
to AvidWG_old.
10. If you are copying a non-split database, copy the zipped file to the target server and
unzip the file to the Workgroup_Databases folder. Make sure the path on the target
server matches the path on the source server.
If you are copying a split database, copy and unzip both zipped files to the correct
locations. Then edit the FolderLocations.xml file to show the correct paths. See
Splitting a Database for Existing Interplay Installations on page 215.
11. Activate the database by using the Manage Databases view (see Activating a
Deactivated Database on page 64).
12. On an Interplay Access client, log in to the new server and verify that all data is
available.
If all data is available, the new database is ready for use.
If necessary, remove the old database from Interplay Access by right-clicking the
database name and then clicking Remove Databases.
13. (Option) On the source server, rename the original database folder to avoid unwanted
future access.
Use the Cluster Administrator to bring the source server back online. Right-click the
Avid Workgroup Server group (not the resource) and select Bring Online.
75
2 Database Settings
c
c
Avid recommends that you have telephone support from Avid during the process in
case complications arise.
If you move a database to a server that points to a different CCS, all the old CCS
information that was stored, including users, user settings, and local administration
settings for the database, will be lost because you will have to migrate the database (see
Migrating a Database on page 67). If you move a database to another server and also
move the CCS, however, this information is preserved. To move both a database and a
CCS, use this procedure. For more information about a CCS, see Understanding the
Central Configuration Server on page 93.
To move a database and users to another server (clustered systems):
76
a.
b.
c.
In the list of resources, select Avid Workgroup Engine Monitor and change the state
to Offline.
Make sure that you change the state to offline for the Avid Workgroup Engine Monitor
resource only, not the entire Avid Workgroup Server group.
d. Close the Cluster Administrator.
6. Locate the database folder on the source server.
The default path is \\virtual_cluster_name\WG_Database$\AvidWG (or AvidAM for an
Archive Manager). By default, the administrative share WG_Database$ refers to
S:\Workgroup_Databases. For more information, see Identifying the Root Folder of the
Interplay Server Database on page 220.
If the S drive is not available on the machine, either this is the offline node or the entire Avid
Workgroup Server group was taken offline instead of only the resource.
7. Pack the database folder into a zip file or use Robocopy from the Microsoft Windows
Resource Kit for path names longer than 256 characters.
To save time and storage, you do not need to copy all the backups in the
S:\Workgroup_Databases\AvidWG\_Backup folder. One complete backup and the most
recent Fast backup are sufficient.
If you are moving a split database, create two zip files, one for
S:\Workgroup_Databases\AvidWG and the other for
\\server_name\\workspace_name\\AvidWG.
8. Locate the user folder _InternalData on the source server.
The default path is S:\Workgroup_Databases\_InternalData.
9. Copy the zipped file and the _InternalData folder to a network server, removable media,
laptop, or directly to the target server.
10. On the target server, rename the existing database folder, for example, rename AvidWG
to AvidWG_old.
11. Open the Interplay Administrator, log on to the target server, and deactivate the database
(AvidWG or AvidAM) using the Manage Databases View.
12. Lock the server using the Lock Server view (see Locking and Unlocking the Server on
page 84).
13. Rename the existing _InternalData folder to _InternalData_old.
14. If you are copying a non-split database, copy the zipped file to the target server and
unzip the file to the Workgroup_Databases folder. Copy the _InternalData folder to the
Workgroup_Databases folder. Make sure the path on the target server matches the path
on the source server.
77
2 Database Settings
If you are copying a split database, copy and unzip both zipped files to the correct
locations. Then edit the FolderLocations.xml file to show the correct paths. See
Splitting a Database for Existing Interplay Installations on page 215. Copy the
_InternalData folder to the Workgroup_Databases folder.
15. Unlock the server using the Lock Server view.
16. Verify that all users are on the system by opening the User Management view and
viewing the lists of user groups.
17. Activate the database by using the Manage Databases view (see Activating a
Deactivated Database on page 64).
18. On an Interplay Access client, log in to the new server and verify that all data is
available.
If all data is available, the new database is ready for use.
If necessary, remove the old database from Interplay Access by right-clicking the
database name and then clicking Remove Databases.
19. (Option) On the source server, rename the original database folder to avoid unwanted
future access.
Use the Cluster Administrator to bring the source server back online. Right-click the
Avid Workgroup Server group (not the resource) and select Bring Online.
c
78
NxNServerLock.exe
NxNServerUnlock.exe
NxNServerShutdown.exe
Before beginning this procedure, be sure to make a backup of the database. See
Creating and Restoring Database Backups on page 36 for information on running a
backup. Temporarily change the Backup time field to Once at and enter or select
from the list the time in the future closest to the current time.
Renaming a Database
Use the Interplay Administrators Lock Server view (see Locking and Unlocking
the Server on page 84).
Use NxNServerUnlock.exe.
5. Deactivate the moved database using the Manage Databases view (see Deactivating a
Database on page 63).
6. Activate the moved database in the correct location using the Manage Databases view
(see Activating a Deactivated Database on page 64).
Renaming a Database
Under some circumstances you might need to rename a database For example, if you need to
create a new database with the same name, you can rename the original database. You can
keep the original database as an archive for searching.
Before beginning this procedure, be sure to make a backup of the database. See
Creating and Restoring Database Backups on page 36 for information on running a
backup. Temporarily change the Backup time field to Once at and enter or select
from the list the time in the future closest to the current time.
To rename a database:
1. In the Database section of the Interplay Administrator window, click the Manage
Databases icon.
The Manage Databases view opens.
2. Select the database and click the Deactivate Database button to ensure that the database
is not in use.
79
2 Database Settings
3. On the server or at the database location, use the Windows desktop to rename the
database folder, .pro file, and .nif directory, and all files within the _Database folder, that
is, replace the old <DatabaseName> with the new name for all files fitting the following
mask:
<DatabaseName>\<DatabaseName>.pro
<DatabaseName>\<DatabaseName>.nif
<DatabaseName>\<DatabaseName>\_*.pro.jrn
<DatabaseName>\_Database\<DatabaseName>.*
<DatabaseName>\_Database\<DatabaseName>_*.jrn
Do not forget to rename the .jrn files correctly: make sure there are no typos in the
database name, and that they are followed by the underscore and the numeric ID.
4. In the Interplay Administrator, click the Manage Databases icon and activate the
database (see Activating a Deactivated Database on page 64).
80
3 Server Settings
The Server settings enable you to configure and change server settings and shutdown and
restart the server. The following topics describe how to use these settings:
Managing Licenses
Do not change the location for the metadata database. The metadata database must be
stored directly on the local Interplay Engine server because permanent access to these
files is required. This is the only supported setup. You have the option of storing the
source files for file assets on an Avid shared-storage workspace. This configuration is
known as a split database.
Changing the root folder for file assets is part of the process of creating a split database. For
more information and instructions, see Configuring Interplay for a Split Database on
page 209.
The root folder for a new database is set during the installation of the Interplay Engine
software. By default, the installation program creates a shared folder that functions as the
root folder for both the metadata database and the source files for file assets (the file
repository). The default location is the D:\Workgroup_Databases folder, which is
represented by the administrative share name WG_Database$. The $ indicates a hidden
share.
To identify the actual folder, open a Command Prompt window and type net share.
If you need to create a new database, changing these settings does not affect any existing
databases.
3 Server Settings
1. In the Server section of the Interplay Administrator window, click the Server Settings
icon.
The Server Settings view opens.
2. For the root folder of the database (metadata), keep the folder that was set during the
installation of the server (the default is \\IEServer\WG_Database$\).
3. For the root folder of the data (file assets), change the folder to a workspace on Avid
shared storage (see Configuring Interplay for a Split Database on page 209). Type a
UNC path or browse through the Avid Unity Network or Avid ISIS Network to the
workspace.
You might need to provide proper credentials to browse and access the shared storage
workspaces.
4. Click Apply Changes to change the setting for new databases.
5. If you changed the root folder for the file assets, complete the tasks described in
Splitting a Database for New Interplay Installations on page 213 or Splitting a
Database for Existing Interplay Installations on page 215.
82
The number of connected clients (through Interplay Access and other client
applications)
The Connected User Information area displays information about the following:
-
The type of licenses in use (see License Types and Usage on page 90)
In the Server section of the Interplay Administrator window, click the Server
Information icon.
The Server Information view opens.
83
3 Server Settings
If possible, use the database lock instead of the server lock. Use the server lock if you want
to do maintenance on the server machine itself or the shared storage system. Use the
database lock if you need to do maintenance on a database or its related files (for example,
moving a database to another server). Using the database lock provides more security and is
also preferable since it avoids making the entire server inaccessible. See Locking and
Unlocking Databases on page 62.
To lock the server:
1. In the Server section of the Interplay Administrator window, click the Lock Server icon.
The Lock Server view opens.
84
Indefinitely: An indefinite shutdown. This is a good choice when shutting down the
server to carry out any vital maintenance, for example replacing hard drives, or
making the first backup of a new database. The server needs to be manually
unlocked after maintenance work.
Minutes: Allows you to stipulate when to restart the server (short time frame). It is
useful when you are making routine backups and you know how much time you
need. Specify the time period by clicking the Up and Down arrows.
Lock until: Allows you to stipulate when to restart the server (longer time frame).
Specify the time period by clicking the Up and Down arrows.
3. In the Lock Details text box, type a comment as to why you are locking the server. This
comment is displayed when clients try to connect to the server.
4. Click Lock Server.
The Lock Server view changes to display lock information. You cannot return to the
Interplay Administrator window by clicking the Menu button. You can log out of the
Interplay Administrator tool and then log in again.
To manually unlock the server:
Depending on the size of the database, this process can take several minutes. Do not
attempt to reboot the server under any circumstances before this process is completed.
85
3 Server Settings
1. In the Server section of the Interplay Administrator window, click the Restart Server
icon.
The Restart Server view opens.
2. Click Restart.
Managing Licenses
Avid Interplay needs valid licenses in order to function. A license consists of a hardware ID
and a license key. The hardware ID is sometimes associated with the physical application
key, or dongle. The license key is created by a license file and includes information about the
license types for individual applications.
The Licenses view has two areas:
86
Your current license types (see License Types and Usage on page 90).
Time limit (days): the total days included in the license. If you have more than one
license loaded that includes the same license type, only one time limit is stored for
each type.
Days remaining: the number of days until expiration. If you have more than one
license loaded that includes the same license type, only one value for the days
remaining is stored for each type.
Managing Licenses
Hardware ID, obtained from the physical application key (dongle). The Hardware
ID is required to obtain technical support.
Lock timeout: The lock timeout is the time the server freezes a license on the server
before it is freed for use by another user or machine. All Interplay licenses use a
setting of 0 hours, 0 minutes, and 0 seconds.
In the Server section of the Interplay Administrator window, click the Licenses icon.
The Licenses view opens.
For information about importing a license file, see Installing a Permanent License on
page 88. For information about exporting a license file, see Exporting a License on
page 91.
87
3 Server Settings
You can access the license file from the USB flash drive. The advantage of copying the
license file to a server is that you have easy access to installer files if you should ever need
them in the future.
If the USB flash drive does not automatically display:
a.
b.
4. Copy the license file (*.nxn) into the new folder you created.
5. In the Server section of the Interplay Administrator window, click the Licenses icon.
6. Click the Import license button.
7. Browse for the *.nxn file.
8. Select the file and click Open.
You see information about the permanent license in the License Types area.
88
Managing Licenses
Product
KEY_AM
KEY_C
KEY_X
Interplay Access
KEY_XL
Interplay Assist
KEY_XE
KEY_XI
Avid Instinct
KEY_XP
One Interplay Streaming Server license (KEY_C) is required for each streaming server in an
Interplay workgroup.
If you have an editing application running, then no additional license is needed to run Access
at the same time. For example, if an Avid editing application has been started, KEY-XE also
covers Interplay Access on the same machine. If the editing application is started after
Interplay Access is started, KEY-X is released and KEY-XE is used instead. The same
behavior applies to licenses for Interplay Assist, Avid Instinct, and Digidesign Pro Tools
Integration.
When you close an application, its license is released and can be used by another client.
89
3 Server Settings
Exporting a License
You might need to export your license information for support purposes.
Export functionality is intended for Avid support purposes. You might not be able to reimport
an exported license.
To export your license to a file:
90
Managing Licenses
91
3 Server Settings
92
4 User Management
An administrator controls access to Avid Interplay through user accounts and user roles. The
following topics provide information about how to manage user accounts and access to the
database:
For specific examples of how to manage user roles, see Setting Up a Folder Structure and a
User Database in the Avid Interplay Best Practices.
4 User Management
Depending on the number of Interplay Engines that are installed, several CCS configurations
are possible:
Several Interplay Engines: Usually you configure only one Interplay Engine as the CCS.
The use of more than one CCS in a company might be useful if there are several
independent domains, departments, or sites where there is no need to share users or
other settings in Avid Interplay. In the case where several sites are located in different
locations, having one CCS for each site could be practical.
If necessary, you can use the Central Configuration Server view to change the CCS that you
set during the Interplay Engine installation.
Do not reset the CCS unless there is real need to do so, such as a space issue. All the
information that was stored on the old CCS, including users and local administration
settings, is lost when the CCS is changed to another server unless you first move the
_InternalData folder to the server that will be used as the new CCS. If you do not or
cannot move the _InternalData folder to the new CCS, and you set the new CCS for the
database, you must migrate the database through the Manage Databases view. In this
case, all previous CCS-related information will be lost.
The following procedures describe how to change the CCS:
Specifying an incorrect CCS can prevent login. See Troubleshooting Login Problems on
page 201.
Before beginning the following procedure, be sure to make a backup of the database.
See Creating and Restoring Database Backups on page 36 for information on
running a backup. You can use the Start Backup Now feature to start a backup
immediately.
The following procedure is based on these assumptions:
94
You want to keep the CCS settings and user information that exist on server A, but move
them to server B.
You do not want to keep the original CCS information that exists server B.
Server B should be created by a clean installation and should serve as its own CCS. No
other database should point to Server B as a CCS, because any existing user data on
Server B will be lost.
To move a CCS to another server:
1. Back up the database. See Creating and Restoring Database Backups on page 36.
2. Make sure that the Interplay Engine on both servers is the same version. See Viewing
Server Information on page 82.
3. Start Interplay Administrator and log in to server A (which is the current CCS).
4. Lock server A. See Locking and Unlocking the Server on page 84.
5. In Interplay Administrator, log out of server A.
6. Log in to server B.
7. Lock server B.
8. Log out of server B.
9. Use Windows Explorer to delete the _InternalData folder on server B.
The folder is located by default in \\IEServer\WG_Database$ (usually
D:\Workgroup_Databases\). See Identifying the Root Folder of the Interplay Server
Database on page 220.
10. Copy the _InternalData folder from server A to the default database location of server B.
11. In Interplay Administrator, log in to server A, unlock the server, and log out.
12. Log in to server B and unlock the server.
13. Make sure the CCS for server B is set as server B itself. If necessary, complete Viewing
and Changing the CCS for a Server on page 95.
14. Log out of server B.
15. On server A, change the CCS for server A to server B using Viewing and Changing the
CCS for a Server on page 95.
Before beginning the following procedure, be sure to make a backup of the database.
See Creating and Restoring Database Backups on page 36 for information on
running a backup. You can use the Start Backup Now feature to start a backup
immediately.
95
4 User Management
You want server B to be the CCS for server A. You want to use the settings and user
information that exists on server B.
You do not want to keep the CCS information that exists on server A.
1. Back up the database. See Creating and Restoring Database Backups on page 36.
2. Make sure that server A and server B are the same version, otherwise the CCS does not
reset. See Viewing Server Information on page 82.
3. Start the Interplay Administrator on server A, and log in to Server A.
4. In the User Management section of the Interplay Administrator window, click the
Central Configuration Server icon.
The Central Configuration Server view opens.
5. Use the arrow in the Central Configuration Server list to select server B to use as the
CCS.
A warning appears explaining the consequences if you have not followed the procedure
Moving the CCS to Another Server on page 94 and moved the _InternalData folder to
server B.
Moving the _InternalData folder is usually recommended. If you do not, all users and
local administration settings are lost.
96
7. If you have not moved the original CCS server (see Moving the CCS to Another
Server on page 94), you need to migrate the database to the new CCS and all of your
CCS-related data (such as users and local administration) are lost. Unmigrated
databases should not be used; databases should always be migrated to a CCS.
Unmigrated databases cannot be administered. For more information, see Migrating a
Database on page 67.
97
4 User Management
Automatically adding Avid Unity (shared-storage) users. These users are added to the
CCS the first time they log in. They log in using their Avid Unity username and
password. For more information, see Setting Avid Unity Authentication on page 100.
Importing users from a Windows domain or LDAP directory. You need to use the User
Authentication Providers view to import these users. They log in using their Windows or
LDAP username and password. For more information, see Setting Windows Domain
Authentication and Importing Users on page 101 and Setting LDAP Authentication
and Importing Users on page 103.
Individually creating users. You need to use the User Management view to create
individual users. They log in using the username and password that you set. For more
information, see Adding Users Manually on page 112.
Avid Unity
Windows Domain
LDAP
Selecting these providers lets users log in without requiring them to use an additional
username and password for Avid Interplay. You still have the option of creating individual
users specifically for Avid Interplay (see Adding Users Manually on page 112).
The User Authentication Providers view lets you import users from a Windows domain or
LDAP server. You do not need to explicitly import Avid Unity users; they are imported at the
time they log in.
Information from this view is saved in the CCS (see Understanding the Central
Configuration Server on page 93).
98
All special characters are allowed in user names except for \ (backslash), / (forward slash),
| (vertical bar), and quotes (" and '). When LDAP and Windows Domain users are imported,
these characters are replaced with _. If two users have different user names that are
mapped to the same converted name (for example, dann/o and dann\o become dann_o), only
one converted user name is imported. These users currently cannot be authorized through
LDAP or Windows Domain; they can only be imported.
The users are added to the Imported Users folder in the User Management page, under the
respective subfolder for LDAP, Microsoft, or Avid Unity. Users are also added to the
Everyone folder. The following illustration shows these subfolders with the LDAP folder
selected.
99
4 User Management
These types of user authentication and how users are imported are described in the following
topics:
100
This method of authorization is implicit. In other words, there is no active import of users at
the time the Avid Unity authentication is enabled. Instead, the first time that an Avid Unity a
user logs in to Avid Interplay, the user is added to the UNITY user group subfolder. By
default, this user group has Read rights.
To enable Avid Unity authentication:
1. In the User Management section of the Interplay Administrator window, click the User
Authentication Providers icon.
The User Authentication Providers view opens.
2. Click Avid Unity Authentication.
3. Type the Avid Unity server name with which the CCS should cross-check
for authentication.
In an Avid Unity MediaNetwork environment, type the name of the File Manager. In an
Avid ISIS environment, type the name of the System Director.
4. Click Apply.
When an Avid Unity user logs into Interplay, the user is added to the CCS as part of the
UNITY user group under Imported Users, with Read rights by default.
To reassign an Avid Unity users Interplay rights:
Move the user to a different user group later if you want to give the user a different role.
For more information, see Managing Database Roles on page 118.
101
4 User Management
Note also that for Interplay to import users from an Active Directory, these users must be
placed in groups. Interplay does not support importing of single users. To facilitate
administration, Avid recommends that you align the Interplay group structure with the
Active Directory group structure.
Some large organizations might use a hierarchical domain structure called a forest root
domain. For example, an organization with a domain named company.com might choose
to place its Interplay production system in a sub-domain named avid.company.com. In
Windows, users from different parts of this organization can be managed in groups (for
example, a Universal Group) and can be authenticated across the entire forest. Interplay
domain authentication does not support this structure. If you select a domain for
authentication, users from other forest domains will be stripped from the group during the
import process.
To enable Windows domain authentication:
1. In the User Management section of the Interplay Administrator window, click the User
Authentication Providers icon.
The User Authentication Providers view opens.
2. Select the Windows Domain Authentication option.
Select the user groups you want to import into the Avid Interplay system.
Click Select All to import all the user groups into the Avid Interplay system.
5. Click OK.
n
102
Depending on the size and complexity of the import, the import operation might prevent
users from logging on, browsing, checking in, or doing on work on the server
Upon import, Interplay creates a new user group and subfolder called MICROSOFT
under Imported Users in the User Management view. It imports all the users
authenticated on the Windows domain that are not currently in the Avid Interplay user
database. These users are imported to the MICROSOFT group and have the default role
of No Access. Users can then be moved to different groups to gain a new user role. See
Managing Database Roles on page 118.
Users that are already in the Avid Interplay user database during a Windows Domain
User import are added to the MICROSOFT group again but retain the group placement
and role they already had.
New users added to the Windows domain are not continually imported to the CCS. You need
to add them manually. See Adding Users Manually on page 112.
The configuration you specify depends on the LDAP schema against which you are
authenticating. The following illustration shows some differences between Active Directory
and OpenLDAP.
103
4 User Management
OpenLDAP
Details on the LDAP schema objects can be found in RFC1274, The Cosine and Internet
X.500 Schema.
To import LDAP users and enable LDAP authentication:
1. In the User Management section of the Interplay Administrator window, click the User
Authentication Providers icon.
The User Authentication Providers view opens.
2. Select the LDAP Authentication option.
3. Type the information in the edit fields that specifies the individual LDAP settings of
your LDAP server.
The settings are described in LDAP Server Configuration Settings on page 105.
4. Click Apply.
5. Click Import LDAP Users to add all the LDAP users to the user group LDAP Users
for the Interplay CCS.
The Import LDAP Users dialog box opens.
104
New users added to the LDAP server are not continually imported to the CCS. You need to
add them manually. See Adding Users Manually on page 112.
Description
LDAP Server
LDAP Port
Port for the LDAP service. For Standard LDAP, accept the default port
389. For Active Directory Global Catalog LDAP, specify port 3268. For
LDAP enabled over SSL (LDAPS), specify port 636
Use SSL
Select this option if the LDAP uses Secure Sockets Layer (SSL)
technology.
User DN for a user who has the right to query the directory. This DN will
be used for logging on to the LDAP directory and performing a search for
importable objects after you click the Import LDAP Users button.
Password for a user who has the right to query the directory. This
password will be used for logging on to the LDAP directory after you
click the Import LDAP Users button.
105
4 User Management
Setting
Description
Search Root DN
DN root for searches in the LDAP database. This DN specifies the search
root that will be used after you click the Import LDAP Users button. This
DN typically points to the branch of the LDAP tree where the user objects
are located. Typical examples are
CN=queryuser,CN=Users,DC=company,DC=com for Windows Active
Directory LDAP, or CN=queryuser,DC=company,DC=com for
OpenLDAP.
Object class attribute of a User. This value will be used as a search filter
after you click the Import LDAP Users button. Interplay will perform an
ldap_search request on the directory, and all returned objects that match
User Object Class will be imported. A typical setting for Microsoft AD
LDAP would be organizationalPerson. For OpenLDAP, a typical object
class would be simpleSecurityObject.
Attribute that stores the user name to use for LDAP-authenticated logins.
The content of this attribute becomes the imported user name in Interplay
and defines the user name for LDAP-authenticated login attempts. This
attribute might vary according to the LDAP schema, and there might be
multiple attributes storing different varieties of the user name. For
Microsoft Active Directory LDAP and OpenLDAP, the most standard
attribute is cn, the common name as defined in RFC 4519. Other
attributes such as displayName or mailNickname (in an Exchange-enabled
environment) might also exist.
User DN Suffix
106
The following illustration shows an example of settings for an Active Directory LDAP
implementation.
107
4 User Management
108
109
4 User Management
Administrators, with the user Administrator: Users with administrator rights. When you
first log in after the first installation, if you have not yet imported Windows Domain or
LDAP server users, the only user displayed is the user Administrator with
administrator rights. This user cannot be deleted, nor can the user rights be restricted in
any way.
Everyone: All users. This group contains the master user for every user in all the other
groups. The master user in the Everyone group is the original user object. Instances of a
user in other groups are linked to the master user. By default, the group role is set to No
Access. The following illustration shows the master user for Administrator in the
Everyone group and a link to the master user in the Administrators group. The icon for
the linked user includes a link symbol.
110
Imported Users: Users imported from Avid Unity, Windows Domain or LDAP (see
Setting User Authentication Providers and Importing Users on page 98). By default,
the group roles are set as follows:
-
LDAP: No Access.
MICROSOFT: No Access.
Migrated Users: The group for users migrated from an Avid Unity MediaManager
environment to an Avid Interplay environment. By default, the group role is set to No
Access. For more information on migrating users from an Avid Unity MediaManager
environment to an Interplay environment, see your Avid representative.
1. In the User Management section of the Interplay Administrator window, click the User
Management icon.
The User Management view opens.
2. In the Users pane, select the group into which you want to add a the new user group. To
create a group at the top level, select Users.
3. Do one of the following:
t
111
4 User Management
1. In the User Management section of the Interplay Administrator window, click the User
Management icon.
The User Management view opens.
2. In the Users pane, select the group into which you want to add a user.
3. Do one of the following:
t
4. Add attributes for the new user: name, description (inherited from the user group by
default), password, password confirmation, and email.
All special characters are allowed in user and group names except \, /, | and
quotes (" and '). For more information, see Viewing and Setting Attributes on
page 112.
5. (Option) Select a role for the new user.
Roles are inherited from the group in which you create the user. For more information,
see Viewing and Changing Roles on page 114.
6. Select an authentication provider.
For more information, see Viewing and Setting Authentication Providers for Individual
Users on page 116.
7. Click Apply.
In the Users list of the User Management view, select the user group or user.
Attributes for the selected group or user are displayed in the Attributes pane.
If you select a group, the name and description are displayed. For an existing group, you
can add or edit a description.
If you select a user, the name is displayed, plus a description (inherited from the user
group by default), password, password confirmation, and email address, if you have
entered them.
112
By default, the password field in the Attributes text box shows asterisks. If you choose
to allow the user to log in to the server with Internal Authentication, then you need to set
the password in the Attributes text box. For users that log in through other providers,
you do not need to specify the password. For more information, see Viewing and
Setting Authentication Providers for Individual Users on page 116.
The password should only include characters from the ASCII the character set. Multibyte
passwords might cause login problems, and the administrator then has to reset the
password.
To set the internal password:
If you select the Internal Authentication option and do not set a password, anyone can
log in with that user name and no password.
113
4 User Management
The five standard roles and their default rights are as follows:
Read/Write/Delete: Users are allowed to view, import, edit, delete, rename, and move
any item in the database. They can view items they have deleted themselves in the
Deleted Items folder in Interplay Access.
Read/Write: This role allows users to view, import, and edit items in the database.
Read: These users can copy files to their local disk, but cannot delete, edit or import any
item into the database. Read-only users cannot change properties.
No Access: This role takes away all user rights, but the user is not removed. This is
useful if you want to control access on a folder basis, for example, if you do not want a
particular set of users to be able to view selected folders in the database. This is the
default role for users in the Everyone, Imported Users, and Migrated Users folders.
You can assign rights for specific users on specific folders in the Manage Database Roles
view (see Managing Database Roles on page 118).
In the Users list of the User Management view, select the group or user.
The role is displayed in the Roles pane. If a user has more than one role, the User
Management view displays the accumulated inherited role, the highest role (the role
with the most rights) that the user has in any one user group.
The groups to which a user or group belongs are shown in the Part of Group(s) pane.
These entries also display the role inherited from each group.
The following illustration shows information about the user Composer1. This user has
Read/Write/Delete access that is inherited from the Editors group.
114
Select Go To to switch the focus of the Users tree to the group you selected.
Select Go to user in this group to switch the focus of the Users tree to the selected
user in the selected user group. The Part of Group(s) dialog box focus does not
update.
1. In the Users list of the User Management view, select the user group for which you want
to change the role.
2. In the Roles area, select the appropriate role.
115
4 User Management
3. Click Apply.
To change the role for a user, do one of the following:
Right-click the user and select Cut, select the group, right-click the group and select
Paste. This action moves the user from one group to another. You can also drag the user
from one group to another.
Right-click the user and select Copy, select the group, right-click the group and select
Paste. This action removes the user from one group and adds it to another. You can also
hold down the Ctrl key and drag the user from one group to another.
Description
The user can log in to the Interplay database using a valid Avid
Unity password.
Internal Authentication
The user can log in to the Interplay database using the password
you set in the User Management view. By default, the password
field in the Attributes pane is empty. The user can change this
password anytime in the Interplay login dialog box.
LDAP Authentication
The user can log in to the Interplay database using an LDAP user
name and password.
Windows Domain Authentication The user can log in to the Interplay database using a Windows
domain user name and password.
c
116
If you do not select an authentication method for a user, the user cannot log in.
1. In the Users list of the User Management view, select the user.
2. In the Authentication Providers pane of the User Management view, select the
appropriate options.
Deleting a user or user group deletes it from all groups in the Users list and from the
Central Configuration Server.
To delete a user group or a user:
117
4 User Management
1. Select the user in the group from which you want it removed.
2. Do one of the following:
t
General role assignments (see Viewing General Role Assignments on page 118 and
Setting or Changing a General Role Assignment on page 121)
Special access folders (see Managing Special Access Folders on page 124)
For more examples of setting up rights on folders, see Setting Up a Folder Structure and a
User Database in the Avid Interplay Best Practices Guide.
1. In the User Management section of the Interplay Administrator window, click the
Manage Database Roles icon.
The Manage Database Roles view opens.
118
3. In the Database pane, select the database or a folder for which you want to view roles.
119
4 User Management
If the database icon has a red X, you are not connected. Click the database icon to
connect. The database icon shows a green check mark when you are connected. The
following table describes three different states of the database icon.
Icon
Meaning
(Green circle with check mark) Database you are connected to.
To view roles for all users of the selected folder, select All Users and Groups.
To view roles for a particular user or user group of the selected folder, select that
user or user group.
To view all roles for the selected users of the selected folder, select All roles.
To view particular roles for the selected users of the selected folder, select a role.
The path in the middle of the view displays a formula for what is displayed in the lower
panel.
The Node (item in the database), User, and corresponding role are displayed in the lower
panel. Roles that are inherited from a group are grayed out. Roles that have been
assigned directly are black.
The following illustration shows the Projects folder, the Editors group, and All roles
selected. All roles are listed in the lower panel.
120
To delete items, the user must have deletion rights for the folder, even if the user is the
owner of the item to be deleted.
To move items, the user must have write rights on the object, the folder the object is
being moved out of, and the target folder.
All users are automatically assigned the Read role for the folder Unchecked-in Avid
Assets (but not the contents), and the Read/Write/Delete role for their private folder
within the Unchecked-in Avid Assets folder. All users are automatically assigned the No
121
4 User Management
Access role for Orphan Clips. Administrators have full access to all folders. For more
information about the Unchecked-in Avid Assets folder and the Orphan Clips folder, see
the Avid Interplay Access Users Guide.
To set or change a role for users of the database or a folder:
1. In the User Management section of the Interplay Administrator window, click the
Manage Database Roles icon.
The Manage Database Roles view opens.
2. Select the General Role Assignment option.
3. In the Database pane, select the database or a folder for which you want to set a role.
4. In the User/Group column, select the user or user group.
5. In the Roles column, select the role you want to set.
The formula in the middle of the view shows your selection. For example, in the
following illustration, you are going to give Editors the Read role (read-only access) for
the Antarctica folder.
122
To change a role:
Select the entry in the lower pane, right-click, and select Set Role > role name.
The role for the users on that item is inherited from the parent user group again.
123
4 User Management
1. In the Manage Database Roles view, in the Database pane, select the project from which
you want to block users.
2. In the User/Group pane, expand the group.
3. Select each user, and in the Roles pane select No Access.
4. Click Set Role.
To prevent a user from accessing all databases:
In the User Management view, deselect all authentication providers available to a user.
1. In the Manage Database Roles view, set the No Access role for the specific user on the
top-level folder that you want to be hidden (see Setting or Changing a General Role
Assignment on page 121).
2. On the item for which the user needs access, set the role to Read (or higher).
The Folder is not visible dialog box opens, telling you how applying the role to the
selected location will affect the users rights on other folders.
124
3. Click the Apply button for the option Mark as Special Access Folder: Grant path
access and allow to view path.
This option allows users to log in to the database and navigate to the specified location.
The tree structure above the folder will be visible, but not the contents of the other
folders in the structure. The first option makes the contents of the tree structure
accessible as well (not recommended).
After you set the special access, when users connect to the database, they see the
structure of the database above the special access folder, but not the contents of the
individual folders. Only the contents of the folder for which they have Read or higher
rights are available.
To view who has been assigned access to Special Access folders:
Special Access
Folders option
2. In the Database pane, select the entire database or the folder for which you want to
check for Special Access folder rights.
3. In the User/Group pane, select All Users to see all users who have special access to the
folders you selected, or select a specific user.
125
4 User Management
4. The bottom panel displays the users who have special access according to your
selections.
The following illustration shows that the user jeditor has special access to the folder
/Outside Productions/Graphics. To view what specific role jeditor has, select the folder
in the Database pane.
Special
Access
Folder
User who
can access
Special
Access
Folders
The role for the user on that item is inherited from the parent user groups again.
126
The fundamental rule of user management is that explicit rights override inherited
rights, and database rights (set in the Database Management view) override CCS rights
(set in the User Management view and stored in the CCS). The exception to this rule is
the user who is a global Administrator set through the User Management view. This
Administrator always has Administrative rights on all folders, even if rights are set
otherwise in the Manage Database Roles view.
By default, the root group Users is assigned the NoAccess role. That means that all user
subgroups (Everyone, Imported Users, Migrated Users and any other groups you add)
except for the Administrators and UNITY (under the Imported Users) have the role
NoAccess through inheritance. NoAccess means that a user cannot even log in to the
server. (The Administrators group is assigned the Administrator role and the UNITY
group is assigned the Read role.)
To override the NoAccess role, create another user group with a different role and copy
the user into that group.
Changing the role for the Users group or the Everyone group (from No Access to Read,
for example) makes it impossible to take away this role from individual users. Avid
recommends that you do not change the role of the Users group or the Everyone group.
You can assign a user to more than one user group (see Setting or Changing a General
Role Assignment on page 121) and each group can have a different role. As a result,
the user inherits different roles, which can be useful if a user contributes to different
projects in different ways.
In the User Management view, you can set only group roles. You can set roles for
individual users in the Manage Database Roles view. See Managing Database Roles
on page 118.
The following steps describe how the Interplay Engine server determines access to an object
(usually a folder). This process can help you understand how to assign roles and access:
1. The server checks on the object in question to see if explicit rights are set. If a user is
assigned a role on the object, the evaluation stops and the server grants the user only the
role allowed and the accompanying rights, if any.
2. If no explicit permissions were found on the object, the server checks the inherited
rights on the object in question.
127
4 User Management
3. If there are no inherited permissions, the server checks the global user rights. In this
case, the server determines what role the user has from the CCS settings.
4. In case of a conflict where the evaluation sees a user with multiple roles, for example:
-
then the highest ranking role wins. In this case, the user gets the read/write role.
This is an example of an accumulated inherited role. The users overall role for the database
is the highest role he or she is assigned to in any group, unless otherwise specified in the
Manage Database Roles view. For example: If User A is in Group 1 (which is assigned a
Read role) and User A is also in Group 2 (which is assigned a No Access role), then User A
has the accumulated inherited role Read. When you select User A in the User Management
view, this role is displayed in the Roles pane.
128
5 Site Settings
Site settings include configuration options for various Interplay components. The following
topics provide information about site settings:
Configuring Categories
Interplay Access
Interplay Assist
Avid Instinct
5 Site Settings
These properties are sometimes referred to as system metadata. However, it is only part of
the metadata included in an Avid Interplay database. For a description of available
properties, see System Metadata Properties on page 269.
For Interplay Access, administrators select which properties are displayed by default in the
Content tab and Object Inspector Property tabs. Users can then add other available
properties to these tabs. They can also use available properties in an extended search. For the
other client applications, the default properties are preset, and users can add other available
properties as columns in the Research panel.
By default, a set of properties categorized as Broadcast is selected and displayed. You can
customize this set or you can display an alternative set of properties, either Post or Film, and
then customize this set.
The following illustration is an example of properties displayed in the Properties tab of the
Interplay Access Object Inspector.
The administrator can also use the Property Layout view to do the following:
Control the resolutions that are available for display. See Setting the Resolutions
Available for Display on page 132
1. In the Site Settings section of the Interplay Administrator window, click the Property
Layout icon.
The Property Layout view opens.
130
Broadcast
Post
Film
This option determines which set of properties is displayed in the client
applications.
131
5 Site Settings
(Option) To make a property available for users to add into displays on their own,
and to use in an Extended Search in Interplay Access, select the property in the
Available column. To make a property unavailable, deselect it.
(Option) To include a property in the Interplay Access Content tab, select the
property in the Content Default Column. To remove a property from the Content
tab, deselect it.
You must select a property in the Available column if you want to display the property in the
Object Inspector or the Content tab.
6. (Option) Click Revert to reset properties to the defaults.
7. Click Apply to save the changes.
The changes appear the next time you log in to Interplay Access.
Interplay Access
Interplay Assist
Avid Instinct
Lists of available resolutions appear in various places in these clients. For example, Interplay
Access includes a Resolutions dialog box that lets you select which resolutions to display as
columns in the Content view (available when you click the Presets button). Interplay Assist
and Avid Instinct include a dialog box that lets you select the columns you want to display in
the Research panel.
The Resolutions tab in the Property Layout view displays a list of all current Avid
resolutions. By default, the available resolutions that are currently used in the database are
selected and are displayed in bold.
132
In some circumstances you might want to make additional resolutions available for display.
For example, if you are using Interplay Access to view the status of assets on remote
workgroups, and the database for the local workgroup does not include resolutions used on
the remote workgroup, you can select those resolutions for display in the local version of
Interplay Access.
By default, the option Enable used resolutions automatically is selected. If you add an
asset associated with a previously unused resolution to the Interplay database, this option
automatically adds it to the default list. It also prevents you from deselecting currently used
resolutions (check boxes are grayed out). If you want to remove a currently used resolution
from the list for display, deselect this option.
To set the resolutions that are available for display:
1. In the Site Settings section of the Interplay Administrator window, click the Property
Layout icon.
The Property Layout view opens.
2. Select the database for which you want to set resolutions.
3. Click the Resolutions tab.
Resolutions that are used in the database are selected by default.
4. To add a resolution, select its check box in the Available column.
The check box for the selected resolution is colored green. The name of the resolution is
not in bold face.
133
5 Site Settings
Resolution in local
database:
grayed-out check box,
name in bold face
134
Interplay Access
Interplay Assist
Avid Instinct
By default, the user needs to type the value for a custom property. Administrators can import
an XML file that creates a list of values from which the user can select a value.
The following topics describe how to create and use custom properties:
1. In the Site Settings section of the Interplay Administrator window, click the Property
Layout icon.
The Property Layout view opens.
2. Select the database for which you want to set properties.
3. Click the Custom Meta Data tab.
Any previously defined custom properties are displayed.
4. In the Add Custom Meta Data Field text box, type a name for the custom property.
5. Click the green plus sign (+).
After a few seconds, the custom property appears in the list, with the Available column
selected. The following illustration shows a new Custom Property named Teams.
135
5 Site Settings
When the Available column is selected, the custom property is available for users to add
into the application displays, and to use in an Extended search. If the user performs an
All Custom search, only the available custom properties are used in the search.
Deselect the property in the Available column to turn off custom properties that you do not
want displayed in the properties lists. You cannot delete custom properties for this release
but you can turn off their display.
6. Select whether to include the property in the Content tab or the Object Inspectors
Properties tab, as needed (Access only).
7. (Option) If you created an XML file for a list of values:
a.
b.
136
8. Click Apply to save the added custom property and new layout.
9. (Option) If you want to prevent a user or group from supplying a value for a custom
property, change the role in the User Management view (see Setting Access Control for
Custom Properties on page 138).
The next time a user starts Interplay Access and logs in, the new custom property is
displayed. The following illustration shows the custom property Teams and its list of
values, with the default value highlighted.
137
5 Site Settings
To select a value, click an item in the list, then click Apply. In this example, a user associated
the value Team A to the folder.
Users can add a custom property as a column in Interplay Assist, Avid Instinct, and the
Interplay Window.
1. In the User Management section of the Interplay Administrator window, click the User
Management icon.
The User Management view opens.
138
Users pane
Edit button
Inherited: Allows the selected user or group to inherit the role of the parent group
No: Prevents users from typing or selecting from a menu. Users can see the property
and its text box, but cannot supply a value for it.
5 Site Settings
The choices will appear in Interplay Access as shown in the following illustration:
140
The following example shows an XML file that creates a two-level hierarchy, with
League 1 Team A as the default value.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE values SYSTEM "custom_attributes.dtd">
<values description="Teams">
<value name="League 1">
<value name="Team A" default="true"/>
<value name="Team B"/>
</value>
<value name="League 2">
<value name="Team C"/>
<value name="Team D"/>
</value>
</values>
The choices will appear in Interplay Access as shown in the following illustration:
141
5 Site Settings
A custom property with a list of values is blank until you select a value. After you select a
value, you cannot return the field to a blank state. If appropriate for your custom property,
you can include a value in the list called No Value or something similar. To clear a value
and completely remove a list, see Removing a List for a Custom Property on page 142.
To create an XML file of values for a custom property:
1. Use a text editor or XML editor to create a file that matches one of the formats presented
above.
2. Name and save the file.
3. In the Custom Meta Data tab, create a custom property and import the file, as described
in Adding a Custom Property on page 135.
To edit a list of values:
Export the existing file by clicking Export in the Custom Properties tab and then
edit it.
142
1. Use a text editor or XML editor to create a file that matches the following format. Use
quotation marks as shown:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE values SYSTEM "custom_attributes.dtd">
<values/>
For more information on searching in Access, see the Avid Interplay Access Users Guide or
the Access Help.
143
5 Site Settings
Configuring a remote workgroup in this view is not needed for transfer from Interplay Assist,
Avid Instinct, or Avid editing systems.
For complete information on transferring Avid assets, see the Avid Interplay Transfer Setup
and Users Guide or the Interplay Transfer Help.
You can configure a maximum of 10 hostnames. For example, you can configure for
searching five remote workgroups and five Nearchive servers for a total of 10.
To set up access to a remote workgroup:
1. For transfers, make sure the Transfer Engines for both workgroups are correctly
configured.
2. Make sure the list of users for the remote workgroup includes the user name and
password of users in the local workgroup who require access to the remote workgroup.
For transfers, make sure the user name and password match exactly, and that
Administrator passwords also match exactly.
In Interplay Access, if the local users account is not included in the remote user
database, a login screen appears. If you log in with an account on the remote workgroup,
you can add the remote workgroup to the accessible remote servers list but you cannot
transfer to the workgroup.
3. In the Site Settings section of the Interplay Administrator window, click the Configure
Remote Workgroups icon.
The Configure Remote Workgroups view opens.
144
b.
Interplay Server / 3d Party Searchto add access for a third-party plug-in. The
plug-in needs to be properly installed before you can configure it. See Using
Third-Party Search Plug-Ins in the Interplay Access Users Guide or Help.
Type information for the remote workgroup. The fields vary, depending on the Host
Type you selected.
-
For the Server, you can type the remote workgroups IP address instead of the
host name.
145
5 Site Settings
c.
The Nickname is displayed in the Interplay Access Remote Search list and
must be less than 255 characters. If you do not supply a Nickname, the
Interplay Engine creates one that combines the host name and the database.
Click Add.
The Server name and other information about the remote workgroup appears in the
list of accessible remote servers.
Configuring Categories
Categories provide a grouping mechanism for the data that is stored in the database.
Categories are displayed in Interplay Access, Interplay Assist, and Avid Instinct. A user can
assign database items to these categories and use these categories in a search. You can
double-click a category to view a list of the categorys items.
There is no option to rename a category. The database items identify the categories
they belong to by the category name, so this name cannot be changed once it is used.
Adding Categories
To make categories available in Interplay Access:
1. In the Site Settings section of the Interplay Administrator window, click the Configure
Categories icon.
The Configure Categories view opens.
146
Configuring Categories
When performing a search, you can use a Category name to locate items that belong to
that category.
147
5 Site Settings
Removing Categories
Removing a category only removes it from the Configured Categories list in the Interplay
Administrator. Objects in the database that have this category keep it, even if it is not listed
anymore. If an item was assigned to a category but you removed that category in the
Interplay Administrator, users are informed that the category is not valid anymore in the
Interplay Access Categories tab.
To remove a category:
148
The computer name of the Interplay Media Services Engine. You must register the
Interplay Media Services Engine before you can run the Interplay Media Services view
(see Interplay Media Services View on page 153) or use any Interplay Media
Services. For more information, see the Avid Interplay Media Services Setup and Users
Guide.
The hostname and port for the Interplay Delivery Receiver service. You must enter the
name of the system where the Interplay Delivery Receiver service is installed before you
can receive transfers from the Delivery service. By default the port is 33321. For more
information, see the Avid Interplay Media Services Setup and Users Guide.
The name of the Interplay workgroup. You must enter the name of the workgroup so
that Interplay Access, Interplay Assist, and Avid Instinct can locate the Media Indexer,
which is used to monitor shared storage. For more information, see the Avid Service
Framework Users Guide.
The Workgroup Name field is case sensitive and the name must exactly match the
workgroup name used by the Avid Service Framework. You can view or change this
workgroup name in the Avid Interplay Workgroup Properties, which is an application
that is part of the Avid Service Framework.
The computer name of the fallback shared-storage server. This name is automatically
entered after the first connection from the Interplay Engine to the shared storage system,
so in most cases you do not need to enter this computer name. Usually the Interplay
Engine gets the name of the shared-storage server from the Media Indexer. If this is not
possible, the Interplay Engine gets the name of the shared-storage server from the
Fallback Shared-Storage Server setting. Use this setting in case you need to change the
name of the shared-storage server.
The computer name of the server that is running the Interplay Streaming Server, a
Windows service that is used to play clips for WAN browsing. You need to enter this
computer name after you install the Interplay Streaming Server software. See
Configuring the Interplay Streaming Server on page 151.
149
5 Site Settings
1. In the Site Settings section of the Interplay Administrator window, click the Server
Hostname Settings icon.
The Server Hostname Settings view opens.
2. In the Interplay Media Services Settings area, type the name of the Interplay Media
Services Engine server in the text box.
3. Click Apply Changes.
To set the Interplay Delivery Receiver host and port:
1. In the Interplay Media Services Settings area, type the name of the host and the port
number. By default, the port number is 33321.
2. Click Apply Changes.
150
1. In the Workgroup and Media Indexer Settings area, type the workgroup name.
The Workgroup Name field is case sensitive and the name must exactly match the
workgroup name used by the Avid Service Framework.
2. Click Apply Changes.
3. Click Check Media Indexer to check whether the Media Indexer that monitors shared
storage is running.
If the Media Indexer is running, the system displays the message Connected to Media
Indexer successfully in the Notifications area at the bottom of the Interplay
Administrator window.
If there is a problem, an error message is displayed, such as No lookup service found
for workgroup. See Configuring Avid Interplay Media Indexers in the Avid Interplay
Best Practices Guide.
To change the name of the shared-storage server:
1. Clear the field by deleting the name of the previously used shared-storage server.
2. Click Apply Changes.
The name is automatically entered after the first connection from the Interplay Engine to
the shared-storage system.
151
5 Site Settings
In Interplay v2.4, the Interplay Streaming Server was re-engineered to directly play
MPEG-4/H.263 and H.264 video media and MPEG1 layer 2 audio media. There is no
longer any need to use the Publishing service or Workflow Engine to create QuickTime
reference movies for streaming play. Double-click a clip that is associated with supported
proxy media, and the clip plays in the Interplay Access Monitor.
For Interplay v2.4, the name of the stream server on the Avid Server Installation USB flash
drive is Avid Interplay Streaming Server and the name of the installed Windows service is
Avid Interplay Streaming Server Service. For Interplay v2.3 and earlier, the name was
Avid Interplay Stream Server.
To add an Interplay Streaming Server to a workgroup:
1. In the Site Settings section of the Interplay Administrator window, click the Server
Hostname Settings icon.
The Server Hostname Settings view opens.
2. In the Stream Server Settings area, click the Add button.
The Add Stream Server and Share dialog box opens.
3. Type the computer name of the system that is running the Interplay Stream Server. You
do not have to type \\ before the name of the server.
4. Click OK.
The computer name is displayed in the Server Hostname Settings view.
152
The share name listed does not apply to the Interplay Streaming Server v2.4 (it was used in
the Interplay Stream Server v2.3 and earlier). The installer for the Interplay Streaming
Server v2.4 does not create this share. However, you cannot remove this share name.
Registering providers
Installing services
Setting up users
Setting up profiles
These options are also available from the Admin Tool in the Avid Interplay Media Services
application dialog box.
Before you can use the Interplay Media Services view, the Interplay Media Services Engine
for the workgroup must be configured in the Server Hostname Settings view. For details, see
Setting Server Hostnames and the Workgroup Name on page 149. Also, the Interplay
Media Services Engine must be running.
If the Interplay Media Services connection to the Interplay Media Services Engine fails, the
login panel is displayed to let you manually attempt to login again.
For details on installing and using the Interplay Media Services Engine, see Avid Interplay
Media Services Setup and User's Guide.
153
5 Site Settings
The list of Interplay Transfer Engines available from the Interplay Transfer Status filter is
created from the Interplay Transfer Settings. For details, see Interplay Transfer Settings
View on page 154.
For descriptions of the various filters and configuration settings, see the Avid Interplay
Transfer Setup and User's Guide.
Users with Administration rights can change the configuration to another destination in the
Send to Workgroup dialog box in Interplay Access.
For procedures that explain the Workgroup Transfer Presets view, see the Avid Interplay
Transfer Setup and User's Guide.
154
1. In the Site Settings section of the Interplay Administrator window, click the Asset
Tracking/Archive Settings icon.
The Asset Tracking/Archive Settings view opens.
2. If you want to track assets in a non-archive server, in the Online server name text box,
type the computer name of the Interplay Engine server and click Add.
The server name is added to the list of configured hosts.
155
5 Site Settings
3. If you want to track assets on an archive server, in the Archive Server name text box,
type the computer name of the Interplay Archive Engine.
4. Click Apply Changes.
This option lets you choose whether the Archive Provider archives duplicate
versions of the media.
This option lets you choose whether the AAF metadata for Avid assets is sent to the
tape archive along with the media.
These settings are described in the following topics. For more information about using an
Interplay Archive Engine, see Avid Interplay Best Practices and the Avid Interplay Media
Services Setup and Users Guide.
156
The Interplay Archive Engine avoids duplication by default. If you prefer to have the
Archive Engine archive duplicate media files, you can use the Interplay Administrator to
change the setting.
This setting appears only when you log in to an Archive Engine database.
To change whether archive operations create duplicate media:
1. Open the Interplay Administrator and log into the system running the Archive Engine.
2. In the Site Settings section of the Interplay Administrator window, click the Asset
Tracking/Archive Settings icon.
The Asset Tracking/Archive Settings view opens.
3. Select the Archive database AvidAM from the database list.
The system displays the Asset Tracking/Archive Settings window for the Interplay
Archive Engine.
4. Select one of the following settings for Allow duplicated media files option:
-
No When you archive an Avid asset the first time, the Archive Provider archives
all associated media. If you archive other assets that reference the same media, the
Archive Provider archives the metadata but does not archive duplicate versions of
the associated media (default setting).
157
5 Site Settings
Yes The Archive Provider archives the associated media each time you archive
an asset. If you delete an asset that references the duplicated media, the system asks
if you want to delete the associated media files. If you choose the delete the media,
the system deletes all copies of the media.
1. Open the Avid Interplay Administrator and log into the system running the Interplay
Engine.
2. In the Site Settings section of the Interplay Administrator window, click the
Asset Tracking/Archive Settings icon.
The Asset Tracking/Archive Settings view opens.
3. Select the AvidWG database from the database list.
The Archive Settings area displays these options.
158
In the Archive server name text box, type the name of the computer running the
Avid Interplay Archive Engine.
In the Archive Segment size (frames) text box, type the segment size used for partial
restore operations, in frames. The default and minimum value is 1800 frames.
If you later change the Archive Segment size, the new size applies only to new archives.
Partial restores of media that is already archived use the original segment size.
t
Use best effort restore - if you select this option, a restore process restores as many
files as it can without returning errors. This option requires special implementation
by supported third-party vendors to ignore any missing files that are no longer in the
archive storage. If you do not select this option, then the restore process fails when
there are any missing files (the default).
The Use best effort restore option is not supported by all third-party archive
vendors. If you select this option and your archive vendor supports it, then a restore
process restores as many files as it can without returning errors.
5. Click Apply Changes at the bottom of the window.
Interplay Access
Interplay Assist
Avid Instinct
Interplay Window
By default, the user who creates a folder is set as the owner. As the owner, the user by default
has read/write/delete permission on the folder. In Interplay Access, a problem could develop
in the following situation:
1. Editor 1 owns a folder named Final that contains a sequence named Final_Sequence and
has read/write/delete permission on the folder.
2. Editor 2 has read/write permission on the folder, but not delete rights.
3. Editor 2 creates a folder named Final_2 within folder Final, and thus has
read/write/delete permission on the new folder.
159
5 Site Settings
An administrator can change the owner and permissions for a folder after it is created. For
more information, see the Avid Interplay Access Users Guide or Help.
To specify how ownership is set for new folders:
1. In the Site Settings section of the Interplay Administrator window, click the Ownership
Behavior icon.
The Ownership Behavior view opens.
2. Select the database for which you want to set the behavior.
3. Select the option you want.
160
Set same owner as parent folder sets the owner of a new folder to be the owner of
the folder in which the new folder was created.
4. Click Apply.
The change takes effect immediately.
5. To undo your change, click Revert, then click Apply.
Setting Options for Deleting Only OMF Media, Only MXF Media, or Both on
page 169
Clip 1
(link)
V1 media
Clip 1
database asset
Clip 1 copy
(link)
A1 media
A2 media
2. Links for assets that are not reserved or referenced by other assets are deleted from the
database.
161
5 Site Settings
Clip 1
(link)
V1 media
Clip 1
database asset
Clip 1 copy
(link)
A1 media
A2 media
3. Database assets (and associated files such as AAF files and QuickTime reference files)
are deleted unless they reference online media.
The following illustration shows the completed deletion.
Clip 1
(link)
V1 media
Clip 1
database asset
Clip 1 copy
(link)
A1 media
A2 media
The last part of the process is the part that takes the longest time and places the heaviest load
on the Interplay Engine. In addition, this part of the process does not provide immediate
feedback, as opposed to media deletion (you can see the files deleted from shared storage)
and link deletion (you can see links are deleted from the Access folder structure). Database
assets are not displayed in Interplay Access.
Changes in Interplay v2.4
In Interplay v2.4 and later, the last part of the deletion process (database asset deletion) is
disassociated from the first two parts of the deletion process. When the last link to a database
asset is deleted, the Interplay Engine moves the last link for the database object to the
Orphan Clips folder. This link points to the database asset.
162
Clip 1
(link)
V1 media
Clip 1
database asset
Clip 1 copy
(link)
A1 media
A2 media
Deletion of the link in the Orphan Clips folder and the database asset takes place during a
time span that is set in the Interplay Administrator client application. By default, the time
span in the Interplay Administrator is set as 24 hours (00:00 to 00:00). In this case, the
database asset deletion takes place at approximately the same time that you run the deletion
operation, and links to the database assets might not appear in the Orphan Clips folder
because they are deleted almost immediately. The default time span results in the least
disruption for established workflows, but it does not lessen the load the deletion operation
places on the Interplay Engine.
To take advantage of the improved process and lessen the load on the Interplay Engine, you
need to set a custom schedule with one or more time spans (see Scheduling the Deletion of
Database Assets on page 166). Scheduling a deletion time span results in a faster initial
deletion operation and less impact on other Interplay Engine operations.
Scheduled deletion works similarly on the Interplay Archive Engine. On the Interplay
Archive Engine, media is flagged for deletion, but the deletion itself takes place through the
third-party archive system.
Changes to the Orphan Clips Folder
The function of the Orphan Clips folder and the status of its contents changed in
Interplay v2.4.
Previously the Orphan Clips folder contained links for assets deleted or removed from
Interplay folders that still referenced media files on shared storage (including unused
rendered effects). Now, in addition to these links, the Orphan Clips folder also contains links
for assets deleted from Interplay folders whose media files were also deleted.
163
5 Site Settings
If your deletion time span is set for the default 24-hour period, you might not see links for
assets without media in the Orphan Clips folder, because the database assets are deleted at
approximately the same time as the asset deletion.
You can distinguish links that have online media from links that do not have online media by
displaying the Media Status column. A red icon indicates media offline. Double-click the
column head to sort by the values of the column. Links with offline media are automatically
scheduled for deletion.
Links with
offline media
Links with
online media
Kept Media folder: You can select an option to include deletion of links with online media
in the scheduled deletion. If you do not select this option, the scheduled deletion moves any
links with online media to a subfolder in the Orphan Clips folder named Kept Media. This
option is not selected by default, so even if you do not enable custom deletion, the Interplay
Engine creates a Kept Media folder when needed. You can manually delete clips and media
from this folder at a time that is appropriate for your workflow.
Failed to Delete folder: If the deletion process is not able to delete a clip or its media (for
example, if a clip is corrupted), the Interplay Engine creates a subfolder in the Orphan Clips
folder named Failed to Delete and moves assets it could not delete to this folder. You can
try to manually delete clips and media from this folder as well, but you might need to
determine a different method of deleting these clips and media. For example, check the
shared-storage system workspace to make sure the the Server Execution User has delete
rights.
These folders are useful in two ways:
It is easier to browse and search a large Orphan Clips folder for assets with online media
and assets that cannot be deleted.
The scheduled deletion process ignores both of these folders, resulting in improved
performance.
You can manually delete assets from the Orphan Clips folder at any time.
164
AvDeletes.log. This log lists information about media deleted from shared storage.
AvMetaDataDelete.log This log lists information about assets (metadata) deleted from
Orphan Clips or any other folder. Scheduled deletions are noted.
When a user deletes metadata that is moved to the Orphan Clips folder:
[Thu Mar 10 12:12:17 2011] User 'Administrator' on host
'MUC-TReichgr' deleting metadata:
[Thu Mar 10 12:12:17 2011]
From '/Projects/Test3/'
When a scheduled deletion permanently deletes metadata from the Orphan Clips folder:
[Tue Mar 08 13:45:00 2011] Scheduled deletion: deleting metadata from
Orphan Clips:
[Tue Mar 08 13:45:00 2011]
'Administrator'
When an administrator user permanently deletes metadata from the Orphan Clips folder:
[Thu Mar 17 20:16:10 2011] User 'Administrator' on host
'MUC-TReichgr' deleting metadata instantly:
[Thu Mar 17 20:16:10 2011]
[Thu Mar 17 20:16:10 2011]
The AvMove.log file includes entries for links moved to the Kept Media folder.
New Properties for Deletion
The Interplay v2.4 database includes three new properties that are displayed only for assets
in the Orphan Clips folder:
Date Deleted: Displays the date and time the last link was deleted.
Deleted By: Displays the user name of the person who deleted the last link.
Original Path: Displays the folder path for an asset whose last link was deleted.
165
5 Site Settings
To display these properties, an Interplay administrator has to make them available in the
Property Layout view. An Interplay Access user has to select the properties for display as
entries in the Object Inspector or as columns in the Assets pane. For more information, see
the Interplay Access and Interplay Administrator documentation.
You can now schedule the most load-demanding part of deletion operations during times
of low activity.
As a result, deletions that you perform during normal working hours have less impact on
the Interplay Engine and can be performed more quickly.
Scheduled deletion affects database assets whose links are contained in the Orphan Clips
folder in the Interplay Administrator.
The Orphan Clips folder contains two types of links:
Links for assets deleted or removed from Interplay folders that still reference media files
on shared storage (including unused rendered effects). You can delete these links
manually (such as in an established delete workflow) or include them in a scheduled
deletion.
Links for assets deleted from Interplay folders whose media files were also deleted.
Deletion of these links is automatic but takes place during a scheduled deletion. You can
also delete these links manually.
During the scheduled time spans, the Interplay Engine reviews the objects in the Orphan
Clips folder and deletes the links, the database assets, and the media (if media deletion is
included in the scheduled deletion). At the end of a time span the Interplay Engine keeps a
record of where it stopped and if not all eligible assets were deleted, continues from this
position at the start of the next time span. This process also takes place if the scheduled
deletion is interrupted, such as for system maintenance.
To schedule the deletion of database assets:
1. In the Site Settings section of the Interplay Administrator window, click the Delete
Behavior icon.
The Scheduled Deletion Options section is at the bottom of the view.
166
Permanently delete assets and associated online media from the Orphan Clips folder
If all links for an asset are deleted or removed from Interplay folders, but media for
the asset is still online, the last link is moved to the Orphan Clips folder. Select this
option if you want to include these links and the media in the scheduled deletion.
Otherwise the links and media are moved to the Kept Media folder.
Delay scheduled deletion by at least x days from the asset deletion date
Select this option if you want to delay the scheduled deletion by a specified number
of days. You can specify 1 to 30 days. This option gives you the opportunity to
review the contents of the Orphan Clips folder before the scheduled deletion. To
help determine which links will be deleted, you can check the asset deletion date in
the Date Deleted column (see New Properties for Deletion on page 165).
167
5 Site Settings
For example, imagine that you selected this option with a time period of 1 day (24
hours), and a deletion is scheduled for 2 a.m. to 4 a.m. It's 6 p.m. Friday, March 25,
and you delete a group of assets and media. The assets are moved to the Orphan
Clips folder and scheduled for deletion at 2 a.m. Sunday morning, March 27
(32 hours later). This scheduled deletion will include any assets deleted at or before
2 a.m. on Saturday, March 26 (24 hours before the start of the scheduled deletion).
The following diagram illustrates this example.
Friday
Saturday
Sunday
6 pm
2 am
2 am
Assets scheduled
for deletion
Scheduled
Deletion
Click Add Time Span to create more than one time span. Click Remove Time Span to
remove the associated time span. Overlapping time spans are not allowed.
In addition to a specific time span, you can select one or more days for that time span.
The following illustration shows an example of three different time spans.
168
The first time span specifies deletions to take place from midnight until 4:00 am
every day of the week.
The second time span specifies deletions from 4:01 am until 8 am every Saturday
and Sunday.
The third time span specifies deletions from 8:30 pm until 11:59 pm every Monday,
Wednesday, and Saturday.
Time spans are not allowed to overlap. For example, you cannot schedule a time span
from midnight until 4:00 am every day and also schedule a time span from 2 am to 4 am
on Saturday and Sunday. If you schedule an overlap, a message describes the problem
and how to correct it.
Scheduling deletion for specific days requires Interplay Engine v2.5. If you connect to
an Interplay Engine running v2.4 or earlier, the days of the week check boxes are
displayed but are inactive.
Setting Options for Deleting Only OMF Media, Only MXF Media, or
Both
If a clip is associated with both OMF and MXF media, you might want to delete only the
OMF media or only the MXF media. You can enable an option in the Interplay
Administrator so that the Delete dialog box gives users the option of which media format to
delete.
To set an option that allows deleting only OMF media or only MXF media:
1. In the Site Settings section of the Interplay Administrator window, click the Delete
Behavior icon.
2. In the OMF media handling section, select Allow user choice for deleting OMF/MXF
media.
3. Click Apply.
The next time a user logs into Interplay Access and opens the Delete dialog box, the
following options are displayed:
-
169
5 Site Settings
1. In the Site Settings section of the Interplay Administrator window, click the Delete
Behavior icon.
2. In the Locked media handling section, select one of the following options:
-
Allow user choice in Delete dialog: Two options are available in the Delete dialog
box: Skip and Force delete.
Always skip (default): In the Delete dialog box, the Skip option is shown but
cannot be changed.
Always force-delete: In the Delete dialog box, the Force delete option is shown
but cannot be changed.
Both Skip and Force Delete options are always active for Interplay Access users
with administrative privileges
3. Click Apply to save any changes.
The next time a user logs into Interplay Access and opens the Delete dialog box, the
options are active or inactive, depending on the current settings in the Delete Behavior
view of the Interplay Administrator.
1. In the Site Settings section of the Interplay Administrator window, click the Metadata
Override Settings icon.
A folder tree displays the archive database.
-
Folders that have metadata override enabled are marked with a blue check mark
icon.
Folders with metadata override disabled are marked with a red x icon.
Folders with metadata override disabled are listed in the Locations window.
Red icon =
metadata override
is disabled
Blue icon =
metadata override
is enabled
Gray icons =
inherited setting
2. (Option) Select a folder in the folder tree to limit the folders displayed in the Locations
window to subfolders.
To enable metadata override:
Select a folder in the folder tree or one or more folders in the Locations window and
click Enable Override.
Select a folder in the folder tree or one or more folders in the Locations window and
click Disable Override.
171
5 Site Settings
172
6 Application Settings
In the Application settings, you can configure application-specific permissions and options,
as described in the following topics:
Editor Settings tab. For a description of options in this tab, see the following topics:
-
Application Defaults. For a description of options in this tab, see the following topics:
-
Setting Audio Mixing Defaults for Access and Assist on page 182
Setting the Shotlist Start Timecode for Interplay Access and Interplay Assist on
page 185
Setting an Automatic Timeout for Interplay Assist and Avid Instinct on page 186
6 Application Settings
1. In the Editing Settings section of the Interplay Administrator window, click the
Application Database Settings icon.
2. Click the Editing Settings tab.
3. Select a folder in the database.
174
If the database icon has a red X, you are not connected. Click the database icon to
connect. The database icon shows a green check mark when you are connected. For
more information, see Viewing General Role Assignments on page 118.
4. Do one of the following:
t
Edit button
5. Click Apply.
A notification box tells you whether or not the changes have been successfully applied.
Users who are currently logged in need to log out and log in again to see the changes.
6. Click Dismiss to close the notification box.
If you do not click Dismiss or the close box, after a few seconds the notification box
minimizes to a green bar at the bottom of the dialog box. To view the notification again,
click the green bar. The green bar is available for approximately 45 seconds.
To undo a setting:
Audio Patching
175
6 Application Settings
These settings are described in Application Database Settings: Editing Settings Tab on
page 176. For more information about using these settings, see the Avid Instinct Users
Guide.
Application Database Settings: Editing Settings Tab
You can set options for the Editing Settings tab in the Application Database Settings view as
described in the following table. Options apply to Avid Instinct or Avid Interplay Assist
unless specified otherwise.
Application Database Settings: Editing Settings Tab
Option
Setting
Description
Format
Video Format
n
Audio Patching
176
Natural Sound
Sound on Tape
Setting
Description
177
6 Application Settings
Setting
Description
Media Creation workspace Sets the workspace location used for media clips
created by Instinct and Assist users, such as
voice-over recordings and clips created during
send-to-playback operations.
To view a list of available workspaces, the user
logged into the Interplay Administrator must have a
matching username and password on the Avid
shared-storage system. The list shows all
workspaces to which the logged-in user has write
access.
178
Ducking [-dB]
Setting
Dynamic Relink
Description
Target resolution,
secondary
179
6 Application Settings
Setting
Description
180
Setting
Description
Auto Reservation
Dissolve Duration (frames) (Avid Instinct only) Sets the length of an audio
dissolve in frames. For example, to create a default
dissolve of 2 frames (the default), type 2.
Center-Panned Sound on
Tape and Voice Over
Duration [h]
181
6 Application Settings
Setting
Description
Bins
Check in bins when closing (Avid editing systems only) Allows you to set the
default behavior for checking in media objects from
open bins to the Interplay database when closing
your Avid editing application. The default is Ask
user.
For Interplay Access, the settings apply to the Audio Mixer controls, which let you
enable and mute tracks and adjust volume. Adjustments that you make with these
controls apply only when you play Avid assets and file assets in Interplay Access. For
more information, see the Avid Interplay Access Users Guide.
For Interplay Assist, the settings apply to the Local Audio Mixing controls, which let
you edit audio settings for clips or subclips that you load in the Monitor. Adjustments
that you make with these controls apply only when you play clips, subclips, or shotlists
in Interplay Assist. For more information, see the Avid Interplay Assist Users Guide.
These settings apply to the entire database only. You cannot set them for individual folders.
The following illustration shows audio tracks 1 through 16 enabled, with left/right
alternating pan (the initial default setting). Buttons for enabled tracks display a green icon.
182
To set audio mixing defaults for Interplay Access and Interplay Assist:
1. In the Application Settings section of the Interplay Administrator window, click the
Application Database Settings icon.
2. Click the Application Defaults tab.
3. Select the Enable Audio Mixing Defaults option so that a green check mark is
displayed.
4. For each track that you want to enable, click the corresponding button, so that the button
has a green icon.
183
6 Application Settings
5. For each track, select Left, Mono, or Right to assign the track to an output channel (pan
setting).
6. Click Apply.
You set the target audio and video resolution for a folder in the Interplay Administrator. If
you have Dynamic Relink enabled in a workgroup, settings for audio and video target
resolutions are enabled and required in the Interplay Administrator. You should set target
resolutions for the root folder. Subfolders inherit this setting. You can set different target
resolutions for subfolders that override the settings inherited from the root folder.
The following illustration shows DNxHD 1080 115-120-145 and PCM set as target
resolutions on the database root folder.
184
If you send a source to playback (a clip, subclip, or sequence) and a shotlist is open, the send
to playback operation uses the target resolution of the folder that holds the shotlist.
If a shotlist is not open, the send to playback operation uses the target resolution that is set at
the database root. If this resolution is not what you want to use for the source, you need to
create or open a shotlist in a folder that has the desired settings.
To make it easier to select target resolution settings to use when sending a Source to
playback, you can create a set of template shotlists and folders, each in a folder that has been
set with the target resolutions. You can then do one or both of the following:
Create the template shotlists with names that are easily searched, for example,
TRES_DNxHD1080, TRES_MPEG50, and so on.
Then, before you send a source to playback, use a shortcut or search to load the appropriate
shotlist.
Setting the Shotlist Start Timecode for Interplay Access and Interplay
Assist
An administrator can set the default starting timecode for shotlists that are created in
Interplay Access or Interplay Assist. The default starting timecode for shotlists is
01;00;00;00 (drop frame) or 01:00:00:00 (non-drop frame). For example, you can use this
setting to change the starting timecode hour from 01 to 00.
This setting applies to the entire database only. You cannot set it for individual folders.
Interplay Access and Interplay Assist determine the format of the timecode differently:
For Interplay Access, the timecode format is determined by the first clip in the shotlist.
You cannot mix drop-frame and non-drop-frame clips in the same shotlist.
For Interplay Assist, you set the default starting timecode as Drop Frame or Non-Drop
Frame in the Interplay Administrator. If you select Drop Frame, and if the frame rate of
the first clip in the shotlist supports drop-frame timecode (for example, 29.97 fps), the
timecode will be drop-frame. If you select Non-Drop Frame, or the first clip in the
shotlist does not support drop-frame timecode, the default timecode will be
non-drop-frame. You can mix drop-frame and non-drop-frame clips in the same shotlist.
Interplay Assist users can change the starting timecode for an individual shotlist by using
the command Edit > Edit Shotlist Start Timecode.
185
6 Application Settings
1. Start Interplay Administrator and log on to the database for which you want to set the
shotlist start timecode.
2. In the Application Settings section of the Interplay Administrator window, click the
Application Database Settings icon.
3. Click the Application Defaults tab.
4. Select the database (AvidWG).
5. For the Shotlist Start Timecode option, enter the timecode in the format HH:MM:SS.
You cannot enter a default starting frame.
6. For Interplay Assist, specify the Default NTSC Shotlist Format as Drop Frame or
Non-Drop Frame.
7. Click Apply.
1. Start Interplay Administrator and log on to the database for which you want to set the
automatic timeout.
2. In the Application Settings section of the Interplay Administrator, click the Application
Database Settings icon.
3. Click the Application Defaults tab.
4. Select the database (AvidWG).
186
5. In the Assist/Instinct - Defaults section, enter a value in hours for the Automatic
Timeout option. Decimal values are allowed. For example, for a timeout period of one
and a half hours, enter:
1.5
Default Setting in
Interplay Administrator
Timecode
Always selected
Comment
Always selected
Track
Selected by default
User
Selected by default
Color
Selected by default
Selected by default
The ability to configure which columns you display can be useful if you use locator
information in another application. You can export locator information in various formats or
you can copy rows of information and paste them into another application by using your
desktop copy and paste commands.
To configure the default display in the Interplay Administrator:
1. Open the Interplay Administrator and log in to the database for which you want to set
the default display.
2. In the Application Settings section, click Application Database Settings.
3. Click the Application Defaults tab.
187
6 Application Settings
4. In the Access Frame Locators View section, select the columns that you want to display
in the Frame Locators tab.
The Timecode and Comment columns are always displayed.
5. Click Apply.
To override the default display in Interplay Access:
188
1. In the Application Settings section of the Interplay Administrator window, click the
Instinct/Assist User Settings icon.
2. In the Users tree on the left, select a group of users or an individual user.
The settings for the selected user or user group area are displayed in the pane on the
right.
3. Do one of the following:
t
6 Application Settings
If a setting is grayed out (inherited), click the Edit button to enable editing
Edit button
Description
Inherited
The user inherits this setting from the group it is a part of.
Yes
No
If you select Inherited, and then click Apply, the option changes to the inherited setting
and the options are grayed out.
5. Click Apply.
A notification box tells you whether or not the changes have been successfully applied.
Users who are currently logged on need to log out and log in again to see the changes.
6. Click Dismiss to close the notification box.
If you do not click Dismiss or the close box, after a few seconds the notification box
minimizes to a green bar at the bottom of the dialog box. To view the notification again,
click the green bar. The green bar is available for approximately 45 seconds.
To undo a setting:
190
Setting
Instinct Assist
Access
Avid editing
applications Description
191
6 Application Settings
Setting
Instinct Assist
Access
Avid editing
applications Description
192
Setting
Instinct Assist
Access
Avid editing
applications Description
193
6 Application Settings
Setting
Instinct Assist
Access
Avid editing
applications Description
194
You can install Interplay Access and the Pro Tools Interplay Option on any Windows system
that you want to use to configure the import and export settings. For example, you can install
the Pro Tools option on the Interplay Engine server.
For information on installing the Pro Tools Interplay Option, see the Avid Interplay Software
Installation and Configuration Guide.
1. In the Application Settings section of the Interplay Administrator window, click the Pro
Tools Import Settings icon.
The Pro Tools Import Settings view opens.
195
6 Application Settings
2. Select the database or folder for which you want to configure import settings.
If the database icon has a red X, you are not connected. Click the database icon to
connect. The database icon shows a green check mark when you are connected. For
more information, see Viewing General Role Assignments on page 118.
The following illustration shows the Pro Tools Import Settings view. In this example, the
settings are configured for the entire database AvidWG. You can also select an
individual folder and set specific values for that folder and its subfolders. Settings are
inherited from the parent folder.
3. Select the values that Pro Tools should use to import the files and create a new session.
For more information about these settings, see the Pro Tools documentation.
4. Click Apply.
196
1. In the Application Settings section of the Interplay Administrator window, click the
Editor Export Settings for Pro Tools icon.
The Editor Export Settings for Pro Tools view opens.
2. Select the database or folder for which you want to configure export settings.
If the database icon has a red X, you are not connected. Click the database icon to
connect. The database icon shows a green check mark when you are connected. For
more information, see Viewing General Role Assignments on page 118.
The following illustration shows the settings for a project folder named
PR3 NTSC 30i. You can modify the settings for any folder in the hierarchy.
Subfolders inherit settings.
197
6 Application Settings
Option
Description
Video Details
Transcode Video
Resolution
Audio Details
Audio Mixdown
Specifies the audio sample rate for the export. The Project
option refers to the current Avid editor project setting.
Convert Audio Bit Depth Specifies the audio bit depth for the export. The Project
option refers to the current Avid editor project setting.
4. Click Apply.
Changes take effect for the Avid editing application the next time the Avid editor logs
into the Interplay Window. The editor might have to log out of the Interplay Window
and log back in.
198
For more information about the Avid Interplay Services, see the Avid Service Framework
User's Guide or Avid Interplay Best Practices.
200
Avid Workgroup Properties and Avid Service Configuration are also available from the
Interplay Access View menu.
8 Troubleshooting
The following topics provide information for troubleshooting problems with the Avid
Interplay Engine server:
8 Troubleshooting
5. In the Registry Editor, double-click CMS, type a valid entry, and click OK.
6. Unlock the server.
Check the TCP/IP connection by typing ping <servername> in the Command Prompt
on the client.
Server Settings
Check if there is a user account for the user. See Managing Users, User Groups, and
User Rights on page 108.
Check if the password is expired. See Viewing and Setting Attributes on page 112.
Check that the user has access to the database (a role other than No Access).
Make sure the user authorization provider includes the user account. See Setting User
Authentication Providers and Importing Users on page 98.
Client Settings
Reinstall Interplay Access. This client application hosts Interplay Access, Interplay
Administrator, and the connection package for any connection to Interplay.
Make sure that the server meets the current specifications. See the Avid Interplay
ReadMe.
Make sure that the client is running on a system that meets specifications.
202
Check the speed of the LAN between the Avid Interplay Engine and the shared storage
server.
Make sure that the Avid Interplay Engine and the Avid shared-storage server are
connected appropriately; for example, the Avid Interplay Engine needs to read the files
to create thumbnails. If the connection is slow, performance can drop.
Check the speed of file operations of the Avid Interplay Engine on the shared storage
server.
Make sure that the Avid Interplay Engine can move data quickly on the
Avid shared-storage system. Log in to the Interplay Engine server and use Windows
Explorer to transfer files from an Avid shared-storage workspace to the Interplay Engine
server. The speed performance of these operations should be independent of file size and
instantaneous. Make sure the connectivity and credentials are correct.
The list of servers does not appear, for example, when you are connecting to a new
database.
Cause
These problems can be caused by personal firewalls installed on the client machine. A
typical example for such a firewall is ZoneAlarm from ZoneLabs or the Windows XP
firewall.
These applications intercept all outgoing and incoming network traffic and decide whether
to let the traffic go through or block it. The effect is that applications like Avid Interplay fail
to connect to their servers.
203
8 Troubleshooting
Typically when the client looks for available Avid Interplay Engines in the network, no
servers can be retrieved. When the client is looking for servers, a UDP broadcast is sent out
on port 8321.
Solution
Usually these personal firewalls can be configured to allow all network traffic for specific
applications. This should be done for Avid Interplay locally or for Internet access depending
on which servers Avid Interplay should connect to.
For information about ports used by Avid Interplay, see Required TCP/IP Ports on
page 241 and Interplay Port Usage in the Avid Interplay Software Installation and
Configuration Guide.
The Server Execution User account is different from the Interplay Administrator account.
The Server Execution User account is used to run the Interplay Engine processes.The
Interplay Administrator account is used to manage users and the database.
The following topics provide more information about the Server Execution User account:
n
204
You should always use the Custom install option when installing the Interplay Engine
software so that you can specify the Server Execution User.
You have the following options for creating the Server Execution User:
If your Interplay system is joined to a Windows domain, you can create a domain user
(for example, IPEngine). The Interplay Engine installer will associate the appropriate
permissions with the account. If you want to run the Avid Interplay Engine within your
domain and also want to automatically make use of domain user management, such as
Windows Domain or LDAP, you must specify a domain user as the Server Execution
User.
For Interplay Engine failover cluster systems, you must specify a Windows domain user.
You have the option of allowing the Interplay Engine installer to create the account.
Select a name before the installation and specify the name and a password during the
installation. The installer will create a local user in the Administrators group with the
appropriate permissions.
You can also create a local Administrator account manually and specify that account
during the installation. The account must have local administration rights on the
operating system for the Interplay Engine server (both nodes on a cluster system). The
account must have the following local security policy settings set to enabled:
-
Log on as a service
Debug programs
An account with an identical user name and password must have read/write access to the
Avid shared storage workspaces that contain media (including the workspace used for file
asset sources in a split database). Use the Avid ISIS or Avid Unity MediaNetwork
Administration tool to create this account.
When you install the Interplay Engine or the Interplay Archive Engine, do not select
the default Server Execution User. Create a custom user instead. The default user
account is AVID_WORKGROUP_USER. Do not use this account.
Ideally the Server Execution user should be an account that users do not use to log onto the
system. This prevents accidental changes to the Server User Account during normal
administration duties. For example, if someone changes the password by mistake, users
might not be able to access the Interplay database.
205
8 Troubleshooting
For security reasons, do not use the Interplay Engine server operating system Administrator
account. Create a unique account that you use only as the Server Execution User. For
example, you can create an administrative account called IPEngine. Avoiding the word
Administrator can help indicate that this account is not used for normal administrative tasks.
The Server Execution User account is different from the Interplay Administrator account.
The Server Execution User account is used to run the Interplay Engine processes. The
Interplay Administrator account is used to manage users and the database.
Run the cluster-aware version of the NXNServerUser tool (see Re-creating the
Server Execution User on page 207).
Use the Custom install option when you upgrade the Interplay Engine software.
6. (Cluster only) In the list of services, right-click Avid Workgroup Engine Monitor, select
Properties, and click the Log On tab. This is the Windows user account that is running
the Avid Workgroup Engine Monitor service. If this account does not match the Avid
Workgroup TCP COM Bridge account and the Cluster Service account, do one of the
following:
206
Run the cluster-aware version of the NXNServerUser tool (see Re-creating the
Server Execution User on page 207).
Use the Custom install option when you upgrade the Interplay Engine software.
See the Avid Interplay ReadMe for more information about upgrading and troubleshooting a
cluster system.
Make sure that you use the correct password for the specified user because the tool cannot
verify the password.
The tool changes the execution user settings for the following servers and services:
-
Avid Interplay Engine Server: The Avid Interplay Engine Server runs under the
specified account. The NxNServerUser tool changes the corresponding DCOM
settings. You can verify that the new user has been set using the dcomcnfg tool as
described in Avid Interplay Engine Server on page 242.
Avid Interplay TCP/COM Bridge: The Avid Interplay TCP/COM Bridge Service
runs under the specified account. You can verify that the new user has been set in
the service control panel tool as described in Required TCP/IP Ports on page 241.
Impersonation of Apache Modules: The Apache modules that need to access files
on the file server are impersonated to the specified user account (see Avid
Workgroup HTTP Server on page 243 and Avid Workgroup Preview Server
Service on page 244). You can verify that the new user and the encrypted password
has been set in the following registry keys:
-
8 Troubleshooting
(Cluster Only) Avid Interplay Engine Monitor: The Avid Interplay Engine Monitor
Service runs under the specified account. You can verify that the new user has been
set in the service control panel.
(Cluster Only): Cluster Service: The Windows Cluster Service runs under the
specified account. You can verify that the new user has been set in the service
control panel.
208
Lock the server using NxNServerLock.exe in the Avid Interplay Engine installation
directory.
Lock the server using the Lock Server view in the Interplay Administrator. See
Locking and Unlocking the Server on page 84.
Shut down the server using NxNServerShutdown.exe in the Avid Interplay Engine
installation directory.
Storing the file repository of a large Interplay database on ISIS shared storage in a
split-database configuration might reduce the maximum number of media files you can store
on the ISIS system. If the number of assets in your Interplay database might exceed 50,000,
contact your Avid representative for a recommendation.
The following topics provide information about this configuration:
Supported Configurations
A metadata database, which the Interplay Engine uses to store metadata for all assets.
These assets can include both Avid assets and file assets. (File assets include Photoshop
files, Microsoft Office files, and other files that are not created through Avid systems.)
A file repository, which holds the source files for file assets, streamed properties for
Avid assets (such as head frames and AAF information),and other files.
If the Interplay Engine server does not have adequate local storage for your Interplay
database, you can configure the Interplay Engine to store only the metadata database on the
Interplay Engine. All other database files and folders can be stored on an Avid
shared-storage workspace. This configuration is called a split database.
Storing the file repository of a large Interplay database on ISIS shared storage in a
split-database configuration may reduce the maximum number of media files you can store
on the ISIS system. If the number of assets in your Interplay database might exceed 50,000,
contact your Avid representative for a recommendation.
If your Interplay system uses a cluster configuration, it includes a large amount of local
storage space, and a split database is probably not necessary.
The following illustration shows the metadata database stored on the internal drive of the
Interplay Engine server and the source files for the assets stored on Avid shared-storage
workspaces.
File Assets
Metadata
Database
Streamed
Properties
Media for
Avid Assets
210
Supported Configurations
In a split database, source files for file assets and streamed properties for Avid assets are
stored on a shared storage workspace. Media files for Avid assets, such as .mxf files, are
always stored on a shared storage workspace.
Relationship Between the File Repository and the Metadata Database
The file repository contains folders that hold the file versions created through importing and
checking in files, as well as other files such as preview images and head frames of clips. The
metadata database contains the information needed by the Interplay Engine to access the
files in the database, and stores metadata about the files.
For a description of the files that make up the database, see Avid Interplay Databases,
Folders, and Files on page 33.
You can configure your system to store the file repository on shared storage. However, for
performance and reliability reasons, Avid requires that the metadata database be stored on
the server running the Interplay Engine. If the metadata database is stored on an external file
server, network problems or unavailability of the shared storage server causes the Interplay
Engine to lock the databases because it cannot write changes persistently.
Methods for Splitting a Database
Specify how to split the database before you first create it.
In either case, you need to prepare the shared storage workspace before you split the
database. These procedures are described in the following topics:
Supported Configurations
The following table summarizes the supported configurations for the Interplay Engine.
211
Metadata Location
File Repository
Location
Supported
Comments
Yes
No
No
No
Select an Avid shared-storage workspace to store the source files for file assets (file
repository).
212
2. Make sure that the Server Execution User has full access to the Avid shared-storage
workspace.
The Server Execution User is usually a domain user, such as \\MYDOMAIN\IPEngine.
In this case, create a user on the Avid shared-storage system that has the identical name
and password as the domain user and the Server Execution User. For more information,
see Creating the Server Execution User Account on page 204.
3. Set read-only access on the workspace for all users that will connect to the Interplay
Engine. Users will be able to edit local copies on their client systems.
1. Prepare the shared storage workspace, as described in Preparing for a Split Database
on page 212.
2. Install the Interplay Engine. During the installation process, accept the default share on
the Interplay Server as the database location.
3. Edit the workgroup.xml file to include the path for the shared storage workspace (see
Configuring the workgroup.xml File on page 219).
4. Open the Interplay Administrator.
5. In the Server section of the Interplay Administrator window, click Server Settings.
The Server Settings view opens. This view shows the settings for two root folders: one
for the metadata database and one for the data (file assets). Leave the root folder for the
database unchanged.
6. In the text box labeled Root folder for data (Assets), type the UNC path or browse to
the Avid shared-storage workspace you want to use as a file repository for the file assets.
The following screen capture shows an example.
-
213
214
10. Accept the Database Name, type a description, and click Create.
The new database is created.
-
You should find the database folder on the Interplay Engine, for example
D:\Workgroup_Databases\AvidWG\_Database.
You should find the file repository on the Avid shared-storage workspace, for
example \\AAC-ISIS\File_Assets\AvidWG. The AvidWG folder should contain
_Master and other database folders and files.
11. In the Schedule Backups view of the Interplay Administrator, change the backup
location to an external file server.
By default, the _Backup folder is now located on the shared storage workspace. To
avoid filling up the workspace with backups, select Custom and specify the UNC path
for a different external file server. Make sure the Server Execution User has read/write
access to this external file server.
During the installation of the Interplay Engine, a shared folder for the database is created
on the Interplay Engine server. In the Interplay Administrator this folder is displayed as
WG_Database$, which is a hidden share name and not an actual folder. By default the
folder is named D:\Workgroup_Databases (non-cluster systems) or
S:\Workgroup_Databases (cluster systems). For more information, see Identifying the Root
Folder of the Interplay Server Database on page 220.
The following procedure refers to two different types of backups:
Interplay database backup: A backup copy of the Interplay database created by the
automated backup system built into the Interplay Engine. For more information, see
Creating and Restoring Database Backups on page 36.
Archive database backup: A copy of the Interplay database manually created by using a
third-party tool that can handle long path names (longer than 256 characters). Two
examples are Robocopy (contained in rktools.exe, available on Microsoft.com) and
7-Zip. For more information, see Using an Archiving Tool for Backup on page 46 and
documentation for the third-party tool.
215
If you create an archive backup, keep in mind that creating a complete archive backup
can take several hours. You must lock and deactivate the database before creating the
archive. You can save time by removing old backups from the _Backup folder, located
by default in \\IEServer\WG_Database$\AvidWG\_Backup.
To split an existing database:
b.
c.
b.
c.
Click Deactivate.
216
This folder name (AvidWG) must exactly match the name of the corresponding folder
on the Interplay Engine server.
9. Copy all files and folders except the _Database folder from
\\IEServer\WG_Database$\AvidWG to the new location
\\SharedStorageServer\WorkspaceName\AvidWG.
Windows Explorer cannot copy paths longer than 256 characters or Unicode names that
are not in the default operating system language. If the database includes either or both
of these items, use a tool such as Robocopy or 7-Zip.
After copying the files and folders, delete them from the original location (or rename
them), so that this location contains only the _Database folder. The following
illustration shows both locations: the metadata database on the Interplay Engine and the
file repository on the shared storage workspace.
11. Make sure the file includes the correct path for the _Database directory. It should
include the line
<Path>\\IEServer\WG_Database$\AvidWG\_Database</Path>
For IEServer, substitute the network name for the Interplay Engine server. This path
points to the metadata database on the Avid Interplay Engine.
If the FolderLocations.xml file does not exist on the workspace, or it is empty, use a text
editor or an XML editor to create the file in the folder AvidWG.
Add the file location information as follows:
<XML>
<Folder Name="_Database">
<Path>\\IEServer\WG_Database$\AvidWG\_Database</Path>
</Folder>
</XML>
For IEServer, substitute the network name for the Interplay Engine server. Be sure to
use a UNC path. The Interplay Engine effectively maps it to a local path if possible.
Make sure to type this information accurately. Errors in the file can prevent you from
activating the database. XML files are case sensitive. Make sure that a text editor does
not automatically change the XML tags to lower case.
12. Activate the database:
a.
b.
In the Database (.pro) file to activate text box, type the full UNC path to the .pro
file, which now resides on the shared storage workspace. For example:
\\SharedStorageServer\WorkspaceName\AvidWG\AvidWG.pro.
You can also navigate through the network to select the file. For example, open My
Network Places > Entire Network > Avid ISIS Network. Then navigate to
\\SharedStorageServer\WorkspaceName\AvidWG\AvidWG.pro
c.
218
a.
b.
c.
d. After reconnecting to the database with Interplay Access, check if the file is still in
the database.
14. In the Schedule Backups view of the Interplay Administrator, change the backup
location to an external file server.
By default, the _Backup folder is now located on the shared storage workspace. To
avoid filling up the workspace with backups, select Custom and specify the UNC path
for a different external file server. Make sure the Server Execution User has read/write
access to this external file server.
15. (Option) In the Server Settings view of the Interplay Administrator, specify the path for
the shared storage workspace as the root folder for data, as described in step 6 in
Splitting a Database for New Interplay Installations on page 213.
On a cluster system, the following file might be installed on both nodes: C:\Program
Files\Avid\Avid Interplay Engine\Data\Apache\conf\workgroup.xml. These files are not
currently used and do not need to be edited.
The default database location that you specified during the Interplay Engine installation is
published through this file as a default. The following example shows the section of
workgroup.xml that includes the database location:
<filetransfer>
<path read="true" write="true>
\\IEServer\WG_Database$
</path>
</filetransfer>
For IEServer, substitute the network name for the Interplay Engine server.
219
If you move the file repository to a different location, this location must be published in this
file as well. For example:
<filetransfer>
<path read="true" write="true>
\\IEServer\WG_Database$
</path>
<path read="true" write="true>
\\SharedStorageServer\WorkspaceName
</path>
</filetransfer>
For SharedStorageServer, substitute the network name for the Avid ISIS System Director or
the Avid Unity MediaNetwork File Manager. For WorkspaceName, substitute the workspace
you designated for the file repository. For example, \\AAC-ISIS\File_Assets.
1. Log onto the Interplay server (local computer) with an administrative account.
2. Open a Command Prompt by clicking All Programs and selecting Accessories >
Command Prompt.
3. Type the following command at the Windows Command line:
net share
All shares on the system are displayed, along with their paths, as shown in the following
illustration:
220
Database
root
folder
The _Database folder is located in the AvidWG folder on the Interplay Engine server
The remaining folders and files are located in the AvidWG folder on a shared storage
workspace
221
The following illustration shows all database files located in the same AvidWG folder on the
Interplay Engine server.
222
In a correctly split database, the AvidWG folder on the Interplay Engine should
contain only the _Database folder. If the AvidWG folder on shared storage includes a
_Database folder, do not copy this folder to the Interplay Engine. Rename this folder
_Database_UNUSED or something similar before copying the other content to the
Interplay Engine.
In some configurations, the _InternalData folder (which holds user metadata) might also be
located on the shared storage workspace, or might be split between the Interplay Engine and
the shared storage workspace. This folder should be located in \\IEServer\WG_Database$,
for example, D:\Workgroup_Databases, as shown in the following illustration.
223
If the _InternalData folder is already located on the Interplay Engine, see Reuniting a
Split Database (AvidWG Only) on page 224.
If the _InternalData folder is located on a shared storage workspace, or split between the
Interplay Engine and shared storage, see Reuniting a Split Database (AvidWG and
_InternalData) on page 227.
Interplay database backup: A backup copy of the Interplay database created by the
automated backup system built into the Interplay Engine. For more information, see
Creating and Restoring Database Backups on page 36.
Archive database backup: A copy of the Interplay database manually created by using a
third-party tool that can handle long path names (longer than 256 characters). Two
examples are Robocopy (contained in rktools.exe, available on Microsoft.com) and
7-Zip. For more information, see Using an Archiving Tool for Backup on page 46 and
documentation for the third-party tool.
If you create an archive backup, keep in mind that creating a complete archive backup
can take several hours. You must lock and deactivate the database before creating the
archive. You can save time by removing old backups from the _Backup folder, located
by default in \\IEServer\WG_Database$\AvidWG\_Backup.
1. If you are working on a cluster system, make sure that cluster services that provide the
local S drive are running.
2. Lock the database to make sure that no user can access it:
a.
b.
c.
224
a.
b.
c.
Click Deactivate.
\\SharedStorageServer\WorkspaceName\AvidWG
\\IEServer\WG_Database$\AvidWG
By default, this folder is
D:\Workgroup_Databases\AvidWG (non-cluster system)
S:\Workgroup_Databases\AvidWG (cluster system)
_Backup folder
_Buckets folder
_CheckIn folder
_Handover folder
_Import folder
_Master folder
_PropertyHandover folder
_PropertyStore folder
_AvidWG.nif
Aliasconfig.xml
225
Copy from
\\SharedStorageServer\WorkspaceName\AvidWG
to
\\IEServer\WG_Database$\AvidWG
AvidWG.pro
FolderLocations.xml
In a correctly split database, the AvidWG folder on the Interplay Engine should
contain only the _Database folder. If the AvidWG folder on shared storage includes a
_Database folder, do not copy this folder to the Interplay Engine. Rename this folder
_Database_UNUSED or something similar before copying the other content to the
Interplay Engine.
6. Delete or rename \\IEServer\WG_Database$\AvidWG\FolderLocations.xml.
7. Edit the workgroup.xml file to include only the following path:
\\IEServer\WG_Database$
See Configuring the workgroup.xml File on page 219.
8. Activate the database:
a.
b.
In the Database (.pro) file to activate text box, type the full UNC path to the .pro
file, which now resides on the Interplay Engine server. For example:
\\IEServer\WG_Database$\AvidWG\AvidWG.pro.
c.
If the database is activated, its name is displayed in the Databases list. The database is
automatically unlocked.
9. Check the backup location in the Schedule Backups view of the Interplay Administrator.
If the _Backup folder was located on shared storage, it is now located on the Interplay
Engine. If necessary, change the location to the Interplay Engine or to another external
file server.
10. In the Server Settings view of the Interplay Administrator, make sure the path for the
Root folder for data matches the path for the Root folder for database.
This location is used if you create a new database.
11. Test the setup by doing the following:
226
a.
b.
c.
d. After reconnecting to the database with Interplay Access, check if the file is still in
the database.
12. If the test is successful, delete or rename the folder
\\SharedStorageServer\WorkspaceName\AvidWG.
1. If you are working on a cluster system, make sure that cluster services that provide the
local S drive are running.
2. Lock the database to make sure that no user can access it:
a.
b.
c.
b.
c.
Click Deactivate.
On a cluster system, bring the Avid Workgroup Engine Monitor resource (not the
resource group) offline.
On a non-cluster system, stop the services Avid Workgroup TCP COM Bridge and
the service Avid Workgroup Server Browser and run C:\Program Files\Avid\Avid
Interplay Engine\Server\NxNServerShutdown.exe.
For more information on Interplay Engine services, see Avid Interplay Engine Servers
and Services on page 241.
227
6. If you do not have a complete Interplay database backup available, manually create an
archive backup from both database locations:
-
\\SharedStorageServer\WorkspaceName\AvidWG
\\IEServer\WG_Database$\AvidWG
By default, this folder is
D:\Workgroup_Databases\AvidWG (non-cluster system)
S:\Workgroup_Databases\AvidWG (cluster system)
_Backup folder
_Buckets folder
_CheckIn folder
_Handover folder
_Import folder
_Master folder
_PropertyHandover folder
_PropertyStore folder
_AvidWG.nif
Aliasconfig.xml
AvidWG.pro
228
Copy from
\\SharedStorageServer\WorkspaceName\AvidWG
to
\\IEServer\WG_Database$\AvidWG
FolderLocations.xml
In a correctly split database, the AvidWG folder on the Interplay Engine should
contain only the _Database folder. If the AvidWG folder on shared storage includes a
_Database folder, do not copy this folder to the Interplay Engine. Rename this folder
_Database_UNUSED or something similar before copying the other content to the
Interplay Engine.
8. Use Windows or a tool that can copy long path names to copy the _InternalData folder
from
\\SharedStorageServer\WorkspaceName
to
\\IEServer\WG_Database$
If the contents of the folder are split between the Interplay Engine and the shared storage
workspace, copy the files and folders listed in the following table.
Copy from
\\SharedStorageServer\WorkspaceName\_InternalData
to
\\IEServer\WG_Database$\_InternalData
_Backup folder
_Buckets folder
_CheckIn folder
_Handover folder
_Import folder
_Master folder
_PropertyHandover folder
_PropertyStore folder
_AvidWG.nif
Aliasconfig.xml
229
Copy from
\\SharedStorageServer\WorkspaceName\_InternalData
to
\\IEServer\WG_Database$\_InternalData
AvidWG.pro
FolderLocations.xml
If the _InternalData folder on shared storage includes a _Database folder, do not copy
this folder to the Interplay Engine. Rename this folder _Database_UNUSED or
something similar before copying the other content to the Interplay Engine.
9. Delete or rename \\IEServer\WG_Database$\AvidWG\FolderLocations.xml.
10. Delete or rename \\IEServer\WG_Database$\_InternalData\FolderLocations.xml.
11. Edit the workgroup.xml file to include only the following path:
\\IEServer\WG_Database$
See Configuring the workgroup.xml File on page 219.
12. Open a Command Prompt window, type regedit, and navigate to one of the following:
-
Check the UNC paths for RecentProject1 and RecentProject2. Both paths should show
the Interplay Engine server, as shown in the following illustration.
230
On a cluster system, bring the Avid Workgroup Engine Monitor resource (not the
resource group) online.
On a non-cluster system, start the services Avid Workgroup TCP COM Bridge and
the service Avid Workgroup Server Browser.
b.
In the Database (.pro) file to activate text box, type the full UNC path to the .pro
file, which now resides on the Interplay Engine server. For example:
\\IEServer\WG_Database$\AvidWG\AvidWG.pro.
c.
If the database is activated, its name is displayed in the Databases list. The database is
automatically unlocked.
15. Check the backup location in the Schedule Backups view of the Interplay Administrator.
If the _Backup folder was located on shared storage, it is now located on the Interplay
Engine. If necessary, change the location to the Interplay Engine or to another external
file server.
16. Test the setup by doing the following:
a.
b.
c.
d. After reconnecting to the database with Interplay Access, check if the file is still in
the database.
17. If the test is successful, delete or rename the folder
\\SharedStorageServer\WorkspaceName\AvidWG.
231
232
Apache: This folder includes an Apache server to provide access to Preview images and
to provide client access. See Apache Folder on page 233.
Data: This folder contains all server-relevant configuration and data files. See Data
Folder on page 236.
Logs: This folder contains the log files written by the Avid Interplay Engine. See Logs
on page 236.
NxN: This directory contains services and modules for the Apache server.
PreviewServer: This directory contains a tool for cleaning the Preview Server cache. See
Preview Server Folder on page 240.
Server: This directory contains all data to execute an Avid Interplay Engine on this
machine. See Server Folder on page 241.
Apache Folder
The Apache web server handles every incoming request and forwards them to the database
server. The Apache folder includes important logs from the Apache process.
Description
Apache\logs\error.log
Apache\logs\access.log
New log entries are appended to the log files, which makes them grow over time. The log
files are not deleted automatically. This must be done manually, if required.
error.log
This log file contains error messages and notices. An entry is received, for example, if a
connection to the TCP/COM bridge failed. An entry is also created when a client logged in
or logged off. The entries in this case look similar to the following:
[Thu Mar 14 18:24:07 2002] [notice] logon request received, session
'bad5781de4bd712b8bf49c7376de3cd4:1016126647' created
[Thu Mar 14 18:43:45 2002] [notice] logoff request for session
'bad5781de4bd712b8bf49c7376de3cd4:1016126647' received
A logon entry is always created when a client logs on, while a logoff entry is only created if
the client performs a clean logout. No logoff entry is created if, for example, the network
connection is interrupted.
access.log
The access.log file contains a log of every incoming request similar to the following:
192.168.1.199 - - [22/Jan/2002:21:11:49 +0100] "POST /nxn/workgroup/http
HTTP/1.1" 200 172
234
The IP address of the machine where the request was coming from;
The request method (GET or POST), the request URI and any request parameters;
The returned status codes are the standard HTTP codes as described in RFC 2616 available
under http://www.ietf.org/rfc/rfc2616.txt. Some of the important values are:
404 Not found: The server has not found anything matching the requested URI.
The creation of the access.log file is by default deactivated for performance and space
reasons.
or
#CustomLog logs/access.log combined
235
Data Folder
The Data folder contains server-relevant configuration and data files, including the following
Apache modules and configuration files used by the Avid Interplay Preview Server and Avid
Interplay HTTP Server.
File Path (C:\Program
Files\Avid\Avid Interplay Engine)
Description
Data\Apache\conf\httpd.conf
Data\Apache\conf\workgroup.xml
Data\TCPCOMBridge\ServerXML.xml
Logs
The Logs folder contains the following logs:
File Path (C:\Program
Files\Avid\Avid Interplay Engine) Description
236
Logs\Machines\[COMPUTER
NAME]\AvDeletes.log
Logs\Machines\[COMPUTER
NAME]\AvMetaDataDelete.log
Logs\Machines\[COMPUTER
NAME]\AvMoveEx.log
Logs\Machines\[COMPUTER
NAME]\NxNServer.log
Logs\Machines\[COMPUTERNAME]\
NxNTCPCOMBridge.log
Logs\Machines\[COMPUTERNAME]\
NxNBackup.log
In Interplay version 1.6 and later, the Interplay Engine compresses and archives log files
older than 7 days. The log compression process runs during project backup. For more
information see Restoring Archived Log Files on page 60.
AvDeletes.log
The AvDeletes.log file includes the following information about media delete operations:
Computer name of the machine on which the delete operation was performed
Name and path of the media files deleted, with deletion time in milliseconds (ms)
237
AvDeletes.log
q
w
[Mon May 25 14:02:29 2009] User 'airspeed' on host 'muc-ifsputnik' deleting media
for:
[Mon May 25 14:02:29 2009]
/Projects/ETPB1/INCOMING1/VIEWCUT_7151_MEDEA_020809_JT
[Mon May 25 14:02:29 2009] Media locations:
[Mon May 25 14:02:29 2009]
Successfully deleted file //caetavdisis/feeds_a/avid
mediafiles/mxf/tm_caetavdetpb-1/etpb_1v01d015d6.mxf 57 ms
[Mon May 25 14:02:29 2009]
Successfully deleted file //caetavdisis/feeds_a/avid
mediafiles/mxf/tm_caetavdetpb-1/etpb_1a01d015d6.mxf 25 ms
[Mon May 25 14:02:29 2009]
Successfully deleted file //caetavdisis/feeds_a/avid
mediafiles/mxf/tm_caetavdetpb-1/etpb_1a02d015d6.mxf 25 ms
[Mon May 25 14:02:29 2009]
Successfully deleted file //caetavdisis/lowres/Avid
MediaFiles/MXF/CAETAVDTC02.1/VIEWCUT_7151_MEDEA_498FCF9C.mxf 25 ms
[Mon May 25 14:02:29 2009] User 'airspeed' on host 'muc-ifsputnik' deleting media
for:
[Mon May 25 14:02:29 2009]
/Projects/ETPB-1/INCOMING1/ccut street song recut
012809
[Mon May 25 14:02:29 2009] Media locations:
[Mon May 25 14:02:29 2009]
Successfully deleted file //caetavdisis/Feeds_A/Avid
MediaFiles/MXF/TM_caetavdetpb-1/ETPB_1V01249C352.mxf 25 ms
[Mon May 25 14:02:29 2009]
Unable to delete file //caetavdisis/Feeds_A/Avid
MediaFiles/MXF/TM_caetavdetpb-1/ETPB_1A01249C352.mxf (net path not found 0x35) 0
ms
[Mon May 25 14:02:29 2009]
Successfully deleted file //caetavdisis/Feeds_A/Avid
MediaFiles/MXF/TM_caetavdetpb-1/ETPB_1A02249C352.mxf 25 ms
q Date, time, user login, and host system for the delete operation
w Name and path of master clip deleted
e Names and paths of four media files successfully deleted, with deletion time in milliseconds (ms)
r Failure to delete one object with Windows error net path not found 0x35
AvMetaDataDelete.log
The AvMetaDataDelete.log includes the following information about metadata delete
operations:
Computer name of the machine from on the delete operation was performed
Display name, object handle, and path for every deleted object, grouped by path
If an object could not be deleted, the error code (for example, a reservation)
238
q
w
e
r
t
[Mon May
data:
[Mon May
[Mon May
[Mon May
[Mon May
14:02:39
14:02:39
14:02:39
14:02:39
2009]
2009]
2009]
2009]
From '/Projects/ETPB-1/INCOMING1/'
'ET_VCT_7143_US_MICHELLE_5A_CY' handle 163841
'VIEWCUT_7151_MEDEA_020809_JT.tr' handle 758621
'IN_VIEWCUT_STREETSONG_FINAL 012' handle 1260969
q Date, time, user login, and host system for the delete operation
w Name of the folder that holds the deleted objects
e Names and object handles of three objects successfully deleted
r Name and object handle of an object that could not be deleted with error 0x899901a6 (Object is still referencing
media and cannot be deleted).
AvMoveEx.log
The AvMoveEx.log includes the following information:
Computer name of the machine on which the move operation was performed
Mime type (master clip, sequence, and so on), display name, object handle, and source
and target path of the moved objects
If the objects are sequences or subclips, the deleted and created proxies and references
239
AvMoveEx.log
q
w
e
r
Fri May 29 11:02:45 2009] User 'airspeed' on host 'muc-ifsputnik' moving masterclip 'Flash 1.mov' handle 1962859:
[Fri May 29 11:02:45 2009]
From '/Projects/DAILY PROJECTS/ETS PROJECTS/ETS DAILY
PROJECTS/DONT_DELETE/LIGHT LEAKS ETC/'
[Fri May 29 11:02:45 2009]
To
'/Projects/AOT/Test/'
[Fri May 29 11:03:08 2009] User 'airspeed' on host 'muc-ifsputnik' moving sequence
'President' handle 538510:
[Fri May 29 11:03:08 2009]
From '/Projects/AOT/Test/'
[Fri May 29 11:03:08 2009]
To
'/Projects/DAILY PROJECTS/ETS PROJECTS/ETS DAILY
PROJECTS/DONT_DELETE/LIGHT LEAKS ETC/'
[Fri May 29 11:03:09 2009] Proxies & References deleted at '/Projects/AOT/Test/'
during move:
[Fri May 29 11:03:09 2009]
'President' handle 538510
[Fri May 29 11:03:09 2009]
'President.Voice Over.1' handle 1108345
[Fri May 29 11:03:09 2009] Proxies & References created at '/Projects/DAILY
PROJECTS/ETS PROJECTS/ETS DAILY PROJECTS/DONT_DELETE/LIGHT LEAKS ETC/' during
move:
[Fri May 29 11:03:09 2009]
'President' handle 2799799
[Fri May 29 11:03:09 2009]
'Channel 4 News @ 5' handle 69537
[Fri May 29 11:03:09 2009]
'President.Voice Over.1' handle 376256
q Date, time, user login, host system, and name and object handle of the master clip being moved
w Path the clip is being moved from
e Path the clip is being moved to
r Date, time, user login, and name of sequence being moved
t Proxy files and reference clips deleted and recreated for the sequence
240
Server Folder
The Server folder contains the Avid Interplay Engine Server installation.
File Path (C:\Program
Files\Avid\Avid Interplay Engine) Description
Server\Machines\[COMPUTER
NAME]\MachineConfig.ini
Server\Config\Config.xml
241
The Avid Interplay Engine Server is the central process where all assets and asset
meta-information are managed. See Avid Interplay Engine Server on page 242.
The Avid Workgroup HTTP Server is a module for the Apache server that allows clients
to connect to the Avid Interplay Engine Server using a HTTP protocol. See Avid
Workgroup HTTP Server on page 243
Four services are installed on the Interplay Engine. You can view these services through the
Control Panel (Click Start and select Control Panel > Administrative Tools > Services):
Avid Workgroup Server Browser service: This service makes the Avid Interplay Engine
visible to the network. It answers requests on the 8313 port, which are called from the
clients. See Avid Workgroup Server Browser Service on page 244.
Avid Workgroup Preview Server service: This service is an Apache web server. It
provides the thumbnail images for the Preview facility and the client connection
interface. See Avid Workgroup Preview Server Service on page 244.
Avid Workgroup TCP COM Bridge service: This service provides a bridge from TCP
calls to the Avid Workgroup COM interface. See Avid Workgroup TCP/COM Bridge
Service on page 248.
Avid Workgroup VSS service: This service provides backup functionality to the Avid
Interplay Engine (Interplay version 2.1 and later only). See Avid Workgroup VSS
Service on page 249.
Avid Workgroup Engine Monitor: This service starts the Engine Server process and
monitors the health of the Engine Server, Apache HTTP Server, and TCP/COM Bridge
components (Interplay version 2.3 and later only) See Avid Workgroup Engine Monitor
Service on page 250.
The database files, as well as the assets, can be backed up while the Interplay Engine is
running. For details, see Creating and Restoring Database Backups on page 36.
242
Processes
Do not change the settings using the DCOM configuration tool. Instead, use
NxNServerUser.exe to change the user under which the Avid Interplay Engine Server
and other servers and services run. See Troubleshooting the Server Execution User
Account on page 204.
Windows Services
The Avid Interplay Engine Server must run on a Windows Server 2003 or Windows
Server 2008. For additional hardware requirements, see the Avid Interplay Software
Installation and Configuration Guide.
The user under which the Avid Interplay Engine Server runs (the Server Execution
User) needs to have full read/write access to the database directory and to the Avid
shared-storage workspaces.
243
The Avid Workgroup Server Browser is started automatically at system startup. This service
always runs under the local system account. The main task of this service is to start the main
Avid Interplay Engine process (NXNServer.exe). In order to access files on the file server,
the main Interplay Engine process needs to run under a user account that has access to the
file server.
Requirements
The Avid Workgroup Server Browser must run on the same machine as the Avid
Interplay Engine Server.
244
On both the Preview Server and on the local machine, cache directories keep the generated
previews.
On the Preview Server: in the directory you specified during installation, by default
\\IEServer\\WG_Database$\PreviewServer\Cache.
The Preview Server is accessed only from clients via HTTP. It uses the default port 80.
Make sure that no other application allocates port 80. For example, IIS might be installed as
the default HTTP server. In this case, deactivate the corresponding application.
Processes
There are two processes of Apache.exe running. One of them is a watchdog whose only task
is to make sure that the main Apache process is running. The main Apache process serves
the preview requests of port 80.
The Avid Workgroup Preview Server must run on the same machine as the Avid
Interplay Engine Server.
Since the Avid Workgroup Preview Server needs to access the files on the file server
during thumbnail rendering, a user with appropriate access rights must be impersonated
for each preview action. To ensure that the impersonated user can access the files, we
strongly advise setting it to the same user under which the Avid Interplay Engine Server
runs.
245
The user name and encrypted password for the impersonation is stored in the following
registry keys:
Change the impersonation settings for the Avid Interplay Preview Server with the
NXNServerUser.exe tool only. See Troubleshooting the Server Execution User
Account on page 204.
Configuring the Preview Service
The Preview Service is responsible for the generation of thumbnails and preview images on
the server, as well as delivering them to the Interplay application.
All settings can be edited in the workgroup.xml file in the <preview><settings /> section.
This file is located in the Interplay Engine installation directory, for example,
246
The settings should look similar to the following. Default settings are shown; the actual file
references the locations you specified during installation:
<settings
CacheRoot="C:\WG_Database$\PreviewServer/Cache"
IconRoot=C:\Program Files\Avid\Avid Interplay
Engine\Data\Apache/icons"
ServerEnableDiskGuard="yes"
ServerCacheMinFreeDiskSpace="250mb"
ThumbnailImageFormat="png"
ThumbnailsUseAlpha="yes"
PreviewsUseAlpha="yes"
/>
The Preview Server reads the settings from this file when the service is started. This means
settings become active only after you restart the Preview Server. You can do this without
restarting the whole machine by restarting the service Avid_Workgroup_Preview_Server.
Select Control Panel > Administrative Tools > Services, double-click the service, and click
Start.
Description of Preview Generation Settings in workgroup.xml
CacheRoot: Path where previews and thumbnails generated by the preview server are
stored. This location is used by the preview server to create a cache of converted images.
The preview server can reuse those images for subsequent requests from any client. To
ensure best performance, this path should reside on a disk that has enough free space
available to hold a reasonable working set of cached images. While the default is inside
of the database directory of the Avid Interplay Engine, it is a good idea to place it on a
different disk.
IconRoot: Path to a directory where a set of icons is stored, usually pointing into the
Avid Interplay Engine installation directory. The icons stored here are used by the
Preview Server if, for example, a thumbnail generation failed or if an asset has an
unknown format or is not an image/video file.
247
Generated thumbnails never contain any alpha information. This setting only renders the
alpha channel into the normal image data.
PreviewsUseAlpha: If yes, generated preview images are delivered to the client with
the alpha channel included (if it is actually displayed is a client option). Use no to
generate previews without any alpha channel information.
The service Avid Workgroup TCP COM Bridge is automatically started at system startup
and should be running all the time.
248
Requirements
The Avid Workgroup Server Browser must run on the same machine as the Avid
Interplay Engine Server.
The Avid Workgroup TCP/COM bridge needs to run under the same user account as the
Avid Interplay Engine Server. To check under which user the bridge runs, use the
Windows Services Control Panel.
To check the user account, click Start, click Run, and type services.msc. Right-click
Avid Workgroup TCP COM Bridge and select Properties. In the Log On tab, the This
Account option should display the Server Execution User.
Use the tool NXNServerUser.exe to change the Server Execution User. Do not change
the settings in the Control Panel. See Troubleshooting the Server Execution User
Account on page 204.
The VSS Service communicates with the Avid Interplay Engine using standard Operating
System pipes.
Processes
The Avid Workgroup VSS service is automatically started at system startup and should be
running all the time. This service always runs under the local system account. The Avid
Workgroup VSS service requires that the Windows Volume Shadow Copy service is also
running. The Windows Volume Shadow Copy service is installed by default and started
automatically.
249
Requirements
The Avid Workgroup VSS service must run on the same machine as the Avid Interplay
Engine Server.
The Avid Workgroup VSS service requires that the Windows Volume Shadow Copy
service is also running.
250
Processes
The service Avid Workgroup Engine Monitor is started by the cluster resource Avid
Workgroup Engine Monitor.
Requirements
The Avid Workgroup Engine Monitor must run on the same machine as the Avid
Interplay Engine Server. (This is ensured by the Avid Workgroup Server cluster
resource group.)
The Avid Workgroup Engine Monitor needs to run under the same user account as the
Avid Interplay Engine Server. To check under which user the Engine Monitor runs, use
the Windows Services Control Panel.
To check the user account, click Start, click Run, and type services.msc. Right-click Avid
Workgroup Engine Monitor and select Properties. In the Log On tab, the This Account
option should display the Server Execution User.
251
252
If you are moving the file repository to a shared-storage workspace, you need to edit the
workgroup.xml file. See Configuring the workgroup.xml File on page 219.
When the Interplay Engine server sends e-mails, it uses the login of the Server
Execution User. Make sure the mail server is aware of the username and password of
this account (usually a domain account). If the mail server is not aware of this account, it
might reject the e-mail request.
E-mail service might be unreliable if there are too many event notices in a short time
frame. Some events might be dropped. Because a large number of event notices
indicates a problem, the administrator needs to investigate and correct the problem.
Config.xml File
The Avid Interplay Engine reads its event manager settings from a file called Config.xml. By
default, e-mail notification is disabled in the installation program. If you select e-mail
notification during installation, basic settings are created in this file. If you want to add
e-mail notification after installation, you can edit the Config.xml file.
The Config.xml file is located in the Avid Interplay Engine installation directory, for
example, C:\Program Files\Avid\Avid Interplay Engine\Data\Server\Config.
The configuration file is an XML file that has the following format:
<XML>
<Events>
<Event Name=Name of Event>
<Action Name=Name of Action>
<Parameter Name=Name of Parameter>
Value of Parameter
</Parameter>
...
</Action>
<Parameter Name=Name of Parameter>
Value of Parameter
</Parameter>
...
</Event>
<Parameter Name=Name of Parameter>
Value of Parameter
</Parameter>
...
</Events>
</XML>
The <Events> block specifies to which events the Avid Interplay Engine should react. The
<Events> block contains <Event> blocks that specify the names of the events that you want
configured here.
Inside each <Event> block is the <Action> block that specifies the actions to be performed
whenever an event occurs. The attribute Name describes which action is to be performed.
254
The <Parameter> blocks are used to specify the behavior of an action. It is also possible to
identify a parameter by its Name attribute. Parameters are identified by their
Name attributes.
Whenever the server performs an action, it searches the parameters from the inside out,
which means it searches the parameter block inside the <Action> block first and then inside
the <Events> block. This allows you to specify a parameter for all events. Alternatively, you
can specify a parameter for all actions of an event.
Note the following:
When the Interplay Engine server sends e-mails, it uses the login of the Server
Execution User. Make sure the mail server is aware of the username and password of
this account (usually a domain account). If the mail server is not aware of this account, it
might reject the e-mail request.
E-mail service might be unreliable if there are too many event notices in a short time
frame. Some events might be dropped. Because a large number of event notices
indicates a problem, the administrator needs to investigate and correct the problem.
255
SendMail
The SenderMachine parameter specifies the name of the machine on which the server
resides.
The RCPTList parameter contains a comma separated list of valid e-mail addresses. These
addresses should receive an e-mail whenever the server performs an action.
The SenderAddress parameter contains the e-mail address of the sender (the Server
Execution User). The sender should act as the originator of the sent e-mail.
Make sure the mail server is aware of the username and password of this account (usually a
domain account). If the mail server is not aware of this account, it might reject the e-mail
request.
The SMTPServer parameter contains a valid IP address of the mail server to which the
mail is to be sent.
256
The FreeSpace parameter contains a list of numbers that specify the free space on the disk
in megabytes. Whenever the free space falls below one of the specified numbers, it triggers
the server to perform one of the configured actions.
BackupFailed Event
The BackupFailed event is triggered whenever the automatic backup of a database fails,
that is, when the _Database folder cannot be copied to the backup location.
The BackupFailed event is configured with the following XML block:
<Event Name="BackupFailed">
</Event>
To send an e-mail when a BackupFailed event is triggered, use the SendMail action
described in Supported Actions in Config.xml on page 255.
LogEvent Event
The LogEvent event is triggered according to the settings in the LogWatch.xml, in which
an administrator can specify what actions should happen if a severe problem inside of the
Interplay Engine occurs (for example, send an e-mail or shut down the server). The file
allows a rough definition by severity of the problem or a very detailed configuration via the
message ID of the problem.
257
The LogEvent is configured in the Config.xml with the following XML block:
<Event Name="LogEvent">
</Event>
To send an e-mail when a LogEvent event is triggered, use the SendMail action.
See also LogWatch.xml on page 260.
ClusterResourceFailure Event
258
123.123.123.123
</Parameter>
</Events>
</XML>
LogWatch.xml
Log event notifications are configured in LogWatch.xml, located in the Avid Interplay
Engine installation directory:
C:\Program Files\Avid\Avid Interplay Engine\Data\Server\Config.
Edit this file to assign actions for different log events. Actions can be assigned to all message
events of a given severity or to specific events by message IDs.
260
Action
Value
None
Send mail
Shutdown server
ID
Severity
-500
-400
-300
-200
ID
Severity
-100
100
200
To configure how and where the event notification should be sent, see Supported
Actions in Config.xml on page 255.
To send e-mail notification on a specific message event:
261
The message ID is the last number in brackets before the actual message string in the log
file. The message ID of the entry below is 0x00004678. Note that the log file displays
hexadecimal ids. You need to convert the numbers to decimal format before adding to
the message mapping.
[Thu Sep 16 17:27:43 2004] [FATAL] [.\NxNDbServer.cpp
4627]
] [
The message mapping for the error [4678] hex (which is 18040 in decimal) triggering
Send email action looks like the following:
<MessageMappings>
<Mapping MessageID = 18040" Action = "1"/>
</MessageMappings>
Settings you configure in the User Management view through the Avid Interplay
Administrator also apply to the databases (see Managing Database Roles on page 118).
These settings are an additional security layer on top of the Avid Interplay User
Management.
Configuring Access
The <server> token specifies the name of the server on your network that should be visible
to clients connecting to a single server machine. Make sure that all of the database
directories to be accessed are shared and visible on the single server machine.
Through <project> tokens, you specify which databases should be visible to clients
connecting to the single server. The token can have two attributes: name and access.
262
The name attribute specifies the name of the database. This name must be the same as the
name of the database configured in the Active Database List through the Avid Interplay
Administrator. If a database is not in the Active Database List, it cannot be made visible by
specifying its name in <project> token either. You can also use the * as a wildcard
character representing all databases in the Active Database List.
The access attribute specifies the type of access for the database. If it is set to allow,
clients can see the database in the database browser and are allowed to access it. If the
attribute is set to deny, the database is not accessible and is not even visible to the clients.
By default, everything is set to deny.
With the <user> token, you specify which users are allowed to connect to a database. As
with the <project> token, the name and access attributes can also be used here. The
name attribute is the name of a user in the database. The name attribute supports the *
(wildcard) value representing all users.
Database and user settings are inherited from the parent node in the token tree if the settings
are not specified on the current level. This allows you to specify access permissions for all
databases on a server, or even for all servers.
The additional attribute emptypassword is supported for the <project> and <server>
tokens. This attribute can be set to the value allow or deny. If set to deny, then all
connection attempts by a user with no password specified are refused by the server or the
database, respectively. By default, whenever you create a user in an Avid Interplay database,
the password is set to empty. Avid highly recommends setting this value to deny for
security reasons.
Following are some examples illustrating the configuration of database and user access.
Example 1:
<XML>
<server name="WGSERVER">
</server>
</XML>
The server WGSERVER is visible to the outside, although no databases are accessible.
263
Example 2:
<XML>
<server name="WGSERVER>
<project name=* access=allow emptypassword=deny>
<user name=* access=allow />
</project>
</server>
</XML>
All databases on server WGSERVER are visible and any user can connect to the database.
For all databases, connection requests with empty passwords are refused.
Example 3:
<XML>
<server name="WGSERVER emptypassword=deny>
<project name=* access=allow>
<user name=* access=allow />
<user name=Administrator access=deny />
<user name=John access=deny />
</project>
</server>
</XML>
All users except Administrator and John are allowed to access the databases on server
WGSERVER. For all databases on the server, connection requests with empty passwords are
refused.
264
Example 4:
<XML>
<server name="WGSERVER>
<user name=* access=allow />
<user name=Administrator access=deny />
<user name=John access=deny />
<project name=Project1 access=allow />
<project name=Project2 access=allow>
<user name=Nina access=deny />
</project>
</server>
</XML>
All users except Administrator and John are allowed to access the databases Project1 and
Project2. Access to Project2 for the user Nina is refused.
Example 5:
<XML>
<project name=* access=allow />
<user name=* access=deny />
<user name=Administrator access=allow />
<server name="WGSERVER />
</XML>
265
This file is located in the Interplay Engine installation directory, for example,
266
Not Allowed
Characters: / \ |
All characters allowed Characters: * ? : / \ " < > |
for files in Windows
Names ending with a dot
Names used as DOS devices (LPT1, com1, .., .,, for
example)
Property names
(metadata field
names)
Characters: / \ |
Video ID
metadata field
Although the following characters are valid for users and user groups in Interplay, they are
not supported when naming projects, bins, and users on Avid editing systems:
:*?<>
Do not use these characters in Interplay user names or group names.
For information on International Character Support (ICS), see the Avid Interplay Help.
When you name a Mac OS X computer, use single-byte ASCII characters without spaces.
268
Post
Film
Content
Default
Inspector
Default
Content
Default
Inspector
Default
Content
Default
Inspector
Default
Comments
Comments
Comments
Comments
Camroll
Camroll
Created By
Duration
Created By
Created By
Comments
Comments
Creation Date
Media File
Format
Creation Date
Creation Date
Duration
Duration
DRM
Duration
End
End
Duration
Media File
Format
KN Dur
KN Dur
KN End
KN End
KN Start
KN Start
Name
Name
Pullin
Pullin
DRM
Name
Duration
Tape ID
Format
Media Status
Modified Date
Tracks
Format
Media Status
Modified Date
Name
Tape
Tracks
Name
Name
Tape ID
Tape
Pullout
Pullout
Tracks
Tracks
Start
Start
Heading
Description
All Custom
Access Rights
AudioBitDepth
Audio bit depth used when you work with Type a value or use the arrows to select a
audio files: 16 bit or 24 bit.
value.
AudioFormat
AudioSR
AuxTC24
Auxiliary Ink
AuxiliaryTC1 through
TC5
AuxInkDur
AuxInkEdge
AuxInkEnd
Ending auxiliary ink number for the clip. Type numbers only in the four
colon-separated entry fields displayed.
AuxInkFilm
270
Heading
Description
Cadence
Camera
Camroll
Category
CFPS
Color
The text display color for metadata of the Returns items of selected color found.
selected item in all Interplay Access
The search does not find items colored
displays.
only by inheritance (only the parent is
returned).
Comments
Created by
Creation Date
Type text.
Data Format
Date Deleted
271
Heading
Description
Deleted By
Disk Label
DPX
DRM
Digital Rights Management property. Has Depending on the search flags, this search
the special operators Has DRM and Does can retrieve links to the assets, assets or
not have DRM.
links and assets which have at least one
DRM protected media somewhere in the
structure. Searches for DRM should
return all of the sequences, subclips,
rendered effects, and so on that use a
restricted master clip. DRM is referred to
as restrictions in Interplay Assist, Avid
Instinct, and Avid editing systems.
Duration
The length of the asset in hours, minutes, Type numbers only in the four
seconds, and frames.
colon-separated entry fields displayed.
End
FilmTC
Timecode used on film. Used for 24p and Type numbers only in the four
25p projects only.
colon-separated entry fields displayed.
Format
272
Heading
Description
FPS
Expected length of a clip captured by the Type numbers only in the four
Frame Chase Editing method.
colon-separated entry fields displayed.
Current length of a clip being captured by Type numbers only in the four
the Frame Chase Editing method.
colon-separated entry fields displayed.
In Use
IN-OUT
InkDur
InkEdge
InkEnd
InkFilm
InkNumber
KNDur
273
Heading
Description
KNEnd
Ending key number for the clip. Used for Select an operator and then type numbers
24p projects, 25p projects, and matchback only in the four colon-separated entry
projects only.
fields displayed.
KNFilm
KNIN-OUT
KNMarkIN
KNMarkOUT
Key number for the OUT point, if you set Select an operator and then type numbers
one for the clip. Used for 24p projects,
only in the four colon-separated entry
25p projects, and matchback projects
fields displayed.
only.
KNStart
Starting key number for the clip. Used for Select an operator and then type numbers
24p projects, 25p projects, and matchback only in the four colon-separated entry
projects only.
fields displayed.
Labroll
LUT
Mark IN
Timecode for the IN point, if you set one Select an operator and then type numbers
for the clip.
only in the four colon-separated entry
fields displayed.
Mark OUT
Master Dur
274
Heading
Description
Master Edge
Master End
Master Film
Master Start
MXF or OMF.
Media Size
Media Status
Online, offline, or partially offline status, Select is/is not, and then online, offline,
or exists on another workgroup.
partial, or nearonline.
Modified Date
Name
Original Bin
Original Path
Original Project
Offline
275
Heading
Description
Path
Perf
Playable in Access
Pullin
Pullout
Record Complete
Reel #
Reservation
276
Heading
Description
Reserved
Scene
Type text.
ShootDate
Slip
SoundTC
Soundroll
Start
Take
Type a number.
Tape
TC24
24-fps timecode.
TC25
TC25P
TC30
30-fps timecode with 2:3 pulldown. Used Select an operator and then type numbers
for 24p and 25p projects only.
only in the four colon-separated entry
fields displayed.
TC30NP
277
Heading
Description
TC60
Text
Tracking
Tracks
All tracks used by the asset (from the bin) Select Video, Audio, or Both.
Transfer
Type
Type of asset.
UNC Path
Version Comment
VFX
VFX Reel
278
Heading
Description
Video ID
VITC
Workspace
279
280
0x525
0x8000ffff
8007000e
out of memory
80070005
80004001
not implemented
80004005
general failure
89990010
out of range
89990011
89990012
89990013
89990020
89990021
89990022
89990023
89990024
89990025
89990026
89990027
89990028
89990030
invalid path
282
89990031
invalid name
89990032
invalid handle
89990033
invalid destination
89990034
invalid property
89990035
invalid parameter
89990036
invalid filename
89990037
invalid object
89990038
invalid hostname
89990039
89990040
89990041
89990042
89990043
89990050
89990051
89990052
89990053
89990054
89990055
89990057
89990060
89990061
89990062
89990068
89990069
89990070
89990071
89990072
89990073
89990080
89990081
89990082
89990083
89990084
89990085
89990086
sharing violation
89990087
corrupt file
89990090
89990091
89990092
89990093
89990094
89990095
89990096
89990097
8999009b
cannot move the item to another branch. Due to the branch settings, the
source and destination locations are in different branches.
8999009c
cannot create a share to a file in another branch. Due to the branch settings,
the share and share target locations are in different branches.
8999009d
8999009e
89990100
89990101
89990102
89990110
283
284
89990111
89990120
89990121
89990122
89990123
89990124
The database share on the server is not accessible. Please contact your
administrator.
89990130
89990131
89990132
89990140
89990141
89990142
89990143
89990144
89990145
89990146
89990147
89990148
89990149
error during reversal of transaction, file still pending, you must recover
manually
8999014a
8999014b
8999014c
8999014d
Another check-in operation was performed before yours. Try the merge
again against the correct version.
8999014e
89990160
89990161
89990162
89990163
89990164
89990165
the server could not be instantiated (is the server installed on this
machine?)
89990166
89990167
89990168
89990169
89990170
89990171
89990172
89990173
89990174
89990175
89990177
89990178
The license key contained one or more expired licenses. These licenses are
ignored.
89990192
89990195
the database was created with a newer version and cannot be opened with
this server
89990196
8999019c
8999019f
setting a property failed because the condition for setting did not match
899901a4
An item in a folder was removed while the folder was being enumerated
89990200
89990201
89990202
285
286
89990220
89990221
89990222
89990224
89990225
89990226
89990227
89990228
89990230
89990231
89990232
89990233
89990234
89990235
89990236
89990237
89990238
89990239
89990240
89990244
89990250
incorrect cookie
89990251
89990252
incorrect password
89990253
89990260
89990261
89990262
89990280
89990290
archive is corrupted
89990291
89990292
89990300
89990301
89990302
89990303
89990304
89990305
user is invalid
89990306
89990307
89990308
89990309
89990310
89990311
89990312
89990313
89990314
The given action category name already used by another action category
89990315
89990316
89990317
Unable to complete the operation because the action exists with another
type
89990318
89990319
89990320
Unable to complete the operation because the role exists with another type
89990321
89990322
287
288
89990323
89990324
The system id's for roles or actions are out - impossible to create new
system actions or roles
89990326
89990327
89990340
89990341
A generic command was called which is not supported for user or group
objects
89990342
Internal requirements for user or groups objects are not fulfilled (for
example, link broken)
89990351
89990352
89990353
The user can neither be moved nor removed (that is, users cannot be moved
from the Everyone group and the Administrator cannot be moved from the
Administrators group)
89990354
The given user shall be destroyed but was not deleted before
89990355
Not a user
89990356
89990361
89990362
89990363
89990364
89990365
89990366
not a serigraph
8999036
89990368
89990369
8999036a
8999036b
8999036c
8999036d
8999036e
The CCS does not have the same version as the server of the database
89990370
89990371
89990372
89990401
89990450
There is no open session for this client. If you are using an older version of
the client, JXDK or MDK please upgrade to a newer version
89990500
89990600
89990601
continue
89990602
switching protocols
89990603
OK
89990604
created
89990605
accepted
89990606
non-authoritative information
89990607
no content
89990608
reset content
89990609
partial content
89990610
multiple choices
89990611
permanently moved
89990612
moved temporarily
89990613
see other
89990614
not modified
89990615
use proxy
89990620
bad request
289
290
89990621
unauthorized
89990622
payment required
89990623
forbidden
89990624
not found
89990625
89990626
not acceptable
89990627
89990628
request timeout
89990629
conflict
8999062a
gone
8999062b
length required
8999062c
precondition failed
8999062d
8999062e
8999062f
89990630
89990631
not implemented
89990632
bad gateway
89990633
service unavailable
89990634
gateway timeout
89990635
89990700
89990701
89990702
89990703
89990704
89990705
89990706
89990707
89990708
89990709
89990800
SQL error
89990801
89990802
89990900
89990901
89990902
89990903
89990904
89990905
89990906
89990907
89990908
89990a00
Could not open an image because the file could not be found or the caller is
not allowed to open the file.
89990a01
Could not read an image. The file could be opened but not be read.
89990a02
Could not create an image file. Maybe the destination folder does not exist
or the caller is not allowed to write to that location.
89990a03
Could not write an image file. The file was created but writing to the file
failed. This could for example happen if disk has insufficient disk space.
89990a04
The image could not be read because it does not have a known format.
89990a05
89990a06
89990a07
An image could not be loaded or saved because the license for the LZW
algorithm is not available.
291
292
89990a08
The image could not be read or stored because the file or image has an
invalid format.
89990b00
89990b01
The LDAP server received an invalid request from the server, LDAP error:
LDAP_PROTOCOL_ERROR(0x2)
89990b02
89990b03
A specified size limit was exceeded in a request to the LDAP server, LDAP
error: LDAP_SIZELIMIT_EXCEEDED(0x4)
89990b04
The LDAP server does not support the authentication method specified by
the server, LDAP error:
LDAP_AUTH_METHOD_NOT_SUPPORTED(0x7)
89990b05
The request sent to the LDAP server required strong authentication and
therefore failed, LDAP error: LDAP_STRONG_AUTH_REQUIRED(0x8)
89990b06
89990b07
The LDAP server was unable to satisfy a request because one or more
critical extensions were not available, LDAP error:
LDAP_UNAVAILABLE_CRITICAL_EXTENSION(0xC)
89990b08
89990b09
A search request sent to the LDAP server is not compatible with the
attribute syntax specified by the LDAP database, LDAP error:
LDAP_INAPPROPRIATE_MATCHING(0x12)
89990b0a
89990b0b
89990b0c
89990b0d
The LDAP server cannot perform the operation on a leaf entry, LDAP
error: LDAP_IS_LEAF(0x23)
89990b0e
A search request sent to the LDAP server could not dereference an alias
because of missing access rights, LDAP error:
LDAP_ALIAS_DEREF_PROBLEM(0x24)
89990b0f
89990b10
The credentials sent to the LDAP server are invalid, LDAP error:
LDAP_INVALID_CREDENTIALS(0x31)
89990b11
The request sent to the LDAP server was not completed because of missing
access rights, LDAP error: LDAP_INSUFFICIENT_ACCESS(0x32)
89990b12
The LDAP server is too busy at the moment to fulfill the request, LDAP v:
LDAP_BUSY(0x33)
89990b13
89990b14
89990b15
89990b18
The LDAP server could not complete the request because it violates the
naming convention, LDAP error: LDAP_NAMING_VIOLATION(0x40)
89990b19
The LDAP server could not complete the request because it violates the
rules set for the object class, LDAP error:
LDAP_OBJECT_CLASS_VIOLATION(0x41)
89990b1a
The LDAP server cannot perform the operation on a non-leaf entry, LDAP
error: LDAP_NOT_ALLOWED_ON_NONLEAF(0x42)
89990b1b
89990b1c
The LDAP server cannot perform the operation because the entry already
exists, LDAP error: LDAP_ALREADY_EXISTS(0x44)
89990b1d
The LDAP server cannot perform the operation because it would change
the structure rules of the object class, LDAP error:
LDAP_NO_OBJECT_CLASS_MODS(0x45)
89990b1e
The results of a request to the LDAP server are too large to return them,
LDAP error: LDAP_RESULTS_TOO_LARGE(0x46)
293
294
89990b1f
89990b20
The LDAP server cannot perform the operation because of a virtual list
view error, LDAP error: LDAP_VIRTUAL_LIST_VIEW_ERROR(0x4C)
89990b21
89990b22
89990b23
89990b24
89990b25
89990b26
89990b27
89990b28
89990b29
89990b2a
89990b2b
89990b2c
89990b2d
89990b2e
89990b2f
89990b31
89990b32
89990b50
The operation failed because the user authentication provider is not enabled
89990b51
89990b52
The CCS was unable to retrieve the users from a user authentication
provider
89990b53
89990b54
89990b55
The required setting for the LDAP user object class is not set
89990b56
The required setting for the LDAP user name attribute is not set
89990b57
89990b70
295
296
The Consistency Check is for support purposes. You should perform this check only if
requested by Avid Technical Support.
If any of the following critical errors are reported, do not use your database; contact
Avid immediately using the protocol outlined in the If You Need Help topic in the
front of this manual.
Code
Meaning
7050
7051
7052
7053
7088
7089
7099
7100
7101
7110
7141
Code
Meaning
7142
7143
7144
11064
298
If any of the following errors are reported, some problems were found related to the
particular object. It is still possible to use your database, but you should contact Avid using
the protocol outlined in the If You Need Help topic in the front of this manual to resolve
the problem.
Code
Meaning
7061
Not possible to determine the server master path for the file
7063
7064
7065
7066
7067
7068
7069
7070
7071
7077
7078
7081
7082
7083
Code
Meaning
7085
7111
7112
7113
7114
7153
7171
link is invalid
7172
link is invalid
7173
link is invalid
7174
link is invalid
7175
link is invalid
7176
link is invalid
11058
11059
11060
11061
11062
23020
23021
23023
299
300
Code
Meaning
7062
7072
7073
7074
7075
7076
7091
23022
invalid entry in the authorization role table. This can happen when there is
an entry in the permission table that does not refer back to an object. For
example, an object was deleted or the creation of a folder was cancelled.
ABCDEFGHIJKLMNOPQRSTUVWXYZ
Index
Symbols
_Backup directory
described 33
_Buckets directory
described 33
_Database directory
backing up and restoring 36, 37
described 33
_Master directory
described 33
_PropertyStore directory
backing up and restoring 36, 37
described 33
Numerics
7-Zip
for Interplay backups 46
A
AAF metadata
adding to tape archive 158
Access control
for custom properties 138
Accumulated inherited role
described 113
Activating
database 64
Administrator role
described 113
Administrators group 110
Apache web server
activating creation of access.log 235
folder and files 233
Index
ABCDEFGHIJKLMNOPQRSTUVWXYZ
Avid
online support 15
training services 17
Avid assets
described 20
Avid Instinct
Application Database options 176
setting Application Database options 173, 174
setting user options 188
user options 191
Avid Interplay
client-server application 23
optimizing performance 202
Avid Interplay Administrator
See Interplay Administrator
Avid Interplay Assist
Application Database options 176
setting Application Database options 173, 174
setting user options 188
user options 191
Avid Interplay Engine directory
Apache folder 233
Data folder 236
folders and files 233
Logs folder 236
Preview Server folder 240
Server folder 241
Avid Interplay Engine Server process 242
locking or shutting down 208
Avid Media Composer
setting Application Database option 173, 174
Avid Service Framework
Services views 199
Avid Unity
authentication 100
file repository on workspace 210
Avid Unity ISIS
workspace for file repository 212
Avid Unity MediaManager
migrating users from 110
Avid Unity MediaNetwork
workspace for file repository 212
Avid Workgroup Engine Monitor service 250
Avid Workgroup HTTP Server process 243
Avid Workgroup Preview Server service 244
Avid Workgroup Server Browser service 244
Avid Workgroup TCP/COM Bridge service 248
302
B
BackupArchive tool 57
BackupFailed event 257
Backups
described 36, 37
manual, starting 45, 45
number of backups to keep 38
performing 41
recommendations for configuring 38
restoring 48
scheduling 41
scheduling automatic backups 41
using archiving tool 46
Best effort restore
setting 158
C
Categories
adding 146
configuring 146
removing 148
Central Configuration Server (CCS)
adding users 98
caution when moving 93
described 23
moving to another server 94
overview 93
selecting a different server 96
Client access
configuration 262
Client connections
troubleshooting 202
Clients
disconnecting all 86
list of connected 82
ClusterResourceFailure event 257
ABCDEFGHIJKLMNOPQRSTUVWXYZ
Complete backup
described 36, 37
Config.xml 253
supported actions 255
supported events 257
Configuration files
Interplay Engine 253
Configuring
automatic backup 38
categories 146
client access 262
Interplay Engine files 253
Pro Tools Export plug-in 197
Pro Tools Import plug-in 195
project token attributes 262
remote workgroups 144
Consistency Check
critical errors 297
error codes 297
errors 298
performing 60
warnings 300
Create Database view 31
Custom Meta Data tab
using 135
Custom properties
adding 135
creating 134
custom lists for 140
extended search 143
removing a list 142
setting access control 138
XML files for 140
D
Data folder 236
Database
activating 64
backing up 36
blocking access to 124
changing root folders 81
creating 31
deactivating 63
described 19
directories and files 33
limits 36
Index
locking 62
migrating 67
moving (clustered) 73
moving (non-clustered) 69
moving database and users (clustered) 76
moving database and users (non-clustered) 71
moving when disk space low 78
renaming 79
restoring 36
restoring example 56
splitting 210
supported storage configurations 211
unlocking 62
viewing information about 60
Database asset
deletion 161
Database Information View 60
DCOMConfig Settings 242
Deactivating
database 63
Deleting
options for deleting locked media 170
options for deleting OMF or MXF 169
overview 161
scheduling 166
users and user groups 117
Dictionaries
for custom properties 140
Differential backup
described 37
DiskLimit event 257
Dongle 86
DRM (restrictions) 272
Duration attribute 272
Dynamic relink
Editor Database option 176
E
E-mail notifications
errors and severity level 261
Engine Monitor Service 250
Error codes
Consistency Check 297
server 281
Event Manager settings 253
Everyone group 110
303
Index
ABCDEFGHIJKLMNOPQRSTUVWXYZ
Exiting
Interplay Administrator 29
Exporting
license 91
Extended search
custom properties 143
F
Failed to Delete folder 161
Fast backup
described 37
File assets
described 20
source files for 210
File repository
described 210
Filetransfer server 266
Firewalls
troubleshooting 203
Folderlocations.xml
described 33
Folders
assigning roles to 118
blocking access to 124
setting ownership 159
Frame Locators tab
configuring display 187
Full backup
described 36, 37
G
General role assignments
setting 121
viewing 118
Global authentication 98
H
Handover directories
described 33
Hardware ID 86
Help
opening 28
304
I
Imported Users group 110
Importing
LDAP users 103
license 88
users 98
Windows domain users 101
Incremental backup
described 37
Inherited rights 113
IN-OUT attribute 273
Installing
Pro Tools Import plug-in 195
Instinct/Assist User Settings view 188
options 191
Interplay Access
default folders in 31
defining property layouts for 129
enabling login from Windows domain 101
Interplay Administrator
described 24
exiting 29
Help 28
opening a view 28
starting 24
Interplay Administrator views
opening 28
Interplay Administrator window
using 26
Interplay Archive Engine
described 22
Interplay database
described 19
See also Database
Interplay Engine
Avid Interplay Engine Server process 242
Avid Workgroup Engine Monitor service 250
Avid Workgroup HTTP Server process 243
Avid Workgroup Preview Server service 244
Avid Workgroup Server Browser service 244
Avid Workgroup TCP/COM Bridge service 248
Avid Workgroup VSS service 249
configuration files 253
described 19
folders and files 233
optimizing performance 202
ABCDEFGHIJKLMNOPQRSTUVWXYZ
ports used 241
servers and services 241
Interplay Media Services Engine
registering 149
Interplay Media Services view 153
Interplay Portal
viewing 15
Interplay Transfer
configuring for remote workgroups 144
Interplay Transfer Settings view 154
Interplay Transfer Status view 154
Interplay Window
automatic reservation 181
Interplay workgroup
described 19
multiple workgroups 21
InterplayRestore tool
described 48
example 56
J
Journal files
described 33
K
Kept Media folder 161
L
LDAP authentication 103
LDAP server settings 105
LicenseKeyInfo.exe 92
Licenses
displaying and printing 92
exporting 91
importing 88
managing 86
permanent 88
troubleshooting 91
types 90
Licenses view 86
Lock Server view 84
Lock/Unlock Database view 62
Locked clips
deleting 170
Index
Locking
database 62
server process 208
Log files
deletion 161
LogEvent event 257
Logging in
troubleshooting 201
Logging out
Interplay Administrator 29
Logs folder 236
Logwatch.xml 260
M
Manage Database Roles view 118
Managing Databases view 63
Manual backup
starting 45, 45
Media Composer
setting Application Database option 173, 174
Media Indexer
registering in Interplay Administrator 149
MediaManager
migrating users from 110
Metadata
system, list 269
Metadata override
for archive 170
Migrated Users group 110
Migrating
database 67
Moving
database (clustered) 73
database (non-clustered) 69
database and users (clustered) 76
database and users (non-clustered) 71
database when disk space low 78
MXF files
option for deleting 169
N
No Access role
described 113
305
Index
ABCDEFGHIJKLMNOPQRSTUVWXYZ
NxNServerLock.exe
locking server process 208
moving database with 78
NxNServerShutdown.exe
moving database with 78
shutting down server process 208
NxNServerUnlock.exe
moving database with 78
NXNServerUser.exe
recreating Server Execution User 207
O
Object Inspector
configuring Frame Locators 187
OMF files
option for deleting 169
Online support 15
Orphan Clips folder
changes for v2.4 161
types of links 166
Ownership Behavior view 159
P
Passwords
viewing and setting 112
Perform Consistency Check view 60
Performance
optimizing Interplay 202
Permanent license 88
Permissions
setting 113
See also Roles
Presets
workgroup transfer 154
Preview Server folder 240
pro file
described 33
Pro Tools
configuring Export plug-in 197
configuring Import plug-in 195
installing plug-ins 195
plug-ins for Interplay 195
User Settings plug-in 198
Property Layout view 129
306
R
Read role
described 113
Read/Write role
described 113
Read/Write/Delete role
described 113
Remote workgroups
configuring for search or transfer 144
Renaming
database 79
Reservations
automatic 181
Resolutions
setting available in clients 132
Restart Server view 86
Restarting
server 86
Restoring
backup version 48
Restrictions
DRM property 272
Reuniting
split database 221
Rights
setting 113
See also Roles
Robocopy
for Interplay backups 46
Role assignments
general 118
Roles
assigning to folders 118
described 113
viewing and changing 114
Root folders
setting 81
S
Schedule Backups view 41
Scheduled deletion 166
Searches
custom properties 143
Searching
remote workgroups 144
ABCDEFGHIJKLMNOPQRSTUVWXYZ
Send mail action 255
Server
error codes 281
information about 82
locking 84
restarting 86
shutting down 84
unlocking 84
Server Event configuration
example 259
Server Event Manager
configuring 253
Server Execution User
creating 204
described 23
recreating 207
troubleshooting 204
Server folder 241
Server Hostname Settings view 149
Server Information view 82
Server Settings view 81
ServerXML.xml 262
Service Configuration view (Avid Service
Framework) 199
Shotlist
changing default start timecode 185
Shutting down
server process 208
Split database
configuring workgroup.xml file 219
described 210
existing Interplay installations 215
new Interplay installations 213
preparing for 212
reuniting 221
reuniting AvidWG and _InternalData 227
reuniting AvidWG only 224
Start timecode
changing default for shotlist 185
Streamed properties
described 33
System metadata
list 269
Index
T
Taxonomies
for custom properties 140
TCP/COM Bridge service 248
TCP/IP
ports required 241
Timecode
changing default start for shotlist 185
Timeout
setting automatic 186
Tracks attribute 278
Training services 17
Transferring
to remote workgroup 144
Transfers
configuring transfer engines 154
monitoring status 154
preset view 154
Troubleshooting 15
client connection problems 202
firewalls 203
licenses 91
login-in problems 201
optimizing Interplay performance 202
server process 208
U
Unlocking
database 62
User Authentication Providers view 98
User groups
adding 111
default 110
deleting 117
removing users from 117
roles 113
setting attributes for 112
setting passwords for 112
User management
guidelines 127
User Management view 108
Users
adding from Avid Unity 100
adding manually 112
adding to a CCS 98
307
Index
ABCDEFGHIJKLMNOPQRSTUVWXYZ
default 110
deleting 117
disconnecting all 86
importing 98
importing from LDAP 103
importing from Windows domain 101
list of connected 82
management guidelines 127
managing 108
removing from group 117
roles 113
setting attributes for 112
setting passwords for 112
V
VITC (Vertical Interval Timecode)
in a bin 279
VSS service 249
W
WG_Database$
identifying root folder for 220
Windows Domain authentication 101
Workgroup name
setting 149
Workgroup Properties view (Avid Service
Framework) 199
Workgroup Transfer Presets view 154
workgroup.xml file
configuring for file transfer server 266
configuring for split database 219
Workgroups
described 19
multiple workgroups 21
remote 144
X
XML files
for custom properties 140
308
Avid
Product Information
75 Network Drive
Burlington, MA 01803-2756 USA