Soon, we will launch a new and updated customer portal, which is an important step toward providing our customers with one place to learn, interact, and get help.
Learn more.

Activate, Transfer, or Update a Softkey License On A Machine Without Internet Access

This article describes how to activate, update, or transfer a softkey license when working on a computer working offline (isolated machine without internet access).  

*PLEASE NOTE*   If the machine hosting your softkey license does have internet access, you should refer to one of the following articles:

How To Install a Single User Softkey
Update or Transfer a Softkey License (with internet) 
How to Install the Network License Version of OpticStudio

CONTENTS:

Alissa Wilczynski
03/28/2016



 

OpticStudio
Installation and Troubleshooting
Lensmechanix


NOTE:  Before continuing this article, you should be certain that you have a softkey license.  If you received a USB dongle from Zemax Sales, you do not own a softkey license.

                

There are separate articles to help update your support information if you have a USB key

If you have a Black USB license refer to Is My Key Under Current Support?
If you have a Red or Green USB license, refer to the following article offline: Update Green and Red USB Licenses on a Machine Without Internet Access 

Activate a Softkey Without Internet

When you initially purchase an OpticStudio softkey license, you will receive an automated email from sales@zemax.com.  The email will contain an activation code.  The activation code can only be applied within the Zemax License Manager on machines where internet access is available.  If your machine does not have internet access, you will ignore the activation code and instead follow the instructions below.

Required software

To start this process, you need to install the appropriate software. 

If this is a single-user machine, just install OpticStudio. It needs to be version 15.5 or higher to use a softkey. For additional information on installing OpticStudio, see this page.

If this is a network license being installed on a keyserver, you just need the Zemax License Manager. It's located in the "Resource Files" section of the Zemax download page. For full setup instructions of the Zemax License Manager on a network server, refer to How to Install the Network License Version of OpticStudio.

Once you have the appropriate software, follow the below steps.

1.    Open a web browser and go to the Sentinel Admin Control Center, located at http://localhost:1947.  Your machine does not need internet access – this is an application that runs on your machine via a web browser.

If this page does not open, then the Sentinel LDK licensing runtime required to use your Zemax license did not install properly. Refer to How to Troubleshoot Softkey License Issues to check and repair the underlying license software. Return to this article once the Sentinel Admin Control Center is working.

2.    Go to the Diagnostics section, and click the "Create ID File" in the upper right corner.



3.    A file (named your_computer_name.id) will be saved on your machine, typically in the Windows "Downloads" folder. Attach it to an email addressed to sales@zemax.com with subject “Softkey Activation: V2C Required”. Please include your license serial number (It is the number that starts with L1) in the subject of the email .

4. We will then reply to you with a V2C type file.  Save that file to your machine, then continue the instructions below. 

Note: There is no need to keep the .v2c file we send you, as we have a copy on our server if it is needed for any reason.

5.    Open a web browser on the server and go to back to the Sentinel Admin Control Center at http://localhost:1947 .

6.    Click on the "Update/Attach" link on the left hand navigation bar. Click “Choose File” and locate the .V2C file you saved.

7.    Click “Apply File” to activate the license and lock it to the machine. 


 8.    You can now open the Zemax License Manager, and you will see your new softkey's details on the "License Information" tab.

This is a good time to review our article on protecting your softkey from loss.

Update a Softkey Without Internet

When you renew your support, you receive an automated email from sales@zemax.com containing your update code. If your machine hosting the softkey is not online, you will not use the code.  Instead, reply to sales@zemax.com and request a V2C file. Be sure your license number (L10XXXX) is in the email. Save the .V2c file to the machine that hosts your softkey license, then continue the instructions below.

Note: There is no need to save the .v2c file we send you, as we have a copy on our server if it is needed for any reason.

1.    Open a web browser and open the Sentinel Admin Control Center at http://localhost:1947.
2.    Click on the Update/Attach link on the left hand navigation bar.
3.    Click “Choose File” and browse to the location you saved the .V2C file.
4.    Click “Apply File”.

5.    You can now open OpticStudio or the Zemax License Manager, and should be able to see your updated softkey license information.

 

Transfer a Softkey License From/To a Machine Without Internet

Required applications

This article requires you already have either OpticStudio 15.5+ or the Zemax License Manager installed on the source and destination computer. If this is the case, you just need to download the Zemax_RUS tool. It is available in the Resource Files section of the OpticStudio downloads page or via this direct link.

Summary

This is basically a 4 step process and needs to begin on the machine that you want to move the license to. The basic steps:

1. Download the Zemax_RUS tool to the source and destination machines.
2. Use the Zemax_Rus tool to create a destination file on the the destination machine (the one you want to move the license to).
3. Copy the destination file to the machine where the license is currently located. Use Zemax_RUS to generate a license transfer file.
4. Copy the license transfer file back to the machine you want to move the license to. Apply the transfer file with the Zemax_RUS tool.

Starting the transfer

1.    On the destination machine (where you want to move the license to), you need to verify the licensing software is working. Open a web browser and go to the Sentinel Admin Control Center, located at http://localhost:1947.  Your machine does not need internet access – this is an application that runs on your machine via a web browser. Verify the "Help" page as below opens successfully. If this page opens to an error message, then the Sentinel LDK licensing runtime required to use your Zemax license did not install properly. Refer to How to Troubleshoot Softkey License Issues to check and repair the underlying license software. Return to this article and move to step 2 once the Sentinel Admin Control Center is working.

Sentinel Admin Control Center Help page



2.  Open Zemax_RUS and select the "Transfer License" tab.  Save a recipient information file to your desktop by clicking the "..." button. We suggest you name it "destination.id" as that is what the steps in this article use. However, the particular file name is not important.



3.  Click the "Collect and save information" button. You will get a notice that the recipient information is stored in the file. 
TIP: Do not skip this step or the transfer process will fail.




4.    Move to the source machine (where the Zemax license is currently installed). 
5.    Copy the “Destination.id” you created above to the source machine.
6.    Open the Zemax RUS application.
7.    Select the "Transfer License" tab.
8.    Select the Key ID of the license you want to transfer. If there is more than one listed, you need to be sure to identify the correct key. If you are not sure which is correct, launch the Zemax License Manager (Usually in Start / Programs /  Zemax OpticStudio or Zemax License Manager). Look on the "License Information" tab to see all licenses. Note that only licenses marked as "Local" can be transferred.




9.    In our example, we are going to transfer key L101601. Select key ID 855860311232220694 in the RUS tool. Click the "..." button next to "Read the recipient information file" and select the “Destination.id” that you copied from the destination machine. Click Open.



10.    Click the “…” button next to "Generate the license transfer file". Save the file as “TransferFile.h2h”. (The particular file name is not important, but this matches the steps used in this article).



11.    Click the "Generate License Transfer File" button. You will see a message asking to confirm that you want to transfer your license away to the destination computer name (Owner-PC in the image below). Click Yes to confirm you are sure.

IMPORTANT: Your softkey license is now contained in the transferfile.H2h. Make sure not to lose this file. If it is lost, your license will be subject to the Zemax lost key policy. This can mean purchasing a replacement license if you do not have ZPA insurance. We recommend copying rather than moving the transferfile to your transfer media in case it is lost in transit.




12.    Move to the destination machine
13.    Copy the generated “TransferFile.h2h” file you created before to a convenient folder on the machine. 
14.    Open the Zemax_RUS tool. Select the the "Apply License File" tab. Browse and select the TransferFile.h2h file. Click Open.
15.    Click Apply Update. You are finished! 

Testing the transferred license

On the destination machine, open the Zemax License Manager.and check the License Information tab. You should see your transferred license now located on the new machine. If you will be running OpticStudio on the destination, open it and verify it recognizes the license as well.

If the license does not appear, or has an invalid date, visit the How to Troubleshoot Softkey License Issues article for troubleshooting information. Otherwise, refer to the getting help section below.

Getting Help

If you receive any error messages while activating, transferring or updating, contact the Zemax Support team for further help. Please include any error messages as well as your license key number (such as L000001). It would also help to send a screen shot of the Sentinel Keys page located at  at http://localhost:1947/_int_/devices.html.