Offline license activation during initial setup

For your on-premises (not ESHA cloud) programs, you will have to use these instructions if:

• You are not connected to the ESHA licensing servers during your initial installation, you will have to activate your license offline
• Your license changes (i.e., you add user licenses, purchase a labeling module, or renew your subscription), you will have to remove and re-activate your offline license. 

Note: This is a cumbersome process and we highly recommend that you work with ESHA and your IT staff to enable online activation instead.

You will have to:

• Send a Machine Key to ESHA for each computer that is in need of the offline activation.  If you have multiple installations, you will need to repeat this for each one. 
• Use the License Text string generated by ESHA to finish the activation or re-activation.

Send a Machine Key to ESHA using EAT

Installed with your ESHA software is a utility called ESHA Administrative Tools (EAT).  There is no shortcut link for EAT, but it can be accessed by clicking the Start menu (or pressing the Windows key). 

If EAT is not installed, you can download and install it here:
https://esharesearch-webinstaller.s3.amazonaws.com/installers/eshaadmintool/1.1.7/ESHAAdminTools+Setup-1.1.7.exe

1. Launch EAT and run as an Administrator with permissions to the Database.
2. Select your program from the Selected Product dropdown:
   
   If the selected Products dropdown is not populated with any options, at the command prompt on the right half of the lower pane, type (or paste):
   

    Set-EshaProductContext -Product FoodProSQL -Connection (New-ProductDatabaseConnection -Product FoodProSQL -Force )

   Substitute the proper Product depending on your installed software.

3. Click the Licensing tab.

4. Select Remove Activation.
   
   If this option is grayed out, at the command prompt on the right half of the lower pane, type or paste (again, substitute the Product if necessary)
   Remove-EshaMachineLicenseActivation -Product FoodProSQL

5. The right-pane should reflect the activation has been successfully removed.

6. Again on the right-pane, type or paste:
   Get-MachineUniqueId

7. Copy the full Machine Key and send this in plain text and support will generate an offline license text. Tip: paste the Machine Key into a simple .txt file, and attach that to the email to Support. ESHA Support personnel will use the Machine Key you sent to correctly build a new License Text file, which will be sent to you.

Update your License using EAT

Once you have received the License Text;

1. Launch EAT again.
2. Click the Licensing tab.
3. Select the Offline Activation type
   
4. Ensure your Customer Number is set.
5. Copy the License Text provided to you by ESHA Support into the License Text section.  Be careful to copy the full block of text, and no additional whitespace.
6. Click Set.
   
   NOTE: If these are grayed out you can manually enter the license text by entering
   
   Update-EshaMachineLicenseActivation -MachineName {MyComputerName} -LicenseText {BigLongStringOfTextFromESHASupport} -Product FoodProSQL
   
   Text in the 2 sets of curly brackets{ } indicate areas where you must enter the data, removing the brackets.
7. The license text should be updated successfully.  Launch your software and verify.