5 Direct ISIS AM Communicator Workflows

The following figures are examples of standard Direct ISIS AMC workflows for various requests (Archive, Restore, and Partial File Restore), followed by a description of the sequence of events for each request.

All Delete commands are the same as in the Legacy AMC Delete Workflow described in Legacy AM Communicator Delete Workflow.

This chapter includes the following information:

ISIS AM Communicator Archive Workflow

AMC Direct ISIS Archive Workflow

The general ISIS Archive workflow is as follows:

  1. The Media Services Application submits a JobXML to the Archive service.

    1. The Archive Service loads the fpdiDET2.dll and DET2 calls provided.

    2. The fpdiDET2 uses the Avid Archive SDK for this purpose.

    3. The fpdiDET2 connects to AMC, and then submits the JobXML.

  2. AMC receives the command, and then receives the JobXML from fpdiDET2.

  3. The JobXML is parsed and a list of all files, and their details, is constructed.

  4. AMC confirms whether the clip (or sequence of clips) is part of any existing object, determines if deletion is required (based on the configuration), and then sends the Archive request to the Manager.

  5. The Manager processes the requests, and then forwards all necessary information to the Actor (using the ISIS Client).

  6. The Actor then archives the objects directly from the ISIS server.

ISIS AM Communicator Restore and Partial File Restore Workflow

AMC Direct ISIS Restore Workflow

The general ISIS Restore workflow is as follows:

  1. The Media Services Application submits a JobXML to the Restore service.

    1. The Restore service loads the fpdiDET2.dll and DET2 calls provided.

    2. The fpdiDET2 connects to AMC, and then submits the JobXML.

  2. AMC receives the command, and then receives the JobXML from fpdiDET2.

  3. The JobXML and fpdiDET2 provide AMC with the file path and MOB ID to construct the Manager request.

  4. AMC searches all categories, identifies a list of objects to Restore, and then sends the Restore request to the Manager.

  5. The Manager notifies the Actor of the request, and then the Actor proceeds to restore the objects directly to the ISIS server.

Configuring AM Communicator for Direct ISIS Connectivity

Caution:

Never change any category parameters, for example, DIVA_DEFAULT_CATEGORY when the system has been used previously. This will affect all Restore operations.

The default configuration file named amc.conf.ini is delivered in both 1.x and 2.x packages with specific parameters for Legacy and ISIS respectively. You must configure the file with the appropriate parameters. If an upgrade is being performed from a previous release, you can copy amc.conf, and then add any new parameters for the release to the new file.

Installing the ISIS Client

You must install the newest ISIS client on the Actor computer that interfaces with the ISIS server. Execute the ISIS client installation file, and install the program with the default settings.

If the ISIS server is on the same subnet as the Actor where the ISIS client is installed, the ISIS client will automatically detect the server. You right-click the server name in the top Systems panel, and select Connect from the resulting context menu to connect to the server.

If the ISIS server is on a different subnet than the Actor computer where the ISIS client is installed, you use the following procedure to add the server to the ISIS client interface:

  1. Open the ISIS client and click the Add Server icon in the icon bar (it looks like a globe). The Remote Hosts dialog box appears.

  2. Enter the IP address of the remote ISIS server in the field and click + to add the host name to the Host panel.

  3. Confirm that the server has connectivity, and has been added, by clicking the Network icon on the icon bar (the icon looks like two computers connected together).

    A window is displayed showing the added server on the network. Confirm that the Enabled check box is selected to use the server.

  4. You right-click the server name in the top Systems panel, and select Connect from the resulting context menu to connect to the server.

Configuring the AM Communicator Source/Destination in DIVArchive

To enable archive and restore workflows, you must configure dedicated FTP-like Source/Destinations with the Source Type AVID_AMC in DIVArchive. You perform this task in the Sources and Destinations panel in the Configuration Utility.

You use the following specific parameters when you add a Source/Destination for use with Legacy AM Communicator. You set the other parameters as you normally would for your environment and operations.

Source Name

This parameter identifies the AMC Source/Destination name. The name must either match the value of the DIVA_SRCDST parameter from the AMC configuration, or the partition parameter value from the Archive Profile in Avid (depending on configuration).

IP Address

This parameter identifies the IP address of the AMC FTP interface. The value must be consistent with the FTP_IP parameter value from the AMC configuration.

Source Type

This parameter identifies the Source Type and must be set to AVID_AMC for Legacy AM Communicator operations.

Connect Options

The AMC FTP interface port, login, user name and data socket buffer size (in kilobytes) must match the values of FTP_PORT, FTP_LOGIN, FTP_PASSWORD, and AM_BUFFER_SIZE from the AMC configuration.

An example entry in this field might be -login amc -pass diva -port 6121.

AMC supports Passive Mode FTP. To switch to Passive Mode FTP add the -PASV option to the string as follows:

-login amc -pass diva -port 6121 -PASV

You use the following specific parameters when you add a Source/Destination for use with Direct ISIS AM Communicator.

You must keep the Source/Destination Root Path value empty for Direct ISIS. There is only one Source/Destination type that is AVID_DIRECT for all Actors. Multiple Actors do not require METASOURCE.

All Actors with an ISIS Client and the AVID_DIRECT Source/Destination must be in a single production system so that other (non-ISIS) Actors are not used with this Source/Destination.

You must set the other parameters as you normally would for your environment and operations.

Source Name

This parameter identifies the AMC Source/Destination name. The name must either match the value of the DIVA_SRCDST parameter from the AMC configuration, or the partition parameter value from the Archive Profile in Avid (depending on configuration).

IP Address

This parameter field is left empty for Direct ISIS AM Communicator operations. The IP address does not have any significance for ISIS configuration. An IP address is not required in the configuration because the ISIS Source/Destination acts like a CIFS Source/Destination. The Actor uses the -login {user_name} -pass {password} options for authentication to access the ISIS Workspace Paths for reading and writing files in the file list.

For example:

\\rd-avid-isis5k\raw\avid mediafiles\mxf\rd-avid-mc.1\justinseq1_audi5384fd47.1.mxf
Source Type

This parameter identifies the Source Type and must be set to AVID_DIRECT for Direct ISIS AM Communicator operations.

Connect Options

The Connect Options field must include the login and password for the Source/Destination ISIS server.

An example entry in this field might be -login amcdirect -pass is-admin.

The amc.conf configuration file must be configured with all required parameters. Important parameters for Direct ISIS configuration include the following:

  • AM_MAX_CONNECTIONS - the default is 100.

  • DIVA_SRCDEST - this is a type of AVID_DIRECT.

  • DIVA_DEFAULT_CATEGORY

You set all other parameters the same as a Legacy configuration.

Note:

The AM_TIMEOUT parameter is no longer used for status because the status is no monitored by AMC. The AM_TIMEOUT parameter will continue to monitor requests until they are canceled or terminated.

See AM Communicator Default Configuration File for the default, delivered amc.conf file.

Configuring the Avid Archive Manager

The Push, Pull, and Remove requests are initiated, and processed by, three separate Avid services. The services normally reside on different computers. In a typical configuration, Archive and Restore services are installed on the Archive Provider server, and the Archive Engine server handles Remove services.

The DET2 DLL must be installed on the servers where the corresponding Avid services reside to enable Archive, Restore, Partial File Restore, and Delete functionality.

The following procedure is identical for all Avid servers:

  1. Copy the fpdiDET2.dll, and all other files, from the $AMC_INSTALLATION/fpdiDET2 folder to $DLL_HOME folder on the target Avid server. Oracle recommends you use the default C:\DET2\fpdiDET2 path.

  2. If the selected $DLL_HOME folder is different from the recommended default path, you must edit the am_regkey.reg file's VendorFolder Key Value so it matches the $DLL_HOME value.

  3. Merge the am_regkey.reg file into the Windows Registry.

  4. Change the AMC parameter value in fpdiDET2.xml to define the correct AM Communicator network address using the format {IP}:{Port}.

    IP

    This parameter is the IP address of the AM Communicator Listener. This must be consistent with the value of the AM_IP parameter from the AMC configuration file.

    Port

    This parameter is the port number for the AM Communicator Listener. This must match the value of the AM_PORT parameter from the AMC configuration file.

  5. If required, set the optional SOCKET_BUFFER_SIZE parameter in fpdiDET2.xml to enable TCP/IP Scaling.

    This parameter value specifies the socket receive and send buffer sizes in kilobytes. The value must match the value of the AM_SOCKET_BUFFER_SIZE parameter from the AMC configuration.

    Leave this parameter set to the default value if TCP/IP Scaling is not configured for your system.

  6. The Archive and Restore Provider services must both be restarted for these changes to take effect. Oracle also recommends restarting the Avid Archive Engine server.

You must define both the Archive and Restore profiles using the Avid Interplay Media Services and Transfer Status utility to submit Archive, Restore, or Partial File Restore requests to the AM Communicator.

The partition parameter value defines either the destination tape group or disk array name, or the Source/Destination Name in DIVArchive. Creation and use of multiple Archive profiles enables archiving to different tape groups, disk arrays, or both.

Using the partition parameter as the Source/Destination Name enables the creation of Storage Plans based on the Source/Destination in DIVArchive. You can also use the Storage Plan as media.

Changing or adding Archive profiles does not require AMC Service reconfiguration or restarting.

If you do not specify the partition parameter value, or you submit a request with no profile selected, AMC uses the tape group, or disk array, and Source/Destination Names from its configuration file.

Note:

All other parameters in the Archive and Restore profiles depend on your specific requirements and are left to your discretion.

You can configure Avid Interplay 1.4 and later to store AAF (Advanced Authoring Format) Metadata with the media files. This configuration enables duplicate media files in a single archive.

You use the following procedure to enable these options:

  1. Open the Avid Interplay Administrator application.

  2. Connect to the AvidAM database by clicking the name in the navigation tree on the left side of the screen.

  3. Click the Asset Tracking/Archive Settings link.

  4. You select the value for the options in the Archive and Restore Settings section of the screen.

    Enabling the Allow duplicate media file(s) option consumes more storage space in DIVArchive, but generally decreases the time required for archived object restoration.

    In Direct ISIS, metadata files (.AAF) are not archived as part of the objects like they are in Legacy AMC. Therefore, Oracle highly recommends setting the Allow Metadata Archive parameter to No.

  5. Click Apply Changes to save your changes.

You can configure Avid Interplay 1.6 and later to enable Best Effort Restore. When the Best Effort Restore option is enabled, AMC attempts to restore as many media files as it can, and reports an error only if cannot restore any files at all.

Caution:

It is recommended to disable Best Effort Restore because the Avid Interplay Media Services, and Transfer Status GUIs, do not show partially restored, and completely restored clips and sequences differently. As a result, it may appear that some content is successfully restored while it actually is not.

You use the following procedure to enable Best Effort Restore:

  1. Open the Avid Interplay Administrator application.

  2. Connect to the AvidWG database by clicking the name in the navigation tree on the left side of the screen.

  3. Select the check box next to Use best effort restore option to enable the function. Deselect the check box to disable the function.

  4. Click Apply Changes to save your changes.