Smoketest the Geoportal

IMPORTANT: Before proceeding with the smoketest, save all configuration files, and restart your geoportal web application.

Now that your geoportal web application has been installed, it is important to do a brief smoketest before continuing with installing the Desktop Tools or doing customizations. The following describes basic steps to check that your geoportal is up and running. These are steps for an initial smoketest. Your organization should also do extensive testing and reference Post-Deployment-Actions before the geoportal goes into production.

If you encounter errors during the smoketest, review your gpt logfiles (Tomcat\logs) and see Common-problems-and-solutions.

• Launch the geoportal web application in a web browser. A sample URL: http://serverName:port/geoportal
  • Verifies that the gpt.xml file is valid XML, and the Tomcat service is started.

• Click the Login link from upper right corner. Login with your Administrator user login credentials. After doing so, you should see a Welcome message and the Administration tabs should now appear.
  • Verifies that the server hosting the geoportal can connect to the directory server if it is configured with a directory server, that the <identity></identity> section in the gpt.xml file is configured correctly, and that the geoportal can communicate with the database.

• Click the Administration tab. From the resulting Manage interface, click the Add link. You will be presented with three options for adding a resource to the geoportal. From the list, choose the radio next to Use dedicated editor to create metadata manually. A page presenting the supported metadata profiles will appear.

• For this smoketest, you will create a simple Dublin Core metadata record for testing. Select the Dublin Core radial. On the resulting form, fill out information for all required fields. Required fields have bold/italic headings. Then click Save at the bottom. After clicking Save, you should receive a success message or a message saying what is missing in the document to be valid. If you receive a message that something is missing, fill in the missing information and click Save again.
  • Verifies the connection to the database and the user's ability to publish metadata.

• Click the Manage link, and in the resulting interface check the box next to your newly created record in the table. Then select Set as Approved from the dropdown box, and click the Execute Action button. The document should now have a Status of Approved.

• Click the Search tab. In the resulting Search interface, type a word in the search field that was included in your newly approved record;s title or abstract. Then click Search. Your document should be returned.
  • Verifies that the indexing mechanisms in the geoportal are working (e.g., lucene folder set in the gpt.xml).

• Click on the record returned in the Search results to display its options. Select the Metadata link. The document's metadata XML should load in a new browser window.
  • Verifies that the geoportal is able to retrieve the full XML from the database.

• If the smoketest is completed successfully, you may proceed to Install Desktop Tools if you desire to use ArcGIS Desktop to search or publish to your geoportal. Also, review All gpt.xml file settings to apply configurations in the gpt.xml file for additional functionality.