Registering Production License Keys

This article describes all the steps associated with registering a production license key. However, if you want to evaluate Graphics Mill before you purchase a license you should request a trial license key as described in the Evaluating Graphics Mill topic.

There are several ways to register a production license key for Graphics Mill:

  1. You can register a license key on a development computer or a production server using the Graphics Mill License Key Manager . The tool requires Internet access for the machine where the key is registered.
  2. If you experience problem with Internet connection or have strict strict firewall settings, you can you can apply a license key by updating the Windows Registry manually.
  3. You can register a license key using the LIC file on a production or development web server.
  4. On a development computer you can embed a license key inside a desktop application which has a reference to Graphics Mill binaries using the License.licx file.
  5. On a development web server you can set a license key in the application's web.config file.

Using Graphics Mill License Key Manager

Graphics Mill License Key Manager is intended to register license keys on developer machines and target web servers. This tool is distributed along with Graphics Mill:

  • If you downloaded Graphics Mill from www.graphicsmill.com, find LicenseManager in the Graphics Mill instalation folder - Aurigma\Graphics Mill 9 SDK\LicenseManager.
  • If you downloaded Graphics Mill as a NuGet package, launch LicenseManager located in packages of the project solution - packages\Aurigma.GraphicsMill.Core.x86.9.x.x\tools\LicenseManager.

After launching LicenseManager, you will see the following dialog:

If you have not registered on www.graphicsmill.com yet, open the New User tab and enter your name, company, and email. If you have been registered on www.graphicsmill.com, open the Existing User tab and enter your email and password:

After you press the Proceed button, you will be redirect to www.graphicsmill.com stating your license key and when it expires. The tool retrieves a production key from your account and registers it in your system. If a trial license key cannot be obtained or registered for some reason, please contact our support team.

By Updating the Windows Registry Manually

If by whatever reason you cannot register license keys using Graphics Mill License Key Manager you can apply a license key by updating the Windows Registry manually. To perform this: download your license keys from My Licenses & Downloads and create the .reg file or update the following keys of Windows Registry:

[HKEY_LOCAL_MACHINE\SOFTWARE\Aurigma\Graphics Mill for .NET\6.0] 
"License Key"="YOUR_KEY" 
  
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Aurigma\Graphics Mill for .NET\6.0] 
"License Key"="YOUR_KEY

Also you can download the .reg file by the following link: Register License Key Offline.

Using LIC File

If you deploy a web application on a server where you have no permission to run the Graphics Mill License Key Manager, you can register a production key using a LIC file.

Important

If you develop a desktop application, do not include a production license key in the end product using a LIC file! Instead, register Graphics Mill at the development machine only and embed a license key into application resources. This approach is described in the Using Licenses.licx File section of this article.

  1. Create a new text file named Aurigma.GraphicsMill.lic.
  2. Insert the license key (XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX) into this file. Make sure that this file has no extra characters, such as white spaces, etc.
  3. Copy this file into the \bin folder of your web application.

Using Licenses.licx File

This approach is intended for desktop applications. You should apply all the steps described in this section on the development machine only. After you execute these instructions correctly a production license key will be imported into the resources of your application. Therefore you do not need to register Graphics Mill on the customers' workstations.

  1. Register Graphics Mill using the Graphics Mill License Key Manager on the development machine as described in the Using Graphics Mill License Key Manager section of this article.
  2. If you have Visual Studio opened, close it and then re-open it.
  3. Add a new text file named Licenses.licx (you cannot give this file any other name) into the project, or open an existing one.
    Note

    Normally Visual Studio hides this file in the Solution Explorer. That's why it is possible that this file already exists in your project (under certain circumstances it is auto-generated). In this case you should click Show All Files on the Solution Explorer tree pane to see this file.

    Note

    If you use Graphics Mill in a custom control (rather than in an end-user desktop application), you should add the Licenses.licx file into the desktop application which uses your control.

  4. Add the following string into this file:

    Aurigma.GraphicsMill.Bitmap,Aurigma.GraphicsMill

    In other words, you should add the name of the licensed class and DLL name without the file extension, separated by comma.

  5. Rebuild the project.
Note

If the license key works on the developer's machine and does not work on the customers' workstations, this most likely means that there are some problems with the Licenses.licx file. In this case check whether you have correctly performed step 2 above.

Resolving a Problem with Licenses.licx File in 64-bit Application

Visual Studio 2010 uses a 32-bit version of the license compiler, even though a project is configured as 64-bit. To work around this issue open your Visual Studio project file in a text editor and add the following line to all of your 64-bit configurations:

<LCToolPath>C:\Program Files (x86)\Microsoft SDKs\Windows\v7.0A\Bin\NETFX 4.0 Tools\x64</LCToolPath>

In web.config File

On a development web server you can apply a license key in your application's web.config file. To perform this insert your license key in the appSettings section like it is shown below:

XML
<appSettings>
    <add key="GraphicsMillLicenseKey" value="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX" />
</appSettings>
Important

This approach is for using in your organization only. It is not for distributed applications, since the key is stored unprotected.

License Key Validation

Graphics Mill provides the ability to check whether the registered license key is a trial or production and also the ability to obtain the evaluation or maintenance expiration date. The following code sample demonstrates how to perform that check.

C#
var info = Aurigma.GraphicsMill.Licensing.LicenseInfoProvider.LicenseInfo;
if (info.IsTrial)
{
    Console.WriteLine("Evaluation period expires on " + info.TrialExpirationDate.ToString());
}
else
{
    Console.WriteLine("Maintenance period expires on " + info.MaintenanceExpirationDate.ToString());
}