Publish Client

Geoportal Extension Publish Client

The Geoportal extension Publish Client is used to publish metadata documents to a Geoportal directly. The Publish Client will examine the folder in ArcGIS Desktop's ArcCatalog that a user specifies, find the metadata documents in that folder, and publish those documents to the Geoportal that is indicated in the interface. It provides a quick way to publish metadata for data resources.

Note:

The Publish Client is backward and forward compatible with version 9.3.1 and version 10. This means that you can use a 9.3.1 Publish Client installed on ArcGIS Desktop 9.3.1 to publish to geoportals of both version 9.3.1 or version 10. It also means that you can use a version 10 Publish Client in an ArcGIS Desktop 10 environment to publish to a version 9.3.1 geoportal. It is important to make sure that your ArcGIS Desktop version and Publish Client version match, as a 9.3.1 Publish Client will not work on a version 10 ArcGIS Desktop environment, nor will a version 10 Publish Client work on a 9.3.1 ArcGIS Desktop environment.

• Install the Publish Client
• Add the Publish Client to the ArcCatalog Interface
• Use the Publish Client

Install the Publish Client

Install the Publish Client by running its setup file, or silently from the command line.

• Installation by running the setup file
  1. Run the setup.exe for the Publish Client. The installer dialog will open.
  2. Click Next on the Welcome screen.
  3. Accept the License Agreement. Click Next.
  4. Enter in your Information into the Username and Organization text boxes. Click Next.
  5. Choose the Destination Folder into which the Publish Client should install or accept the default. Also choose the Destination Folder to which Publish Client logfiles should be written. Click Next.
  6. Click Install to begin the installation.
  7. Once the installation wizard completes, click Finish.
• Installation from the command line (silent installation)
  1. Copy the following string into a text editor, such as Notepad:

     msiexec /i "[install_path_for_Publish_Client_msi]\Geoportal Extension Publish Client.msi" /qn ALLUSERS=1 INSTALLDIR_FS="C:/Program Files/ESRI/Geoportal/Geoportal_Publish_Client/" LOGDIR="C:\Documents and Settings\All Users\Application Data\ESRI\GeoportalPublishClient"
     

  2. Replace the [install_path_for_Publish_Client_msi] with the location of the Publish Client msi file (eg, C:\Downloads\)
  3. After editing the string, open a command prompt.
  4. Copy and paste the edited string into the command line, and run the command.
     Note:

     If the Publish Client was not installed through the copy and paste, enter the string in manually, as sometimes hidden characters can be copied over which affects the command.

Add the Publish Client to the ArcGIS Desktop Interface

1. Start ArcGIS Desktop. The Publish Client is used with the ArcCatalog component of ArcGIS Desktop.
2. Click Customize > Customize Mode. The Customize window appears.
3. In the Customize dialog, select the Commands tab.
4. Scroll down through the list of Commands and select Geoportal. Select the Publish Client icon
   under the Commands list on the right, and drag the icon to a toolbar in ArcGIS Desktop.

Use the Publish Client

After you have installed the Publish Client and added it to your ArcGIS Desktop toolbar, it is ready to be used. The following steps explain how to use the Publish Client.

Note:

ArcGIS Desktop automatically removes <!DOCTYPE> tags from metadata when a geoprocessing task is run upon the document. If your metadata document contains <!DOCTYPE> tag information, the tag will be removed after running the Publish Client, even if you comment out the tag.

1. In the ArcCatalog Catalog Tree, highlight the folder, branch, or resource from which you wish to publish metadata.
2. Click the Publish Client button
   on your toolbar.
3. An interface with input fields will appear. Enter information in the input fields as follows:
   • Server Url: the URL to the Geoportal endpoint to which you want to publish. The URL should consist of your geoportal server name, port number (if applicable), and the geoportal web application name. For example, http://myserver:8080/geoportal.
   • Metadata Service: the geoportal publish service used if the geoportal is a 9.3.x version with the MetadataServer component deployed. Leave as the default, GPT_Publish_Metadata.
   • UserName: the login of the user who has publishing permissions to the geoportal.
   • Password: the publisher's password.
   • Display Execution Summary: checking this option expands the Publish Client interface and will display results of the publish session in a Process Execution Summary window. It is recommended that you enable Display Execution Summary.
4. Once you have entered all the information, click the Publish button. The Publish Client traverses the resource you selected in the Catalog Tree, and attempts to publish any documents with file extension ".xml" to the geoportal. The metadata will be validated against the rules defined by the metadata standards supported in the geoportal.
5. When the Publish Client has finished, a message will be written to the Process Execution Summary window displaying the results of the publish session. Also, if you have enabled Publish Client logging, a popup box will appear confirming that logfiles were written. For more about turning on logging and interpreting the logfile, see The publishMetadata.log file for the Publish Client.
6. Verify that your records were published. Login to the geoportal as a publisher and click the Administration tab to see the newly published resources.
   Note:

   Resources published to a version 10 geoportal will have a Publication Method of Upload; when publishing to a version 9.3.x geoportal, the Publication Method will be Batch.

   Tip:

   Remember that records will not show up in the geoportal search results until the geoportal administrator approves them.