|
||
The network installation needs a shared folder on the server for the license file - for details see Network license - how it works. A 'Server' is not necessary. The shared folder could also be on an external hardware drive like NAS drive.
•Depending on the registration tool (see below) admin or non admin rights
During Runtime of the Application
•read and write permission to the license file on the server
•read and write permission to the registry (hkey_current_user)
If Licence Protector is used within a .NET server application, check if the .NET server user has the necessary rights.
The folder ..\files for distribution contains all Licence Protector DLLs. There is an folder with a compressed version and uncompressed version. We recommend using the uncompressed version because it works with all compilers and operating systems.
Licence Protector offers different ways to register the DLL / COM exe:
•Using LPRegister313.exe - it registers the DLL / COM exe without needing administrator rights
•Do not register the DLL if you use a manifest file. Administrator rights are not needed. Manifest files are not supported for the COM exe
•Register the DLL / COM exe with the windows tool regsvr32.exe or the inbuilt option of an installer. This requires administrator rights
You should copy the licprotector313.dll to the \windows\system32 folder although it could also be installed in your program directory. As each DLL version of Licence Protector has an own ProgID, multiple different versions can be installed on the same machine.
•If your installer needs administrator rights, use the inbuilt option of the installer or regsvr32.exe. To use regsvr32.exe add a shell execute command in the installer which invokes regsvr32.exe
- Register the DLL: Execute "c:\windows\system32\regsvr32.exe" " ....\pathname\LicProtector313.dll" (note: this requires administrator rights)
- Register the COM exe: LicProtector313.exe /regserver (note: this does not require administrator rights)
•If your installer does not need administrator rights then use LPRegister313.exe
•If you do not have an installer and you only copy files to a folder, use a manifest file
•If you just want to register the DLL manually on one system, use LPRegister313.exe. Using regsvr32.exe would work as follows:
- right click on “Command Prompt” in Accessories and click “Run as Administrator”
- run regsvr32 "....\pathname\LicProtector313.dll” in the command window
If multiple users on one computer or services use the COM exe, then you have to register it using administration rights and the command: LicProtector313.exe /regserver /NOREDIRECT
Vista / Windows 7 and MSI files
Some installers generate a message HRESULT -2147220472 or -2147023898. This is due to missing rights during installation. Use LPRegister313.exe to register the DLL and not the installer built in dll register function.
Each user needs a read and write access to the license file. There is no special consideration for Vista / Windows 7.
Copy the license file to a folder on the server and assign the license file a read and write permission for all users.
If you want to change the permission with an installer see below.
Some installers have built in options to change rights on folders. You cannot use the standard Windows tool cacls.exe or icacls (Vista) because you have to address the user / group name you want to change in the language of the operation system - e.g. 'users' or 'Benutzer'.
There is a tool SetAcl.exe which allows using SID to change the permission. The tool can be downloaded here: http://setacl.sourceforge.net/html/examples.html . Documentation for the SID can be found here (only German): http://www.grurili.de/index.html?/Grundlagen/WellKnown_SIDs.htm
Your installer could use the following sequence
•Copy setacl.exe to the installation directory •Execute Setacl.exe e.g. "maindir\SetAcl.exe" -on "maindir" -ot file -actn ace -ace "n:S-1-5-32-545;p:full;s:y" - This will set full rights to the group users. The SID S-1-5-32-545 is used instead of the name users •Delete setacl.exe
|
Although you could deliver an unsigned installer file, we recommend adding your digital signature. You can buy a code-signing certificate from one of the accredited providers like www.verisign.com, www.thawte or www.comodo.com.
With the digital signed installer file your users do not get warning messages when they download the file or start the file.
First check your installation tool if it supports to add a digital signature. As installers often add their own CRC checks a digital signature would destroy the installer file. Therefore the installer tool has to add the signature first before the CRC check is added.
To use the Licence Protector DLL on Windows 2000, you additionally have to install the GDI+ DLL, which is only part of the operating system in Windows XP and later.
Download DLL: http://www.microsoft.com/downloads/details.aspx?FamilyId=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en