User Tools

Site Tools


map_suite_production_server_licensing_9.0

Map Suite Production Server Licensing

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 production server licenses. These licenses are necessary when you have a web-based application or other service that lives on a web- or cloud-based server. In order to deploy your application or service to such an environment in a production capacity, you will need a server license for each server that will host the application. Failure to install a production server license will result in a blank map being drawn by your application, with a message stating “Unlicensed for Runtime”.

The following Map Suite products require production server licenses: Map Suite Web Edition, Map Suite MVC Edition, Map Suite Silverlight Edition and Map Suite WMS Server Edition. A production server license may also be required if you are running an application built with the following products in a web or cloud-based environment: Map Suite Services Edition, Map Suite Routing and Map Suite Geocoder.

If in doubt, contact your ThinkGeo sales representative for full details. Production server licenses can be purchased online from the ThinkGeo Store, and are offered on a per-server or unlimited-servers basis.

Downloading a Production Server License

Beginning with Map Suite 8.0, production server licenses are downloaded through the ThinkGeo Product Center application. The download package consists of a tool that can simply be installed on your server to activate the license.

Once you have purchased the appropriate server license from ThinkGeo, simply log into the Product Center using the associated ThinkGeo account. Click on the product for which you purchased the server license – for example, Map Suite MVC Edition – and you will see a section labeled Server License Tool on the right side of the window. This section contains your production server license serial number, as well as a link to download the license installation tool.

Simply click “Download” to retrieve your server license installation tool from ThinkGeo. You will be prompted for a location in which to save the file, which will be a Microsoft Installer package (.msi). We recommend that you keep your license installation tool and serial number backed up in a safe place.

Compatibility Note

The server license you download and install must be of equal or lesser version to the Map Suite developer control you used in your application. For example, if you have built your application using Map Suite Web Edition 8.0, you must use the Web Edition server license tool version 8.0 or older. You cannot use Web Edition server license tool version 9.0 or higher, because your application will not recognize the newer license format. This is why we recommend that you store your server license tool in a safe place after you have downloaded it.

If you need a legacy version of a server license tool, please contact ThinkGeo.

Installing a Production Server License

Important note: Your server will need an available Internet connection in order to successfully install and activate a production server license. If this is not possible, you should use the offline Map Suite Registration Builder tool to activate your server license instead. Skip to this section of the guide.

Once you have downloaded your production server license tool, copy it up to the web or cloud-based server on which you will be hosting your application. Double-click on the server license .msi file. You should be presented with a window like the one below:

Click the “Next” button to proceed.

You will then be asked to accept the ThinkGeo software license agreement. Once you have read the license in its entirety, check the box at the bottom of the window and click “Next”.

On the next step, enter your customer information. This includes your name, your company, and the serial number for your production server license (which you obtained from the ThinkGeo Product Center application).

After filling in your customer information, click “Next” to proceed.

Now, you will choose your installation type. Make a choice as follows:

  • If you are installing a license on a production server for a live application, select the Production Server option. This will consume one production server license from your ThinkGeo account, but will enable your application to display maps without watermarks.
  • If you are installing a license on a test server that will be used only for internal testing, select the Development/Test Server option. This will not consume a license from your ThinkGeo account, but any map displayed by your application will be rendered with a watermark to show that it is being run on a test server.

Once you have made a selection, click the “Next” button.

On this step, choose the installation directory for your server license information. The default is typically fine. Then, click “Next”.

Your production server license is ready to be installed. To proceed, click the “Install” button. At this point, you may be asked to enter credentials for an administrator account on Windows Vista / Server 2008 or higher. Make sure you say “Yes” to the User Account Control prompts, or your production server license will be unable to install.

The installation will proceed, and a blue bar will indicate its progress until it is complete.

When the installation finishes successfully, you will be shown the following screen:

Click the “Finish” button to exit the installer.

Your production server license is now installed! To test it, launch or access your Map Suite application at runtime and ensure that your maps are displaying correctly and without any watermarks.

Installing a Production Server License While Offline

If your server environment does not have an active Internet connection, or you are otherwise unable to reach the thinkgeo.com domain due to proxy, firewall or other issues, you must install your production server license using the offline Map Suite Registration Builder tool.

When you activate a Map Suite product license that you have purchased, that license is verified with ThinkGeo's online servers as part of the activation process. This simple process ensures that you are activating a license that you are entitled to, and also allows you to easily move licenses from one machine to another by first deactivating and then reactivating that license. ThinkGeo takes care of all the particulars, and the process is seamless if you have an Internet connection.

However, if your development machine or server environment does not have an Internet connection, or you are otherwise unable to reach the thinkgeo.com domain due to proxy, firewall or other issues, you must activate your license using the offline Map Suite Registration Builder tool. This is a simple process that consists of the following basic steps:

  1. You generate a request file on your development machine or server.
  2. ThinkGeo generates a unique license file for you, based on your request file.
  3. You complete your license activation by importing the unique license file.

The following guide will walk you through these steps in detail.

Generating an Activation Request File

Please make sure you perform these steps on the computer where you intend to use the Map Suite product in question. If you generate a request file on one machine and attempt to import the license file on a different machine, the product will not successfully activate.

The Map Suite Registration Builder tool gets installed on your system when you install the ThinkGeo Product Center application. If you used the default install directory, you will find the tool in:

C:\Program Files (x86)\ThinkGeo\Map Suite X.X\Miscellaneous\Map Suite Registration Builder

Double-click MapSuiteRegistrationBuilder.exe to launch the tool, and the following window will appear.

To begin the process of activating your product license while offline, click the “Generate Request File” button on the left side of the window. This process will generate a special file that ThinkGeo will then use to create a unique license for your particular account, product and environment.

When you click “Generate Request File”, a file save dialog will appear. Select where you want to save the request file, then click “Save”. The following message will appear:

When you click “OK” on this message box, an Explorer window will open, highlighting the location of the request file so that you can easily attach it to an email.

Now, email the request file to support@thinkgeo.com with the subject line “Product Activation Request”. In the body of the email, please include:

  • Your name (e.g., John Smith)
  • Your company name (e.g., ABC Industries)
  • The name and version of the Map Suite product that you wish to activate (e.g., Map Suite Web Edition X.X)
  • Whether you are activating a developer license or a production server license

Importing the ThinkGeo License File

ThinkGeo will manually generate a unique license file for your particular installation, a process that is usually completed within one business day. Once this is done, the license file will be returned to you by email. Once you receive it, you will need to import it using the Map Suite Registration Builder tool – the same tool you used to generate the request file.

Right-click MapSuiteRegistrationBuilder.exe and select “Run as administrator”. When the tool's main window appears, click the “Import License File” button. A file open dialog will appear.

Locate the license file that was sent to you by ThinkGeo and double-click it to process the activation contained within.

If everything is in order, the Registration Builder tool will respond with a success message.

Your product license is now activated!

If any errors occur, please take note of the specific error message, and then contact ThinkGeo for assistance.

Uninstalling a Production Server License

Important note: Your server will need an active Internet connection in order to free the uninstalled license activation from your ThinkGeo account.

The uninstallation procedure described below is only applicable if you used the Windows installer to install your production server license. It does not apply if you installed your server license with the Registration Builder tool.

To remove a production server license, simply open the Windows Control Panel, select “Uninstall a program”, and then locate the server license in the list of installed software. Its name will begin with “Map Suite” and it will indicate the product edition that the license is associated with; for example, “Map Suite Web Edition Server License Tool”.

If there is more than one version of the Map Suite server license on the machine, please ensure that you are removing the correct version. Then, simply double-click the item to uninstall it.

If you installed the server license as a “Production Server” type, uninstalling will free up one server license activation in your ThinkGeo account. This means you can reinstall the server license later at any time, or on a different server. Please note that your server will need to have an active Internet connection in order for your license to be freed.

map_suite_production_server_licensing_9.0.txt · Last modified: 2017/03/16 02:43 by kevinlaw