Geospatial Portal Installation Guide - geo.cmirit.rugeo.cmirit.ru/GeospatialPortalDoc/PDF/Geospatial_Portal... · please read these terms carefully before using hexagon geospatial’s

GEOSPATIAL PORTAL

INSTALLATION GUIDE

May 2016

Product Documentation Copyright and Terms of Use

Copyright

© 2016 Hexagon AB and/or its subsidiaries and affiliates. All rights reserved. Hexagon has registered trademarks in many countries throughout the world. Visit the Trademarks Page http://www.hexagongeospatial.com/legal/trademarks for information about the countries in which the trademarks are registered. See Product Page and Acknowledgments for more information.

Product Documentation Terms of Use

PLEASE READ THESE TERMS CAREFULLY BEFORE USING HEXAGON GEOSPATIAL’S DOCUMENTATION ("DOCUMENT"). USE OF THIS DOCUMENT INDICATES ACCEPTANCE OF THIS AGREEMENT WITHOUT MODIFICATION. IF YOU DO NOT AGREE TO THE TERMS HEREOF ("TERMS"), DO NOT USE THIS DOCUMENT.

Use Of This Document

All materials in this Document are copyrighted and any unauthorized use may violate worldwide copyright, trademark, and other laws. Subject to the terms of this Agreement, Hexagon Geospatial (a Division of Intergraph Corporation) and Intergraph’s subsidiaries ("Intergraph") hereby authorize you to reproduce this Document solely for your personal, non-commercial use. In consideration of this authorization, you agree to retain all copyright and other proprietary notices contained therein. You may not modify the Materials in any way or reproduce or publicly display, perform, or distribute or otherwise use them for any public or commercial purpose, except as specifically authorized in a separate agreement with Hexagon Geospatial.

The foregoing authorization specifically excludes content or material bearing a copyright notice or attribution of rights of a third party. Except as expressly provided above, nothing contained herein shall be construed as conferring by implication, estoppel or otherwise any license or right under any copyright, patent or trademark of Hexagon Geospatial or Intergraph or any third party.

If you breach any of these Terms, your authorization to use this Document automatically terminates. Upon termination, you will immediately destroy any downloaded or printed Materials in your possession or control.

Disclaimers

ALL MATERIALS SUPPLIED HEREUNDER ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. Hexagon Geospatial does not warrant that the content of this Document will be error-free, that defects will be corrected, or that any Hexagon Geospatial Website or the services that make Materials available are free of viruses or other harmful components.

Hexagon Geospatial does not warrant the accuracy and completeness of this Document. Hexagon Geospatial may make changes to this Document at any time without notice.

Limitation Of Liability

IN NO EVENT SHALL HEXAGON GEOSPATIAL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, DATA OR USE, INCURRED BY YOU OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, ARISING FROM YOUR ACCESS TO, OR USE OF, THIS DOCUMENT.

http://www.hexagongeospatial.com/legal/trademarks

Indemnification

You agree to defend, indemnify, and hold harmless Hexagon Geospatial, its officers, directors, employees, and agents from and against any and all claims, liabilities, damages, losses or expense, including reasonable attorneys' fees and costs, arising out of or in any way connected with your access to or use of this Document.

Use Of Software

Use of software described in this Document is subject to the terms of the end user license agreement that accompanies the software, if any. You may not download or install any software that is accompanied by or includes an end user license agreement unless you have read and accepted the terms of such license agreement. Any such software is the copyrighted work of Hexagon Geospatial, Intergraph or its licensors. Portions of the user interface copyright 2012-20nn Telerik AD.

Links To Third Party Websites

This Document may provide links to third party websites for your convenience and information. Third party websites will be governed by their own terms and conditions. Hexagon Geospatial does not endorse companies or products to which it links.

Third party websites are owned and operated by independent parties over which Hexagon Geospatial has no control. Hexagon Geospatial shall not have any liability resulting from your use of the third party website. Any link you make to or from the third party website will be at your own risk and any information you share with the third party website will be subject to the terms of the third party website, including those relating to confidentiality, data privacy, and security.

Trademarks

The trademarks, logos and service marks ("Marks") displayed in this Document are the property of Hexagon Geospatial, Intergraph or other third parties. Users are not permitted to use Marks without the prior written consent of Hexagon Geospatial, Intergraph or the third party that owns the Mark. "Intergraph" is a registered trademark of Intergraph Corporation in the United States and in other countries. Other brands and product names are trademarks of their respective owners.

Find additional trademark information http://www.hexagongeospatial.com/legal/trademarks.

Procedure For Making Claims Of Copyright Infringement

Notifications of claimed copyright infringement should be sent to Hexagon Geospatial by mail at the following address: Intergraph Corporation, Attn: Intergraph Legal Department, P.O. Box 240000, Huntsville, Alabama 35824.

US Government Restricted Right

Materials are provided with "RESTRICTED RIGHTS." Use, duplication, or disclosure of Materials by the U.S. Government is subject to restrictions as set forth in FAR 52.227-14 and DFARS 252.227-7013 et seq. or successor provisions thereto. Use of Materials by the Government constitutes acknowledgment of Hexagon Geospatial or Intergraph’s proprietary rights therein.

International Use

You may not use or export Materials in violation of U.S. export laws and regulations. Hexagon Geospatial makes no representation that Materials are appropriate or available for use in every country, and access to them from territories where their content is illegal is prohibited.

Hexagon Geospatial provides access to Hexagon Geospatial international data and, therefore, may contain references or cross references to Hexagon Geospatial products, programs and services that

http://www.hexagongeospatial.com/legal/trademarks

are not announced in your country. These references do not imply that Hexagon Geospatial intends to announce such products, programs or services in your country.

The Materials are subject to U.S. export control and economic sanctions laws and regulations and you agree to comply strictly with all such laws and regulations. In addition, you represent and warrant that you are not a national of, or otherwise located within, a country subject to U.S. economic sanctions (including without limitation Iran, Syria, Sudan, Cuba, and North Korea) and that you are not otherwise prohibited from receiving or accessing the Materials under U.S. export control and economic sanctions laws and regulations. Hexagon Geospatial makes no representation that the Materials are appropriate or available for use in every country, and access to them from territories where their content is illegal is prohibited. All rights to use the Materials are granted on condition that such rights are forfeited if you fail to comply with the terms of this agreement.

Revisions

Hexagon Geospatial reserves the right to revise these Terms at any time. You are responsible for regularly reviewing these Terms. Your continued use of this Document after the effective date of such changes constitutes your acceptance of and agreement to such changes.

Applicable Law

This Document is created and controlled by Hexagon Geospatial in the State of Alabama. As such, the laws of the State of Alabama will govern these Terms, without giving effect to any principles of conflicts of law. You hereby irrevocably and unconditionally consent to submit to the exclusive jurisdiction of the United States District Court for the Northern District of Alabama, Northeastern Division, or the Circuit Court for Madison County, Alabama for any litigation arising out of or relating to use of this Document (and agree not to commence any litigation relating thereto except in such courts), waive any objection to the laying of venue of any such litigation in such Courts and agree not to plead or claim in any such Courts that such litigation brought therein has been brought in an inconvenient forum. Some jurisdictions do not allow the exclusions or limitations set forth in these Terms. Such exclusions or limitations shall apply in all jurisdictions to the maximum extent allowed by applicable law.

Questions

Contact us http://www.hexagongeospatial.com/about-us/contact-us with any questions regarding these Terms.

http://www.hexagongeospatial.com/about-us/contact-us

About Us

Hexagon Geospatial helps you make sense of the dynamically changing world. We enable you to envision, experience and communicate geographic information. Our technology provides you the form to design, develop and deliver solutions that solve complex, real-world challenges. Ultimately, this is realized through our creative software products and platforms.

CUSTOMERS. Globally, a wide variety of organizations rely on our products daily including local, state and national mapping agencies, transportation departments, defense organizations, engineering and utility companies, and businesses serving agriculture and natural resource needs. Our portfolio enables these organizations to holistically understand change and make clear, reliable decisions.

TECHNOLOGY. Our priority is to deliver products, platforms and solutions that make our customers successful. Hexagon Geospatial is focused on developing technology that displays and interprets information in a personalized, meaningful way. We enable you to transform location-based content into dynamic and useable business information that creatively conveys the answers you need.

PARTNERS. As an organization, we are partner-focused, working alongside our channel to ensure we succeed together. We provide the right platforms, products, and support to our business partners so that they may successfully deliver sophisticated solutions for their customers. We recognize that we greatly extend our reach and influence by cultivating channel partner relationships both inside and outside of Hexagon (http://www.hexagon.com).

TEAM. As an employer, we recognize that the success of our business is the result of our highly motivated and collaborative staff. At Hexagon Geospatial, we celebrate a diverse set of people and talents, and we respect people for who they are and the wealth of knowledge they bring to the table. We retain talent by fostering individual development and ensuring frequent opportunities to learn and grow.

HEXAGON. Hexagon’s solutions integrate sensors, software, domain knowledge and customer workflows into intelligent information ecosystems that deliver actionable information. They are used in a broad range of vital industries.

Hexagon (Nasdaq Stockholm: HEXA B) has more than 16,000 employees in 46 countries and net sales of approximately 3.4bn USD. Learn more at hexagon.com (http://www.hexagon.com) and follow us @HexagonAB.

http://www.hexagon.com/

http://www.hexagon.com/

6

Contents Product Documentation Copyright and Terms of Use ............................................................................ 2

About Us ....................................................................................................................................................... 5

Overview ....................................................................................................................................................... 7

WebGIS eTraining Links ............................................................................................................................. 8

Prerequisites for a New Installation .......................................................................................................... 8

Prerequisites for Upgrade from Previous Version of Geospatial Portal ............................................. 11

Installing Geospatial Portal ...................................................................................................................... 12

Configuring the Administration Console ................................................................................................ 21

Licensing Geospatial Portal ..................................................................................................................... 29

Running the Administration Console ...................................................................................................... 30

Creating Geospatial Portal Test Instance ............................................................................................... 30

Modifying, Repairing, or Removing Geospatial Portal .......................................................................... 33

Getting the Installation Status ................................................................................................................. 33

Hexagon Geospatial Setup Manager - Overview .................................................................................... 34

Hexagon Geospatial Setup Manager User Interface ............................................................................ 34

Dialog Box Options ......................................................................................................................... 34

Icons ............................................................................................................................................... 35

How to Use Google Maps and Microsoft Bing Maps API Keys............................................................. 37

Technical Support and Information ......................................................................................................... 38

Index ........................................................................................................................................................... 40

7

S E C T I O N 1

Overview

The Geospatial Portal Installation Guide provides basic information for installing your software.

The Geospatial Portal installation process on the server consists of the following steps:

Geospatial Portal installation

Administration Console configuration

Uploading a current Geospatial Portal license

Creating a Geospatial Portal Test Instance

The pictures in this document may appear slightly different from the software depending on your operating system.

WebGIS eTraining Links

8

WebGIS eTraining Links

Would you prefer to watch a video? Many of our workflows are showcased in short, to-the-point eTraining modules on the Hexagon Geospatial Community http://community.hexagongeospatial.com. We add new videos regularly, so check back often.

Visit our Community and check out the videos http://community.hexagongeospatial.com/t5/WebGIS/tkb-p/eTWebGIS for our WebGIS products.

Also on our Community, check out our Licensing videos http://community.hexagongeospatial.com/t5/Licensing/tkb-p/eTLicensing.

Raw videos not yet converted to eTraining modules are on the eTraining Incubator https://www.youtube.com/playlist?list=PL3cpeZTQSqXeBFvr1nD8Z4tSCH13lADiw.

Prerequisites for a New Installation

Before you install Geospatial Portal 2016, you must have the following prerequisite products already installed:

.NET Framework 3.5 SP1

.NET Framework 4.0

.NET Framework 4.5.2

Windows Identity Foundation

Internet Information Services (IIS) 7.x or 8.0 and the following features:

IIS-StaticContent

IIS-WebServerRole

IIS-Metabase

IIS-WindowsAuthentication

http://community.hexagongeospatial.com/

http://community.hexagongeospatial.com/t5/WebGIS/tkb-p/eTWebGIS

http://community.hexagongeospatial.com/t5/Licensing/tkb-p/eTLicensing

https://www.youtube.com/playlist?list=PL3cpeZTQSqXeBFvr1nD8Z4tSCH13lADiw


9

IIS-ASPNET

IIS-ISAPIExtensions

IIS-ISAPIFilter

WCF-HTTP-Activation

Registering ASP.NET with IIS

If you are installing on Windows Server 2008 R2 you must register the correct version of ASP.NET with IIS.

1. Open a Command prompt window (Run as Administrator).

2. Navigate to %windir%\Microsoft.NET\Framework64\v4.0.30319.

3. Run the following command: aspnet_regiis -i

4. When the registration completes you can close the command prompt window.

On Windows Server 2012 and later the correct version of ASP.NET should already be registered with IIS. To verify this, use Server Manager to confirm that ASP.NET 4.5 is listed as a role service in the IIS role.

Once you have installed the prerequisites, you can load Geospatial Portal onto your server using the Hexagon Geospatial Setup Manager, as described in the following sections.

To use the Google Maps connector in your Geospatial Portal site, you must sign up for a Google Maps API key at this location: http://code.google.com/apis/maps/signup.html (http://code.google.com/apis/maps/signup.html). You must have a different key for each domain name on which you will host a Geospatial Portal site using the Google Maps connector, and you must enter the base URL that your site(s) will be hosted on when you request the key from the Google Web site. This key will then have to be included in the portal Web.Config configuration file.

To use the Google Maps connector, you must also agree to and abide by the Google Maps API Terms of Service found at this location: http://code.google.com/apis/maps/terms.html (http://code.google.com/apis/maps/terms.html). Your use may require the purchase of a software license.

http://code.google.com/apis/maps/signup.html

http://code.google.com/apis/maps/terms.html


10

To use the Microsoft Bing Maps connector in your Geospatial Portal site, you must agree to and abide by the Microsoft Bing Maps licensing and pricing terms found at this location: http://www.microsoft.com/maps/product/licensing.aspx (http://www.microsoft.com/maps/product/licensing.aspx). Your use may require the purchase of a software license.

Windows® Identity Foundation (WIF) is a framework for building identity-aware applications and is a

required prerequisite for the Geospatial Portal components. WIF can be downloaded from http://www.microsoft.com/en-us/download/details.aspx?id=17331 http://www.microsoft.com/en-us/download/details.aspx?id=17331.

For Windows Server 2008 R2, select Windows6.1-KB974405-x64.msu for download. Downloading WIF is not necessary if you are using Windows Server 2012 or later because it is included with .NET 4.5.

http://www.microsoft.com/maps/product/licensing.aspx

http://www.microsoft.com/en-us/download/details.aspx?id=17331

Prerequisites for Upgrade from Previous Version of Geospatial Portal

11

Prerequisites for Upgrade from Previous Version of Geospatial Portal

If Geospatial Portal 2015 is the only Geospatial server product installed, then uninstall the old version before you install Geospatial Portal 2016.

If you have any other Geospatial server products installed on the same machine, you must uninstall those products before installing Geospatial Portal 2016. After installing Geospatial Portal 2016, install the other 2016 server products.

The Hexagon Geospatial server products are ERDAS APOLLO Essentials/Advantage/Professional, GeoMedia WebMap Essentials/Advantage/Professional, Geospatial SDI, and Geospatial Portal.

Be aware that some of the configuration elements prepared in the Administration Console, specifically “Maps & Workspaces” and “Search Configuration” may be lost when removing the Hexagon Geospatial 2015 (prior to EP06) products containing the Geospatial Portal component. Therefore before uninstalling the Geospatial Portal 2015 run the Administration Console 2015 Configuration Update executable and follow the instructions on the screen in order to preserve the configuration elements when upgrading to version 2016. After running the tool, you can proceed with the uninstallation the 2015 versions of software and install the 2016 release. The configuration elements will be preserved in the 2016 installation.

To download the Administration Console 2015 Configuration Update tool click here.

The products that require the use of Administration Console 2015 Configuration Update tool include the ones from 2015 release with patch number prior to EP06 that are on the following list:

Geospatial Portal

GeoMedia WebMap (all tiers)

ERDAS APOLLO (all tiers)

Installing Geospatial Portal

12


1. From your delivery media, right click Setup.exe and select Run as administrator.

2. The Hexagon Geospatial Setup Manager opens with a list of products available for installation.


13

Select the Geospatial Portal and click Install in the Action column of the New Software box.


14

3. The Welcome window will appear. Click Next.


15

4. The End-User License Agreement will appear. If you agree, select the I accept the terms in the license agreement option; then click Next.


16

5. The Custom Setup window will appear. Click to choose the type of installation. Select the program features you want to install; then click Next.


17

6. The Ready to Install the Program window will appear. Click Install to begin the installation. The installation process may take a few moments and depends on the server performance.


18

7. The InstallShield Wizard Completed window will appear. Click Finish.


19

8. The following view will appear:

The icon in the table Status column means the product is installed properly. You can click Modify, repair, or remove in the Action column of the upper (Installed Software) table if you want


20

to modify some software features, repair current application instances (for example, if you miss the necessary files), or remove installed software.

9. Run the Configuration wizard to set up the Administration Console.

To run the Configuration wizard in the Hexagon Geospatial Setup Manager, select Configure Action for Geospatial Portal in the Configuration box, or select Configuration Wizard from Start > All Programs > Hexagon Geospatial Portal > Utilities > Configuration Wizard.

If you click Configure in the Hexagon Geospatial Setup Manager or Configuration Wizard in the system menu, the next wizard that configures important information required by the Administration Console will be run.

For more information on how to configure the Administration Console, see Configuring Administration Console (see "Configuring the Administration Console" on page 21).

For complete information on how to configure, instantiate, and manage Geospatial Portal, see the Geospatial Portal Administrator Guide and the Geospatial Portal User Guide.

Configuring the Administration Console

21


The Administration Console is a tool that is used to create and manage Web service instances, including Geospatial Portal.

This wizard configures important information required by the Administration Console and prepares the Administration Console for use.


22

1. To run the wizard in the Hexagon Geospatial Setup Manager, click the Configure button in the Action column or, from the Start menu, select All Programs > Hexagon Geospatial Portal > Utilities > Configuration Wizard. For more information about the Hexagon Geospatial Setup Manager, see Hexagon Geospatial Setup Manager - Overview (on page 34).


23

2. On the Welcome screen, click Next to begin the configuration.


24

3. The wizard searches for installed system features and components. When completed, a screen with a list of all installed or missing features will be shown. In case all required features are enabled, click Next. In case there are some missing system features, configure them and then click Next.


25

4. Choose the Web site, and then enter the name of the application for the Administration Console.

The options to leave or to re-create the Administration Console GUI Instance (as shown in the picture above) appear only in case the Administration Console is already installed. If you chose Recreate, the previous version will be removed before installing the new version.

5. Decide whether you want to enable OpenStreetMap as your default map tile source. If you select Yes, all Geospatial Portal instances will be enabled to use OSM map tiles http://tile.openstreetmap.org.

http://tile.openstreetmap.org/


26

By selecting "Yes" you confirm that your use of OSM map tiles will strictly conform to the Tile Usage Policy described at http://wiki.openstreetmaps.org/wiki/Tile_usage_policy http://wiki.openstreetmaps.org/wiki/Tile_usage_policy. If you will not or cannot strictly conform the Tile Usage Policy, do not select Yes.

http://wiki.openstreetmaps.org/wiki/Tile_usage_policy


27

6. Review your choices before continuing, and then click Finish. The wizard will configure your application.


28

7. When finished, you can click Open Log File, or exit the wizard by clicking Close.

Licensing Geospatial Portal

29

Licensing Geospatial Portal

The License Administrator Utility lets you manage all of the software licenses that are available for your machine to review in order to run the Geospatial Portal application that is installed on your machine. Every time you start Geospatial Portal, it searches for a license. If it does not find a license, the application cannot be run. It is necessary to add a license source for Geospatial Portal in order to run the application.

Adding a Nodelocked License Source

1. If you have purchased a nodelocked license for Geospatial Portal, run the Intergraph License Host ID / Show Host ID command on the machine on which you will run the software product. This command is accessible from the Client or the Server menu, or from the Start menu under Intergraph Licensing.

2. When you have the necessary information from the Intergraph License Host ID / Show Host ID dialog box, click Request license from the Intergraph License Host ID dialog box.

3. Go to the Intergraph SG&I Licensing Web site, enter all of the requested information, and obtain your nodelocked license (.lic) file.

4. Place the .lic file in the folder of your choice, and add this folder to your License Navigation Pane by using the Add Nodelocked License Source command.

a. Select the Client > Add Nodelocked License Source command.

b. In the Browse for Folder dialog box, select the folder that contains the nodelocked .lic file that you want to add.

c. Click OK.

5. Geospatial Portal should now run because you have a license.

Visit our licensing Web site https://sgilicense.intergraph.com (https://sgilicense.intergraph.com) to generate or to view your licenses. There are help topics on this page to assist you if you have difficulty in generating or managing your license.

For more information and help topics on the Intergraph License Administrator utility, refer to the Intergraph License Administrator help.

https://sgilicense.intergraph.com/

Running the Administration Console

30

Running the Administration Console

In order to run Administration Console:

1. Open the Web browser.

2. In the web browser address field, provide the http administration address (for example, http://<server_name>/AdminConsole).

3. Press ENTER.

4. Provide the server credentials in case the authentication dialog appears.

5. The Administration Console will be run in the web browser window.

OR

1. Click the Administration Console link provided on the r product Welcome Page.

2. The Administration Console will be run in new web browser tab.

To open a Geospatial Product Portfolio welcome page open your favorite Web browser and in the address field, type: http://<server_name>/geospatial and press ENTER

Creating Geospatial Portal Test Instance

After installing Geospatial Portal and configuring the Administration Console, you need to create the Geospatial Portal instance in order to verify the installation process.

To create the test instance of Geospatial Portal:

1. Run the Administration Console.

In order to run the Administration Console, open your Web browser and type the address to your application (http://<hostname>/<application_name>) in the address bar.

2. From the left menu, choose the New Instance link, or go to the Instances List section and click NEW INSTANCE.

3. Configure the new instance to be created. Type the name of your new service instance in the Service Name field and, from the drop-down list, select the Geospatial Portal service type.


31

4. Optional: Configure more details regarding the IIS hosting of the new instance. From the Web site drop-down list, select an IIS Web site on which the service should be deployed. All available Web sites are listed by their names; the default selection is Default Web Site.

5. Optional: Check the box on the right of Virtual Directory Name field, and then type the custom virtual directory name for the new service instance (by default, the virtual directory name is the same as the name of the service instance, and changing the name is optional).

6. Optional: Provide a short description for the instance.

7. When all details are configured, click CREATE to instantiate the new service.

During the creation of the new service instance, the Administration Console will show a splash screen with this message: "Creating instance. Please wait."

After the successful creation of the service instance, a screen with a summary of the created instance will be displayed.


32

8. Go to the Instance List section by clicking the Instance List link in the left or top menu.

9. Select your Geospatial Portal instance, and click the Run button located in the ACTION column. Geospatial Portal will be run in your default web browser.

After creating the Geospatial Portal instance, Geospatial Portal is ready to use with the default settings, but it can be configured according to your needs. For more information about configuring the Geospatial Portal instance, see the Geospatial Portal Administration Guide.

Modifying, Repairing, or Removing Geospatial Portal

33

Modifying, Repairing, or Removing Geospatial Portal

To modify Geospatial Portal using the Hexgon Geospatial Setup Manager:

1. From the delivery media, run Setup.exe.

2. In the Action column of the Installed Software dialog box, click Modify, repair, or remove.

3. Click Next on the Geospatial Portal installation wizard Welcome page.

4. On the Program Maintenance screen of the Geospatial Portal installation wizard, select the Modify option; then click Next and follow the prompts.

To repair Geospatial Portal using the Hexgon Geospatial Setup Manager:




4. On the Program Maintenance screen of the Geospatial Portal installation wizard, select the Repair option; then click Next and follow the prompts.

To remove Geospatial Portal using the Hexgon Geospatial Setup Manager:




4. On the Program Maintenance screen of the Geospatial Portal installation wizard, select the Remove option; then click Next and follow the prompts.

Getting the Installation Status

You get the installation status of your software from the Hexagon Geospatial Setup Manager (Setup.exe).

From your delivery media, run the Hexagon Geospatial Setup Manager (Setup.exe). The Hexagon Geospatial Setup Manager displays the status of the applications you have installed.

Hexagon Geospatial Setup Manager - Overview

34


The Hexagon Geospatial Setup Manager (Setup.exe) is a tool that you use to install and maintain Hexagon Geospatial software. Once the software is installed, you can also use the tool to perform the following software maintenance tasks:

Modify

Repair

Remove

If the following options are available for your site, you can also use the Hexagon Geospatial Setup Manager to do the following:

Run configuration processes

Install complementary software

The Hexagon Geospatial Manager dialog box opens when you double click Setup.exe to start the installation process.

Hexagon Geospatial Setup Manager User Interface

Dialog Box Options

Software

The Software box displays the list of products that you can install. Select these one at a time to install software or to modify, repair, or remove software. When you select a product, the user interface updates to display the current status of the software installation, which is reflected in the New Software or Installed Software list.

Version

To the right of the Software box is the Version number of the selected product.

Documentation Links

Listed under the Version number are links that provide access to information about the selected software. The Support link takes you directly to the Customer Support Portal. If a document is not available for the selected software, the corresponding link is disabled.


35

New Software or Installed Software

If no software products have been installed, the New Software box is displayed so you can install new software. Once software is installed, the label of this box changes to Installed Software. The Version, Status, and Action columns are explained below:

Version Status Action

If you are installing software, this field displays the version available for installation.

If you are modifying, repairing, or removing software, this field displays the version currently installed on your computer. This is a read-only field.

Displays an icon reflecting the status of the software you selected. See the Icons section below for more information.

The links displayed under Action change to reflect what actions you can perform during the installation or the modify, repair, or remove process.

Configuration

This box may not be implemented for all product installations.

If additional configuration steps are required for your software, the Configuration box opens after installation is complete. Select the application from the list and click Configure.

Complementary Software

Complementary software is software that is useful for or needed to run with your Hexagon Geospatial software. If complementary software is available for your site, the Complementary Software box opens after installation is complete. Select the application from the list and click Install.

Complementary Software is available for your site only if an application developer creates it. For more information, see Complementary Software Setup.

Icons

The following icons appear in the Status list. These icons and their corresponding tooltips change to reflect the current status of the installation or the modify, repair, or remove process.


36

Icon New or Installed Software Configuration Complementary Software

Indicates that the selected software is not installed.

Or

Indicates an installation failure. Check the Event Log for information.

Indicates that the installed application of the selected software is not configured.

Or

Indicates a configuration failure. Check the Event Log for information.

Indicates that the complementary software is available but is not installed.

Or

Indicates an installation failure. Check the Event Log for information.

Installation is in progress. Configuration is in progress.

Installation is in progress.

Installation is successful. Configuration is successful.

Installation is successful.

How to Use Google Maps and Microsoft Bing Maps API Keys

37

How to Use Google Maps and Microsoft Bing Maps API Keys

To use the Google Maps connector in your Geospatial Portal site, you must sign up for a Google Maps API key at this location: http://code.google.com/apis/maps/signup.html (http://code.google.com/apis/maps/signup.html). You must have a different key for each domain name on which you will host a Geospatial Portal site using the Google Maps connector, and you must enter the base URL that your site(s) will be hosted on when you request the key from the Google Web site. This key will then have to be included in the portal Web.Config configuration file.

To use the Google Maps connector, you must also agree to and abide by the Google Maps API Terms of Service found at this location: http://code.google.com/apis/maps/terms.html (http://code.google.com/apis/maps/terms.html). Your use may require the purchase of a software license.

To use the Microsoft Bing Maps connector in your Geospatial Portal site, you must agree to and abide by the Microsoft Bing Maps licensing and pricing terms found at this location: http://www.microsoft.com/maps/product/licensing.aspx (http://www.microsoft.com/maps/product/licensing.aspx). Your use may require the purchase of a software license.

http://code.google.com/apis/maps/signup.html

http://code.google.com/apis/maps/terms.html

http://www.microsoft.com/maps/product/licensing.aspx

38

Technical Support and Information

Hexagon Geospatial® provides several ways to access information and to contact support, including self-help tools, Hexagon Geospatial Community, Hexagon Geospatial Developer Network, and phone support.

Hexagon Geospatial Community

You can find support-related discussion boards and knowledge bases across the Hexagon Geospatial products on the Hexagon Geospatial Community http://community.hexagongeospatial.com. Find more information about the community on a Community blog http://community.hexagongeospatial.com/t5/Community-Blog/A-guide-to-using-the-Community/ba-p/1341.

Blogs

Get the latest on our technologies: from what engineering is working on, to news about the latest APIs, as well as developer tips and tricks.

Discussions

Discuss topics with other Hexagon Geospatial Product pioneers and experts.

Knowledge and Support

Learn more about our products, find answers, get the latest updates, and connect with other Hexagon Geospatial Community members, or get support from our support teams http://www.hexagongeospatial.com/support.

Developer Network

Share technical information with other developers who use Hexagon Geospatial's SDKs and M.App Portfolio. To get full access to the Developer Network you need to purchase a Hexagon Geospatial Developer Network (HGDN) Subscription. With HGDN, you get broad access to select Hexagon Geospatial development products in one place. You will also get access to powerful toolkits, including currently published APIs and SDKs. You also get access to in-depth resources such as tutorials, collaborative samples, and web-based training.

Find more information about HGDN on a Community blog http://community.hexagongeospatial.com/t5/About-the-Community/HGDN-Subscription/ba-p/3597.

eTraining

Short, to-the-point videos showcasing specific workflows for many tasks and organized by product. We add new videos constantly, so check back often.

Tutorials

Written, step-by-step instructions for our most asked-about tasks. Includes helpful hints and introduction material to get you started with our products.

http://community.hexagongeospatial.com/

http://community.hexagongeospatial.com/t5/Community-Blog/A-guide-to-using-the-Community/ba-p/1341

http://www.hexagongeospatial.com/support

http://community.hexagongeospatial.com/t5/About-the-Community/HGDN-Subscription/ba-p/3597

Technical Support and Information

39

Professional Service Team

For support phone numbers or to submit sales inquiries, general questions, and comments, click the appropriate tabs at the top of the Hexagon Geospatial Support (http://www.hexagongeospatial.com/support) page.

http://www.hexagongeospatial.com/support

40

Index

A About Us • 5

C Configuring the Administration Console • 21

Creating Geospatial Portal Test Instance • 30

G Getting the Installation Status • 33

H Hexagon Geospatial Setup Manager - Overview

• 34

How to Use Google Maps and Microsoft Bing Maps API Keys • 37

I Installing Geospatial Portal • 12

L Licensing Geospatial Portal • 29

M Modifying, Repairing, or Removing Geospatial

Portal • 33

O Overview • 7

P Prerequisites for a New Installation • 8

Prerequisites for Upgrade from Previous Version of Geospatial Portal • 11

Product Documentation Copyright and Terms of Use • 2

R Running the Administration Console • 30

T Technical Support and Information • 38

W WebGIS eTraining Links • 8

Documents

Geospatial Portal Installation Guide - geo.cmirit.rugeo.cmirit.ru/GeospatialPortalDoc/PDF/Geospatial_Portal... · please read these terms carefully before using hexagon geospatial’s