Download SourceGuardian 10 for Mac OS X User Manual

46
SourceGuardian 10 for Mac OS X User Manual
--mac [xx:xx:xx:xx:xx:xx]
Lock the script to LAN hardware (MAC) addresses (The "MAC" word used here has nothing about Apple
Macintosh computers. MAC address is a hardware address of the local area networking LAN controller
available for all platforms). This address is usually unique for each networking adapter and so it may be
easily used to identify a machine. A MAC address is 6 bytes long, with each byte represented in hex
and separated with a colon (:).The encoder will lock a script to run only from the machine which has a
networking adapter with a specified MAC address. If there is more than one LAN adapter installed then
script will check all of them. If an attempt is made to run the script on a machine that is missed a
correct adapter, then the script fails with an error message: "This script is not licensed to run on this
machine". You may specify multiple MAC addresses, if any one address matches then the script runs.
You may use 'ifconfig' command in Linux or OSX or 'ipconfig /all' in Windows to get a list of installed
networking adapters and know MAC addresses.
--external [filename]
Scripts encoded with this option will require a license file in order to run. A license file may be deployed
with protected scripts or separately from them. This option gives you an opportunity to encode your
scripts once and deploy to users providing them with different licenses. Each license may have different
locks within it. A license file is not created during encoding. You should use SourceGuardian license
generator (licgen) tool for creating a license file for the script or you may do it in the GUI application. This
option can be used only ONCE in the command line. This option may not be used with any other locking
options.
If the name of the license file does not include any path then protected scripts will search for the license
file in the protected script's folder, its parent folder and so on. So you may have one license file for the
entire project located in the top project's folder. A path may be specified for a license file. It may be an
absolute file system path or URL like http://xxx/mylicense.lic (you may use any name for the license
file). If a protected script cannot find the specified license file it will display the following error message:
"script requires ... file to run".
Since version 10 of SourceGuardian loaders you may use SG_LIC_PATH environment variable to specify
where the loader should search for the license file. If the SG_LIC_PATH variable is set then the loader
will not use any other methods of searching the license file. The environment variable should be available
for PHP engine, this may require changes in the web server's configuration.
Example: --external script.lic
Example: --external http://myserver.com/user123.lic
If you chosen to lock your scripts to an external license file this gives some additional protection to your
scripts. Using locking to a license file is the best if you need to deploy one script or the entire project to
different users, but need to use different restriction options for each of them.
--projid [project_id_string]
Allows you to specify Project ID to identify your project. This option is required if --external option is
used. When generating a license file using licgen tool or GUI you need to specify the same Project ID/
Project Key pair. This option is useful when you want to deploy several products that use external
license locking so that each license works only with a corresponding Project ID.
© 2001-2014 SourceGuardian Ltd.