How to create a replica in a connected environment

Summary

This topic shows how to create a replica in a connected environment. A connected environment is where both replica geodatabases are connected on the same local area network (LAN) or wide area network (WAN) during replica creation.

Creating a replica in a connected environment

1. Connect to a geodatabase to host the parent replica and connect to a geodatabase to host the child replica. This requires initializing a GeoDataServer object for each connection. GeoDataServer objects allow access to a geodatabase on a LAN or a WAN through ArcGIS for Server. For more information about initializing a GeoDataServer, see How to initialize a GeoDataServer object.
2. Call the following methods by pasting them into an application and passing in the following parameters:
   

[C#]

// Creates a replica of all data in a feature dataset.
public void CreateFeatureDatasetReplica(IGeoDataServer parentGDS, IGeoDataServer
    childGDS, String replicaName, esriReplicaAccessType accessType, String
    featureDataset, IGeometry geometry, Boolean registerOnly, Boolean useArchiving)
{
    try
    {
        // Set and expand the replica datasets.
        IGPReplicaDataset gpReplicaDataset=new GPReplicaDatasetClass();
        gpReplicaDataset.DatasetType=esriDatasetType.esriDTFeatureDataset;
        gpReplicaDataset.Name=featureDataset;
        IGPReplicaDatasets gpReplicaDatasets=new GPReplicaDatasetsClass();
        gpReplicaDatasets.Add(gpReplicaDataset);
        IGPReplicaDatasets gpReplicaDatasetsExpand=parentGDS.ExpandReplicaDatasets
            (gpReplicaDatasets);

        // Set the replica description.
        IGPReplicaDescription gpReplicaDesc=new GPReplicaDescriptionClass();
        gpReplicaDesc.ReplicaDatasets=gpReplicaDatasetsExpand;
        gpReplicaDesc.ModelType=esriReplicaModelType.esriModelTypeFullGeodatabase;
        gpReplicaDesc.SingleGeneration=(accessType ==
            esriReplicaAccessType.esriReplicaAccessNone);
        gpReplicaDesc.QueryGeometry=geometry;
        gpReplicaDesc.SpatialRelation =
            esriSpatialRelEnum.esriSpatialRelIndexIntersects;

        // Set the replica options.
        IGPReplicaOptions2 replicaOptions=new GPReplicaOptionsClass();
        replicaOptions.AccessType=accessType;
        replicaOptions.ChildReconcilePolicy =
            esriReplicaReconcilePolicyType.esriReplicaResolveConflictsNone;
        replicaOptions.ParentReconcilePolicy =
            esriReplicaReconcilePolicyType.esriReplicaResolveConflictsNone;
        replicaOptions.IsChildFirstSender=true;
        replicaOptions.RegisterReplicaOnly=registerOnly;
        replicaOptions.UseArchiving=useArchiving;

        // Create the replica.
        IReplicationAgent replicationAgent=new ReplicationAgentClass();
        replicationAgent.CreateReplica("", parentGDS, childGDS, replicaName,
            gpReplicaDesc, replicaOptions);
    }
    catch (COMException comExc)
    {
        throw new Exception(String.Format(
            "Create replica errored: {0}, Error Code: {1}", comExc.Message,
            comExc.ErrorCode), comExc);
    }
    catch (Exception exc)
    {
        throw new Exception(String.Format("Create replica errored: {0}", exc.Message)
            , exc);
    }
}

[VB.NET]

' Creates a replica of all data in a feature dataset.

Public Sub CreateFeatureDatasetReplica(ByVal parentGDS As IGeoDataServer, ByVal childGDS As IGeoDataServer, ByVal replicaName As String, ByVal accessType As esriReplicaAccessType, ByVal featureDataset As String, ByVal geometry As IGeometry, ByVal registerOnly As Boolean, ByVal useArchiving As Boolean)
    
    Try
    ' Set and expand the replica datasets.
    Dim gpReplicaDataset As IGPReplicaDataset=New GPReplicaDatasetClass()
    gpReplicaDataset.DatasetType=esriDatasetType.esriDTFeatureDataset
    gpReplicaDataset.Name=featureDataset
    Dim gpReplicaDatasets As IGPReplicaDatasets=New GPReplicaDatasetsClass()
    gpReplicaDatasets.Add(gpReplicaDataset)
    Dim gpReplicaDatasetsExpand As IGPReplicaDatasets=parentGDS.ExpandReplicaDatasets(gpReplicaDatasets)
    
    ' Set the replica description.
    Dim gpReplicaDesc As IGPReplicaDescription=New GPReplicaDescriptionClass()
    gpReplicaDesc.ReplicaDatasets=gpReplicaDatasetsExpand
    gpReplicaDesc.ModelType=esriReplicaModelType.esriModelTypeFullGeodatabase
    Dim singleGeneration As Boolean
    If accessType=esriReplicaAccessType.esriReplicaAccessNone Then
        singleGeneration=True
    Else
        singleGeneration=False
    End If
    gpReplicaDesc.SingleGeneration=singleGeneration
    gpReplicaDesc.QueryGeometry=geometry
    gpReplicaDesc.SpatialRelation=esriSpatialRelEnum.esriSpatialRelIndexIntersects
    
    ' Set the replica options.
    Dim replicaOptions As IGPReplicaOptions2=New GPReplicaOptionsClass()
    replicaOptions.AccessType=accessType
    replicaOptions.ChildReconcilePolicy=esriReplicaReconcilePolicyType.esriReplicaResolveConflictsNone
    replicaOptions.ParentReconcilePolicy=esriReplicaReconcilePolicyType.esriReplicaResolveConflictsNone
    replicaOptions.IsChildFirstSender=True
    replicaOptions.RegisterReplicaOnly=registerOnly
    replicaOptions.UseArchiving=useArchiving
    
    ' Create the replica.
    Dim replicationAgent As IReplicationAgent=New ReplicationAgentClass()
    replicationAgent.CreateReplica("", parentGDS, childGDS, replicaName, gpReplicaDesc, replicaOptions)
    Catch comExc As COMException
    Throw New Exception(String.Format("Create replica errored: {0}, Error Code: {1}", comExc.Message, comExc.ErrorCode), comExc)
    Catch exc As Exception
    Throw New Exception(String.Format("Create replica errored: {0}", exc.Message), exc)
    End Try
    
End Sub

---

To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):

• System.Runtime.InteropServices
• ESRI.ArcGIS.System (ESRI.ArcGIS.esriSystem)
• ESRI.ArcGIS.Geodatabase
• ESRI.ArcGIS.GeoDatabaseDistributed
• ESRI.ArcGIS.Geometry

Development licensing	Deployment licensing
ArcGIS for Desktop Standard	ArcGIS for Desktop Standard
ArcGIS for Desktop Advanced	ArcGIS for Desktop Advanced
Engine Developer Kit	Engine: Geodatabase Update