Differences

This shows you the differences between two versions of the page.

--- map_suite_production_server_licensing [2015/09/16 06:11]
admin [Uninstalling a Production Server License]
+++ map_suite_production_server_licensing [2017/03/22 21:06] (current)
bradrollins
@@ Line 1: / Line 1: @@
 ====== Map Suite Production Server Licensing ======
+** The page was created for Map Suite 10. For Map Suite 9.0 please visit (http://wiki.thinkgeo.com/wiki/map_suite_production_server_licensing_9.0). **
 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]].
+The following Map Suite products require production server licenses: [[Map Suite Web For WebForms]], [[Map Suite Web For MVC]] and [[Map Suite Web For WebAPI]].  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 Routing]] and [[Map Suite Geocoder]].
 If in doubt, [[http://thinkgeo.com/contact-us.aspx|contact your ThinkGeo sales representative]] for full details.  Production server licenses can be purchased online from the [[http://thinkgeo.com/store/|ThinkGeo Store]], and are offered on a per-server or unlimited-servers basis.
-===== Downloading a Production Server License =====
+===== Installing a Production Server License =====
-<div floatright marginleft10px>
+<div msgbox>
-{{:Map Suite Product Center Server License Tool Download.png ?300}}
+**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 activation tool to activate your server license instead. [[#Installing a Production Server License While Offline|Skip to this section of the guide.]]</div>
-</div>
-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.
+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 Web For MVC and you will see a button named **Setup Deployment Server** on the right side of the window. Click this button and a dialog box will appear.
+[[|{{:mapsuite10:setup_deployment_server.png}}]]
-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.
+Simply select the **Install Production Server** checkbox and then click OK. 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.
+[[|{{:mapsuite10:install_production_server.png}}]]
-==== Compatibility Note ====
+===== Installing a Production Server License While Offline =====
-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 [[http://thinkgeo.com/contact-us.aspx|contact ThinkGeo]].
+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.
-===== Installing a Production Server License =====
+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 the proxy, firewall or other issues, you are still able to activate your license with a simple process that consists of the following basic steps:
-<div msgbox>
-**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. [[#Installing a Production Server License While Offline|Skip to this section of the guide.]]</div>
-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:
+  - You generate a request file on your development machine or server.
+  - ThinkGeo generates a unique license file for you, based on your request file.
+  - You complete your license activation by importing the unique license file.
-{{:Map Suite Server License Tool Installer 01.png?500}}
+The following guide will walk you through these steps in detail.
-Click the "Next" button to proceed.
+==== Generating an Activation Request File ====
+<div msgbox>
+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.</div>
-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".
+To begin the process of activating your product license while offline, click the **"Activate Offline"** button on the right top of the Product Center.
+[[|{{:mapsuite10:click-offline-activate.png}}]]
-{{:Map Suite Server License Tool Installer 02.png?500}}
+Select the **"Generate Request File"** button. This process will generate a special file that ThinkGeo will then use to create a unique license for your particular account, product and environment.
-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).
+[[|{{:mapsuite10:click_generate_request_file.png}}]]
-{{:Map Suite Server License Tool Installer 03.png?500}}
+When you click "Generate Request File", a save file dialog box will appear.  Select where you want to save the request file, then click "Save".  The following message will appear:
-After filling in your customer information, click "Next" to proceed.
+[[|{{:Map Suite Registration Builder 03.png}}]]
-{{:Map Suite Server License Tool Installer 04.png?500}}
+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, you will choose your installation type. Make a choice as follows:
+Now, email the request file to [[mailto:support@thinkgeo.com?Subject=Product%20Activation%20Request|support@thinkgeo.com]] with the subject line "Product Activation Request".  In the body of the email, please include:
-  * 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.
+  * Your name (e.g., John Smith)
-  * 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.
+  * 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 [[Map Suite Production Server Licensing|production server license]]
-Once you have made a selection, click the "Next" button.
+==== 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 Product Center.
-{{:Map Suite Server License Tool Installer 05.png?500}}
+Click the **"Activate Offline"** button on the right top of Product Center again. The offline activation dialog will appear. Select the **"Import License File"** button.
-On this step, choose the installation directory for your server license information.  The default is typically fine.  Then, click "Next".
+[[|{{:mapsuite10:import_license_file.png}}]]
-{{:Map Suite Server License Tool Installer 06.png?500}}
+Locate the license file that was sent to you by ThinkGeo and double-click it to process the activation contained within.
-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.
+If everything is in order, the Product Center will respond with a success message.
-{{:Map Suite Server License Tool Installer 07.png?500}}
+[[|{{:Map Suite Registration Builder 05.png}}]]
-The installation will proceed, and a blue bar will indicate its progress until it is complete.
+Your product license is now activated!
-When the installation finishes successfully, you will be shown the following screen:
+If any errors occur, please take note of the specific error message, and then [[http://thinkgeo.com/contact-us.aspx|contact ThinkGeo]] for assistance.
-{{:Map Suite Server License Tool Installer 08.png?500}}
-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.
-{{section>Map Suite Offline Activation Guide#OfflineLicenseInstrux}}
 ===== Uninstalling a Production Server License =====
-<div msgbox>**Important note:** Your server will need an active Internet connection in order to free the uninstalled license activation from your ThinkGeo account.
+<div msgbox>
+**Important note:** Your server will need an active Internet connection in order to free the uninstalled license activation from your ThinkGeo account. </div>
 \\
 \\
-The uninstallation procedure described below is only applicable if you used the [[#Installing a Production Server License|Windows installer]] to install your production server license. It does not apply if you installed your server license with the [[#Installing a Production Server License While Offline|Registration Builder]] tool.</div>
+To remove a production server license, simply select the product that you've installed on a production server license, e.g. Map Suite Web For MVC and you will see a button named **Setup Deployment Server** on the right side of the window. Click on this button and a dialog will pop up. Simply select the *Uninstall Production Server* option and click OK. The production license will be uninstalled from this machine.
-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".
-{{Map Suite Server License Tool Uninstall.png?640}}
-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.

User Tools

Site Tools

Differences

Page Tools