User Tools

Site Tools


map_suite_license_guide

Map Suite 10.0 License Strategy

Map Suite Provides 3 kinds of licenses based on different stages of an application.

Development License

A Development Toolkit is licensed on a per-developer basis, with one development license for each developer. Only the individual developer to whom a Development Toolkit license is registered may access, install on a computer, or otherwise use in any way the retail version of the Development Toolkit. It's used to verify the toolkit when you are debugging a project with Map Suite.

Run-time License

In addition to the developer license that you will need in order to write an application against the Map Suite .NET controls, some Map Suite products also require a run-time license. The run-time License may be called “Production Server license” for some products.

Software Assurance Renewal License

Software Assurance Renewal License is a special license which makes sure that you have permission to download the Map Suite Products' Daily Builds from NuGet and use the builds without limitation.

Map Suite for Desktop (WinForms, Wpf)

How to create a license?

Dev License: Created by clicking “Activate” button through Product Center.

Runtime License: Created by clicking “Create Runtime License” through Product Center after inputting the required information.

  • Currently user can ONLY define the calling executable. ThinkGeo can define a more customized license file such as the calling assembly.
  • Runtime license can have a watermark and no watermark. With no watermark, it will not have an expired date even though its corresponding Dev License will expire in 1 year.
How does it work?

Development Time

In development time, the Development License is taken into account to make sure you are using a Map Suite toolkit guaranteed from ThinkGeo. To make sure the Mapping part doesn't stop your task without any relationship with the map, the run-time license should be asked for from your team members who has installed and activated Map Suite products.

Development License Runtime License Result
Non-existent / Incorrect Non-Existent / Incorrect 1. Throw InvalidOperationException: “If you are a map developer, you need to activate it through product center or contact sales@thinkgeo.com; If you are a tester or doing some map-unrelated programming, please contact your map developer to get a runtime license to avoid this exception. “
2. Try to launch product center, passing the parameter such as no license/first time user.
  a, Pre-select the exact product the user is using.
  b. Open that login window to make it ready to go for the user to log in.
Non-existent / Incorrect Correct Shows a blank white map with watermark: “Not Licensed for Map Development”

If the Development License is correct, check the following:

Watermark Expiration Result
True Not Expired Show the map with watermark: “xx Days Left”. The text is from the license file.
Expired Throw InvalidOperationException: “The {Production Name} has expired. Please contact sales@thinkgeo.com.” The text is from the license file.
False Not Expired Show the map.
Expired Throw InvalidOperationException: “The {Production Name} has expired. Please contact sales@thinkgeo.com.” The text is from the license file.

Runtime

Runtime LicenseDev licenseResult
Non-existent / Incorrect Non-existent / IncorrectShow blank white map with watermark: “Not Licensed for Run Time”.
CorrectConsider it as being on a development machine; the same as a Dev license. One difference is “Print Map” instead of “Throw exception”
Correct CorrectShow the map with the higher level. For example, if the dev license has watermark but the runtime license does't have watermark, it should work following higher level license: no watermark.

If RunTime License is correct and considered only.

Watermark Expiration Result
True Not Expired Show the map with watermark: “xx Days Left”. The text is from the license file.
Expired Show blank white map with watermark: “The {Production Name} has expired. Please contact sales@thinkgeo.com.” The text is from the license file.
False Show the map.

Map Suite for Mobile (Android, iOS)

How to create a license?

A Dev license is not needed for Android and iOS, only a runtime license. The runtime license is created on product center and will be added to a project. Please refer to Map Suite Quick Start Guide For Android and Map Suite Quick Start Guide For iOS for information on know how to create a runtime license for an application.

How does it work?

A Runtime license can have a watermark and no watermark. For no watermark, it doesn't have an expired date in runtime but it will expire in development time.

Dev time and Runtime

Runtime License Dev time/Runtime Result
Non-existent / Incorrect Dev time Throw InvalidOperationException: “A license is needed to debug/run the APP. Please refer to http://wiki.thinkgeo.com/wiki/map_suite_runtime_license_guide_for_mobile for the details”
Runtime Show a blank white map with watermark: “Not Licensed for Run Time”.

If License is correct, check the following:

Watermark Expiration Result
TRUE Not Expired Show the map with a watermark: “xx Days Left”. The text is from the license file.
Expired Throw InvalidOperationException: “The {Production Name} has expired. Please contact sales@thinkgeo.com.” The text is from the license file in Dev time and show the exception message in runtime.
FALSE Show the map

Map Suite for Web (WebForms, Mvc, WebApi)

Map Suite provides 2 kinds of licenses for Web: development and deployment.

How to create a license?

Please refer to the following urls to know how to create the two kinds of licenses for an application:

Development license: MapSuite Developer License Guide

Deployment license: Map Suite Deployment License Guide for Web

How does it work?

Dev Time

Dev License Runtime License Result
Non-existent / Incorrect Non-existent / Incorrect 1, Throw InvalidOperationException: “If you are a map developer, you need to activate it through product center or contact sales@thinkgeo.com. If you are a tester or doing some map-unrelated programming, please contact your map developer to get a runtime license to avoid this exception.“
2. Try to launch product center, passing the parameter such as No license/first time user.
  a. Pre-select the exact product the user is using.
  b. Open that login window to make it ready to go for the user to log in.
Non-existent / Incorrect Correct Show a blank white map with watermark: “Not Licensed for Map Development.”

If Dev License is correct, check the following.

Watermark Expiration Result
True Not Expired Show the map with watermark: “xx Days Left”. The text is from the license file.
Expired Throw InvalidOperationException: “The {Production Name} has expired. Please contact sales@thinkgeo.com.” The text is from the license file.
False Not Expired Show the map
Expired Throw InvalidOperationException: “The {Production Name} has expired. Please contact sales@thinkgeo.com.” The text is from the license file.

Runtime

Runtime License Dev license Result
Non-existent / Incorrect Non-existent / Incorrect Show blank white map with watermark: “Not Licensed for Run Time”.
Correct 1. Watermark: show the map with watermark: ”“xx Days Left”“ if not expired, otherwise show blank white map with: “The {Production Name} has expired. Please contact sales@thinkgeo.com.”
2. No watermark: show blank map with ”“Not Licensed for Run time”.
Correct Show Map.

Software Assurance Plan for Map Suite

“Software Assurance” just takes “Purchased Product” into account. Same behavior for Dev & Runtime

Assembly Build Date Result
Non-existent / Incorrect Throw InvalidOperationException: “The assembly of {Production Name} is invalid, please download official assemblies from ThinkGeo's NuGet, or contact sales@thinkgeo.com.”
Expired (Compared with “Assurance Expired Date” )Throw InvalidOperationException:“Your Software Assurance Plan for {Production Name} has expired, please contact sales@thinkgeo.com to renew or use the version that was built prior to [Expired Date]” in Dev time and show watermark with the exception message in Runtime.
Software Assurance Result
Not found in server Throw InvalidOperationException: “Your Software Assurance Plan for {Production Name} has expired, please contact sales@thinkgeo.com” in Dev time and show watermark with the exception message in Runtime.

Install/Uninstall the Licenses using Product Center

You can install/uninstall the licenses mentioned above using the GUI tool ThinkGeo.ProductCenter.exe. Also a CLI version (ThinkGeo.ProductCenter.com) is provided along in the folder with all the features as well. Here below is the list of arguments it supports:

Show a list with product name and id. /getproductids

Start evaluation for a product. /startevaluation /username:[name] /password:[password] /productid:[id]

[name]      Specifies user name.
[password]  Specifies user password.
[id]        Specifies product id.

Extend evaluation for a product(must contact ThinkGeo for approval first). /extendevaluation /username:[name] /password:[password] /productid:[id]

[name]      Specifies user name.
[password]  Specifies user password.
[id]        Specifies product id.

Activate a product. /activate /username:[name] /password:[password] /productid:[id]

[name]      Specifies user name.
[password]  Specifies user password.
[id]        Specifies product id.

Deactivate a product. /deactivate /username:[name] /password:[password] /productid:[id]

[name]      Specifies user name.
[password]  Specifies user password.
[id]        Specifies product id.

Generate runtime license for desktop and mobile applicateions. /generateruntimelicense /username:[name] /password:[password] /productid:[id] /applicationname:[application name] /outputpath:[output path]

[name]              Specifies user name.
[password]          Specifies user password.
[id]                Specifies product id.
[application name]  Specifies application name.
[output path]       Specifies output path for license file.

Activate production deployment license on the current computer. /activateproductiondeploymentlicense /username:[name] /password:[password]

[name]              Specifies user name.
[password]          Specifies user password.

Deactivate production deployment license on the current computer. /deactivateproductiondeploymentlicense /username:[name] /password:[password]

[name]              Specifies user name.
[password]          Specifies user password.

Activate test deployment license on the current computer. /activatetestdeploymentlicense /username:[name] /password:[password]

[name]              Specifies user name.
[password]          Specifies user password.

Deactivate test deployment license on the current computer. /deactivatetestdeploymentlicense /username:[name] /password:[password]

[name]              Specifies user name.
[password]          Specifies user password.

Frequently Asked Questions

What is MapSuite 10.0 file base license?

MapSuite 10.0 works based on license file instead of registry. So it's very easy to be deployed to the different platforms. Please refer to above sections to know how to get a license for ThinkGeo MapSuite productions.

Can I use MapSuite 9.0 license file?

No. The Map Suite 10.0 license file is not compatible with Map Suite 9.0. And you need to create individual license file for MapSuite 10.0 by Product Center 10.0.

Do I get access to new releases and product updates?

As long as your software assurance or subscription is current you do get access to free upgrades as well as continued product support.

map_suite_license_guide.txt · Last modified: 2020/04/17 14:20 by admin