AGP TO AGP Harvesting with the Geoportal

AGP-TO-AGP harvesting enables an administrator to use the Geoportal as a broker to harvest/transfer items from one Portal for ArcGIS instance to another Portal for ArcGIS instance. For example, you can use it to transfer items that belong to a particular user or group to another.

The harvested records go directly to the destination Portal for ArcGIS instance; they are not stored in the Geoportal Server repository.

Enable AGP-TO-AGP harvesting

• Open the \\geoportal\WEB-INF\classes\gpt\config\gpt.xml file
• Uncomment one of the following two protocol sections - Note, the Agp2AgpProtocolFactory option will stop the harvest if it runs into an exception; the Agp2AgpRelaxedProtocolFactory option will log the exception but continue harvesting if it runs into an exception.

    <protocol factoryClass="com.esri.gpt.control.webharvest.protocol.factories.Agp2AgpProtocolFactory"
             resourceKey="catalog.harvest.manage.edit.protocol.agp2agp"/>  
    <protocol factoryClass="com.esri.gpt.control.webharvest.protocol.factories.Agp2AgpRelaxedProtocolFactory"
             resourceKey="catalog.harvest.manage.edit.protocol.agp2agp"/>                 

• Save the gpt.xml and restart the geoportal web application.

Register an AGP-TO-AGP harvesting service

• Login to your geoportal as an administrator and click on the Administration tab
• Click on the Add link, then select the Register resource on the network radio and click Proceed.
• Select the AGP-TO-AGP option as the protocol type
• Enter information for the source ArcGIS Portal
  • Host - host name and prefix for the target portal, if the site is 10.2, the default is "hostname", for 10.2.1 the default is "hostname/portal", for 10.2.2, the default is "hostname/arcgis", the prefix can vary depending on individual implementation.
  • User Name - user name with the source portal
  • Password - password for the user with the source Portal
  • Query - query text for items to be harvested from the source portal
    • The query is used for querying the content in the source portal. The query text follows the same search syntax as used in Portal for ArcGIS except in this case it is for getting specific records from a user or a group. The following are examples:

owner:"ownername"

group:"1652a410f59c4d8f98fb87b25e0a2669"

• • • Test Query button - click to test if the geoportal can successfully communicate with the source portal instance.
  • Max Items - maximum number of items to be harvested from the source portal. Note: if there are more items matching the search criteria than the maximum items defined, it is possible that the records harvested each time will be a different set. Thus, it is recommended that you either narrow down the query criteria or increase the max items count to ensure the harvest set is consistent.
• Enter information for the destination ArcGIS Portal
  • Host - host name and prefix for the target portal, if the site is 10.2, the default is "hostname", for 10.2.1 the default is "hostname/portal", for 10.2.2, the default is "hostname/arcgis", the prefix can vary depending on individual implementation.
  • User Name - user name with the target portal
  • Password - password for the user with the target portal
    • Test Client - click to test if the geoportal can successfully communicate with the target portal instance.
  • Owner - owner of the harvested records on the target portal. If you've designated a regular user on the target portal, the owner will be that regular user's name; if you've designated an administrative user on the target portal, click on search owners to retrieve a list of owners, then select the designated owner.
  • Folder ID - the id of the folder for keeping the harvested records. The user will need to first create a folder id on the target portal, then click on the Search folders button in geoportal to retrieve a list of folders and select the one folder to be used for holding the harvested records.
• Select other options
  • uncheck the following two options as the AGP-TO-AGP item is not designed to be found in geoportal search results.
    • Allow this resource to be found when searching for metadata
    • Include this endpoint on the federated search list
• Click on Create/Create and Close to save the entry

Harvest from one Portal for ArcGIS instance to another Portal for ArcGIS instance

• Click Manage at the top of the geoportal Administration page
• Find the registered AGP-TO-AGP item
• Approve the item
• Click on the Synchronize Content icon. You will be asked if you'd like to proceed with harvesting - click OK. Then wait for the harvesting process to be carried out - the Synchronize Content icon will be grayed out while the harvesting process still in progress.
• After the harvest process if complete, click on the harvest history icon to verify records are harvested correctly
• Login to the destination Portal for ArcGIS instance and verify the items from the source Portal for ArcGIS instance are harvested successfully.