Oracle® DIVAdirector

Administrator's Guide

Release 5.3

E65553-02

September 2016

Oracle DIVAdirector Administrator's Guide, Release 5.3

E65553-02

Copyright © 2015, 2016, Oracle and/or its affiliates. All rights reserved.

Primary Author:  Lou Bonaventura

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

Preface

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

1 Introduction

- Preparing for Installation

2 Initial DIVAdirector Configuration

- Changing the Administrative Password

- Configuring DIVAdirector Server Connectivity

- Accessing the Configuration Screens

- Confirm DIVAdirector Server Network Connections

- Confirm DIVAdirector Database Connectivity

- Confirm TCP Connection Port

- Confirm SAMMAsolo Support

- Configuring Oracle DIVArchive Manager Connectivity

- Configuring DIVAdirector User Interface

- System Settings

- System Policies

- Database Synchronization Filtering

- Configuring Keyboard Shortcuts

- Shotlist Shortcuts

- Proxy Player Shortcuts

- Style

- Configuring DIVAdirector Web Server

- Listening Port Configuration

- IIS Service Account Configuration

- Storage Location Configuration

- Drop Folder Configuration

- DIVArchive Operation Drop Folders

- Files with Special Names

- Proxy Drop Folders

- Annotation Drop Folders

- Metadata Drop Folder Configuration

- Adding New DIVArchive Operation Drop Folders

- Adding New Proxy Drop Folders

- Map the Storage Location to Windows and Set Folder Permissions

- Add the Proxy Folder to the DIVAdirector Web Server in IIS

- Add the Proxy Location to DIVAdirector Server

- Configuring the Proxy Location's Storage Size

- Configuring the Proxy Location Filling Strategy

- Proxy Location Operational States

- Drop Folder Configuration

- DESCRIPTION Parameter

- ACTION Parameters

- PROXY Action

- ARCHIVE Action

- RESTORE Action

- COPY Action

- PURGE Action

- Using the XML Wizard

- ACTION Screen

- Settings Screen (Next or Final)

- Field Mapping Screen (Final)

- Directly Editing XML Configuration Files

- DIVArchive Operation Drop Folder Specific Configuration

- ARCHIVE Action Parameters

- COPY Action Parameters

- RESTORE Action Parameters

- PURGE Action Parameters

- Transcode Service Configuration

- Web Configuration File Changes

- Windows Service Changes

- Starting and Stopping the Transcode Service Windows Services

- Logging Configuration

- DIVAdirector Server Logging Configuration

- Log Levels

- Log File Name

- Log File Size and Cycling

- Drop Folder Logging Configuration

- Log Levels

- Log File Name

- Log File Size and Cycling

- Account Configuration

- Adding a New Organization

- Adding a New Group

- Group Roles

- Content Filters

- DIVArchive Operations

- Virtual Asset Categories

- Data Export

- Adding a New User

- Lightweight Access Directory Protocol (LDAP) Logins

- Search Configuration

- Object Metadata

- Data Types

- DIVAdirector Presentation Controls

- Predefined Metadata Display Columns

- Adding a New Metadata Entry

- Add New Quality Control Metadata

- Metadata Filters

- Metadata Publish Settings

- Quality Control (QC) Report Configuration

- QC Report File Placement

- Automated Backup Configuration

3 DIVAdirector Daily Operations

- Check Available Storage Capacity

- Check for Orphaned Files

- Check Audit Trails

- Check for Successful Backup Completion

4 System Management

- Database Synchronization Management

- Proxy Storage Management

- Proxy Migration Tasks

- Proxy URL Search List

- User Data and Resource Management

- Making a Public Resource Private

- Account Management

- Managing Organizations

- Modifying an Existing Organization

- Deleting an Organization

- Managing Groups

- Modifying an Existing Group

- Deleting an Existing Group

- Managing User Accounts

- Modifying an Existing User

- Deleting a User

- Search Management

- Metadata Column Manager

- Editing a Metadata Entry

- Deleting a Metadata Entry

- Session Management

- Administrator's Message

- Configuration for ShuttlePro V2 or ShuttleXpress Control Pads

5 Troubleshooting and Disaster Recovery

- Screen Transparency

- Starting and Stopping DIVAdirector Server

- Command Line Parameters

- Starting and Stopping the DIVAdirector Web Server

- Checking Log Files

- Flat File Export

- Manual Backup and Database Restore

- Performing a Manual Backup

- Performing a Database Restore

6 Frequently Asked Questions

Glossary

Preface

This document gives a basic understanding of system functionality and detailed instructions for configuring Oracle DIVAdirector 5.3.

Audience

This document guides System Administrators through initial Oracle DIVAdirector system configuration, daily operations, and routine maintenance.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information refer to the Oracle DIVAdirector Release Notes, and the Oracle DIVAdirector User's Guide.

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements that perform an action.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Introduction

Oracle DIVAdirector is a graphical user interface (GUI) for Oracle DIVArchive 7.1 and later. Your users locate and work with videos remotely, from any computer on your network, through the web-based interface. Administrators monitor and maintain the system and user accounts with minimal effort from anywhere they have access to your network.You access DIVAdirector through a web browser using the HTTPS protocol. Some of the advantages of a web-based interface include:

- No GUI software installation is necessary.

- A browser-based GUI can be accessed from anywhere on the network.

- No client application configuration is necessary.

- No client updates need to be performed.

Using DIVAdirector you can

- Search for video clips by file name, date, category and format.

- Define metadata fields and values that support search.

- Use Boolean operators and greater than - less than criteria. For example you can search for video clips of farm animals in the United States, but not in Nebraska or Kansas. You can search for videos of hockey games that were produced before 9/3/2013 but after 9/1/1999.

- Review located clips using the built-in media player.

- Extract selected frames, add them to a list of related clips, forward them to editing applications, or arrange them for distribution.

Note:
DIVAdirector 5.3 and later is licensed per user, not per concurrent user. You identify the maximum concurrent users (between 1 and 100) on the Admin, System, Defaults screen.

Preparing for Installation

Before the Oracle Delivery and Installation Team arrives at your site you must complete installation and configuration of your system hardware. You must assign IP addresses and storage locations, open ports in the firewall, complete network cabling, and so on. When the team arrives they will review the configuration specifications before starting the installation to ensure all necessary components are in place and accessible.Installed hardware must meet or exceed the list of recommended minimum hardware specifications provided to you. The server host hardware must have Microsoft Server 2008 R2 or Windows 2012 R2 installed.

You configure the server host computer for operation within your network and restrict access to the server with a unique, secure password. Install Microsoft Internet Information Server (IIS) 7 on the server host computer and confirm operation and network connectivity.

Any third party applications must be licensed and installed (for example Telestream). Have all DIVArchive configuration parameters set up including IP addresses and port configurations for storage devices, video servers, Avid Interplay (if in use), Oracle SAMMAsolo (if in use), Microsoft Cluster Manager (if in use), and so on. The team needs this information for reference during DIVAdirector installation.

You must have at least one fully operational client computer available for testing during and after installation. Client computers must have Microsoft Windows 7 Professional or Ultimate (either 32-bit or 64-bit) with Service Pack 1, or Mac OS 10.6 (Snow Leopard) or later operating system installed and one of the following supported web browsers:

- IE7/8 (Must be run in native mode, not compatibility mode)

- IE9

- Chrome 18.0

Note:
Playback of WMV and MOV clips are no longer supported in Google Chrome due to the End of Life (EOL) for NPAPI in this browser. Files in MP4 format will continue to play using Google Chrome.

- Firefox 12.0

- Safari 5.1.5 (Drag and drop from the main right window to the left navigation pane is not supported. Drag and drop from and to the left navigation pane is supported).

2 Initial DIVAdirector Configuration

You must continue to configure DIVAdirector after the Oracle Delivery and Installation Team has completed the initial installation. You typically complete the initial configuration tasks in this chapter one time unless there are major system or network changes (for example if IP addressing changes, port numbers change, and so on).

Changing the Administrative Password

The installation technician installs DIVAdirector using a default administrative login and password, both of which are admin (these are case-sensitive and all lowercase). You must immediately change the DIVAdirector administrative password to fully secure the DIVAdirector Server host computer. Be aware that unauthorized users can gain full access to the DIVAdirector software and server host computer if you leave the default administrator password unchanged and do not secure the Windows operating system. Before the installation technician leaves change the DIVAdirector administrative password as follows:

1. Log in to the DIVAdirector GUI using the admin login credentials.

2. Navigate to the Admin, Personal Settings screen.

3. Enter the existing default password (admin) in the Password field.

4. Enter the new password in the New Password field (passwords are case-sensitive). You must use a secure password.

5. Enter the new password in the Confirm Password field.

6. Click Save on the top right side of the screen to save the new password.

Log out of the system and then log back in to confirm that the new password was accepted by the system.

Configuring DIVAdirector Server Connectivity

DIVAdirector connectivity to DIVArchive requires setting proper values for the communication parameters. The Installation Team set the initial connection parameters during installation. Confirm that the values are correct before proceeding.

Accessing the Configuration Screens

You use both the DIVAdirector GUI and the DIVAdirector Configuration Mode to confirm and (if necessary) reset the communication parameters. The proper interface for each parameter is identified in the steps below.Use this procedure to confirm (or reset) the preset system connection parameters in the DIVAdirector GUI

1. Open your web browser.

2. Enter the server host's IP address in the URL address field.

3. Press Enter to open the DIVAdirector GUI.

4. Log in to DIVAdirector using the administrator login and password.

5. Navigate to the Admin, System menu tree on the left side of the screen and confirm the parameters.

To confirm (or reset) the preset connection parameters restart the DIVAdirector Server in Configuration Mode.

1. From the Windows Start menu click All Programs.

2. From the All Programs menu click FPDI DIVAdirector 5.

3. From the FPDI DIVAdirector 5 menu click Stop DIVAdirector Server.

4. From the Windows Start menu click All Programs.

5. From the All Programs menu click FPDI DIVAdirector 5.

6. From the FPDI DIVAdirector 5 menu click DIVAdirector Server Configuration.

7. Click the DIVAdirector tray icon to open the Status screen.

8. Right-click the Status screen.

9. From the Status screen click Configure Settings from the displayed context menu.

The full configuration screen is displayed.

Confirm DIVAdirector Server Network Connections

Confirm the DIVAdirector Server network connection values in the DIVAdirector GUI.

1. Navigate to Admin, System, DIVAdirector Server Settings in the navigation tree on the left side of the screen.

2. Confirm the DIVAdirector Server IP Address.
The IP address identifies the DIVAdirector Server host computer and is typically the same computer where the web server resides. You can use localhost as the IP address when all DIVAdirector software is on the same host computer.

3. If the IP address does not match the server host's address then you must enter the correct address.

4. Confirm the DIVAdirector Server Port Number.

5. If the port number does not match the server host's port number then you must enter the correct value.

6. On the top right corner of the screen, click Save to save your changes.

7. Stop the server and then restart it in Configuration Mode.
Next you are confirming the DIVAdirector Database connectivity.

Confirm DIVAdirector Database Connectivity

Caution:
Do not change the database parameters unless instructed to do so by Oracle Support personnel.

The DIVAdirector database synchronizes periodically with the DIVArchive database according to a predetermined schedule. If the DIVAdirector Server cannot communicate with the database, no new object updates are received and DIVArchive operations cannot be performed. Your users will still be able to playback proxies, browse metadata, add metadata, create shotlists and workbins, and so on.

1. On the top right of the DIVAdirector Server Configuration screen confirm that the DIVAdirector Database parameter values are correct.

2. Confirm that the User ID value is postgres.

3. The password was set by the installation team and only displays asterisks in the field.

4. Confirm that the DSN value is DIVAdirectorPG.

5. If any value is incorrect, or DIVAdirector cannot connect to the database, notify the installation technician (if they are still on site), or contact Oracle Support for assistance.

Next you are going to confirm the TCP Connection Port and Oracle SAMMAsolo Support.

Confirm TCP Connection Port

The DIVAdirector Server listens on TCP port number 7680 for user interface commands. Do not modify the default port number unless it conflicts with other software installed on the system (for example if another web server uses this port number).

1. On the top left of the DIVAdirector Server Configuration screen confirm that the TCP connection port parameter value is 7680.

2. If the port number is incorrect change the value to port 7680.

3. A warning dialog box appears reminding you to restart the server for the change to take effect.

4. Click OK in the dialog box.

5. Restart the server in Configuration Mode.

Next you are confirming the SAMMAsolo Support.

Confirm SAMMAsolo Support

DIVAdirector has support for communicating with SAMMAsolo. Check with your manager if you are uncertain whether your organization uses SAMMAsolo.

1. Locate the Solo Support check box immediately below the TCP connection port parameter on the Configuration Mode Settings screen.
Selecting the check box adds SoloSupport=1 setting to the [Settings] parameter group in the cmgserver.ini file. Any setting changes will not take effect until the server is restarted.

2. If SAMMAsolo is not in use, deselect the check box to disable the feature.

3. If you made any changes restart the server in Configuration Mode.

Configuring Oracle DIVArchive Manager Connectivity

The Oracle DIVArchive Manager is the main operator for the DIVArchive system. All operation requests go through the manager. The manager queues requests according to the request priority set by the user when the request was initiated. The manager forwards the requests (highest priority first) to the Oracle DIVArchive Actor. The actor carries out the requests and reports the results back to the manager. The manager displays the results in the DIVArchive GUI, and forwards the results to DIVAdirector for users to review the outcome.

Confirm correct values for the manager's IP address and listening port number to ensure communication between DIVAdirector and the DIVArchive Manager.

1. Locate the DIVArchive Manager area immediately below the General area on the left side of the Configuration Mode Settings screen.

2. Confirm that the manager's IP address is correct. If incorrect, enter the correct IP address in the Address field.

3. Confirm that the listening port number is correct - typically port number 9000. If incorrect, enter the correct port number in the Port field.

4. Normally you would select the Re-connect automatically check box to have DIVAdirector automatically attempt to reconnect to the DIVArchive Manager if the link goes offline.

5. If the network or the DIVArchive Manager is down, deselect the Re-connect automatically check box until connectivity issues are resolved.
You will have to reconnect to the manager manually using the Connect to DIVArchive Manager context menu item when this option is disabled.

Next you will configure the DIVAdirector User Interface (UI).

Configuring DIVAdirector User Interface

Now that all of the network and system connectivity has been configured you must configure the internal system parameters that affect how users interact with DIVAdirector and DIVArchive. To configure the DIVAdirector user interface navigate to the Admin, System menu tree on the left side of the GUI screen.

First you will configure the system settings.

System Settings

The Defaults screen has two sections where you configure different options such as resolution, search result limits, date and time display, and so on. These options are located in the Default Settings area at the top of the screen. You configure options for deleting data and files related to local restore and local Oracle DIVArchive Partial File Restore, DIVArchive status, audit trails and scheduled backups in the Number of Days to Delete area on the bottom of the screen.

1. Navigate to the Defaults screen under the System menu tree on the left side of the GUI.

2. Enter the appropriate values that are optimal for your organization and users for each option.

As the System Administrator you can identify most of these values according to existing organizational policies and your physical location, such as calendar display format, time display format, number of days to retain system backups, number of days to retain audit trails, and so on. You may need to consult with your users (or their managers) to identify options such as proxy resolution width and height, SAMMA thumbnail count, capture frame offset, and so on.

The following fields are configurable in the Default Settings area of the screen:

Search Results Limit

Identifies the number of search results to be displayed simultaneously.

Search Language

Defines the language used to optimize full text search. If your metadata is mainly not in a particular language, or your language is not in the list, then select the Simple option.

Caution:
Recalculating your search language is an exhaustive database procedure and should be completed only during a maintenance window of at least eight hours with the guidance of Oracle Support.

Default Results Sort Order

Defines a metadata column that is used as the primary source for sorting.

Capture Frame Offset

Defines the count of frames which must be skipped from the beginning of a proxy while extracting key frames from the dropped proxy file.

Key Frame Count

Defines the number of key frames that will be extracted from a dropped proxy file.

SAMMA Thumbnail Count

Defines the number of thumbnails to use within a SAMMA thumbnail control.

Proxy Resolution Width

Defines the resolution width in pixels.

Proxy Resolution Height

Defines the resolution height in pixels. This parameter maintains an aspect ratio with the Proxy Resolution Width if 0 is entered for the value.

Date Display Format

Defines the format used for all date-type fields in DIVAdirector.

The list includes three format options.

- American - mm/dd/yyyy

- European - dd/mm/yyyy

- Custom - This option does not support any codes except dd, mm, yy, and yyyy. The order of the codes is arbitrary and can be whatever you defines.(can be defined in a relatively free-style format, for example yyyy.dd.mm). The allowed separator symbols are:

- Space ( )

- Period (.)

- Comma (,)

- Underscore (_)

- Hyphen (-)

- Colon (:)

- Forward Slash (/)

- Backslash (\)

Time Display Format

Defines whether the time is displayed in 12 hour or 24 hour format.

Calendar Display Format

Defines the first day of the week in the calendar.

Max Metadata Label Length in Tooltip

Defines the maximum number of characters to display in the Tooltips label. If the metadata field title exceeds this setting it will be truncated with three dots (…) at the end.

Max Metadata Field Length in Tooltip

Defines the maximum number of characters to display in Tooltips content. If the metadata field value exceeds this setting it will be truncated with three dots (…) at the end.

The following fields are configurable in the Number of Days to Delete area of the screen:

Local Restore and Local Partial Restore Files

Defines the number of days to keep the files that have been restored to the DIVAdirector Server host computer through a local restore or local partial restore operation.

DIVArchive Status

Defines the number of days to keep the DIVArchive status information on the Operation Status screen.

Audit Trail

Defines the number of days to keep audit trail and Drop Folder log information.

Scheduled Backups

Defines the number of days to keep backup files created by scheduled backups.

The following field is configurable in the Connections area of the screen:

Maximum Number of Concurrent Users Allowed

DIVAdirector 5.3 and later licensing is per user, not per concurrent user. You set the maximum number of concurrent users (between 1 and 100) in this field. If no entry is made, the default number of users (100) will be used. The maximum number of concurrent users is restricted by the amount of system resources available. If the system appears to slow down with a certain number of concurrent users online, you should lower the maximum number and reevaluate the performance.

Next you will configure the System Policies.

System Policies

The system policy parameters define the system level update interactions between DIVAdirector and DIVArchive - for example discovery of new data (assets), user request status updates, whether to delete a file entry from the database, and so on.

1. Navigate to the Policies screen under the Admin, System navigation tree on the left side of the GUI.

2. Enter the appropriate values for each option that are optimal for your organization and users. You should consult with your manager and your user's manager to determine the most effective and safest (for your data) configuration.

The following fields are configurable on the Policies screen:

Asset Discovery

Defines the automatic synchronization schedule. The first list (on the left) defines the frequency and the second list (on the right) defines the start time.

Update Request Status

Defines how often the DIVAdirector Server requests the DIVArchive operational status from DIVArchive.

Delete from DB

Responsible for deleting objects that were not found during database synchronization from the DIVAdirector database. When the check box is selected the objects that were not found will be deleted. When the check box is deselected the objects will not be removed.

Delete Proxy

Responsible for deleting the proxy files and the corresponding registration in the DIVAdirector database for the proxy files not located during database synchronization. When the check box is selected the files that were not found will be deleted. When the check box is deselected the files will not be removed.

Next you will configure the Database Synchronization Filtering.

Database Synchronization Filtering

The DIVAdirector system is populated automatically as a result of a scheduled synchronization process performed periodically according to the Asset Discovery value on the Policies screen (refer to the previous section). You configure the database synchronization filters on the Discover screen.Synchronization filters define which objects are processed during synchronization. Each synchronization filter represents a combination of an object's parameters such as object name, object category and media name, and has its own time of last synchronization. Parameters can be defined as masks with a wildcard (an asterisk). By default the asterisk will be set for fields that are empty. Filters with an asterisk in all three fields are invalid and cannot be added to the filter list.If you add a new filter after all objects corresponding to existing filters were synchronized and then click Discover New, the object corresponding to the new filter will also be synchronized.

Synchronization filters are applied in sequence from last to first. Because of this it can be easy to make your filters overly restrictive if you are introducing new filters that are highly specific.

You can initiate the next discovery cycle immediately using one of two buttons. Using these buttons will not remove virtual objects from DIVAdirector.

The Discover All button initiates the synchronization of all objects in the DIVArchive database based on the entire DIVArchive history. This option can take a long time if there are a lot of objects to be discovered.

The Discover New button initiates the synchronization of all objects added or removed since the last database synchronization was performed.

Use the following procedure to add a new synchronization filter:

1. Navigate to the Discover screen under the Admin, System navigation tree on the left side of the GUI.

2. Click Add on the top right side of the screen to add a new filter.

3. Enter the Object Name, Object Category and (if known and desired) Media Name fields. At least one of these fields must be entered to be added to the filters list.

4. Select the Enable check box to enable the filter.

5. Click the check mark to save the filter to the list or the X to cancel the operation.

Test the configuration by dropping a new file into one of the storage locations on DIVArchive and click Discover New. The file should be found and registered in the DIVAdirector database. You can check the database registration by running a search for the file from DIVAdirector using the Quick Search field on the top right side of the screen.

Next you will configure the Keyboard Shortcuts.

Configuring Keyboard Shortcuts

Keyboard shortcuts save time when performing common, routine procedures during daily work tasks. DIVAdirector has hot key combinations that are predefined and configured automatically during installation.The Proxy Player can be run in two different modes; Shotlist Mode and Proxy Player Mode. There are two corresponding subsections in the Admin, System, Shortcuts navigation tree - one for each mode. Each subsection defines the keyboard bindings for the player in that specific mode. You should assign keyboard shortcuts for the Proxy Player in each mode.The following hot key combinations are predefined in DIVAdirector:

Control+e

Edit

Shift+1

Rewind x4

Shift+2

Rewind x8

Shift+3

Fast Forward x4

Shift+4

Fast Forward x8

Shift+a

Add

Shift+b

Frame Back

Shift+d

Decrease Volume

Shift+f

Forward

Shift+i

Mark In

Shift+l

Loop

Shift+m

Mute

Shift+n

Frame Forward

Shift+o

Mark Out

Shift+p

Play / Pause

Shift+r

Rewind

Shift+s

Stop

Shift+t

Switch Time Format

Shift+u

Increase Volume

Shift+x

Mark Out and Add

Caution:
You must be careful during configuration of shortcuts because they may coincide with hot keys used in internet browsers or other software, causing unexpected results.

Use the following procedure to change the shortcut key combinations for either subsection:

1. Navigate to the Admin, System, Shortcuts, Shotlist Shortcuts screen, or to the Admin, System, Shortcuts, Player Shortcuts screen as applicable.

2. Click the Pencil icon to edit the desired hot key combination.

3. Select the required combination of Control+ Shift Key. Where Key is the key to assign to the shortcut.

4. Click the Check Mark to save the changes.

5. Test all of the configured hot keys, one at a time, to ensure there are no conflicts with other applications installed on the system.

Shotlist Shortcuts

You configure hot keys used to perform routine functions with the Proxy Player in Shotlist Mode on the Admin, System, Shortcuts, Shotlist screen in the navigation tree on the left side of the screen. Click the Pencil icon to edit existing shortcut combinations.

Proxy Player Shortcuts

The Proxy Player is the default player mode. You configure hot keys used to perform functions with the Proxy Player in the default Play mode on the Admin, System, Shortcuts, Player screen in the navigation tree on the left side of the screen. Click the Pencil icon to edit existing shortcut combinations.

Next you will add your organization's logo.

Style

If required, you can quickly customize the interface style with an organizational logo that appears on all GUI screens in the top right corner of the screen. Use the following procedure to add a logo:

1. Navigate to the Admin, System, Style screen on the navigation tree on the left side of the GUI.

2. Click Browse and navigate to the desired image file in the browse dialog box.

3. Select the desired file and click OK.

4. Click Save on the top right side of the screen to apply the changes.

5. Refresh the browser screen to view the changes.

Next you will configure the DIVAdirector Web Server.

Configuring DIVAdirector Web Server

DIVAdirector uses Microsoft Internet Information Server (IIS) 7 as the web server engine. IIS is installed during Windows Server 2008/2012 R2 installation.The DIVAdirector Web Server is fully configured by the installation application. Unless specific web server parameters require modification, there is no need to adjust the configuration. The default IP port is port 80 and will bind to the first network adapter in the system device list. Contact Oracle Support if you need assistance binding the server to a different network adapter.

First you will configure the Listening Port.

Listening Port Configuration

The default listening port value is 80. This is the standard internet HTTP port for web servers. This value may be any port number not being used in the system and should be changed if port 80 is unavailable. IIS must be restarted from the command line using the issreset command to apply a change to the port number.

Note:
After changing the server to a nonstandard port number, DIVAdirector users may be required to explicitly specify the port number in the web address similar to:
http://dd5server:8080

If changes are made to the listening port, test the web server configuration by opening your web browser and entering the DIVAdirector IP address (and port number if required) in the URL Address bar.

Next you will configure the IIS Service Account.

IIS Service Account Configuration

The DIVAdirector installation process creates account named dd5-user. This account is a vital part of the web server application's security. The account should never be deleted and the account's permissions should never be altered.

Next you will configure Storage Locations.

Storage Location Configuration

In DIVArchive and DIVAdirector, a single storage location can be used as both a source and a destination for data - the difference is in the actions being performed. For example, Tape Storage-A can be defined as a source for file restore, or partial file restore operations. However, Tape Storage-A can also be designated as a destination for archive and copy operations. You configure the storage locations and identify them as a source, a destination, or both in DIVArchive. DIVAdirector will use the storage locations as they are identified in DIVArchive.

Next you will configure Drop Folders.

Drop Folder Configuration

Drop Folders are directories on a storage location where users place (drop) files and actions are performed on the files. Drop Folders make typical work tasks much easier because you simply drop objects in the folder and the folder executes the action specifically configured for that folder.

DIVAdirector monitors the Drop Folders for new additions and other file changes and updates the database information accordingly. Each Drop Folder has its own configuration file, and can execute a single action (proxy, archive, restore, copy or purge). Explanations of these actions and the associated parameters are in the following sections.Refer to the Oracle DIVAdirector User's Guide for information on the configuration of Metadata and Annotation Drop Folders.

DIVArchive Operation Drop Folders

DIVArchive Operation Drop Folders can be monitored for either immediate file-drop processing or for processing based on scheduled events. A full folder scan is performed on any type of event (immediate or scheduled), and each discovered file (except files with special names) is processed according to the folder's configuration. You must understand the configuration options set for the Drop Folders to configure them effectively.

Files with Special Names

There are two types of files considered to have special names.

- The Drop Folder's XML configuration file has a file name that includes the folder name plus a .xml extension. This file is never processed by the system but specifies the configuration for the folder. You can open this file in any Unicode text editor to view or edit the configuration as necessary.

- Temporary files, or files you want to keep in the folder, have file names that begin with two leading tilde (~) symbols. These files are never processed by the system.

Files dropped into DIVArchive Operation Drop Folders will trigger ACTION data. The dropped files are processed as follows:

1. According to the folder FORMAT configured value, the file is either processed as a flat file (similar to the Comma Separated Values (CSV) format) or as an XML file.

2. According to the HEADER_ROW configured value, the first non-empty line is either skipped or processed.

3. Each following line is then parsed for fields, and the set of fields is used for a single action.

4. The configured value of the DELETE_AFTER_PROCESS parameter determines whether the original file is deleted or left in the folder when the end of the file is reached.

5. Each action is logged in a way that corresponds to the folder settings.

Proxy Drop Folders

Proxy Drop Folders are special-purpose Drop Folders used to import DIVAdirector Proxy files (media files using Windows Media 9.0 audio and video format). If the folder's INTERVAL parameter is configured to IMMEDIATELY the import is executed by monitoring the Windows File Change notifications. The system also re-scans every Proxy Drop Folder at one minute intervals to automatically process the files that have not yet been handled.

Note:
Oracle recommends using the new transcode service rather than Proxy Drop Folders. Also, continued use of proxies produced outside of DIVAdirector and DIVArchive for local proxies will continue to function, but is highly discouraged.

The Transcoding Engine typically writes the proxy file directly into the Proxy Drop Folder. The Proxy Drop Folder is then processed on each file system notification event, and when the file write operation finishes the file is processed according to the DIVAdirector system default setting as follows:

1. The file name is parsed for object name, category and language.
You configure the file name format in the folder's .xml file using the NAME_FORMAT parameter. The NAME_FORMAT can either be OBJECT NAME ONLY or OBJECT NAME + OBJECT CATEGORY. In the latter case, the last underscore character separates the object category from the object name.You configure the language format in the folder's .xml file using the LANGUAGE parameter, which can either be FROM NAME or FROM WM9 METADATA. In the former case, the last underscore symbol separates the language name from the object name (+Category), and the category is defined by the previous rule.In the latter case, the language name value is retrieved from within the media file and the internal Windows Media 9 format language tag is used.

Note:
The language name has literal language meaning only in cases of the embedded language. In other cases, it may have any informative value denoting, for example, director's commentary, sound effect channels, and so on. This allows the ability to distinguish between several alternative audio tracks related to the same video material.

2. The DIVArchive object is searched by parsed Name and Category values.

3. If the object is present in the DIVAdirector database, the proxy is registered to this object.

4. If the object is not present in the DIVAdirector database but appears to be known to DIVArchive, the new object is inserted into the DIVAdirector database and the proxy is registered.
This situation may occur when the proxy is dropped before the DIVAdirector database's next synchronization cycle. If the object is not present in the DIVAdirector database and there is no active connection to DIVArchive, the proxy file remains intact in the Drop Folder (the file gets frozen). It will then be processed the next time another proxy arrives in the folder.

5. A proxy that was not frozen in a Drop Folder is moved to one of the storage destinations.

6. The registered proxy is moved into a random subfolder of a Proxy folder. The subfolders are named 0 to 500.

7. The unregistered proxy is moved to a predefined Orphan Folder. You must check Orphan folders at least on a daily basis and decide what to do with orphaned objects.

Annotation Drop Folders

Annotation Drop Folders allow CSV files to be placed into the folder for importing locator metadata for the objects specified in the file.The following conditions apply to the CSV file:

- The file must be in Unicode, UTF-8 encoding.

- The file must contain a header row.

- The file must contain 6 columns as follows:

Object Name

This column is limited to 200 characters and should match the object name in DIVArchive.

Category Name

This column is limited to 200 characters and should match the object category name in DIVArchive.

Object Identifier

A show name or other object-specific identifier.

Start Time Code

Start time of the locator in the format hh:mm:ss:ff.

End Time code

End time of the locator in the format hh:mm:ss:ff. This field is not mandatory and if left empty the locator is considered a marker (description of a single frame).

Description

This column is limited to 2000 characters and is a text description of the locator (marker).

Next you will add a new DIVArchive Operation Drop Folder.

Metadata Drop Folder Configuration

This section addresses configuring Metadata Drop Folders. Clicking on the Dropfolder Configuration menu item in the Admin navigation tree opens the Dropfolders Configuration screen.

The following Metadata Drop Folder options are configured on the Dropfolders Configuration screen:

- Menu Options (on the top right side of the screen)

Save

Clicking this menu item saves the currently selected configuration.

Import

A file selector prompt will initiate the Drop Folder configuration import process. Both legacy XML formatted Drop Folder configurations and new configurations are supported. Once a configuration is imported, the Watch Path option and any other necessary configuration values must be identified before saving. Options that the current group does not have access to will not be imported. For example you cannot import metadata fields that your group does not have permission to edit.

Delete

Clicking this menu item deletes the currently selected configuration. The System Administrator must restart the DIVAdirector Drop Folders and Annotation services after deleting any active configuration.

Export

Clicking this menu item exports and downloads the current Drop Folder configuration in XML format.

- Metadata Drop Folder Configuration Options

- Folder Settings - all of these options are required.

Drop Folder Type

The type of Drop Folder dictates which configuration options are available. The METADATA type is currently the only option available.

Description

This is the title that will be reflected in the navigator and the name of the export file when the Drop Folder is exported.

Watch Path

This is the full path that the Drop Folder Monitor uses to look for new files to process. After a Drop Folder is configured and saved, the watch path cannot be modified.

Log File Path

This is the full path on the DIVAdirector Server that contains the individual log files for each file processing attempt.

Group Assignments

The currently assigned groups allowed to see this drop folder through the user interface. Drop folders that do not have any group assignments will still be active, but only available to ingest files from the file system.

Add Group

This is a drop-down list of available groups to assign. The list will only contain groups within the same organization as the logged in user. Only the SuperAdmin will be able to see all groups at once.

Enabled

Selecting this check box enables the configured Drop Folder. Deselecting the check box disables the configuration.

- File Process Settings

File Format Type

The value in this field defines the file format the Drop Folder is expecting. The following values are valid for Metadata Drop Folders:

CSV: Selecting this value displays the configuration options required to define the schema (see the following details).

XML: XML formatted metadata can be ingested provided the XML format guidelines are followed (see the following details)

JSON: This format is not currently implemented.

File Encoding

The configuration of the expected ingest files encoding. Confirm that these encoding settings are correct to properly ingest character sets outside of the ASCII standard.

Save Backup File

Selecting the check box for this option will save a copy of the ingested file in case there were any errors detected in processing. The backup file is only saved when processed by the Drop Folder Monitor, uploads from a Drop Folder Explorer page are never backed up on the server.

Backup Path

This is the full path on the server where backup copies are made in case an error in processing occurs. This field is required if the Save Backup File check box is selected (the option is enabled).

- Action Settings

Overwrite Old Data

This option overwrites existing metadata if an object already has metadata defined in the specified field.

Delete On Null

This option removes specified metadata from an object if an empty value is parsed from the processed file.

Virtualize

This option creates virtual objects if metadata is added to an object that does not currently exist in the archive.

- CSV File Format Settings

Delimiter

Importing CSV files supports using one of three delimiting characters - comma, semicolon, and tab.

Encapsulation

An encapsulation character allows the use of a delimiting character within the metadata value. Currently the only encapsulation character supported is a quotation mark. If an encapsulation character is present within the imported metadata it must be escaped with a backslash.

Has Header Row

When this check box is selected it indicates that the CSV has a one line header at the top of the file that must ignored by the parser.

Legacy Category Matching

This parameter enables matching metadata to objects without supplying a category within the dropped file. Matching can be achieved through a list of categories or all categories if the Use Only Object Name check box is selected.

Note:
Legacy Category Matching is mutually exclusive with the Virtualize option due to the lack of category provided within the dropped CSV.

- Field Mapping (CSV Specific)
Field mappings identify the order of the columns defined in your CSV file. Defined mappings can be reordered by dragging and dropping the fields into the desired positions. Every CSV import requires the predefined fields Name and Category. New fields can be added by clicking the + Add new record button. This displays the Field Mappings dialog box.

The Metadata Type list will only include fields that have not already been added to the Drop Folder and metadata types that the group has access to. The DateTime Mask field can be defined for date or time metadata, however if no mask is specified a generic format will be used. Fields can be edited or deleted at any time clicking either the Pencil or X icons respectively.

The Space Removal option enables trimming of white space from your provided file.

Note:
DateTime Masks use standard formatting strings. A full list of possible options can be found at https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx.

- XML Formatting
The following example shows the XML formatting required:

<XML Import>
<Category object_category="some category">
<Object object_name="some object name1">
<metadata1>data</metadata1>
<metadata2 dt_mask="some date time mask">date</metadata2>
</Object>
<Object object_name="some object name2">
<metadata1>data</metadata1>
<metadata2 dt_mask="some date time mask">date</metadata2>
</Object>
</Category>
(More Categories Can Be Defined Here)
</XML Import>

Adding New DIVArchive Operation Drop Folders

You must create and configure Drop Folders for use in DIVAdirector, they are not added during installation. The Drop Folder area is located at the bottom of the DIVAdirector Configuration Mode settings screen.

To perform operations on any listed Drop Folder, select the folder from the list and click the button associated with the desired action. The buttons are located within the Drop Folders area on the right side of the screen and include the following actions:

Add

Adds a new Drop Folder to the list of available Drop Folders.

Delete

Deletes the Drop Folder selected in the Drop Folders List.

Enable

Existing Drop Folders are either enabled or disabled. After being enabled, a disabled Drop Folder is ready to process future Drop Folder events. Enabling a Drop Folder does not trigger its immediate processing, even if the currently enabled folder is not empty. The folder will only be processed during the next event it is configured to run (unless you click Run).

Disable

A disabled Drop Folder does not provide any file processing, but remains in the configured Drop Folders list and retains its previously set configuration.

Reinitialize

This will reinitialize a Drop Folder after manual configuration changes have been made directly in the configuration file (rather than through the XML Wizard).

Run

This will cause the selected Drop Folder to process all configured actions immediately.

Settings

Users can reconfigure any Drop Folder at run-time if the preset configuration does not suite their current needs. This operation does not require the DIVAdirector Server to be restarted. To change the Drop Folder configuration using the XML Wizard, select the folder in the list and click Settings on the right side of the screen.

Use the following procedure to add a new Drop Folder to the system. After the folder is added you will need to configure it either using the XML Wizard or editing the folder's XML configuration file directly.

1. Click Add on the top right of the Drop Folder section.

2. Locate and select (single mouse click to highlight the folder) the folder intended for use as a DIVAdirector Drop Folder in the Browse for Folders dialog box that appears.

3. Click OK on the bottom of the dialog box.

4. If the folder does not already contain an XML configuration file, a prompt to configure the folder using the XML Wizard will be displayed.

5. Proceed through the XML Wizard (if applicable) and click Run when finished to trigger immediate Drop Folder processing.
If you prefer editing the configuration file directly you can do so using any Unicode-compatible text editor (like Notepad). Do not use programs like Microsoft Word to edit the configuration file because they add extra (hidden) characters to the file and will corrupt the configuration.

6. If you edited the configuration file directly, save the file as Unicode and reinitialize the Drop Folder using the Reinitialize button on the right side of the Drop Folder area.

7. Test the new folder's operation by dropping a file into the folder as a non-administrative user, and confirm that the configured action was executed correctly. For example, if you dropped a file into an ARCHIVE action Drop Folder, and the folder is configured to archive files to Storage-A, check Storage-A for the presence of the file you dropped into the folder.

Next you will add a new Proxy Drop Folder.

Adding New Proxy Drop Folders

Note:
Oracle recommends using the new transcode service rather than Proxy Drop Folders. Also, continued use of proxies produced outside of DIVAdirector and DIVArchive for local proxies will continue to function, but is highly discouraged.

All proxies registered in the DIVAdirector system are kept on Proxy Storage Disks. The DIVAdirector Server allows configuration and management of multiple proxy storage locations. You use the Proxy Storage Manager to manage and configure proxy storage locations. Access the Proxy Storage Manager by clicking Proxy Storage Manager on the bottom left of the DIVAdirector Configuration Mode Settings screen.The Proxy Storage Location is defined by the path to the folder on the file system (either a local location or network share). By default, one proxy location is added during DIVAdirector installation. The default location will be the C:\Program Files\DIVAdirector\proxies folder for a default installation. During a custom installation the location will be a folder selected by you.Each location has limited usable space on the storage device - the limit can either be relative or fixed. A relative limit is set as a percentage relative to the capacity of the storage device while a fixed limit is set in megabytes.

The Proxy Storage Manager allows users to view the following information about each proxy location on the Proxy Locations tab:

Status Icon

An icon in the first column of the display reflecting the current state of the proxy location.

Path

The path to the proxy location folder.

Capacity

The total amount of space on the storage device where the proxy is located.

Used

The space used in the proxy location, that is, the occupied space by all files in the folder at the moment.

Used %

The percentage of used space relative to the limit.

Available

The space available in the proxy location.

Available %

The percentage of available space relative to the limit.

Files

The number of files in the proxy location. It is not necessary for the proxies themselves to be registered in DIVAdirector - they are still residing on the storage location and using space.

Limit

The amount of space which can be used on the storage device.

Limit %

The percentage of limit space relative to the capacity of the storage device.

Use the procedures outlined next to add a new Proxy Storage Location. First you will map the storage location to Windows and set the folder permissions.

Map the Storage Location to Windows and Set Folder Permissions

1. Map the storage location so that it is visible in Windows.

2. If the folder is a network drive, make sure it is set to reconnect on Windows startup.

3. In Windows File Explorer, right-click the folder and select Properties from the menu.

4. In the middle of the security tab screen click Edit.

5. Click Add in the middle of the screen to add a new user to the folder's permissions.

6. When the Select Users or Groups dialog box appears, enter the IIS web server account (the default is dd5-user) used during DIVAdirector installation in the Object Name field (on the bottom of the screen) and click Check Names (to the right of the Object Name field) to verify that the entered name is valid.

7. When the user is verified click OK to add the user.

8. Repeat steps 5, 6, and 7 for Authenticated Users. Both users should now be added to the folder permissions and set correctly for the DIVAdirector Web Server.

Next you will add the Proxy Folder to the DIVAdirector Web Server.

Add the Proxy Folder to the DIVAdirector Web Server in IIS

1. Click the Windows Start button.

2. Enter inetmgr in the search box. The search will begin automatically.

3. When the inetmgr program is displayed in the search results, double-click the program name to start the application.

4. On the left side of the IIS Manager click the host computer's computer name under the Sites menu, and then click DIVAdirector 5.

5. Right-click DIVAdirector 5 and select Add Virtual Directory from the resulting menu.

6. Enter the Alias and Physical path of the new proxy storage location.

7. Click OK to complete the process.

Next you will add the Proxy Location to the DIVAdirector Server.

Add the Proxy Location to DIVAdirector Server

In order for users to access the proxy location created in the previous steps, the location must be added to the DIVAdirector Server configuration.

1. Start DIVAdirector in Configuration Mode and open the settings screen.

2. Click Proxy Storage Manager on the bottom of the DIVAdirector Configuration Mode Settings screen.

3. On the Proxy Storage Manager's Proxy Locations tab (opened by default) click New (two-thirds of the way down on the right side of the screen).

4. Locate and select (single mouse click to highlight the folder) the folder where registered proxies will be stored in the Browse for Folders dialog box.

5. Click OK to add the selected folder to the list of proxy locations.

Note:
The Proxy Location Path cannot be changed after it has been added.

6. On the Proxy Storage Manager screen navigate to the Proxy URL Search List tab and click Add on the right side of the screen.

7. Enter the Virtual Directory Name (this is the Alias Name entered into IIS) in the field located in the middle of the screen and click Set.

Next you will configure the storage size for the location.

Configuring the Proxy Location's Storage Size

1. In the Proxy Storage Manager, navigate to the Proxy Locations tab and select the proxy location you just added from the Proxy Storage Manager list. The options for the location become active at the bottom of the screen.

2. Select the type of limit (percentage or megabytes) desired using the Limit list.

3. Enter the limit size or percentage in the Limit field.

4. Click Apply Limit to apply the new limit and recalculate the used and available space of the selected proxy location.

Next you will configure the location filling strategy.

Configuring the Proxy Location Filling Strategy

The filling strategy defines how the proxy storages are filled with files. You can select one of two strategies. The strategy chosen will depend on the amount of storage available, number of storage locations available, internal organizational policies, and so on. The two available strategies are as follows:

Waterfall

The proxy file always goes to the first storage location on the chain that has enough free space. The order of locations can be changed using the Up and Down buttons.

Share Alike

The proxy file always goes to the less occupied storage location. This strategy spreads proxy files equally among storage locations.

If all registered storage locations have a status other than Open, the proxy file remains in the Proxy Drop Folder until another location is open and has enough free space to accept the file.

1. Select the appropriate Filling Strategy on the lower left side of the Proxy Locations tab screen.

2. Use the Up or Down buttons to change the priority of the location.

3. On the bottom right of the screen click Close.

The addition and configuration of the new location is now complete. Test the new location by dropping a proxy file into the folder as a non-administrative user and then open the file with the Proxy Player.

The next section describes the operational state of proxy locations.

Proxy Location Operational States

Proxy locations can be in one of the following five possible operational states. Each state has its own Status icon to graphically represent the current state of the location.

Open

The Open state Status Icon is a green filled-in cylinder with no additional markings. This indicates that the limit value has not been reached for this proxy location. Open locations can accept new files, can be explicitly transitioned to the Closed state only, and can participate in migration tasks.

Closed

The Closed state Status Icon is a yellow cylinder with a red X on top of it. This indicates that this proxy location does not accept new files. A Closed location can be explicitly transitioned to the Open state only and can participate in migration tasks as the source but not as the destination.

Overflown

The Overflown state Status Icon is a red cylinder with an exclamation mark on top of it. This indicates that the limit value has been reached for this proxy location. Overflown locations do not accept new files and cannot be transitioned to another state; however they can participate in migration tasks as the source but not as the destination. The filling strategy of the Proxy Storage Manager does not allow the overflowing of a location. Only external manipulations of the environment can result in this state of the storage location.

Migration

The Migration state Status Icon is a pink cylinder with a double-headed arrow underneath it. This indicates that the proxy location is in the process of migration. The Migration location does not accept new files and cannot be transitioned to another state until the migration process has completed.

Unreachable

The Unreachable state Status Icon is a greyed out cylinder with a question mark on top of it. This indicates that the proxy location is not currently detected in the environment (the path is not found). An Unreachable location cannot be transitioned to another state, migrated, or removed.

Next you will configure the Drop Folders to perform the desired actions when a user drops a file into the folder.

Drop Folder Configuration

There are parameters that are common to all Drop Folders. The common parameters are interpreted identically for all Drop Folders, but they are configured separately for each Drop Folder. The following subsections describe the common parameters.

DESCRIPTION Parameter

You include a logical description for the function of a particular Drop Folder using the DESCRIPTION parameter. The description appears in the DIVAdirector Server configuration screen's Drop Folder section for easy reference and identification. You should make the Drop Folder description vivid enough for everyone to immediately recognize exactly what action is executed when a file is dropped into the folder.

ACTION Parameters

You identify the action to be performed on the files located within the Drop Folder using one of the ACTION parameters. Each Drop Folder can have only one action configured in the folder's XML configuration file. Each ACTION value has a distinct status icon associated with it. The ACTION setting can have the following possible values:

PURGE

The PURGE icon consists of a file with a trash can below it and a P in the top left corner. This action results in the deletion of a file or one of its instances in the DIVArchive system.

RESTORE

The RESTORE icon consists of a file on the top right with a drive at the bottom, and a red R on the top left. This action results in restoring a DIVArchive file on one of its destinations.

Note:
Restore Drop Folders do not currently support Partial File Restore operations.

COPY

The COPY icon consists of two drives and a green C in the top left corner. This action results in copying a DIVArchive file instance, or instances, from one media to another.

ARCHIVE

The ARCHIVE icon consists of a file on the top right with a drive at the bottom, and a red A on the top left. This action results in archiving a set of files in the DIVArchive system and creation of a DIVArchive object (file container).

PROXY

The PROXY icon consists of two files and a red X on the top left. This action results in registering a DIVArchive proxy file in the DIVAdirector system. This action does not affect the DIVArchive system content.

SAMMA METADATA

The SAMMA METADATA icon consists of a file on the top right with a red container at the bottom and a green Q on the top left. This action results in moving SAMMAsolo generated metadata into the DIVAdirector's SAMMA metadata location.

PROXY Action

The PROXY action has specific values only applicable to this action. Users typically cannot access proxy storage directly because of security settings. The only way to play proxies is by logging into the DIVAdirector system as a user authorized to play proxies. The following list identifies each PROXY action-specific parameter, what it does, and how you should configure it.

PATH

The PATH folder setting defines the Root Proxies folder used as proxy storage. Every proxy file is placed into randomly selected subfolders named 0 to 500. The path may be a fully qualified folder path; either network-shared or local to the DIVAdirector host. A network path must be specified in Universal Naming Convention (UNC) format and mapped drive paths are not supported.

URL

The URL folder setting defines the URL path relative to a DIVAdirector web server root path. This setting is used in DIVAdirector internally although it is already obsolete in reference to its actual definition. Therefore, it is safe to always set it to /proxies for any Proxy Drop Folder.

ORPHAN

The ORPHAN folder setting is applied to the PROXY action and defines the full path where the unrecognized proxy files are placed. If a proxy is dropped and the file name is not lost, it is moved to the Orphan folder. This requires you to periodically check the folder and decide on what to do with any files located in the folder.

OBJECT_CATEGORY

The OBJECT_CATEGORY setting defines which category should be associated with the dropped proxy. This setting is disabled if OBJECT NAME + OBJECT CATEGORY is selected in the NAME_FORMAT setting.

The OBJECT_CATEGORY setting can have one of the following values:

Blank

This is the default setting. A file dropped in a Drop Folder with filename.wmv results in the file name being matched with the first file found in the database with a matching object_name regardless of its category.

Single Object Category

This setting defines which category the matching file should be in for the association.

* (asterisk)

This setting causes a file dropped into a Drop Folder with filename.wmv to be matched with all files found in the database with a matching object_name regardless of its category.

If the SoloSupport option is turned on, the system uses following process to determine how items are found:

1. The matching files will be found as is (case sensitive mode).

2. If no file was found, files will be found with a matching upper case object_name (the object_category remains as is).

3. If no file was found in Step 2, then files will be found with a matching upper case object_name and an upper case object_category.

NAME_FORMAT
The NAME_FORMAT parameter defines the proxy file name format to be used. The proxy file must be dropped into the Proxy Drop Folder to be correctly registered in DIVAdirector.

The NAME_FORMAT setting can have one of the following values:

OBJECT NAME + OBJECT CATEGORY

DIVAdirector obtains the object name and object category from the file name. The object name and category must be separated by an underscore character - that is objectname_objectcategory.wmv

OBJECT NAME ONLY

DIVAdirector only gets the object name from the file name - that is filename.wmv

LANGUAGE
The LANGUAGE parameter is responsible for how DIVAdirector defines the language in the audio proxy files. The LANGUAGE setting can have one of the following values:

From Name

DIVAdirector gets the language from the .wma file name. The name must be formatted as follows to be successfully registered in the DIVAdirector database:

- OBJECT NAME + OBJECT CATEGORY
objectname_objectcategory.wmv

objectname_objectcategory_language.wma

- OBJECT NAME ONLY
objectname.wmv

objectname_language.wma

From WM9 Metadata

DIVAdirector gets the language from the .wma file settings.

- OBJECT NAME + OBJECT CATEGORY
objectname_objectcategory.wmv

objectname_objectcategory.wma

- OBJECT NAME ONLY
objectname.wmv

objectname.wma

ARCHIVE Action

The ARCHIVE action has specific values applicable to this action. Objects dropped into an ARCHIVE action folder are sent to storage locations designated in the folder's configuration as archiving storage. You should create an ARCHIVE action Drop Folder for each designated archive storage location. The following list identifies each ARCHIVE action-specific parameter, what it does, and how you should configure it.

COMMENTS

The COMMENTS parameter specifies the default comments value for the ARCHIVE action.

DELETE_ON_SOURCE

The DELETE_ON_SOURCE parameter instructs DIVArchive to delete the original set of files on the source after tape migration is complete.The DELETE_ON_SOURCE parameter can have the values YES or NO. NO is the default value.

FIELD (Record Field Mapping)

This FIELD mapping introduces a set of variables embedded into the FILE_NAME_LIST and FILE_PATH_ROOT settings. The example below shows the configuration, but the variables must be expanded (replaced with the actual record field values) at the action's run time.

<FIELD>

<ORDINAL>1</ORDINAL>

<MAPS_TO>variableName1</MAPS_TO>

</FIELD>

<FIELD>

<ORDINAL>7</ORDINAL>

<MAPS_TO>variableName7</MAPS_TO>

</FIELD>

FILE_NAME_LIST

The FILE_NAME_LIST parameter specifies the default file name list for the ARCHIVE action. DIVAdirector functionality enables users to compose complex lists with expandable substitutions from the FIELD and MAPS_TO Drop Folder settings. The FILE_NAME_LIST value contains possible variable fields (symbolic names enclosed by dollar signs) which are substituted with values from the corresponding input fields. Each variable is expected to be mapped to the field name (MAPS_TO). Otherwise, the variable is left in the FILE_PATH_ROOT as is.Only the OBJECT_NAME and OBJECT_CATEGORY are predefined mappings - any other mappings can be arbitrary names.

FILE_PATH_ROOT

The FILE_PATH_ROOT specifies the default File Path Root folder for the ARCHIVE and RESTORE actions. To gain a full understanding of the FILE_PATH_ROOT, you must know the file structure on the Source/Destination.Specifically for the ARCHIVE action this setting can contain variables (symbolic names enclosed by dollar signs). The variables whose names are found in a FIELD mapping are expanded with the actual field value at run-time; otherwise the variables are left in the FILE_PATH_ROOT as they are.

MEDIA_NAME

The MEDIA_NAME parameter specifies the default media name for the RESTORE, ARCHIVE, and COPY actions used to properly form the necessary DIVArchive API archive command. The MEDIA_NAME must match the name that is in DIVArchive.Similar to the OBJECT_CATEGORY parameter, the MEDIA_NAME value is necessary to form the API commands unless the field mapping in the XML configuration file for the Drop Folder includes a mapping for res_media_name. The value included in each record of the input file supersedes the value (if any) in the MEDIA_NAME setting.

SOURCE_DESTINATION

The SOURCE_DESTINATION parameter specifies the configured DIVArchive sources and destinations used for the ARCHIVE and RESTORE actions. It is important that the values configured must match the setting in DIVArchive exactly as they will be used to transparently complete the necessary ARCHIVE and RESTORE API commands.The SOURCE_DESTINATION configuration settings are mandatory for the ARCHIVE and RESTORE actions, and are ignored for the METADATA and PURGE actions. The ARCHIVE action configuration should list only one source, but the RESTORE action list can have up to a maximum of ten destinations.The sources and destinations are identified by symbolic names, but could represent video servers, FTP server locations, editing systems, and so on.It is not necessary for the Source/Destination values to be configured in DIVAdirector for Drop Folder processing to successfully execute the archive or restore operations.

RESTORE Action

The RESTORE action has specific values applicable to this action. Objects dropped into a RESTORE action folder are sent to storage location designated in the folder's configuration as restore storage. You create a RESTORE action Drop Folder for each designated restore storage location.

Note:
Restore Drop Folders do not currently support Partial File Restore operations.

The following list identifies each RESTORE action-specific parameter, what it does, and how you should configure it.

FILE_PATH_ROOT

The FILE_PATH_ROOT parameter specifies the default file path root for the ARCHIVE and RESTORE actions. You must know the file structure on the Source/Destination to gain a full understanding of the FILE_PATH_ROOT.

For the ARCHIVE action this setting can contain variables (symbolic names enclosed by dollar signs). The variables whose names are found in a FIELD mapping are expanded with the actual field value at run time; otherwise the variables are left in the FILE_PATH_ROOT as they are.

MEDIA_NAME

The MEDIA_NAME parameter specifies the default media name used to properly form the necessary DIVArchive API command for the RESTORE, ARCHIVE, and COPY actions. The MEDIA_NAME must match the name that is in DIVArchive.

Similar to the OBJECT_CATEGORY parameter, the MEDIA_NAME value is necessary to form the API commands unless the field mapping in the XML configuration file for the particular Drop Folder includes a mapping for res_media_name. The value included in each record of the input file supersedes the value in the MEDIA_NAME parameter.

INSTANCE

Because multiple copies (instances) of a single object can be present within the DIVArchive system, the INSTANCE parameter specifies which instances of the file to perform the RESTORE, COPY, and PURGE operations on. This parameter is optional for all of these actions, but you can use it to specifically instruct DIVArchive to use a particular instance of the object to complete a request. The value for this parameter can be any integer.

SOURCE_DESTINATION

The SOURCE_DESTINATION setting identifies the configured DIVArchive sources and destinations used for the ARCHIVE and RESTORE actions. It is important to note that the values configured must match the setting in DIVArchive exactly as they will be used to transparently complete the necessary ARCHIVE and RESTORE API commands.The SOURCE_DESTINATION configuration settings are mandatory for the ARCHIVE and RESTORE actions, and are ignored for the METADATA and PURGE actions. The ARCHIVE action configuration should list only one source, but the RESTORE action list can have up to a maximum of ten destinations.The sources and destinations are identified by symbolic names but could represent video servers, FTP server locations, editing systems, and so on.It is not necessary for the Source/Destination values to be configured in DIVAdirector for Drop Folder processing to successfully execute the archive or restore operations.

COPY Action

The COPY action has specific values applicable to this action. Objects dropped into a COPY action folder are copied to storage locations designated in the folder's configuration as a storage destination. You create a COPY action Drop Folder for each designated storage destination location. The following list identifies each COPY action-specific parameter, what it does, and how you should configure it.

INSTANCE

Because multiple copies (instances) of a single object can be present within the DIVArchive system, the INSTANCE parameter specifies which instances of the file to perform the RESTORE, COPY, and PURGE operations on. This parameter is optional for all of these actions, but you can use it specifically instruct DIVArchive to use a particular instance of the object to complete a request. The value for this parameter can be any integer.

PURGE Action

The PURGE action has specific values applicable to this action. Objects dropped into a PURGE action folder are deleted from a storage location designated in the folder's configuration. You create a PURGE action Drop Folder for each designated storage location where objects may need deletion. The following list identifies each PURGE action-specific parameter, what it does, and how you should configure it.

INSTANCE

Because multiple copies (instances) of a single object can be present within the DIVArchive system, the INSTANCE parameter specifies which instances of the file to perform the RESTORE, COPY, and PURGE operations on. This parameter is optional for all of these actions, but you can use it specifically instruct DIVArchive to use a particular instance of the object to complete a request. The value for this parameter can be any integer.

Next you will go through the XML Wizard used for configuring Drop Folders.

Using the XML Wizard

The DIVArchive Operation Drop Folder Configuration dialog box (also known as the XML Wizard) is a Windows wizard-style tool for you to create and edit Drop Folder configuration XML files. The XML files are configurable and editable directly as discussed in the following section, but the wizard makes these tasks easier and quicker. It visualizes the process of creating the Drop Folder configuration file, and assists in configuration validation and consistency.

To invoke the wizard, add a new Drop Folder or select an existing one in the DIVAdirector Server Configuration dialog box and click Settings.

ACTION Screen

The Action screen is the first screen in the wizard. You select the Drop Folder ACTION and enter a Drop Folder DESCRIPTION string on this screen.

1. Select the Drop Folder's action from the ACTION list.

2. Enter a description in the DESCRIPTION field. Descriptions should be vivid enough for everyone to determine at a glance exactly what the folder does when a file is dropped into it.

3. Click Next to advance to the next screen.

Settings Screen (Next or Final)

The Settings screen is the first screen where all Drop Folder parameter values (except field mappings) are specified.

For DIVArchive Operation Drop Folders you will click Next to continue to the Field Mappings screen before completing the wizard.

Since there are no values required in field mappings for a Proxy Drop Folder, this screen is the final screen in this case. After entering the necessary values, click Finish to complete the wizard.

The following points are significant during the configuration process:

- After selecting an INTERVAL item from the list, make sure you replace all XX or XXX placeholders with the actual values required.

- The RECORDS_TO_PROCESS value does not affect Metadata Drop Folders.

- The FILE_CODE_PAGE values that are currently supported include 1252 (Windows Latin-I, Western European) and 1255 (Windows Hebrew). If the dropped files contain any characters that do not correspond to an available code page, Unicode (little-endian) must be used with files for importing.

- To create a SOURCE_DESTINATION list containing several items, use the + or - buttons to correspondingly add or remove currently displayed items.

- PRIORITY values cannot be manually entered (in the XML Wizard) and must be selected from the ones present in the list. Edit the configuration file manually to enter a numeric value between 0 and 100.

- FILE_PATH_LIST and FILE_PATH_ROOT values can be set regardless of whether the corresponding mappings were added on the wizard's next Field Mappings screen. The variable names are not verified in any way for matching with field mappings intended for use.

1. Use the lists to select each parameter's value.

2. Enter the values into the fields as necessary.

3. Click either Finish (for Proxy Drop Folders) or Next (for DIVArchive Operation Drop Folders).

The Settings screen has the following parameters specifically for the PROXY action:

ORPHAN

The ORPHAN folder parameter is applied to the PROXY action and defines the full path where the unrecognized proxy files are placed. If a proxy is dropped and the file name is not lost, it is moved to the Orphan Folder. This requires you to periodically check the folder and decide on what to do with any files located in the folder.

OBJECT_CATEGORY

The OBJECT_CATEGORY parameter defines which category should be associated with the dropped proxy. This setting is disabled if OBJECT NAME + OBJECT CATEGORY is selected for the NAME_FORMAT parameter.

NAME_FORMAT

The NAME_FORMAT parameter defines the proxy file name format to be used. The proxy file must be dropped into the Proxy Drop Folder to be correctly registered in DIVAdirector.

LANGUAGE

The LANGUAGE parameter is responsible for how DIVAdirector defines the language in the audio proxy files. The LANGUAGE setting can have one of the following values:

From Name

DIVAdirector obtains the language from the filename.wma file's name.

From WM9 Metadata

DIVAdirector obtains the language from the filename.wma file's settings.

Field Mapping Screen (Final)

The XML Wizard starts this page with a blank list. You must add and configure all field mappings required for them to be available during import operations.

The following points are significant during the field mapping process:

- After adding a new mapping template, its ORDINAL value is set to zero. A zero ORDINAL value is not allowed in the field mappings and therefore it must be modified.

- With the ARCHIVE action (specifically), the MAPS_TO setting may be filled with the variable name to be used in the FILE_PATH_LIST and the FILE_PATH_ROOT settings. Confirm that the value is entered correctly, independent of the variable definition or usage.

1. Click Add on the bottom left side of the screen to add a new field mapping.

2. Select the necessary field mapping parameter and click OK. You will be returned to the Field Mapping screen.

3. Enter the value for the new parameter.

4. Repeat these steps for each field mapping required.

5. Click Finish to save the changes.

If one or more invalid values were entered during the configuration process you will receive one or both of the following error messages. Each message contains either the name of the parameter where the error was detected or a Drop Folder logic violation description.

The first type of error message includes the error found and the parameter causing the error.

The second type of error message includes the logic error description and the parameter value causing the error.

If either one (or both) of these messages is received, return to the corresponding wizard page and fix the value causing the error - then click Finish to complete the wizard.

Next you will go through how to edit XML configuration files directly.

Directly Editing XML Configuration Files

The XML configuration file defines the configuration parameters for the Drop Folder. Several generic rules apply to the XML tags including:

- If an XML tag's setting (value) is omitted, the default value is applied.

- Any setting that is meaningless in the current action context is ignored even if it is present in the XML configuration file.

- All settings (values) are not case sensitive.

When you are editing an XML configuration file directly (rather than using the XML Wizard), only edit the file using a plain-text Unicode editor. Use of word processing programs (such as Microsoft Word) adds extra hidden formatting codes into the files when they are saved. These codes will corrupt the Drop Folder's XML file. You should only use an editor like Notepad or Notepad ++ and save the file as Unicode.

The Drop Folder XML configuration file can include the following configuration parameters:

ACTION

The action to be performed on the files located within the Drop Folder; such as ARCHIVE, COPY, RESTORE, and PURGE.

CLEAN_UP_INTERVAL

Specifies how long an import file may stay in a Drop Folder.

COMMENTS

Specifies the default comments value for the ARCHIVE action.

DATABASE_CHECK

Specifies whether the DIVAdirector system should verify the existence of the particular object name in each record of the input file for RESTORE, ARCHIVE, and PURGE actions before issuing the appropriate DIVArchive command.

DD_REQUEST_SET_SIZE

Specifies the size of a set of requests sent to DIVArchive that cannot be interrupted by getting the DIVArchive Request Queue Size.

DD_SLEEP_INTERVAL

The interval that must elapse between sending sets of requests to DIVArchive.

DELETE_AFTER_PROCESS

Specifies whether DIVAdirector should delete the input file once processing has completed or leave the input file as is for subsequent processing. This is useful for situations with a large input file metadata for many objects which, over time, will be ingested and archived to DIVArchive. The file remains in the Drop Folder until processing is successful.

DELETE_ON_SOURCE

Instructs DIVArchive to delete the original set of files on the source after Tape Migration completion.

DESCRIPTION

You should include a logical description for the function of each Drop Folder so it is easily identifiable to everyone. This description will appear in the DIVAdirector Server GUI for easy reference.

DIVA_MAX_QUEUE_SIZE

Specifies the maximum DIVArchive request queue size allowed.

ENCAPSULATION

Specifies the encapsulating character used to enclose each value contained within the input file, such as a single quotation mark, double quotation mark, or no encapsulation.

FILE_CODE_PAGE

Defines the rule on how a non-Unicode import file must be interpreted.

FILE_NAME_LIST

Specifies the default file name list for the archive operation. DIVAdirector functionality gives users the ability to compose complex lists with expandable substitutions retrieved from the FIELD and MAPS_TO Drop Folder settings.

FILE_PATH_ROOT

Specifies the default File Path Root for archive and restore operations.

FORMAT

Defines the expected format of the input files. Currently, the system supports only the Flat File format. Depending upon the option selected for this setting, only files in the specified format should be placed into the Drop Folder.

HEADER_ROW

The section header that implies an XML tag and contains the possible configuration setting values.

INSTANCE

Used to specify which instances of the file to perform the RESTORE, COPY, and PURGE actions on.

INTERVAL

Defines how often and when to process files in the Drop Folder.

LANGUAGE

Specifies from where DIVAdirector should extract the language of an audio proxy file.

MATCHING_OBJECT_NOT_FOUND

Specifies what DIVAdirector should do with objects not found in the database. This will either be to return an error or to create a virtual object.

MEDIA_NAME

Specifies the default media name for the RESTORE, ARCHIVE, and COPY actions used to properly form the necessary DIVArchive API archive command.

NAME_FORMAT

Specifies how DIVAdirector should extract the name and category from the proxy file name.

OBJECT_CATEGORY

Specifies the default object category for specific actions such as PURGE, ARCHIVE, RESTORE, and COPY. The object category value is used in combination with the object name found in each record of the input file to properly form the necessary DIVArchive API commands.

OPTIONS

Specifies the default options for the ARCHIVE and RESTORE actions and contains the login and password parameters for the available sources and destinations.

ORPHAN

Applied to the proxy action and defines the full path where the unrecognized proxy files are placed. If the proxy connection is dropped and the file name is not lost, then it is moved to the Orphan Folder. This requires you to periodically check the Orphan Folder and decide on what to do with the files.

PATH

Defines the Root Proxies Folder used as proxy storage. Every individual proxy file is placed into a randomly selected subfolder named 0 to 500. Users typically cannot access proxy storage directly due to security settings. The only way for users to play proxies is by logging into the DIVAdirector system as a user authorized to play proxies

PRIORITY

Specifies the default priority level for the ARCHIVE, RESTORE, COPY, and PURGE actions.

QUALITY_OF_SERVICE

Specifies the default Quality of Service for the ARCHIVE and RESTORE operations.

RECORDS_TO_PROCESS

Specifies the maximum number of records to process in the particular input file. This allows some level of control over the number of requests which could potentially flood the DIVArchive system.

RESULTANT_FILE

This setting defines whether the DIVAdirector system creates a single or multiple resultant files following the processing of an input file.

RESULTANT_FILE_PATH

Specifies the path where DIVAdirector should place the processed files with the results of the processing operation.

SEPARATOR

Specifies how the values within each line of the input file must be separated for the Drop Folder.

SOURCE_DESTINATION

Specifies the path where DIVAdirector should place the processed files with the results of the processing operation.

SPACE_REMOVAL

Specifies whether DIVAdirector should trim leading spaces, trailing spaces, or both for data contained in each of the input field values.

URL

Defines the URL Path relative to a DIVAdirector web server Root Path. It is always safe to set it to /proxies for any Proxy Drop Folder.

Next you will configure parameters specific to DIVArchive operations.

DIVArchive Operation Drop Folder Specific Configuration

The RESTORE, ARCHIVE, COPY, and PURGE DIVArchive operations for the DIVArchive Operation Drop Folders have specific parameters that can be applied only for these types of actions. The following common parameters are available for all four types of actions:

DATABASE_CHECK

The DATABASE_CHECK parameter specifies whether the DIVAdirector system should verify the existence of the particular OBJECT_NAME in each record of the input file for the RESTORE, ARCHIVE, COPY, and PURGE actions before issuing the appropriate DIVArchive command.

Regardless of whether a file is present in the DIVAdirector database, the file is always checked within DIVArchive. Files can also have double registration - that is, instances in both DIVAdirector and DIVArchive.

The DATABASE_CHECK parameter can contain the following values:

YES

This is the default value and checks the database for the existence of the object.

NO

No database check is performed.

DD_SLEEP_INTERVAL
The DD_SLEEP_INTERVAL parameter is the interval that must elapse between sending sets of requests to DIVArchive. The default value for this setting is 60 seconds.

DD_REQUEST_SET_SIZE
The DD_REQUEST_SET_SIZE parameter specifies the size of a set of requests sent to DIVArchive that cannot be interrupted by getting the DIVArchive Request Queue Size. The default value is 10.

DIVA_MAX_QUEUE_SIZE
The DIVA_MAX_QUEUE_SIZE parameter specifies the maximum DIVArchive request queue size allowed. The default value is 150.

This setting limits the load on the DIVArchive system because DIVArchive Drop Folders can easily flood the system with automatically generated requests.

Before issuing the next set of requests, DIVAdirector Server receives the current queue size. If it is greater than the corresponding Drop Folder setting value, the server ceases requesting for the DD_SLEEP_INTERVAL time.

PRIORITY
The PRIORITY parameter specifies the default priority level for the ARCHIVE, RESTORE, COPY, and PURGE actions. You can use any integer number between 0 and 99 specifically identify a priority value for processing files in that Drop Folder.

The PRIORITY parameter can have one of the following values:

NORMAL

50 (This is the default value)

MIN

0

LOW

25

HIGH

75

MAX

99

RECORDS_TO_PROCESS
The RECORDS_TO_PROCESS parameter specifies the maximum number of records to process in a particular input file. This allows some level of control over the number of requests which could potentially flood the DIVArchive system. The DIVAdirector system processes the first set of records in the input file as defined by this value. It is assumed that the number of all records is less than one hundred.

The RECORDS_TO_PROCESS parameter can have the following values:

100

This is the default setting and processes a maximum of one hundred records.

0

This setting processes all records in the input file and is the most commonly used.

NNN

This can be any integer (NNN) number of records to process in the input file.

QUALITY_OF_SERVICE
The QUALITY_OF_SERVICE parameter specifies the default Quality of Service for ARCHIVE and RESTORE actions.

The QUALITY_OF_SERVICE parameter can have one of the following values:

Default

The default setting is configured by the DIVArchive System Administrator.

Cache Only

This setting uses only objects that have been cached.

Direct Only

This setting uses only objects that are directly accessed.

Cache and Direct

This setting uses both cached and direct objects and the cached objects have precedence.

Direct and Cache

This setting uses both direct and cached objects and the direct objects have precedence.

ARCHIVE Action Parameters

The ARCHIVE Drop Folder operation provides a list-based content archive feature allowing objects to be automatically moved into DIVArchive based on the contents of a file. The ARCHIVE Drop Folder operation is based on the following configuration parameters:

- The XML configuration file defines which fields in the flat file contain the OBJECT_NAME and OBJECT_CATEGORY to be processed, and which DIVArchive source is used for the Archive API command.

- Only a single DIVArchive storage location can be identified in the XML file.

- DIVAdirector processes the flat file record by record, and issues the DIVArchive Archive command for each OBJECT_NAME found in the flat file for the storage location configured in the XML configuration file.

- All records in the objects are processed because the files may or may not exist in DIVArchive at the time of processing. This indicates that the DATABASE_CHECK setting is not applicable to this action type.

COPY Action Parameters

The COPY Drop Folder operation provides a list-based copy feature for DIVAdirector to create new instances of objects within the DIVArchive system for operations - for example content pre-staging to a managed disk. The COPY Drop Folder operation is based on the following configuration parameters:

- The XML configuration file defines which fields in the input file contain the OBJECT_NAME and OBJECT_CATEGORY whereby a new instance will be created, and which DIVArchive media names are the targets of the copy operation.

- The defined media names must exist in DIVArchive.

- Because of the nature of the copy operations, multiple media names can be defined in each Drop Folder's XML configuration file. DIVAdirector issues a separate copy request for the object found in each input file record for each of the media names in the XML configuration file.

- Objects that are located in the input file but not found in DIVAdirector are either skipped and logged to the Results file, or processed blindly based on the XML configuration file's DATABASE_CHECK value.

- The priority for the COPY action is defined in the XML configuration file for the particular folder.

- Each record in the input file can also contain the OBJECT_CATEGORY corresponding to the particular OBJECT_NAME, or the OBJECT_CATEGORY can be globally defined in the XML configuration file for all input files placed in the Drop Folder.

- The OBJECT_CATEGORY in each input file record supersedes any globally configured in the XML configuration file only if the OBJECT_CATEGORY parameter is configured as one of the mapped fields in that Drop Folder.

RESTORE Action Parameters

The RESTORE Drop Folder operation provides a list-based restore feature for DIVAdirector to copy objects and files to a set of identified storage locations.

Note:
Restore Drop Folders do not currently support Partial File Restore operations.

The RESTORE Drop Folder operation is based on the following configuration parameters:

- The XML configuration file defines which fields in the input file contain the OBJECT_NAME and OBJECT_CATEGORY to be processed, and which DIVArchive storage locations are the targets of the restore operation.

- The defined storage locations must exist in DIVArchive, but may or may not be configured in DIVAdirector.

- Because of the nature of the restore operation, multiple destinations may be defined in each Drop Folder's XML configuration file. DIVAdirector will issue a separate restore request for the OBJECT_NAME found in each input file record for each of the storage locations in the XML configuration file.

- Objects that are located in the input file but not found in DIVAdirector are either skipped and logged to the Results file, or processed blindly based on the XML configuration file's DATABASE_CHECK value.

- The priority for the RESTORE action is defined in the XML configuration file for the particular folder.

- Each record in the input file can also contain the OBJECT_CATEGORY corresponding to the particular OBJECT_NAME, or the OBJECT_CATEGORY can be globally defined in the XML configuration file for all input files placed in the Drop Folder.

- The OBJECT_CATEGORY in each input file record supersedes any globally configured OBJECT_CATEGORY setting in the XML configuration file only if the OBJECT_CATEGORY is configured as one of the mapped fields in the Drop Folder.

PURGE Action Parameters

The PURGE Drop Folder operation provides a list-based content purging feature for DIVAdirector to remove objects and files from DIVArchive based on the contents of a file.

Caution:
You must be very careful when defining a Drop Folder to perform the PURGE action because files will be processed blindly and any matching objects will be removed from the DIVArchive system. There is currently no function available to undo the purge operation once an object has been deleted.

The PURGE Drop Folder operation is based on the following configuration parameters:

- The XML configuration file defines which fields in the flat file contain the OBJECT_NAME and OBJECT_CATEGORY to be processed.

- DIVAdirector processes the flat file record by record and issues DIVArchive delete commands for each OBJECT_NAME found in the file.

- Objects that are located in the input file but not found in DIVAdirector are either skipped and logged to the Results file, or processed blindly based on the XML configuration file's DATABASE_CHECK value.

- The priority for the PURGE action is defined in the XML configuration file for that particular folder in addition to any other necessary parameters.

- Each record in the input file may also contain the OBJECT_CATEGORY corresponding to the particular OBJECT_NAME, or the OBJECT_CATEGORY can be globally defined in the XML configuration file for all input files placed in the Drop Folder.

- The OBJECT_CATEGORY in each input file record supersedes any globally configured in the XML configuration file only if OBJECT_CATEGORY is configured as one of the mapped fields in the Drop Folder.

Next you will configure the DIVAdirector Transcode Service.

Transcode Service Configuration

DIVAdirector 5.3 introduces a new transcode service to the system. The service contains two main components. The first component is a RESTful API for submitting and viewing requests, and viewing currently configured transcoder information (name, version, and so on). The second component is a time-based background process that executes periodically to update the progress and state of all actively transcoding requests.

The Root Path must point to a location that the currently configured transcoder implementation service can read. However, the new transcode service itself does not need read access to the location. To clarify the distinction between the new transcode service and the transcoder implementation, the transcode service provides a common interface for multiple transcoder implementations (for example, Vantage, FlipFactory, and so on). The transcoder implementation (for example, the Vantage service) requires read access to the root path.

The transcode service API is in a self-hosted Open Web Interface for .NET (OWIN) application and contained in a Windows service - removing any dependency on IIS. The request information is held in a SQL Server Express LocalDB database that is installed with the service installer, and accessed by the data layer through a common interface.

The transcode service will proxy a selected file with a valid file extension (see ProxyableFileExtensions in "Web Configuration File Changes") when a request is made to the Transcode Service Source/Destination from DIVAdirector. To use the transcode service, you select transcodeSvc as the source or destination when submitting requests. To configure the new transcode service correctly, the Source Name must match the DIVAdirector TranscodeSourceDestName configuration value, and the Connect Options entry does not include any of the tr flags (for example tr_restore_format, tr_names, and so on).

A sample source and destination configuration is shown in the figure below. The selection of this particular source and destination location (the restore destination matches TranscodeSourceDestName key) has an implied transcode and proxy creation on restore completion.

Note:
Only the Vantage transcoder is currently supported for use with the new transcode service.

Web Configuration File Changes

The transcode service requires several changes to the DIVAdirector Web configuration. The web configuration file is located in the installation's www folder. For example, C:\Program Files (x86)\DIVAdirector 5\www\Web.config.

The setting updates are as follows:

DIVArchive Web Services (WS) Endpoint

You can configure the WS Endpoint to any available port.

<add key="DIVArchiveAPIUrl" value="http://10.80.106.57:9763/services/DIVArchiveWS_REST_2.1/" />

appName

This identifies the name of the application to be registered in the DIVArchive WS API interface. Specifically, the value of the appName parameter passed to the registerClient method. This is required before interfacing with the DIVArchive WS API.

<add key="appName" value="DIVAdirector" />

TranscodeSourceDestName

This identifies the name of the preconfigured source or destination that defines the DIVArchive restore location to be used by DIVAdirector for creating proxies with the transcoding service.

<add key="TranscodeSourceDestName" value="transcodeSvc"/>

Windows Service Changes

The DIVAdirector Windows Service installed along with the web application handles background tasks performed outside of the context of a web request (for example, proxy creation, metadata extraction, Drop Folder monitoring, and so on). The Windows Management Console displays the legacy service as DIVAdirector Server Service.

Background task functionality is being migrated away from the legacy Windows service to a new service. However, the new Oracle.DIVAdirector.TaskManager Windows service currently handles only a subset of the functionality and therefore both services are currently installed by the DIVAdirector installer.

The Oracle.DIVAdirector.TaskManager service configuration file (Oracle.DIVAdirector.TaskManager.exe.config) is located in the C:\Program Files (x86)\DIVAdirector 5\TaskManager\ folder.

The configuration file has four main sections that need your attention as described below.

1. DIVArchive Web Services API REST Endpoint Configuration
Four settings require configuration in the <appSettings> section:

applicationName

This is the name of the application to be registered in the WS API interface. Specifically, this is the value of the appName parameter passed to the registerClient method. This is required before interfacing with the WS API.

<add key="applicationName" value="app name" />

locationName

This identifies the physical location where the computer running the client is located. Specifically, the value of the locName parameter passed to the registerClient method. This is required before interfacing with the WS API.

<add key="locationName" value="location name" />

processID

This identifies the process ID number used for registering the client application. Specifically, the value of the processID parameter passed to the registerClient method. This is required before interfacing with the WS API.

<add key="processId" value="1234" />

DIVArchiveApiUrl

This identifies the WS API REST endpoint. You can use any available port number for the endpoint.

<add key="DIVArchiveApiUrl" value="http://10.80.106.57:9763/services/DIVArchiveWS_REST_2.1/" />

2. Transcoder Service Access Configuration
Three settings require configuration in the <TranscodeSettingsConfigurationSection> section.

TranscoderClientSettings

The TranscoderApiUrl is the url of the transcode service base API endpoint. An optional int LocationId can be added to TranscoderClientSettings to override the default location.

<TranscoderClientSettings TranscoderApiUrl="http://localhost:9876/api/"

PresetName

The PresetName is the name of a preset configuration in the transcode service. A preset is a name associated with a preset ID (for example, a Vantage workflow ID).

PresetName="Default Video Proxy"

ProxyableFileExtensions

The ProxyableFileExtensions is the list of file extensions for which the service will try to create a proxy.

ProxyableFileExtensions="mxf,lxf,avi,mpg,mpeg,mov,mp4">

The list of parameters below is being passed to the preset workflow defined by PresetName. You can add more parameters to this list as needed without any code changes.

<Parameters> <Parameter Key="GenerateKeyFrames" Value="True" /> <Parameter Key="KeyframeCaptureInterval" Value="00:00:01:00@29.97" /> </Parameters>

3. Task and Task Interval Configuration
The following tasks are configured in the <ScheduledTasks> section and run by the Windows service. You cannot disable any of these tasks without losing functionality. However, you can tune an interval timer with the IntervalInSeconds parameter to achieve better performance.

TranscodeOnRestoreCompleteTask

This task polls the progress of a DIVArchive restore request (through the DIVArchive Web Services (WS) API REST endpoint), and initiates a transcode request upon completion. This task is also responsible for calling the proxy creation service.

<ScheduledTask Name="TranscodeOnRestoreCompleteTask" Type="Oracle.DIVAdirector.TaskManager.Tasks.TranscodeOnRestoreCompleteTask, Oracle.DIVAdirector.TaskManager" IntervalInSeconds="10" Enabled="true" />

UpdateRequestsStatusTask

This task monitors and updates the state and progress of all active DIVArchive requests.

<ScheduledTask Name="UpdateRequestsStatusTask" Type="Oracle.DIVAdirector.TaskManager.Tasks.UpdateRequestsStatusTask, Oracle.DIVAdirector.TaskManager" IntervalInSeconds="10" Enabled="true" />

4. Postgres Database Communication Configuration
This connection string should use the same server and credentials as the connection string defined in the DIVAdirector web application's web.config file.

<connectionStrings><add name="DIVADirectorContext" connectionString="Server=localhost;Database=DIVAdirector;User Id=postgres;Password=Manager;" providerName="Npgsql" /></connectionStrings>

Starting and Stopping the Transcode Service Windows Services

Both Windows services for the Transcode Service should be set to start automatically. The two services display in the Windows Service Manager using the names Oracle.Transcode.Api.Owin and Oracle.Transcode.TaskManager.

You can manually control either of the services from the Windows Services Manager or using a Windows command line. Use the following command line options to control either of the services:

install

This option installs the service.

start

This option starts the service.

stop

This option stops the service.

restart

This option stops and then restarts the service.

uninstall

This option removes the service.

status

This option shows the current status of the service.

help

This option displays a help dialog.

For example, use the following command to start the API Service:

Oracle.Transcode.Api.Owin.exe start

Use the following command to stop and subsequently restart the Background Task Service:

Oracle.Transcode.TaskManager.exe restart

Next you will configure the DIVAdirector logging files and server logging.

Logging Configuration

Now that the storage is configured for the system we are going to configure the log files. There are two sets of log files used in DIVAdirector.

DIVAdirector Server Log Files

DIVAdirector Server has a generic logging system that produces log files related to all server tasks except Drop Folder processing.

Drop Folder Log Files

Drop Folder Logs contain common information regarding the general Drop Folder operation mechanisms and possible general error state processing in the DIVAdirector Server.

DIVAdirector Server Logging Configuration

The DIVAdirector Server logs contain common information regarding the various server operations and possible operational processing error information.

The logging system is intended for server troubleshooting activities and is completely disabled by default. Custom log levels (described in the following section) are configurable to obtain various amounts of information. If a custom log level setting is not defined, level 0 is applied by default.

The log settings are applied during DIVAdirector Server startup. The settings can be changed during server operation, but a server restart is required for the system to recognize and apply the new setting.

Log Levels

The server logging function has several different custom levels. Each level identifies a specific amount of information to be logged during server operation. To set a custom log level, edit the[Startup]section of the DIVAdirector_HOME\cmg-server\cmgserver.ini file.

[Startup]

LogLevel=[custom log level]

The available custom log levels are as follows:

0

Logging disabled.

1

Server errors - this level will only log server-based errors.

2

Warning messages - this level will log both server errors and warning messages. This is the recommended log level setting.

3

Informational messages - this level will log server errors, warning messages, and informational messages. Setting the log level to Level 3 can cause large log files to be created and is not recommended unless instructed to do so by Oracle Support.

4

Debug level - Avoid setting this value because of the amount of log records generated. When requesting Oracle Support assistance, Oracle personnel may ask for the logging level to be set to 4 for troubleshooting purposes.

Log File Name

The server log file name may be specified in a fully qualified or relative form. If this parameter is omitted, the default log file name _cmgserver.log is applied. Since the default name is a relative path, the log file is created in the folder from where the DIVAdirector Server is started.

To set a custom log file name, edit the [Startup] section of the DIVAdirector_HOME\cmg-server\cmgserver.ini file.

[Startup]

LogFileName=[custom log file name]

Log File Size and Cycling

Caution:
Currently, there is no automated log file cleanup mechanism in DIVAdirector Server. Be careful of outdated log files that are accumulated during server operation.
You should create a batch file to remove out of date log files periodically and use the Windows Task Scheduler to create a task to run the batch file daily during non-production hours.

The server log grows during normal DIVAdirector Server operation. To prevent uncontrolled file growth, the log file is verified for a size limit during each log operation. If the file size exceeds the limit, it is closed and renamed according to the following template:

original-log-file-name_timestamp.original-file-extension

Where timestamp is the time the file was renamed. The timestamp string format is YYYYMMDD-hhmmss where:

YYYY = year
MM = month
DD = day of month
hh = hours (0 - 23)
mm = minutes (0 - 59)
ss = seconds (0 - 59)

If the server LogFileSize limit is not specified, the default 4MB value is applied. To set a custom Server Log File Size Limit, edit the [Startup] section of the DIVAdirector_HOME\cmg-server\cmgserver.ini file.

[Startup]

LogFileSize=[custom file size limit in bytes]

Drop Folder Logging Configuration

The Drop Folder logging system is designed to always be enabled. You cannot disable the Drop Folder Log but you can reduce the bulk of log records by setting a lower Log Level.

Log Levels

Drop Folder Log Level settings are intended to provide flexible event logging depending upon your current needs. The setting is applied when DIVAdirector Server is started. The level can be changed during server operation, but a server restart is required for the system to recognize and apply the new setting. If this setting is omitted the 0 log level is applied by default.

The available log levels are:

0

Messages of the highest priority, including the general logging system events (for example: initialization and shutdown) and operational results.

1

Drop Folder initialization errors only.

2

Drop Folder configuration file parsing errors and initialization errors.

3

Generic Drop Folder action errors, file parsing errors, and initialization errors.

4

Other types of Drop Folder errors.

Greater than 4

The levels above level 4 are intended for Drop Folder troubleshooting purposes only due to the amount of log records generated. It is highly recommended to generally avoid setting these higher values unless instructed to do so by Oracle Support.

Edit the [Startup] section of the DIVAdirector_HOME\cmg-server\cmgserver.ini file to set a custom Drop Folder log level.

[Startup]

DropFoldersLogLevel=[custom log level]

Log File Name

The Drop Folder log file name can be specified using a fully qualified path and file name, or a relative form (file name only). If this setting is omitted, the default log file name DropFolders.log is applied. Since this default name is a relative path, the log file is created in the folder from where DIVAdirector Server starts.

Edit the [Startup] section of the DIVAdirector_HOME\cmg-server\cmgserver.ini file to set a custom Drop Folder log file name.

[Startup]

DropFoldersLogFilename=[custom log file name]

Log File Size and Cycling

Caution:
Currently, there is no automated log file cleanup mechanism in DIVAdirector Server. Be careful of outdated log files that are accumulated during server operation.
You should create a batch file to remove out of date log files periodically and use the Windows Task Scheduler to create a task to run the batch file daily during non-production hours.

The Drop Folder log grows during normal DIVAdirector Server operation. To prevent uncontrolled file growth, the log file size limit is verified during each log operation. If the file exceeds the limit, it is closed and renamed according to the following template:

original-log-file-name_time-stamp.original-file-extension

where time-stamp is the time the file was renamed. The timestamp string format is YYYYMMDD-hhmmss where:

YYYY = year
MM = month
DD = day of the month
hh = hours (0 - 24)
mm = minutes (0 - 59)
ss = seconds (0 - 59)
If the log file size limit is not specified, the default 4 MB value is applied. Edit the [Startup] section of the DIVAdirector_HOME\cmg-server\cmgserver.ini file to set a custom Drop Folder Log File Size Limit.

[Startup]

DropFoldersLogFileSize=[custom file size limit in bytes]

Next you will add new organizations, groups and users.

Account Configuration

DIVAdirector is a permission-based system that allows a limited number of simultaneously logged in users. This number of concurrent users depends on system resources and is typically approximately forty to fifty (although one hundred is the maximum configurable value). Any user accessing the system must be validated through the login procedure. To be authorized to access the system, the user must enter a valid login email address and password specific to the user account. You can log in using the name admin for the email address and your administrative password.

There are three categories (or levels) of user accounts (other than the Administrator) in DIVAdirector structured as follows:

- Organizations - this is the top level account for different internal departments. Organizations are comprised of groups.

- Groups - this is the second level account for different groups within an organization. Groups are comprised of user accounts.

- Users - this is the third level account for individual system users. Users are members of groups.

First you will configure a new organization.

Adding a New Organization

Organizations were introduced in DIVAdirector 5.1 and are comprised of a set of groups. Organizations allow restricting access to information from users outside of the organization or group who do not require access to the data. For example, a company may not want to make its data viewable to other companies, or a department within a company may not want its data to be viewable by other departments within the same company. In these two scenarios the entire company, or the specific department, desiring restricted access can be represented by an organization in DIVAdirector.

Use the following procedure to create an organization:

1. Navigate to Admin, Users, Organizations in the menu on the left side of the screen.

2. Click the + next to the Users menu item to expand the menu tree.

3. Select New Organization in the Organization list.

4. Enter the Organization Name in the Organization Name field.

5. Enter the LDAP settings in the LDAP Settings field if an LDAP login is required.

6. In the Permissions' Content Filters area enter any Objects, Categories and Sites - multiple entries are separated by a semicolon. Use an asterisk to denote wildcards (for example ABC* or AB*D, and so on). An exclamation point preceding any filter implies that only objects determined by that filter should be included.
The site permissions are extremely important because they allow the organization to access objects on specific sites that match the filter.

7. Identify the Metadata Access fields that will be accessible by the organization by selecting the check box to the right of the metadata name. If the check box is deselected the organization will not have access to that metadata field. Groups within an organization may further refine their authorized selections.

8. Click Save on the top right side of the screen to save the information.

Next you will add a new group.

Adding a New Group

Groups are collections of users and part of an organization. Each group is assigned a set of permissions to grant users of the group access to specific system features and functions. Groups are customizable and are configurable to fit organizational security requirements. By default, the system is installed with two user groups - SuperAdmin and admins.The SuperAdmin group is the most powerful group in the system because it contains the admin (root) user. Users who are members of the SuperAdmin group are the only users who have complete access to all permissions, configuration parameters, queries, work bins, and shotlists for every other user in the system.

When creating a new group you assign the new group a unique name. Group names should descriptive and unambiguous to make further system administration and maintenance simple and clear. Group names must not exceed 32 characters.

Use the following procedure to create a group and set the group's permissions:

1. Navigate to the Admin, Users, Groups screen. The screen will initially display with the Profile tab selected.

2. Select New Group from the Group list.

3. Enter a new group name in the Group Name field.

4. Select the group's organization from the Organization list.

5. Click Save on the top right of the screen to create the new group.

Group Roles

Now that the group has been created and associated with the correct organization, you must identify the roles for the group.

All users, regardless of their group's roles, always have access to the Operation Status, Change Password and Logout functions. Only the SuperAdmin has access to the DIVAdirector Server screen, Shortcuts screens, and Public Resources and Synchronization Filters on the Discover screen.

The set of roles a user currently has is passed to the application only once during user log in. Any changes made to user permissions will not take effect until the user's next session login.

Only logging out of the system ends a session. A user session time out (one hour) does not result in a terminated session and renewing the session retains the user's permissions from before any changes were made.

Create and Use Group Drop Folders

Allows users to create and use group defined Drop Folders.

View Queries and Save Advanced Searches

Allows users to perform advanced searches and persists history of queries performed. If a user does not have this permission, then the Query Results and Create/Display Query panels will not appear on the Search screen.

Create and View Work Bins

Allows users to create personal and public work bins and perform actions within them.

Modify Asset Metadata

Allows users to modify the object metadata within the Search and Shot List screens. If this permission is disabled the metadata is displayed to the user in a read-only format.

Create Shot Lists

Allows users to access the Shot List screen, add objects and segments of proxies, and perform file management and editing operations. If the user does not have this permission, Edit (and the icons) will not be displayed on the Query Results and Work Bin panels, and the Shot List menu item will not be displayed.

Publish Shot Lists

Allows users to create their own public Shot Lists. If this permission is disabled, Make Public will not be displayed on the Shot List panel.

View Asset Proxies

Allows users to view the proxy and also enables Play.

Download Proxies

Allows users to download proxy videos to their local system.

Modify Annotations

Allows users to have the ability to add, edit, and delete annotation metadata.

Archive from Source

Allows users to archive new data to the DIVArchive long-term storage.

Delete

Allows user to delete object instances from the DIVArchive long-term storage.

Restore

Allows users to restore objects from the DIVArchive long-term storage so they are available for immediate access on the specified destination (for example an ftp destination or a video server).

Partial Restore

Allows users to perform partial restore operations on the selected file in the Shot List.

Local Archive

Allows objects to be transferred from a shared storage location to a designated location (virtual folder) on a DIVAdirector Server. DIVArchive identifies the location as an archive source.

Local Restore

Allows users to restore files to the DIVAdirector Server and to be able to download the restored files.

Local Partial Restore

Allows users to partially restore files to the DIVAdirector Server and to be able to download the restored files.

Create Virtual Assets

Allows users to create virtual objects.

Local Proxies

Allows users to drop proxy files in the Proxy Drop Folder after uploading them from the client computer.

Note:
Continued use of proxies produced outside of DIVAdirector and DIVArchive for local proxies will continue to function, but is highly discouraged.

Local Metadata

Allows users to drop metadata in the Metadata Drop Folder after uploading it from the client computer.

Discover Objects and Manage Requests

Grants users access to administrative functionality for discovering objects within DIVArchive and managing system requests. To access the discovery functionality, navigate to the Admin, System, Discover screen and allows users to perform ad hoc discoveries. Request management is performed on the Operation Status screen and allows users with this permission to manage the request priority or cancel requests in the system.

User Management

Assigns user permissions for either Allow Group-Wide Access or Allow User-Wide Access.

User-Wide Access

Enables users to modify user accounts within a group. Each member of the group to see queries, workbins, and shotlists of every other user within the group.

Group-Wide Access

Enables users to configure groups within an organization. Each member of the group to see queries, workbins, and shotlists of every other user within the user's organization.

Modify Metadata Schema
Enables users to access the Admin, Metadata screen to manage Asset Metadata fields by viewing, editing, adding, and deleting metadata columns.

Modify Interface Style
Enables users to access the Admin, Systems, Style screen and to upload a new banner logo image. The banner logo image is used for customizing the look and feel of DIVAdirector by adding an organization's logo on the top right corner of all pages.

Modify Policies and Settings
Enables users to edit system policies (located on the System, Policies screen) and edit the default settings (located on the System, Defaults screen).

Administer Database Backups
Enables users to access the Perform Database Backup Operations area located on the Admin, Backup menu. Backup operations include viewing the last operation, scheduling an automatic backup, and performing a manual backup or restore.

Display Site Information
Enables or disables viewing of the site information.

Allow Audit Trail
Enables or disables the audit trail. The audit trail is located on the System, Audit Trail screen.

Session Management
Enables or disables session management. The session management is located on the System, Session Management screen.

Use the following procedure to set the group member's roles.

1. On the Admin, Users, Groups screen, click the Permissions tab to view the Permissions screen.

2. Configure the appropriate roles for the group using the check boxes in the Privileges area. A selected check box indicates that the group has been granted permission to that function. A deselected check box indicates that the group has been denied permission to the function.

3. Click Save on the top right of the screen to save the new group and its associated permissions.

Next you will setup the content filters.

Content Filters

Group-based filters are configured on the Permissions screen. Any changes made and saved in the filters are applied immediately for all currently logged in users associated with the group. The Content Filter enables users to see only data complying with a set of filters for Object Name, Object Category, and Sites.The Content Filter is a table with three fields at the bottom of the Permissions screen. All of the fields in the table are initially blank. A blank field indicates that no filtering will take place for that type of discriminator. The content filters are applied to both queries and work bins, but do not affect Shot Lists and the Status screen.

Each field can have multiple filters separated by semicolons. An asterisk is used as a wildcard symbol. An exclamation point at the beginning of a filter indicates that only items that match the filter should be included, while the lack of an exclamation point indicates an exclusion. The filter can also be blank or have white space indicating that no filtering is required; white spaces between filters are ignored.

Note:
Organization level filters are also applied in conjunction, but are obfuscated from the group level configuration.

Next you will configure DIVArchive operational parameters.

DIVArchive Operations

The parameter values for the following DIVArchive operations are configured on the DIVArchive Settings tab on the Admin, Users, Groups screen. Not all parameters are applicable to all operations. Valid operational parameters are as follows:

Archive

Valid parameters are Source, Media, Storage Plan, QoS, Priority, and Category.

Local Archive

Valid parameters are Source, Storage Plan, QoS, Priority, and Category.

Restore

Valid parameters are Destination, QoS, and Priority.

Local Restore

Valid parameters are QoS and Priority.

Partial File Restore (PFR)

Valid parameters are Destination, QoS, Priority, File Format, and PFR Name Format.

Delete

Valid parameter is Priority.

The valid parameters for each operation are applied according to the following descriptions:

Source

The Source parameter defines a list of DIVArchive source storage locations for DIVArchive operations. Users only see the selected sources in the list. Whichever DIVArchive source is chosen to be the default will appear as the default item in the user's list.

Destination

The Destination parameter defines a list of DIVArchive destination storage locations for DIVArchive operations. Users only see the selected destinations in the list. Whichever DIVArchive destination is chosen to be default will appear as the default item in the user's list.

Media

The Media parameter defines a list of DIVArchive media for DIVArchive operations. Users only see the selected media in the list. Whichever DIVArchive media is chosen to be the default will appear as the default item in the user's list.

Storage Plan

The Storage Plan parameter defines a list of DIVArchive storage plans for DIVArchive operations. Users only see the selected storage plans in the list. Whichever DIVArchive storage plan is chosen to be the default will appear as the default item in the user's list.

Quality of Service (QoS)

The QoS parameter defines the Quality of Service for DIVArchive operations. The available choices are Default, Cache, Direct, Cache and Direct and Direct and Cache. If the Force Default Value check box is selected, the chosen option cannot be changed by the user before executing an operation.

Priority

The Priority parameter defines the execution priority of DIVArchive operations. This parameter has a minimum value of 0 and maximum value of 100 - where 100 is the highest priority. If the Force Default Value check box is selected, the chosen option cannot be changed by the user before executing an operation.

Category

The Category parameter defines a list of object categories for DIVArchive operations. Only the selected categories will be included in the user's list. The list will be initially empty; clicking + allows new categories to be added.

File Format

The File Format parameter defines the format of the high-resolution files stored in DIVArchive for partial restore operations.

PFR Name Format

The PFR Name Format parameter defines the file name format for files displayed in the partial file restore operation results. The first list contains the types of separators used in the name format (underline, dash or period). The second list contains additional name construction types as follows:

- none: the object name is used as the file name; additional construction is not used.

- 1: one digit of the segment number in the Shot List is added to the file name with the separator (for example, objectname_1.gxf).

- 2: two digits of the segment number in the Shot List are added to the file name with the separator (for example, objectname_01.gxf).

- 3: three digits of the segment number in the Shot List are added to the file name with the separator (for example, objectname_001.gxf).

- 4: four digits of the segment number in the Shot List are added to the file name with the separator (for example, objectname_0001.gxf).

- SOM-EOM: time codes are used in the file name (for example, [objectname_start-timecode-of-segment]-[end-timecode-of-segment].gxf).

The Use Relative TC check box determines whether relative or absolute timecodes are used in the PFR file name construction and the partial file restore operation.

Next you will configure virtual asset categories.

Virtual Asset Categories

You configure a list of categories for creating virtual objects on the Virtual Asset Settings tab. Users only see the selected categories in the list. The list will initially be empty and you must populated it.

Use the following procedure to add a virtual object category:

1. Click + and enter the category name in the field.

2. Select the check box to the right of the category name to set it as the default. Whichever category is chosen to be the default appears as the default item in the user's list.

3. Repeat Step 1 for each category required.

4. Click Save on the top right side of the screen to save the entries.

Next you will configure data export roles.

Data Export

You choose the data export settings for the group from three lists on the Export Settings tab. The lists are as follows:

Default Shot List Export Video Format

This list determines the video format in an EDL export file. Select either NTSC or PAL from the list.

Default Shot List Export Format

This list determines the Shot List export format. Select from either Final Cut Pro or Avid ALE.

Default Metadata Export Format

This list determines the metadata export format. Select from either CSV or XML.

Next you will add a new user.

Adding a New User

All users are members of a group and inherit the roles and accesses assigned to the group. You add new users to the system using the following procedure to create a user account:

1. Navigate to Admin, Users, User in the navigation tree on the left side of the screen.

2. From the User list select new user.

3. The following information is mandatory and entered in the Account Information area. All other fields are optional and may be left blank if desired.

Group

Select the organizational group to which the user will belong from the list.

Email

Enter the email address to be used for logging into the system. This is not case sensitive.

User Name

Enter the user's real name.

Password

Enter an initial password to be used for logging into the system for the first time. Passwords are case sensitive and it is recommended that users change their password immediately after their first login to the system. Users must change their passwords every sixty to ninety days for security.

Confirm Password

Re-enter the user's password to confirm it is correct. This must match the Password field exactly.

Note:
The Password and Confirm Password fields display only asterisks for security purposes rather than clear text.

4. Click Save on the top right side of the screen to create the new user.

Next you will configure Lightweight Access Directory Protocol (LDAP) login capability. If your company does not support LDAP, you can skip this section and continue with Search Configuration.

Lightweight Access Directory Protocol (LDAP) Logins

If your organization uses Lightweight Directory Access Protocol (LDAP), you can configure DIVAdirector users so they log in to the system using LDAP. Your administrative account should never be configured to use LDAP login because if the LDAP server address is incorrect, or the LDAP servers become unavailable, nobody (including you) will be able to log in. You are only able to log in using DIVAdirector's email and password login mechanism. This enables resetting the LDAP settings if the servers become unavailable or the settings had been incorrectly specified.

Use the following process to switch from the email and password login method to LDAP login:

1. Navigate to Admin, Users, Organizations in the navigation tree on the left side of the screen.

2. Select the Enable LDAP Login check box.

3. Enter the IP address of the LDAP server in the Primary IP Address field. A port number may be specified by suffixing the IP address with the :port option. The port is the port number for DIVAdirector to listen for LDAP connections. If no port is specified, the default LDAP Port (port 389) is used.

4. An optional secondary LDAP server address (and port number if required) may be specified for authentication in the event the primary server fails or is unreachable. Enter the secondary LDAP server information in the Secondary IP Address field.

5. Click Save on the top right side of the screen to apply the changes.

Next you will configure search parameters for groups and users.

Search Configuration

The following sections include detailed information for managing metadata. Metadata is used in systemwide searches on the DIVAdirector and DIVArchive systems to locate a specific file, category of files, objects, or video clips. These roles are set for the group and apply to all members of the group.

Object Metadata

Object metadata is a set of search terms that belong to an object. Each object has its own predefined set of metadata.

- Metadata imported from DIVArchive (OBJECT_NAME, OBJECT_CATEGORY, ARCHIVE_DATE, and so on).

- Proxy metadata imported from dropped proxies.

The Object Metadata screen is accessible from the Admin, Users, Metadata screen. The following functions are available from the Object Metadata screen.

- Add new metadata for objects in DIVAdirector by clicking Add on the top right side of the screen.

- Delete an existing metadata type by selecting the type to be deleted in the list and then click Delete on the top right side of the screen.

- Edit a metadata type by clicking the Pencil icon at the beginning of the row for the metadata to be edited.

Data Types

DIVAdirector supports various data types for metadata field definitions and associated presentation controls. When a specific data type is selected, additional parameters are presented to the user.

The following are the valid metadata types:

CHAR

Any character string; restricted to 1 - 100000 characters in length. The CHAR data type can be represented using an EditBox, TextBox, or SelectBox control (refer to "DIVAdirector Presentation Controls").

INT

Any integer numeric value. The INTEGER data type can be represented using an EditBox, TextBox, or SelectBox control.

FLOAT

Any numeric value - including decimals. The FLOAT data type can be represented using an EditBox, TextBox, or SelectBox control.

DATE

The DATE field can be represented using an EditBox, SelectBox, or Calendar control.

TIME

The TIME field can be represented using an EditBox or a SelectBox control.

BINARY

A fixed representation file of arbitrary internal format which is represented using a FileSelect control.

SAMMA_GRAPH

A graphical representation of metadata that originated from Oracle SAMMAsolo. The graph can represent the entire object or just a portion of the object.

SAMMA_THUMBNAIL

A representation of thumbnails of frames that match the portion of the object represented by the SAMMA_GRAPH.

QC_REPORT

Used for Quality Control reporting options including:

- Report Type

- Selected (selected or deselected)

- Data file extension

- Report file extension

DIVAdirector Presentation Controls

Most metadata field data types have multiple ways of displaying data and some are restricted to using particular controls. The following are descriptions of the controls used to display the metadata fields:

EditBox

A single line text entry control that allows users to edit its value.

TextBox

A general multi-line text editing control.

Select

Allows users to select a value from the supplied list of unique values.

CheckBox

Allows users to select an option by selecting the appropriate check box.

Calendar

Allows users to browse through a graphical calendar and select the appropriate date. This format is used only for the DATE data type.

FileSelect

A special composite control comprised of an Upload button and link to an existing binary file. This format is used only for the BINARY data type.

SammaGraph

This control is only used for the SAMMA_GRAPH data type and shows a graphical representation of SAMMAsolo-generated metadata.

SammaThumbnail

This is only used for the SAMMA_THUMBNAIL data type to provide thumbnail representations of frames that match the portion of the objects represented by a SammaGraph control.

Predefined Metadata Display Columns

The metadata display screen is arranged in a tabular format. The columns in the table are predefined and described as follows:

ID

DIVAdirector-defined unique identifier for the object.

Name

DIVArchive system-defined object name that is used as a unique identifier with the category.

Category

DIVArchive system-defined object category that is used with the name.

Date

The date when the object was archived to the DIVArchive system.

Comments

A comment text field that contains comments added during the object's creation.

Source

The original source of the file from which the object was created.

Active

The current object status that determines whether the object exists.

Virtual

The flag defining whether the object is virtual (YES or NO).

SOM (P)

Start timecode of the object's proxy extracted from the proxy placed in a Proxy Drop Folder.

Duration (P)

Duration of the object's proxy extracted from the proxy placed in a Proxy Drop Folder.

EOM (P)

End timecode of the object's proxy extracted from the proxy placed in a Proxy Drop Folder.

First you will add new metadata entries.

Adding a New Metadata Entry

Use the following procedure to add a new metadata entry to the Metadata Manager:

1. Navigate to Admin, Metadata in the navigation menu on the left side of the screen.

2. Click Add on the top right side of the screen.

3. Enter the information in the resulting dialog box.

4. Click the Check Mark icon on the lower left side of the screen to add the new entry or to click the X icon on the lower left side of the screen to cancel the addition.

5. Repeat these steps for each metadata entry you must add to the system.

When a metadata type is selected from the list, additional parameter fields will be displayed that are specific to the type selected. Each metadata entry has the following parameters:

Title

The Title field is the Metadata Column name displayed in the user interface. The title can be any unicode text with maximum length of 32 characters.

Type

The Type field determines the entry's data type and is defined automatically when selected from the Type list. For example, if the type of the Metadata Column is DATETIME in the database, then one of the two types can be selected from the list, DATE or TIME.

Format

The type of the presentation control used.

File Mask

If the BINARY type is selected the edit field will be displayed instead of the column length. Only files with this mask can be selected to be uploaded using the Object Metadata area of the Shot List screen. Multiple masks can be set and separated by a semicolon. For example, you can enter *.txt; *.log and any spaces will be removed when saved (in this case).

Description

This is the description of the column displayed in the tooltip when the user hovers over the column title in the Query Results, the Work Bin tables on the Search screen, and the Asset Metadata area on the Shot List screen. The description can be any unicode text and has a maximum length of 240 characters.

Display Options (Flags)

One or more of the following as previously described:

- Hidden

- Read Only

- Display in Search Results

- Display in Tooltips

In addition to the above, a SAMMA_GRAPH metadata column type requires the following parameters:

Y Axis Label

This specifies the name of the Y Axis for the SAMMA Graph.

Graph Tags

Specifies the type of information to be displayed on the SAMMA Graph. Click + on the Field Tag button to add each tag and specify a color. Pre-defined tags are available in the Choose Type list or by clicking on the default type displayed under the Field Tag. For example, using the Choose Type list and selecting the type as Video results in 3 field tags being created automatically:

- Luminance Average

- Chroma U Average

- Chroma V Average

Next you will configure quality control report metadata.

Add New Quality Control Metadata

You add Quality Control report metadata to the system's search functions using the following procedure:

1. Open the Metadata Column Manager on the Admin, Metadata screen.

2. Click Add on the top right side of the screen.

3. Enter a name for the metadata in the Title field.

4. Select qc report from the Type list.

5. Select QC Report from the Format list.

6. Select which reports should be visible using the check boxes next to each type of report.

7. Enter the data file extension (usually xml) for each visible report in the Data Extension field.

8. Enter the report file extension (xml or pdf) in the Report File Extension field.
If an XML file for data and PDF file for viewing are both available, set the Report File Extension to PDF. In most cases, it can remain set to the default value (xml).

9. Enter a description in the Description field.

10. Select the Hidden (Hid) check box if you want the report hidden from users, otherwise leave it deselected.

11. Click the Check Mark icon on the lower left side of the screen to save the new report column, or click the red X icon to cancel the addition.

Next you will configure metadata access for the group.

Metadata Filters

Metadata filters authorize and restrict user access to various metadata fields. You configure the filters on a per-group (not per-user) basis on the Permissions (Metadata) tab in the Groups screen. Users can only view the metadata fields that their group has access permissions to.

The metadata filters are applied only within Queries, Edit Metadata and Shot List screens. Each field can be made accessible, inaccessible, and available or unavailable for publishing (refer to the Oracle DIVAdirector User's Guide for more information on publishing).

Next you will configure metadata publishing settings.

Metadata Publish Settings

DIVAdirector can publish restored video clips to Oracle DIVApublish. A destination configured in DIVArchive must point to the DIVApublish location that is receiving the restored video clips and their metadata to use the publishing functions. This setting must be selected as the location for publishing in the DIVArchive Destination list on the Metadata Publish Settings tab on the Groups screen.

The FTP network protocol is used for DIVAdirector's Publish Metadata feature and must be configured in the FTP area of the screen. Publishing clips to DIVApublish requires sending the video clip's metadata as an XML file.

Metadata fields to be included in the XML file are selectable in the Metadata area of the screen. The available fields are determined by the settings configured in the Metadata Permissions Filter.

1. Select the available metadata fields to include in the XML file using the check box to the right of each field. A selected check box will include the field in the XML file and a deselected check box will not be included.

2. Enter the FTP server's Host, Username, Password and Port number in the designated fields. The port number can be entered manually or you can use the up and down arrows to the right of the port field to raise or lower the displayed number. The default FTP port (25) will be used if the port field is left empty.

3. Select the destination from the DIVArchive Destination list.

4. Click Save on the top right side of the screen to save the settings.

Next you will configure quality control reports.

Quality Control (QC) Report Configuration

DIVAdirector supports integration with QC Reports from Venera Rapid, Venera Pulsar, Tektronix Cerify, and Interra Baton. Report files should be placed in the path under the IIS DIVAdirector 5 Root Folder:

DIVAdirector QC Report\{Report Name}\{Category}\{Object Name}\{Object Name}.xml

For example:

DIVAdirector QC Report\Venera Rapid\WMV\AUTO_20120615_031030\AUTO_20120615_031030.xml

First you will create a folder for the QC reports, then you will place all reports in the folder you create.

QC Report File Placement

Use the following procedure to create a folder for the QC Reports. After reports are created you will place the reports in the appropriate folder.

1. Open IIS and navigate to the DIVAdirector QC Report virtual directory under the DIVAdirector 5 menu item.

2. Right-click the DIVAdirector QC Report folder and select Explore from the context menu.

3. Create a new folder with a specific category (for example, Venera Rapid or Venera Pulsar) for the files under the report type folder.

4. Create a new folder using the report name (for example, AUTO_20120615_031030).

5. Place the QC Report XML files in the newly created folder. Other report files (for example, PDF files) can be placed in the same location.

Next you will configure automated system backups.

Automated Backup Configuration

You configure automated backup operations by identifying to your desired schedule and selecting the check box to make the scheduled task active. The schedule can be set to run on a weekly or monthly basis.

Use the following procedure to configure your automated backups:

1. Navigate to Admin, Backup, Schedule on the navigation tree on the left side of the screen.

2. Either enter the time to begin the backup directly in the Start Time field, or use the clock icon to the right of the Start Time field to display a selectable time menu called the Time Picker.
The Start Time field denotes the time when the backup should start and must be in 24-hour format using standard hh:mm notation where:

- hh = hours (0 - 23)

- mm = minutes (0 - 59)

3. Use the Occurrence list to select either a weekly or monthly backup frequency.
If the Occurrence is set to Weekly, you can assign the days of the week when the backup should be performed by selecting the check box to the left of each day desired.

If the Occurrence is set to Monthly, you can set a day of the month (by date) when the backup should be performed by selecting the day of the month from the Days list.

4. Select the destination folder for the backup snapshot files in the Directory field.
The root location is mapped to the virtual folder named DIVAdirector Database Backup Storage. Select the backup destination using the navigation provided in or above the Directory area on the right side of the screen.

5. Click Save on the top right side of the screen to apply the settings. When the changes are saved successfully, a confirmation message is displayed.

The DIVAdirector scheduled backup task that was created is now available (named At1). You can confirm correctness in the Windows Task Scheduler. Additional backup tasks will be number sequentially (for example, At2, At3, At4, and so on).

Important: Although you can delete scheduled tasks in the Windows Explorer, do not use this method to remove the task. If the task was accidentally deleted in the Scheduled Tasks, the Windows registry key named HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Front Porch Digital Inc.\DIVAdirector\DB\Backup must be removed, enabling DIVAdirector to be able to configure further scheduled backups correctly. If you require assistance or are not comfortable editing the Windows registry contact Oracle Support.

Your initial configuration of DIVAdirector is now complete. In the next chapter you will find daily tasks that you use to keep DIVAdirector running.

3 DIVAdirector Daily Operations

You must monitor DIVAdirector daily to insure proper operation, storage capacities, orphaned files, user interaction, successful backups, and general system health. If you discover any anomalies that you are uncertain of or if you are unsure of how to handle them, contact Oracle Support for assistance. This chapter will discuss your daily operations routine.

Check Available Storage Capacity

In your initial DIVAdirector configuration you identified system storage locations and the limits for each location. Storage locations will fill up over time during normal use. You must check the remaining available space for each location daily. If a storage location is reaching it's limit, you must either migrate some (or all) of the data to another location (for proxy data - refer to "Proxy Migration Tasks") or configure a new location (refer to "Storage Location Configuration").

Use the following procedure to check your storage locations and remaining available space:

1. Click Proxy Storage Manager on the DIVAdirector Server Configuration screen to load the Proxy Manager.

2. Review the storage locations on the Proxy Locations tab.

3. Check each location's Status Icon (the first column) to identify the current storage location status. The "Proxy Location Operational States" section describes the icons.
If the location's state is something other than operational (and you didn't set it that way), you must identify why it is the current state and if necessary resolve the issue. You use the server logs and Drop Folder logs to help identify issues. If you are unable to resolve the issue and need further assistance contact Oracle Support.

4. Check the Used and Available columns to identify how much of the storage space is filled and how much is left available (respectively) for each location. You will need to decide if additional space is required, if data must be migrated to another location, or if the location is fine the way it is.

5. If you must add a new storage location refer to "Storage Location Configuration".

6. If you must adjust the storage space limits refer to "Configuring the Proxy Location's Storage Size".

7. If you must migrate data to another storage location refer to "Proxy Migration Tasks".

Next you will check for orphaned files.

Check for Orphaned Files

Throughout daily user interaction with DIVAdirector, you will occasionally get some orphaned files. Orphaned files are files that were placed in a Drop Folder and had the wrong format, had different encapsulation than configured for the folder, or they do not exist in the database. The system identifies the files as unrecognized and moves them to a special Orphan folder. You identified the Orphan folder during your initial configuration (refer to "Drop Folder Configuration").

Use the following procedure to locate and act on orphaned files:

1. Open your Windows File Explorer.

2. Navigate to the Orphan folder you configured for your first Drop Folder.

3. Identify what each file contains that exists in the folder.

4. Once you know what the file is, decide whether to 1) repair whatever caused the file to be placed in the orphan folder and re-drop it into the Drop Folder for re-processing, 2) move the file to another storage location, or 3) delete the file.
Determine the action you take on each file according to your internal organizational policy and the importance of the file.

Next you will check the user interaction with audit trails.

Check Audit Trails

You check the audit trails to review system and user activity formed on specific objects. This is useful for general system overview and in the event errors occurred while a user was trying to perform an action on a specific object.

The Audit Trail screen displays user interactions with the DIVAdirector system. You can filter the display by Action, User, Time (From and To), Object Name and Object Category using the options on the right side of the screen. The Object Name and Object Category fields in the filter can contain partial words.

For example, use the following procedure if you are searching specifically for actions performed by a user in the Marketing Department on an object named MySportsVideos and having the object category MOV:

1. Enter Mark in the Organization field and select the Organization check box.

2. Enter My in the Object Name field and select the Object Name check box.

3. Enter MO in the Object Category field and select the Object Category check box.

4. Click Apply Filter on the bottom right side of the screen to locate the object.
This procedure will locate the object if it exists in the audit trail.

Clicking Export on the top right side of the screen will export the filtered (or unfiltered) audit trail to a file that you can use for tracking general system usage or errors.

Check for Successful Backup Completion

System backups are necessary and extremely important for disaster recovery. You must confirm that the backups you created during initial configuration are completing successfully and to the proper storage location. You cannot restore a corrupt backup file, so they should be checked daily.

Use the following procedure to check the backup files:

1. Open Windows Explorer.

2. Navigate to the storage location you designated in the initial system configuration.
Refer to "Automated Backup Configuration" if you need a reminder of where you set the backup storage location.

3. Check the creation date and time of the latest file in the folder. Confirm that the date and time match the backup schedule.

4. Check the system log files for errors related to the backup job. Refer to "Checking Log Files" for the procedure to use.

If a corrupt or unsuccessful backup is discovered, use the procedure described in "Performing a Manual Backup" to try performing a manual system backup before attempting to troubleshoot any issues.

In the next chapter you will find system maintenance tasks that you must use occasionally.

4 System Management

You must perform occasional system maintenance tasks on DIVAdirector. The tasks are completed on an as needed basis and include database synchronization editing, storage management, data and resource management, account management, and so on.

Database Synchronization Management

You added database synchronization filters in your initial DIVAdirector configuration (refer to "Database Synchronization Filtering"). You can update or remove existing filters as necessary. You can edit, enable, disable or remove filters from the synchronization filter list.

Use the following procedure to edit an existing synchronization filter:

1. Select the filter and click the Pencil icon to enter the Edit screen.

2. You can now make any necessary changes to the filter

3. Click the Check Mark to save your changes.

Use the following procedure to enable or disable a synchronization filter:

1. Select the filter and click the Pencil icon to enter the Edit screen.

2. Either select the Enable check box to enable the filter, or deselect the check box to disable the filter.

3. Click the Check Mark icon to save your changes.

Use the following procedure to remove a synchronization filter from the filter list:

1. Locate the filter you want to remove in the list.

2. Click the red X icon on the right side of the filter entry.

3. The filter is now removed from the list.

Next you will manage proxy storage locations.

Proxy Storage Management

You will check storage capacities during your daily system monitoring. Eventually you will have to add, reconfigure, remove storage locations, (refer to "Storage Location Configuration") or rearrange storage search priority. At times you may have to migrate data from one storage location to another for various reasons such as replacing a storage location, making more storage space available and so on.

Proxy Migration Tasks

You can migrate proxy storage location data to another open storage location. You will perform a migration for different reasons including reducing the amount of space used (while increasing available space), moving data to a different (physical) location or system, or possibly temporarily relocating data so the current location can undergo maintenance or replacement. Only Open, Closed or Overflown locations can be migrated. The migration process is performed according to the Filling Strategy selected on the Proxy Locations tab.

Use the following procedure to perform migration of proxy storage location content:

1. On the DIVAdirector Server Configuration screen click Proxy Storage Manager.

2. On the Proxy Locations tab select the proxy location to migrate.

3. Click Migrate (if available).

4. Click Yes in the confirmation dialog box.

5. The state of the selected location will be changed to Migrating.

Note:
A location that has been set to the Migrating state can only be set to the Open state after setting it to Closed. The migrating location will be set to the Closed state after completing the migration task - or after removing the migration task.

6. Switch to the Proxy Migration Tasks tab on the Proxy Storage Manager screen to view information about the migration process:

The Proxy Migration Tasks columns include the following information:

Source

The path of the proxy location from where the migration process was run.

Files Total

The count of registered proxy files in the proxy location at the moment of beginning the migration.

Files Left

The count of registered proxy files not yet migrated from the proxy location.

Progress %

The percentage of migrated proxy files relative to the number of total files.

Elapsed Time

The elapsed execution time of the migration task.

Started At

The date and time when the migration process was started.

Finished At

The date and time when the migration process was completed.

The proxy migrating task can be in one of three states and each state has its own status icon. To change the state of a proxy migration task, select the task in the list and click Run, Suspend or Remove within the Migration section of the screen. The proxy migration task states are as follows:

Running

The Running state status icon is a pink cylinder with a double-headed arrow underneath it. This indicates that the migration task is running. A running task can be suspended or removed from the task list.

Suspended

The Suspended state status icon is a greyed out cylinder with a red X on top of it. This indicates that the migration task is suspended. A suspended task can be run to continue the process of migration by selecting the task in the list and then clicking Run on the bottom left of the screen, or removed from the task list by clicking Remove on the bottom right of the screen.

Ended

The Ended state status icon is a green outlined cylinder. This indicates that the migration task has ended. An ended task remains in the task list for informational purposes (only) and can be removed from the list at any time. An ended task cannot be transitioned to a Running or Suspended state.

Proxy URL Search List

The Proxy URL Search List tab manages the search order for the dropped proxies. The Proxy URL must correspond to virtual directories set up in IIS for the DIVAdirector Web Server. This tab does not configure the assignment of the virtual directories itself, but allows additional storage to be added to the system without the need to move existing proxies to a new storage location.

The buttons in the middle of the Proxy Location URL List section of the screen perform the following functions when clicked:

Set

Selecting a Proxy URL from the list, entering a name in the Virtual Directory Name field, and clicking Set renames the selected Proxy URL.

Shift Up

Selecting a Proxy URL from the list and clicking Shift Up moves the selected Proxy URL up in the search order, giving it a higher priority.

Shift Down

Selecting a Proxy URL from the list and clicking Shift Down moves the selected Proxy URL down in the search order, giving it a lower priority.

Add

Entering a name in the Virtual Directory Name field and clicking Add inserts a new Proxy URL into the search list.

Remove

Selecting a Proxy URL from the list and clicking Remove deletes the Proxy URL from the search list.

Next you will manage data and user resources.

User Data and Resource Management

Users have the ability to make their private data public so other users can see it including queries, work bins and shot lists. Once a user makes a resource public, you are the only user who can change it back to private again. If a user requests a status change for one of their resources, or if you suspect unauthorized access to data, you can make public resources private as appropriate for the situation.

Making a Public Resource Private

You manage public resources such as queries, work bins and shot lists on the Admin, System, Public Resources screen. Any item made public by a user can only be made private again from this page by you. Information about public resources such as resource name, type, user who created the resource, creation time, and time when resource was made public is displayed on this screen. When you delete a user who owns one or more public resources from the system, the admin user automatically becomes the owner of those public resources.

Caution:
If Make Private is clicked, the selected resources become private without additional confirmation.

You can select one or more resources to make private and use the following procedure to change the resource from public to private:

1. To select multiple items simultaneously, press and hold the CTRL key and click (once) on each resource with the mouse.

2. To select a range of resources, press and hold the SHIFT key and clicking on the first and then the last resource in the range - all items in the range will be highlighted.

3. Right-click the selection and select the Make Private context menu item to make the selected resources private.

Next you will manage organization, group, and user accounts.

Account Management

During normal operations you will eventually have to manage organization, group and user accounts. The following sections cover modifying and removing accounts. To add new accounts refer to "Account Configuration".

Managing Organizations

Typically an organization will not need modification or deletion. However there are times where a company reorganization may require you to add a new organization, or change or delete an existing organization. Refer to "Adding a New Organization" for instructions on adding new organizations.

Modifying an Existing Organization

Use the following procedure to modify an existing organization:

Caution:
Changes cannot be reset once they are saved. To make additional changes or corrections after saving modifications, you must go through the organization modification procedure again and then save the changes again.

1. Navigate to the Admin, Users, Organizations screen.

2. Select the organization to modify from the Organization list.

3. Modify the organization's properties as required.

4. Click Save on the top right side of the screen to apply the changes.

Deleting an Organization

Use the following procedure to delete an existing organization:

1. Navigate to the Admin, Users, Organizations screen.

2. Select the organization to delete from the Organization list.

3. Once the organization is selected, click Delete on the top right side of the screen.

4. Click OK in the resulting dialog box to confirm the deletion.

Managing Groups

Eventually you will have to add, modify, or delete groups during normal operations. Modifications could include changing user roles within the group, changing the group's name, changing content filters, and so on. Refer to Adding a New Group for instructions on adding new groups.

Modifying an Existing Group

Use the following procedure to modify an existing group:

1. Navigate to the Admin, Users, Groups screen.

2. Select the group name to be modified from the Group list.

3. As necessary, modify the group name in the Group Name field, the group permissions in the Privileges area, and the filters in the Content Filter area. Content filters are discussed in "Content Filters".

4. Click Save on the top right side of the screen to apply the changes.

Deleting an Existing Group

You are a member of the SuperAdmin group. You and other users authorized by you are members of the Admin group. You have full control of the system. Your account must always be available and therefore these two groups can never be deleted. If deletion of these groups is attempted, a warning message is displayed and you should immediately check the security of the system.

A group cannot be deleted unless it has no active members. If you attempt to delete a group with active members an error is displayed notifying you that there are active users in the group.

Use the following procedure to delete an existing group with no active users:

1. Navigate to the Admin, Users, Groups screen.

2. Select the group name to delete from the Group list.

3. Click Delete on the top right side of the screen.

4. Click OK in the resulting dialog box to confirm the deletion.

Managing User Accounts

During normal operations you will have to add, modify or delete user accounts. This includes removing users who no longer require access to the system, employees who are no longer with the company, users who change departments (groups or organizations) and so on. User account modification includes changing email addresses, resetting passwords (if they forgot their password), changing user mailing addresses and so on. Refer to "Adding a New User" for instruction on adding new users.

Modifying an Existing User

Use the following procedure to modify an existing user account:

Caution:
Changes cannot be reset once they are saved. To make additional changes or corrections after saving modifications, you must go through the user modification procedure again and then save the changes again.

1. Navigate to the Admin, Users, User screen.

2. From the User list select the user to be modified. The fields will either be filled in or empty, depending upon the information previously entered when the user was created or last modified.

3. Modify the user's properties as required.

Note:
The Password and Confirm Password fields are never automatically provided by the system. Both fields must be manually modified to change the account password.

4. Click Save on the top right side of the screen to apply the changes.

Deleting a User

Use the following procedure to delete an existing user. Remember that the admin user can never be deleted.

1. Navigate to the Admin, Users, User screen.

2. Select the user account to be removed from the User list.

3. To remove the user click Delete on the top right side of the screen.

Search Management

You can add, update, or delete search metadata at any time. You added new search metadata, defined content filters, and assigned metadata publishing roles during the initial system configuration. All modification and deletion of metadata entries occurs on the Admin, Metadata screen. Refer to "Adding a New Metadata Entry" for instructions on adding new search metadata.

Metadata Column Manager

The Admin, Metadata screen contains a table with metadata entries for both base and object metadata. Each row is a different metadata entry called a Metadata Column and displays the entry's parameters in the appropriate table column.

You add, remove, edit, and reorder Metadata Columns for on-screen display in the Metadata Column Manager table. Certain rows, such as the parameters from DIVArchive and Proxy Metadata, are predefined, will be always present in the table, and cannot be deleted.

You change the order of the entries by dragging and dropping the row to another position to complete the repositioning.

Check boxes display the state of each entry and you select or deselect the check boxes to enable or disable the different states.

Hid

Hidden - when selected the entry will not appear on the Metadata screen.

R/O

Read Only - when selected the entry will appear in the Metadata screen but cannot be modified.

SR

Search Results - when selected the entry will appear in the Search Results List View mode.

TT

Tooltip - when selected the entry will appear in the Tooltips.

Next you will edit a metadata column.

Editing a Metadata Entry

Use the following procedure to edit a Metadata Column:

1. Navigate to the Admin, Metadata screen.

2. Locate the metadata entry to edit.

3. Click the Pencil icon in the first table column of the entry row.
The selected row is highlighted in the table and all parameters of the selected entry are displayed for editing.

4. When you are finished editing the entry, click the Check Mark icon to save the changes, or click the X icon to cancel the changes.

Next you will delete a metadata entry.

Deleting a Metadata Entry

Use the following procedure to delete a metadata entry:

1. Navigate to the Admin, Metadata screen.

2. Locate the metadata entry to delete.

3. Select the entry's row.

4. Click Delete on the top right side of the screen.

5. Click OK in the confirmation dialog box to delete the entry.

Next you will manage user sessions.

Session Management

You view information about which users are currently online and which users are not logged in (offline) on the Session Management screen. Each user can log in from only one location (browser session) at a time. User login sessions have an inactivity timeout of one hour.

Currently logged in users can only see other logged in users and logged off statuses if the user's group visibility allows access to this function. For example, if the current user belongs to a group that does not have visibility of other groups, then only users within the same group are visible on the Session Management screen. The only exception is that the SuperAdmin user is always shown on the screen.

Use the following procedure to monitor user sessions, sort the table rows, and log off online users (if necessary):

1. Navigate to the Admin, Session Management screen.

2. Online users are displayed at the top of the screen and offline users at the bottom of the screen.

3. For display purposes, you can sort the rows by clicking on the table header columns.

4. You right-click an online user and select Sign out user from the context menu to log the user off from the system.

Next you will add a system message for all users.

Administrator's Message

The Message screen allows (only) you to add, change or delete a message displayed to all users of the system when they log in. There are three types of the messages:

- Announcement (this is the default)

- Warning

- Alert

Use the following procedure to add or update the system message:

1. Navigate to the Admin, Users, Messages screen.

2. Select the type of message from the Type list.

3. Enter the message text in the Message field.

4. Click Save on the top right side of the screen to save the message.

Next you will install and configure Contour's control pads if your users require them.

Configuration for ShuttlePro V2 or ShuttleXpress Control Pads

You install and configure Contour's control pad on your user's client computer. You setup and configure the ShuttlePro V2 or ShuttleXpress Control Pads by running the installer program supplied with the software and using the default selections.

When installation is complete, copy the Shuttle configuration file as described below for the appropriate operating systems:

Windows 7

Copy C:\Program Files (x86)\DIVAdirector 5\Support\etc\Pref file - Windows\SDIshuttle.pref to C:\Program Data\Contour Design.

Note:
Windows requires privileges to show hidden files in the Folder Settings to see the path.

Mac OSX

Copy C:\Program Files (x86)\DIVAdirector 5\Support\etc\Pref file - Mac\com.contourdesign.shuttle.prefs to ~/Library/Preferences/.

Once you have completed setup of the Shuttle Control, you must set the focus to the player (click once in the player area) before the Shuttle Control can be used.

In the next chapter you will find troubleshooting and disaster recovery procedures.

5 Troubleshooting and Disaster Recovery

This chapter includes information for preliminary system troubleshooting and disaster recovery. You should perform these activities before contacting Oracle Support for assistance.

Screen Transparency

You set the screen Transparency in the middle on the right side of the Configuration Mode settings screen. The display's transparency level can be set between 0 and 90 percent (zero value means full opacity) using the adjustment control in this area. This option is useful when you must view the DIVAdirector Server Status screen while having other dialogs (or screens) open simultaneously, and reduces the amount of screen space required to view both.

The DIVAdirector Server Configuration screen always starts in fully opaque mode. A live demonstration of the effects of changing the transparency level is shown while the adjustment control is being moved. You can visualize the different level's effects before actually accepting the change. When you release the mouse button the dialog reverts back to its opaque state after a short pause; however the last transparency level indicated by the control is temporarily saved. The changed settings are applied to all other server dialogs once OK is clicked. Click Cancel to discard the temporarily saved transparency level and keep the previous setting (before the changes were made).

Next you will start and stop DIVAdirector Server from the command line.

Starting and Stopping DIVAdirector Server

DIVAdirector Server automatically starts as a Windows System Service during system startup (by default). Native DIVAdirector logs (for example, logs of connections to DIVArchive) are kept as application logs in the System Event Viewer. During troubleshooting activities, you start and stop the server service manually using the Windows menu as necessary.

- To stop the DIVAdirector Server service, select Start, All Programs, FPDI DIVAdirector 5, Stop DIVAdirector Server Service.

- To start the DIVAdirector Server service, select Start, All Programs, FPDI DIVAdirector 5, Run DIVAdirector Server Service.

You can manually start DIVAdirector Server in interactive mode after first stopping the service. The DIVAdirector Server interactive mode application and the DIVAdirector Server service cannot be run simultaneously, so the service must be stopped first before entering interactive mode.

When running in interactive mode the DIVAdirector Server application adds an icon to the Windows System Status Tray and displays the current status of the local database and connections to DIVArchive.

When you click the DIVAdirector tray icon, the displayed DIVAdirector Status screen is divided into three sections with specific information in each section.

The General Settings section is located on the top of the screen. This section displays the last date and time the server was started, total number of connections, total number of current connections, the operational mode of the server, last synchronization data and time, and the current server date and time.

The DIVArchive Manager section is located in the middle of the screen. This section displays the connection status of the Oracle DIVArchive Manager and includes the current connection status and the last time the connection was made.

The DIVAdirector Database section is located on the bottom of the screen and includes the Database Source Name (DSN - also known as the Data Source Name) in use, the current connection status, and the last date and time the connection to the database was made.

Command Line Parameters

When necessary during error resolution, you run DIVAdirector Server from the command line (rather than as a Windows System Service) by opening a command line window and using the following syntax:

DIVAdirector Server.exe [-parameter]

You must enter one of the following valid command line parameters or you will be returned to the operating system prompt.

install (-i)

Installs the DIVAdirector Server service.

uninstall (-u)

Uninstalls the DIVAdirector Server service and removes it from the Windows services list; however, Interactive Mode can be run rather than the service.

debug (-d)

Run the DIVAdirector Server application in Interactive Mode.

config (-c)

Run the DIVAdirector Server in Configuration Mode (this is a limited mode).

runservice (-r)

Start the DIVAdirector Server service.

stopservice (-s)

Stop the DIVAdirector Server service.

help (-h or ?)

Displays the help dialog with command line syntax and a list of supported parameters.

Use the following procedure to install the DIVAdirector Server service from the command line:

1. Open a Windows command line prompt.

2. Run the command: DIVAdirector Server.exe -i

3. In the Installing DIVAdirector Server Service window select one of the following options:

Local System

DIVAdirector will be limited to use only local Proxy storages due to native Windows limitations on the local system account.

This user (DOMAIN\User)

Enter your administrative user account in the form DOMAIN\User, the user's password, and confirm the password. The entered user will have access to proxy storage locations that are configured as network shares. The user must belong to the Admin group and must be granted read and write access rights to NAS-based proxy storage. If no domain (or the '.' domain) is specified, the local system is implied as the account domain.

4. Click OK to start the DIVAdirector Server service.

Next you will start and stop the DIVAdirector Web Server.

Starting and Stopping the DIVAdirector Web Server

You can start and stop the DIVAdirector Web Server manually if issues arise pertaining to the web-based user interface using the following procedure:

1. Open the Internet Services Manager (inetmgr).

2. Click the computer's computer name and then locate DIVAdirector 5 under the Sites menu.

3. In the Actions panel (on the right side of the screen), under the Manage Web Site section, click Start to start the web server, Restart to stop a running server and then start the web server again, or Stop to stop it completely.
A menu item that is grayed out and not selectable indicates the current state of the web server. For example, if the Start menu item is grayed out, the web server is currently running.

Next you will check the DIVAdirector Server and Drop Folder log files for errors.

Checking Log Files

DIVAdirector creates log files for both the system and for Drop Folders during normal operations. You configured the log file names, sizes and locations in the initial DIVAdirector configuration. Refer to "Logging Configuration" if you need a reminder of the file names and locations you assigned to the logs.

The DIVAdirector Server logs contain information regarding the various server operations and possible operation processing error information. The Drop Folder logs contain information specific to the Drop Folders.

You can find the web server logs in the DIVADirector_HOME\www\logs\log.txt file. The web server logs are used for troubleshooting the system and may be requested by Oracle Support when you request assistance.

The levels you set during initial system configuration may need to be changed to assist in troubleshooting activities. During troubleshooting it may be necessary to raise the logging level higher to assist in locating the source of an error or fault. The recommended log file level settings for normal system operation are as follows:

- For DIVAdirector Server logs set the log level no higher than Level 2 unless you are trying to locate an error, or instructed to do so by Oracle Support.

- For Drop Folder logs set the log level no higher than Level 0 unless you are trying to locate an error, or instructed to do so by Oracle Support.

Next you will export the database tables to a flat file format.

Flat File Export

Caution:
A flat file export should only be performed upon request by Oracle Support to export specific database table contents. A manual backup of the database should be completed first before performing a database restore operation.

You should export the database tables before performing a database restore. The tables in the database can be exported using the following procedure:

1. Navigate to the Admin, Backup, Flat File Export screen.

2. Select the table or tables to export using the check boxes next to each table name in the list.

3. On the top of the screen select the Separator that will distinguish the fields, and the Enclosure that will encase the statement. Typically the separator will be a comma and the enclosure will be double quotes.

4. If the first row in the table export is column names, select the check box next to Include columns names as first line (right next to Enclosure on the top line).

5. Click Refresh on the top right side of the screen to refresh the list of tables. This causes the list of tables to be regenerated and re-listed on the page using the selected separator and enclosure.

6. Use the check box next to each table name to select (or deselect) the table for export. Selecting the check box at the top will select (or deselect) all tables in the list.

7. Choose Download All on the screen's header row to save all of the files together in zipped format, or click Export on the top right side of the screen to save the files individually.

Next you will perform a manual backup and data restore.

Manual Backup and Database Restore

The manual backup and restore of the database are very important operations in any data system. DIVAdirector provides you a simple way to perform these operations when necessary.

Performing a Manual Backup

Use the following procedure to perform a manual backup of the DIVAdirector database:

1. Navigate to the Admin, Backup, Manual Backup and Restore screen.

2. Click the option for Backup on the Manual Backup and Restore screen next to Operation.Browse the directory and select the backup destination folder.

Note:
The backup file name DIVAdirector_database_timestamp.sql is predefined and cannot be modified.

The time stamp format is DDMMYY-hhmm, where:

- DD = day of month

- MM = month

- YY = year

- hh = hour

- mm = minute

3. Click Backup Now on the top right side of the screen to begin the backup operation.
A message will appear at the bottom of the screen stating that the backup process has started and normally takes approximately 3-5 minutes to complete (depending on the amount of data in the database). The message is displayed in red text at the bottom of the Manual Backup and Restore screen.

Performing a Database Restore

Caution:
A manual backup of the database should be completed first before performing a database restore operation.

Use the following procedure to manually restore the DIVAdirector database:

1. Click the option for Restore on the Manual Backup and Restore screen next to Operation.

2. Browse the From area to display the server's remote file system tree.

3. Select the database snapshot file to be restored (click once on the file name).

4. Browse the To area and select a restore destination folder, or select Restore to Active Database (logs off all connected users).
If you select the Restore to Active Database (logs off all connected users) option, the restore process will replace the existing database with the restored database. A confirmation dialog box is displayed notifying you that all connected users will be logged off.

5. If you have not selected the Restore to Active Database (logs off all connected users) option, click Restore Now to begin the restore process.

6 Frequently Asked Questions

This chapter contains some frequently asked questions.

Do Proxy Drop Folders exist and are they still usable?

Yes they still exist in this release and can be used; however, Oracle recommends using the new Transcode Service rather than Proxy Drop Folders.

Does the original proxy workflow still exist and is it still usable?

Yes the original proxy workflow still exists and is usable in this release.

Is DIVAdirector 5.3 still linked with the DIVArchive 6.5 (and later) APIs?

DIVAdirector 5.3 can be linked to the API release 7.1 and later; however it currently only uses API release 7.1.

Can DIVAdirector 5.3 list all component files of a DIVArchive Complex Object?

Currently DIVAdirector cannot list all complex object component files.

Can DIVAdirector 5.3 restore any component file of a DIVArchive Complex Object?

Complex object support is not currently implemented in this release.

If proxies are created outside of the new transcode service, do local proxies still work the same way?

It is highly discouraged to use proxies produced outside of DIVArchive and DIVAdirector; however the Local Proxies feature still works in this release.

Do Drop Folders support Oracle DIVArchive Partial File Restore?

DIVArchive Operation Drop Folders do not currently support partial file restore operations.

Which file is the proxy generated from when referring to the ProxyFileExtensions parameter?

The transcoder will proxy a file with valid file extensions when a request is made to the Transcoder Source/Destination from DIVAdirector. The user selects the file in question in that case, and automated proxy generation currently remains unchanged.

Exactly what transcoders are supported by the new Transcode Service?

Currently only the Vantage transcoder is supported.

Glossary

Complex Object

A complex object contains 1,000 or more files. This value is configurable in DIVArchive. Complex object handling may be different than non-complex objects. See Object.

Data Store

A data repository of a set of integrated objects.

Drop Folders

Network monitored folders that have specific operations assigned to them. When files are placed into a Drop Folder, the system will perform the operations identified for that specific folder.

Internet Information Service (IIS)

The Internet Information Service is an extensible web server created by Microsoft for use with the Windows NT family of operating systems. IIS supports HTTP, HTTPS, FTP, FTPS, SMTP and NNTP protocols. IIS is not turned on by default when Windows is installed. The IIS Manager is accessed through the Microsoft Management Console or Administrative Tools in the Control Panel.

Lightweight Directory Access Protocol (LDAP)

The Lightweight Directory Access Protocol is an application protocol for accessing and maintaining Distributed Directory Information Services over an Internet Protocol (IP) network.

Object

Objects are archive entries. An object (archive entry) is identified by a pair (Name and Category) and contains video files, audio files, metadata files, and so on. The files are stored in DIVArchive as Object Instances. An object can contain up to 1,000 files before being considered a complex object. See Complex Object.

Open Web Interface for .NET (OWIN)

A standard for an interface between .NET web applications and web servers. It is open-source.

Partial File Restore (PFR)

Restore only part of a file (rather than the entire file) from DIVArchive to a destination based on time code, byte offsets, folders, or DPX frames.

Proxy

A Proxy Video is a form of metadata. It consists of highly compressed, very low resolution video and sound that mirrors a high resolution original master digital recording.

Root

Also known as SuperAdmin, this special user account is identified with an authorization flag in the user profile allowing administrative functions to be performed, and full unrestricted access to the server host. In DIVAdirector this account is named admin.

Shot List

A list compiled by a user containing video clips (shots) which indicates the sequence of scenes included in the list. The list may include the scene number, the location of where the scene was shot, a description of the scene, the length of a scene, a list of actors in the scene, and so on.

Universal Naming Convention (UNC)

The Universal Naming Convention specifies a common syntax to describe the location of a network resource, such as a shared file, directory, or printer. The UNC syntax for Windows systems has the generic form \\ComputerName\SharedFolder\Resource.

Work Bin

A working area for users allowing them to organize and work with video clips, files, objects, and so on in a single location.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2016, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Alpha and Beta Draft Documentation Notice

If this document is in private preproduction status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.