Skip Headers
Oracle® Fusion Middleware Administering Oracle WebCenter Content
11g Release 1 (11.1.1)

Part Number E26692-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

29 Transferring Files

The Transfer function of the Oracle WebCenter Content Archiver utility is used to move or copy content from one Content Server instance to another over sockets.

This chapter covers the following topics:

29.1 Overview of File Transfer

You can use the Transfer function of the Archiver utility to transfer files between Content Server instances on a shared file system, but transfers do not require a shared file system. Transferring files between non-shared file systems requires an outgoing provider on the source Content Server instance.

Transfers will be successful only between Content Server version 4.5 or newer systems.

Caution:

Archiver cannot be used to move or copy data between two instances that share the same Content Server instance name (IDC_Name). To do so will corrupt the data on the target system.

This section covers these topics:

29.1.1 Transfer Uses

Typical uses for the Transfer function include:

  • Exporting and importing over a firewall.

    Note:

    To transfer across a firewall, you might need to configure the firewall to permit the outgoing provider's socket to pass through it.

  • Transferring content between Content Server instances in different physical locations (buildings, cities, or countries).

  • Transferring content between Content Server instances using a shared drive. (A transfer over a file system share can handle large archives better than a socket transfer.)

  • Avoiding the need to build a FTP or HTTP interface to move files from one file system to another.

  • Combining the batch files from two archives into a single archive.

29.1.2 Transfer Methods

You can transfer files in the following ways:

  • Manual Transfer: A one-time transfer initiated from Archiver by an administrator. This copies an archive to another archive.

  • Automatic Transfer: Moving archive files to another archive is initiated automatically whenever the source archive is updated.

29.1.3 Transfer Terms

The following terms are related to the Transfer function:

  • local archive: An archive that belongs to a local collection.

  • local collection: A collection that the Content Server instance can reach by file access using a mapped or mounted network share.

  • local transfer: A transfer between local archives. Both the source archive and the target archive are in a local collection.

  • proxied: In Archiver, the term proxied refers to any Content Server instance to which the local Content Server instance is connected through an outgoing provider.

  • proxied archive: An archive that belongs to a proxied collection.

  • proxied collection: A collection on another Content Server instance that the local Content Server instance can reach through an outgoing provider.

  • pull transfer: A transfer over an outgoing provider that is owned by the proxied (remote) Content Server instance.

  • push transfer: A transfer over an outgoing provider that is owned by the local Content Server instance.

  • source archive: An archive that contains batch files to be transferred.

  • target archive: An archive that receives transferred batch files.

  • targetable archive: An archive that is enabled to be a target archive.

  • transferring: The process of copying or moving batch files and their associated content files from one archive to another. There are three types of transfers: local, push, and pull.

  • transfer owner: The Content Server instance that performs and monitors a transfer.

  • transfer source: See source archive.

  • transfer target: See target archive.

29.2 Transfer Types

This section provides information about the different transfer types, listed in order from simplest to most complex.

29.2.1 Local Transfer

A local transfer is a transfer between local archives, which belong to collections that both the source and target Content Server instances can reach through a mapped or a mounted drive. An outgoing provider is not required. This type of transfer is typically used to combine the batch files of two archives.

Note:

If you are transferring between Content Server instances on a shared file system, the mapped or mounted drive must be available to both Content Server instances. The computers must be on and logged in as a user who has system access to both Content Server instances.

Figure 29-1 Local Transfer

Description of Figure 29-1 follows
Description of "Figure 29-1 Local Transfer"

29.2.2 Pull Transfer

A pull transfer is a transfer that is owned by the proxied (remote) Content Server instance, which is the instance that is the target of the outgoing provider.

  • Multiple pull transfers can be concurrent.

  • If you are running a pull transfer across a firewall, you might need to configure the firewall to permit the outgoing provider's socket to pass through it.

    Note:

    In Archiver, the term proxied refers to any Content Server instance to which the local instance is connected through an outgoing provider. This does not have to be a proxied instance of the master Content Server instance.

Figure 29-2 Pull Transfer

Description of Figure 29-2 follows
Description of "Figure 29-2 Pull Transfer"

29.2.3 Push Transfer

A push transfer is a transfer that is owned by the local Content Server instance, which is the instance on which the outgoing provider is set up.

  • For performance monitoring of a push transfer, you also should set up an outgoing provider from the target (proxied) Content Server instance back to the source (local) Content Server instance. This 'talkback' provider can then notify the source Content Server instance when each transfer is complete. A push transfer will work without the talkback provider, but the source Content Server instance would not be aware of transfer completion or problems.

  • Only one push transfer can be in progress at a time.

  • If you are running a push transfer across a firewall, you might need to configure the firewall to permit the both providers' sockets to pass through it.

Figure 29-3 Push Transfer

Description of Figure 29-3 follows
Description of "Figure 29-3 Push Transfer"

29.3 Transferring Batch Files

This section provides information about transferring batch files.

Transfer Process

When a transfer is initiated, the following actions occur:

  1. Each batch file in the archive is zipped together with its associated content files.

  2. The Zip files are transferred to the target Content Server instance by a local file system move (local transfer) or by the outgoing provider (push or pull transfer).

  3. The Zip files are unzipped and placed in the appropriate file system locations.

  4. For an automated transfer, the batch files and their associated content files are removed from the source Content Server instance. For a manual transfer, the batch files and associated content files remain in the source Content Server instance.

    The transferred archive is now available for import through the Archiver of the target Content Server instance.

Figure 29-4 The Transfer Process

Description of Figure 29-4 follows
Description of "Figure 29-4 The Transfer Process"

Transfer Rules

The following list provides applicable transfer rules:

29.4 Managing Transfers

This section provides information about tasks for managing transfers.

29.4.1 Transfer Process

To transfer content between Content Server instances:

  1. In the source Content Server instance, create the archive to be transferred and set up an export to this archive. See Section 27.2.1.

  2. In the target Content Server instance, create the archive to receive transferred content and make the target archive 'targetable.' See Section 29.4.2.

  3. Set up communications between the Content Server instances:

    • If the source and target archives are on a shared file system, ensure that both computers are on and logged in as a user who has system access to both Content Server instances.

    • If the source and target archives are not on a shared file system, create an outgoing provider from the source Content Server instance to the target Content Server instance. See Section 29.4.3.

  4. From the source archive, specify the target archive. See Section 29.4.4.

  5. Initiate the transfer. See Section 29.4.5. The batch files and content files are copied to the target archive.

29.4.2 Making an Archive Targetable

To indicate that an archive can receive transfers from other archives:

  1. Open the archive collection that contains the target archive. See Section 26.3.1.

  2. Select the target archive in the Current Archives list.

  3. Click the Main Archiver Transfer window.

  4. Click Edit in the Transfer Options section.

  5. In the Transfer Options window, select Is Targetable.

  6. Click OK.

29.4.3 Defining an Outgoing Transfer Provider

To create an outgoing provider for transfer purposes:

  1. In the source Content Server instance, create an outgoing provider. Enter the following information:

    Field Description

    Provider Name

    Enter a name. This will become a subdirectory in the DomainHome/ucm/cs/data/providers/ directory.

    Provider Description

    Enter a user-friendly description. For example, Transfer Provider.

    Server Host Name

    Enter the server host name of the target Content Server instance. For example, extranet_server.

    Server Port

    Enter a unique port number on which the provider will communicate with the target Content Server instance.

    Instance Name

    Enter the name of the target Content Server instance. For example, instance_on_extranet.

    Relative Web Root

    Enter the relative web root of the target Content Server instance. For example, /company/.

    Proxied check box

    Select this check box only if the target Content Server instance was installed as a proxy of the local (master) Content Server instance. See the Caution message below.


    Caution:

    Do not select this check box if the relative web root is the same for both Content Server instances.

  2. In the System Properties utility of the target Content Server instance, set the IP Address Filter or Hostname Filter to the IP address or host name of the source Content Server instance. (The IP Address Filter setting is recommended.)

  3. If you are setting up a push transfer (transfer owned by the local Content Server instance), consider setting up a 'talkback' outgoing provider from the target Content Server instance back to the source Content Server instance.

  4. If you are transferring across a firewall, configure the firewall to permit the outgoing providers' sockets to pass through it.

29.4.4 Setting a Transfer Destination (Target)

To specify the target archive to receive transferred content:

  1. Open Archiver from the Content Server instance that will own the transfer.

    • For a pull transfer, the transfer owner is the target (proxied) Content Server instance.

    • For a push transfer, the transfer owner is the source (local) Content Server instance.

  2. Open the archive collection that contains the source archive. See Section 26.3.1.

  3. Select the source archive in the Current Archives list.

  4. Click the Main Archiver Transfer window.

  5. Click Edit in the Transfer Destination section.

  6. In the Archive Collections window, select the collection that contains the target archive.

  7. Select the target archive.

    Note:

    The target archive must be identified as targetable. See Section 29.4.2.

  8. Click OK.

29.4.5 Initiating a Manual Transfer

To transfer content manually:

  1. Open Archiver on the source Content Server instance.

  2. Open the archive collection that contains the source archive. See Section 26.3.1.

  3. Select the source archive in the Current Archives list.

  4. Select Actions, then click Transfer. The transfer process is initiated, and the status bar at the bottom of the Archiver page displays progress messages.

29.4.6 Deleting a Transfer

This section provides information about the methods to delete a transfer.

Deleting a Transfer from the Transfer To Tab:

  1. Open the archive collection that contains the source archive. See Section 26.3.1.

  2. Select the source archive in the Current Archives list.

  3. Click the Main Archiver Transfer window.

  4. Click Remove in the Transfer Destination section.

  5. When prompted to confirm the action, click Yes.

Deleting an Automated Transfer from the Automation for Instances Page:

  1. Open the archive collection. See Section 26.3.1.

  2. Choose Options, then View Automation For Instance.

  3. In the Automation window, click the Transfers tab.

  4. Select the automated transfer to delete.

  5. Click Remove. The automated transfer is removed from the list.