geomedia smart client

GEOMEDIA SMART CLIENT INSTALLATION GUIDE

15.0 November 2014

Copyright 2012-2014 Intergraph Corporation. All Rights Reserved. Hexagon Geospatial is part of Intergraph Corporation.

© 2012-2014 Intergraph® Corporation and/or its affiliates. All Rights Reserved.

Warning: This computer program, including software, icons, graphical symbols, file formats, and audio-visual displays; may be used only as permitted under the applicable software license agreement; contains confidential and proprietary information of Intergraph and/or third parties which is protected by patent, trademark, copyright and/or trade secret law and may not be provided or otherwise made available without proper authorization.

Restricted Rights Legend

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of Commercial Computer Software -- Restricted Rights at 48 CFR 52.227-19, as applicable.

Unpublished -- rights reserved under the copyright laws of the United States.

Terms of Use

Use of this software product is subject to the End User License Agreement ("EULA") delivered with this software product unless the licensee has a valid signed license for this software product with Intergraph Corporation. If the licensee has a valid signed license for this software product with Intergraph Corporation, the valid signed license shall take precedence and govern the use of this software product. Subject to the terms contained within the applicable license agreement, Intergraph Corporation gives licensee permission to print a reasonable number of copies of the documentation as defined in the applicable license agreement and delivered with the software product for licensee's internal, non-commercial use. The documentation may not be printed for resale or redistribution.

Warranties and Disclaimers

All warranties given by Intergraph Corporation about software are set forth in the EULA provided with the software or with the applicable license for the software product signed by Intergraph Corporation, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties.

Intergraph believes the information in this publication is accurate as of its publication date. Intergraph Corporation is not responsible for any error that may appear in this document. The information and the software discussed in this document are subject to change without notice.

Trademarks

Intergraph and the Intergraph logo are registered trademarks of Intergraph Corporation. Hexagon and the Hexagon logo are registered trademarks of Hexagon AB or its subsidiaries. Microsoft and Windows are registered trademarks of Microsoft Corporation. Other brands and product names are trademarks of their respective owners.

About Us

Hexagon Geospatial helps you make sense of the dynamically changing world. Hexagon Geospatial provides the software products and platforms to a large variety of customers through direct sales, channel partners, and Hexagon businesses, including the underlying geospatial technology to drive Intergraph Security, Government & Infrastructure (SG&I) industry solutions. Hexagon Geospatial is a division of Intergraph Corporation.

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 use information to make mission and business-critical decisions.

TECHNOLOGY. Our priority is to deliver products and solutions that make our customers successful. Hexagon Geospatial is focused on developing leading-edge technology that is easily configurable. Through extensible, scalable and collaborative products, we enable you to transform multi-source content into dynamic and actionable information. We are constantly re-conceptualizing and improving our products.

PARTNERS. As an organization, we are partner-focused, working alongside our channel to ensure we succeed together. We provide the right tools, 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.

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 Geospatial plays a key role in Hexagon’s multi-industry focus, leveraging the entire portfolio for a wide variety of geospatial needs. Hexagon is a leading global provider of design, measurement and visualization technologies. Synergistic thinking is encouraged across all levels and functions at Hexagon companies, so that we all respond better and faster to our shared customer’s needs.

For more information, visit www.hexagongeospatial.com (http://www.hexagongeospatial.com) and www.hexagon.com (http://www.hexagon.com).

http://www.hexagongeospatial.com/

http://www.hexagon.com/

GeoMedia Smart Client Installation Guide 4

Contents

About Us ................................................................................................................................. 3

Installing GeoMedia Smart Client 2015 ................................................................................... 5

Further steps ........................................................................................................................... 16


Installing GeoMedia Smart Client 2015

Please read the Further Steps for convenience concerning your Workflows.

How to install older versions of GeoMedia Smart Client click here.

If you have already installed a previous version of GeoMedia Smart Client create a backup and uninstall the existing GeoMedia Smart Client before installing the new version. The configuration (for example IIS and sites)

will remain.

If you have installed an engineering patch (version without installer) please execute a repair with the old setup before installing the new version.

If you are upgrading GMSC 14 to GMSC 15 and you are using your own language files, please download them again at the GeoMedia Smart Client Language Administrator.

GeoMedia Smart Client uses the Intergraph Setup Manager to install the software.

1. Install all prerequisites

Required prerequisites

IIS 7 or higher

Microsoft .NET 4.5

Register ASP.NET 4.0

C:\Windows\Microsoft.NET\Framework64\v4.0.30319>aspnet_regiis.exe -i

AccessDatabaseEngine_x64.exe (in case that Microsoft Office x64 is not installed and GeoMedia Libraries or Access Warehouses will be used)

In case of Oracle: Make sure that the Oracle Client with ODAC Components 11.2.0.3 is installed. The correct version (in case of instant client) can be found at: [1] --> 64-bit ODAC 11.2 Release 4 (11.2.0.3.0) for Windows x64. At least instant client is needed

Continue with the installation of the GeoMedia Smart Client once the prerequisites have been installed successfully.

2. Open the GeoMedia Smart Client CD/DVD, or go to a network directory where the Setup Manager is located.

3. Double click on setup.exe; the Intergraph Setup Manager will start with the following dialog box:

http://smartclient.intergraph.at/documentation/Installing_GeoMedia_Smart_Client_2015#Further_Steps

http://smartclient.intergraph.at/documentation/Installing_GeoMedia_Smart_Client_2013

http://www.oracle.com/technetwork/database/windows/downloads/index-090165.html

http://smartclient.intergraph.at/documentation/File:Info.png






The links displayed under Action will change from Install/Configure to Modify, repair or remove, or Remove, reflecting what you can do at any given point in the installation or update process. The icons under the Status list will also change, reflecting your current status in the installation or update process.

4. In the Software list box, select the software that you want to install.

5. In the New Software dialog box, click Install under Action. The installer will start. Please wait until the following dialog box appears:

http://smartclient.intergraph.at/documentation/File:Install1_2015.png


6. Follow the instructions in the dialog box.

7. By default, the product is delivered to the following locations: C:\Program Files\Intergraph\GeoMedia SmartClient\. You can change the location to any other folder by clicking Change and navigating to a new root folder.




8. Deselect a software component if you prefer to install this specific component onto another server.

Click Space to get an overview of your free disk space.

9. Click Next.

10. Click Install to install the product.




11. When GeoMedia Smart Client is installed, click Finish. You are returned to the Intergraph Setup Manager dialog box.

12. After a successful installation, an additional Configuration dialog box is displayed. GeoMedia Smart Client needs to be configured. This includes naming and configuring a virtual Web site and setting a path where the GeoMedia Smart Client warehouse directory will be installed.




13. In the Configuration box, check for Geomedia Smart Client and click Configure. The GeoMedia Smart Client Configuration Wizard will start.

14. Initialize your license. Generate your license by visiting our licensing Web site (http://www.intergraph.com/sgi/license), and use the Composite Key. Point to your license file or to the server where your license is installed. Note the Target Location!

http://www.intergraph.com/sgi/license



15. Specify the configuration string to the database schema that will be used for GeoMedia Smart Client. The schema will be filled automatically during the first run of GMSC Administrator.




The schema must have been created previously.

In case of Oracle: The following statement can be used to create the schema. These are the minimum requirements.

CREATE USER GMSC IDENTIFIED BY GMSC

DEFAULT TABLESPACE "USERS"

TEMPORARY TABLESPACE "TEMP";

GRANT UNLIMITED TABLESPACE TO GMSC;

--Alternative to UNLIMITED TABLESPACE

--ALTER USER GMSC QUOTA 100M ON "USERS";

CREATE ROLE GMSC_ROLE;

GRANT CREATE SESSION TO GMSC_ROLE;

GRANT CREATE TABLE TO GMSC_ROLE;

GRANT CREATE SEQUENCE TO GMSC_ROLE;

GRANT CREATE TRIGGER TO GMSC_ROLE;

GRANT CREATE PROCEDURE TO GMSC_ROLE;

GRANT CREATE INDEXTYPE TO GMSC_ROLE;

GRANT GMSC_ROLE TO GMSC;

If you want to have a restricted runtime role after your first start of the GMSC Administrator click here.

In case of SQL-Server: Just create a new database on the SQL Server and define a user. The database name and the user with the password must be the same as in your GeoMedia Smart Client configuration (see figure in step 15).

16. Define the warehouse location. The GeoMedia Smart Client Warehouse is used for files and directories that are only needed for the GeoMedia Smart Client (CSF, Servercache, and so on).

http://smartclient.intergraph.at/documentation/Restricted_User




17. Now set the Web site for the GeoMedia Smart Client Web application. The installer configures the IIS automatically. Consider calling the application by this name in your Web browser.

18. Click Next to finish the configuration.

19. You can either choose if the GeoMedia Smart Client Tile Service is running under the “Local system account”




or define another user. The second option is normally used if you want to access data sources (like Access MDB’s, shape files, …) who are located on a network share and the “Local system account” has no access privileges on these resources.

If the tile service is installed on another server, perform this step on that server.

20. When the configuration has been finished successfully, you will see the Status change to a green button.




21. Modifiy the security settings of the NetworkService for the following directories that were created during the installation process. The path to the following directories depends on the path you defined in the installation. If you used the default path, you find the directories under C:\Program Files\Intergraph\..

..\GeoMedia SmartClient\ (and all subdirectories) (at least read)

..\GeoMedia SmartClient\log (at least modifiy)

..\GeoMedia SmartClient\maps\log (at least modifiy)

..\GeoMedia SmartClient\workflows\log (at least modifiy)

..\GeoMedia SmartClient\Workflows\FormSettings (at least read)



..\GeoMedia SmartClient\Workflows\WorkflowSettings (at least read)

..\GeoMedia SmartClient\administrator\log (at least modifiy)

The Smart Client Warehouse directory and all subfolders must have full permission.

TEMP folder, which is defined in Environment variables (Default: C:\Windows\Temp) (at least modifiy): Set by default but sometimes disabled by the administrator on the server side

22. Restart the IIS.

23. Restart the Intergraph TileService in the service console.

24. To log on to the Administrator, first open the url you have defined in Step 14 in a Web browser. (For instance: www.yourservername.com/GMSC/Administrator.) Then type in the default username (SCAdmin) and password (SCAdmin) to log in to the GeoMedia Smart Client Administrator.

Further steps

With GeoMedia Smart Client 2015 the location of the Workflow’s custom themes changed. This was done due to the request to have all custom code and configuration in one unified location.

Copy your custom theme folders from

…\GeoMedia SmartClient\Program\Workflows\Content\Css\workflow-themes

To the new location

…\GeoMedia SmartClient\Program\Workflows\Custom\Themes

Remove the first two lines of theme-content.less of a custom theme. Here is an example with 'MyTheme'

@ig-theme: 'MyTheme';

@import '../../ig/ig-content-less.less';

Remove the first two lines of theme-menu.less of a custom theme. Here is an example with 'MyTheme'

@ig-theme: 'MyTheme';

@import '../../ig/ig-menu-less.less';

geomedia smart client

Documents