Developer Center Resources

cancel
Showing results for 
Search instead for 
Did you mean: 

Tutorial: License a LabVIEW Executable Using Instant Protection PLUS 3


Goal

The easiest way to license an executable is through the Instant Protection PLUS 3 licensing injector/wrapper tool. It has an easy-to-use licensing wizard, and is available from SoftwarKey.com / Concept Software.  This exercise will show how to license a LabVIEW-built executable using Instant Protection PLUS 3.


Prerequisites


Part 1:  Build “LabVIEW Executable.exe”

  1. Open LabVIEW Executable.lvproj

  2. View the source code of LabVIEW Executable.vi and test its functionality.

  3. Close LabVIEW Executable.vi

  4. In the project explorer window, right click on “LabVIEW Executable” under “Build Specifications” and select build.

image003.png

  1. When the build is complete, click Explore to view the executable file.

    image004.png

  2. Double click on LabVIEW Executable.exe to run it. See that the VI runs instantly.

    image005.png

Part 2:  License EXE with Instant Protection PLUS 3

  1. Click on the start menu and choose Start > All Programs > SoftwareKey Licensing System > Instant Protection PLUS 3 > Instant Protection PLUS 3
  2. If you are using a trial version of Instant Protection PLUS 3 , you will first get an evaluation screen. Click “Evaluate Instant Protection PLUS 3” to continue.

    ipp3-labview-evaluate.png


  3. On the Instant Protection PLUS 3 Wizard page choose “Start a new project” and click Next.

    ipp3-labview-newproject.png

  4. If you are using the Instant Protection PLUS 3 trial, click OK on the popup asking you to sign up for a test account.
  5. On the SOLO Configuration page, if you are already have a SOLO server account, choose “I have already subscribed to the Instant SOLO service or I host my own SOLO Server” and click Next to log in with your credentials. Alternately, you can create your own account by choosing “I want to sign up for an Instant SOLO Server test account”.

    ipp3-labview-soloserver.png

  6. On the Choose SOLO Product page, choose “I would like to create a new product on SOLO Server” and click Next
  7. Log into the SOLO Server page with the same Login ID and Password used previously.
  8. In the “Add Product Wizard”, fill out the information for the new product as shown in the below screenshots and click Next on the left pane.   
    • Description, Option Name, Option Description and Price can be whatever you choose. Everything else should remain default.


      ipp3-labview-addproduct.png


  9. On the Product Options page, click Next. There is no need to change these options.

    ipp3-labview-applicationoptions.png

  10. On the General Product Information page, uncheck “Auto-Detect Version” and enter the version number of your software. Change the Product Logo to C:\Hands-On\LabVIEW Executable\LabVIEW Executable.bmp, or any other bitmap file. Click Next.

    ipp3-labview-generalproduct.png

  11. On the License File Options page, click Next. There is no need to change these options.
  12. On the Trial Options page, click Next.
  13. On the Copy-Protection Options page, click Next.
  14. On the Telephone Activation Options page, click Next.
  15. On the Activation Options page, click Next.
  16. On the License Key Injection page, click Next.
  17. On the Periodic Expiration page, click Next.
  18. On the Integration Method page, click Next.
  19. On the Wrapper Settings page, choose the executable to be licensed in “File to Wrap” field. Change the Output Folder to where you want the new wrapped executable to be saved. Do not change the other options.

    ipp3-labview-wrapper.png


  20. Click Next. When prompted to save changes, click Yes. Save the IPP file somewhere on your hard drive. This file should not be distributed with the executable.
  21. Wait for the Process Application window to display “Processing completed.” Your executable is now licensed.

    ipp3-labview-wrap-app.png


Part 3:  Test your licensed executable

  1. In the Instant Protection PLUS 3 dialog click the “Run App” button to test your licensed application. Alternately you can run “C:\Hands-On\builds\licensed\LabVIEW Executable.exe" from windows explorer.
  2. Press OK on the Trial Message dialog.  This only appears since you licensed the executable using a trial version of Instant Protection PLUS 3.
  3. The next window that opens is the evaluation dialog that users will see if they run your application without a full license.

    ipp3-labview-protected-app.png
  4. Click Evaluate LabVIEW Executable to bypass the Evaluation Dialog and proceed to the built application. Notice that aside from the evaluation dialog, the application runs just the same as before licensing was added.


Additional Notes

The first time that the licensed application is run, it is important to change the necessary permissions of all license files and registry entries if you changed the License File Location setting on step 13 to something other than the default "Auto-create in the current user registry". This can be done by calling the EXE with the command line parameter /OPENLF. Since this needs to be done at install time, your installer can copy over the licensed EXE file to the target system and immediately call it with the /OPENLF command line parameter to set the permissions and exit.


Conclusion

This hands-on covers licensing a LabVIEW Executable using SoftwareKey Instant Protection PLUS 3. If you need more advanced licensing functionality, you can also utilize Third Party Licensing & Activation Toolkit Licensing API. For licensing a LabVIEW Library, you can use the Third Party Licensing & Activation Toolkit Add-on Licensing Tool.


Additional Resources:

Comments
TiTou
Trusted Enthusiast
Trusted Enthusiast
on

I keep getting an error when I try to login into the test account :

a. Author ID: 3801470

b. Login: 3801470

c. Password: labviewtplat

Please help...

EDIT (3h later) : and now it work...


We have two ears and one mouth so that we can listen twice as much as we speak.

Epictetus

Antoine Chalons

David_L
Active Participant
Active Participant
on

I'm glad that you got it to work.  If you do need further help with InstantPLUS, you should contact ConceptSoftware for support since they are the developers of the product.  We endorse it and wrote a tutorial for it, but they'll be able to fully understand what problems you are having. 

TiTou
Trusted Enthusiast
Trusted Enthusiast
on

ok, thx


We have two ears and one mouth so that we can listen twice as much as we speak.

Epictetus

Antoine Chalons

battler.
Active Participant
Active Participant
on

Have you been able to protect labview exe using this product? Can ConceptSoftware really support use with LabVIEW? Last time I checked they could not.

Thoric
Trusted Enthusiast Trusted Enthusiast
Trusted Enthusiast
on

What are you implying battler? Is there something unsafe about the use of ConceptSoftware software? If so, please share as this could be very important.

Thoric (CLA, CLED, CTD and LabVIEW Champion)


Olivier-JOURDAN
Active Participant Active Participant
Active Participant
on

At SAPHIR, we are currently using ConceptSoftware tools to protect and activate all of our toolkits --> https://decibel.ni.com/content/groups/saphir-toolkit and our application --> https://decibel.ni.com/content/groups/saphir-topaze.

As Thoric asks, I'd to hear more about your concern.


Olivier Jourdan

Wovalab founder | DQMH Consortium board member | LinkedIn |

Stop writing your LabVIEW code documentation, use Antidoc!
battler.
Active Participant
Active Participant
on

Nothing unsafe that I'm aware of; although we currently use hardware locks.  Would you say this toolkit is secure enough to protect expensive applications?

I'm just looking for simple and customizable implementation in LabVIEW and some examples and LabVIEW specific support if need be.

Is this possible now?  Before it didn't seem like it was.

Can you guys point me where to start?  I have read the NI tutorials and downloaded the toolkit.

Olivier-JOURDAN
Active Participant Active Participant
Active Participant
on

Does the last document listed by David_L make sens for you ? VIs allow you to retrieve the status of the license file and you can do what you want in your app depending on this status.

Perhaps the most "difficult" is to understand features of Instant Plus...


Olivier Jourdan

Wovalab founder | DQMH Consortium board member | LinkedIn |

Stop writing your LabVIEW code documentation, use Antidoc!
battler.
Active Participant
Active Participant
on

I had another question.

What's the actual process for activating software in use by the client?  Do you need to manually generate licence files?

battler.
Active Participant
Active Participant
on

I'm just going through that example now.  It seems quite easy.  We actually implemented something similar ourselves.

How does this (licence files) tie with InstantPlus?

How do you implement trial versions and activate/de-activate features?  Is it easy?

Sorry for the million questions I'm just very keen to implement this!!

battler.
Active Participant
Active Participant
on

"web activation URL" - what do I need to implement to allow user to automatically activate.

Do I issue them a unique Serial No.?

What's the process you use to activate your clients software?

David_L
Active Participant
Active Participant
on

Hi Battler.  I think it makes more sense to answer these questions in the discussion forum rather than having the comments on this document grow too long.  I will answer these questions on the thread you started here:

https://decibel.ni.com/content/message/44414

Contributors