Home

PBlicense User Manual - PB

1. cccccceeceeeceneeneeeeceeeeeseeseesensonsonecnesansensoneaes 43 13 1 PBlicense Main Application sororis 44 13 2 DIICCNSE Frontend nerra aA anianeaeucncennsnenants 45 13 0 PBIICense i Manual EE 45 13 4 PBlicense Footprint Generator cccccecceecseeceeeceeeeeeeseeeeeeeeeees 46 1320 License ANAlYSIS MOON EE 47 SE PAR VIEW OO EE 48 13 7 Requirement Check Gcpt A N 49 14 PBlicense Configuration ccccccsccseseeeeeeeeeeeeeeeeeeeeeeeneeeeseneeseneseesenees 50 14 1 Edit the main CGontguratontie 50 14 2 Edit the License Generator Configuration tie 51 14 3 Create new Product hee 53 19 Unlock the SOT WAS icri 54 15 1 Generate and send hekootponnt 54 15 2 Install the License Flle cowwnidssroioraldeninipileninassidenumeesniaamenedaerereielans 58 16 Unlock lee E VC 60 16 1 Check if there is a License File available 60 16 2 Check the Number of Lcenses 60 16 3 Check the Username and COrgantzaton 61 16 4 Check the Product Name and Software Version annannnnnannennenn 62 16 5 Check the License Start and Expiration Date 63 17 PBIIGCENSE Navigatio nicnn e a 64 1S PRINCESS e Le ln EE 65 18 1 Iniormaton cece cece eee e eee eeceeeeeeceeeeeeseeceeeeaeeeeesueeaeeeeeeeeeeeeseeeeeeness 65 19 Configuration Editor eege EE 68 19 1 Create a new Product Copnfguraton 68 Page 4 of 113 PBlicense User Manual 19 2 Edit a Product E ele UC e EE 78 19 3 Delete a Product Copnfguraton 19 ZO LICENSE
2. http localhost 8800 pblicense main license php PBlicense 1 6 License Generator Configuration Editor License Generator License Manager File Integration License Information Customer name Peter Example Customer organization Example Inc Customer email address peter example com Product name PBlicense 1 xxxx License duration 30 days License file link 190711075657 pbl Send email to customer Create another license Licensee Peter Example PB Soft Copyright 2011 PB Soft If you see the green banner the license was created successfully PBlicense 1 6 License Generator Home Configuration Editor License Generator License Manager File Integration Page 83 of 113 PBlicense User Manual lf there was an error while creating the license you will see a red banner PBlicense 1 6 License Generator Home Configuration Editor License Generator License Manager File Integration In case of an error additional information will be displayed like an error message and a lot of debug information configurable _ PBlicense 1 6 PHP Software Licensing S _ http localhost 8800 pblicense main license php S Gi E v Google a EE PBlicense 1 6 License Generator Configuration Editor License Generator License Manager File Integration The following errors were found The footprint does not match the pattern Back to the input form Step 1 Footprint from the form k4R
3. Numeric value You can use an x at any position to keep the permission the original files have Recurse into subdirectories Apply to all files and directories Apply to files only Apply to directories only Page 15 of 113 PBlicense User Manual Please be sure that the checkbox Recurse into subdirectories is NOT selected Recurse into subdirectories Then open a webbrowser and enter the path to the PBlicense installation file install php The installation script will backup an existing installation unpack the new PBlicense application and if there are no errors a Link to the PBlicense Main Menu will be displayed Firefox j egen _ PBlicense 1 6 Installation a ege aile Page 16 of 113 PBlicense User Manual If there are errors during the installation the screen will display the error messages like on the example below If that happens please first check the write permissions of the directory _ PBlicense 1 6 Installation http localhost 8800 install php s 1 d Google tf EI PBlicense 1 6 Installer The directory pblicense was successfully backuped to pblicense_01 zip The directory pblicense could not be deleted f If there is an existing installation of PBlicense at the same location the installation script will make a backup and save the whole installation to the file pblicense_01 zip the number can vary _ PBlicense 1 6 Installation
4. d d 127 0 d d d d o d CO OO OO OO OO OO CO H bb bb bb fub fub pud k k Page 86 of 113 PBlicense User Manual 21 License Manager The license manager shows all created licenses and the most important client data To view information about the existing license files please click on the link License Manager on the link panel The following window will be displayed EN WW PBlicense 1 6 PHP Software Licensing S Firefox J gt http localhost 8800 pblicense main manager php language en EPT als gt Google PBlicense 1 6 License Manager Configuration Editor License Generator License Manager File Integration Number of licenses 11 License Information License 190711080645 190711075657 190711075645 190711075309 130711033351 110711013253 110711012825 110711005303 050711232939 050711213858 050711204731 Username Peter Example Peter Example Peter Example Peter Example Max Muster Rolf Tanner Karl Keller Martin Hauser Harry Turner John Walker John Walker Organization Example Inc Example Inc Example Inc Example Inc MaxTech AG Rolf Inc Keller Marketing GmbH Hauser AG Turner Corp John s Pub John s Pub Email peter example com peter example com peter example com peter example com max maxtech com rolf xyz com kari keller com martin hauser com harry turner net john walker com john walker com Product PBlice
5. m be _ http localhost 8800 install php HG d Google tf EI PBlicense 1 6 Installer The directory pblicense was successfully deleted The PBlicense installation was completed successfully The following link will take you to the main menu PBlicense Main Menu Page 17 of 113 PBlicense User Manual If you click on the link to the PBlicense Main Menu the installation script install php and the installation archive pblicense zip will be removed and a message will inform you about the success of this operation rex Firefox e PBlicense 1 6 Status OB Eda After 10 seconds you will be forwarded to the PBlicense Main Menu like on the following image Firefox e Page 18 of 113 PBlicense User Manual 5 3 Check Directory Permissions Just to be sure check the directory permissions for the following two directories This directories need to have the permissions set to 777 to have write access for the configuration and export files e pblicense configuration e pblicense export Make sure that here you apply the permissions recursively That means that all subdirectories also will have the permissions set to 777 With the Filezilla FIP client you can set the permissions in a special window Change file attributes Please select the new attributes for the selected directories Owner Permissions Page 19 of 113 PBlicense User Manual After setting the permission
6. the screen size and the test patterns for the user input verification Normally these parameters dont have to be changed footprint css This is an additional cascading style sheet If you want you can modify this CSS file and change the appearance of the footprint generator This file is not necessary to run the footprint generator If the footprint generator does not find this file he will use his built in CSS style but if this file is available in the same directory like the footprint generator it will be used instead of the built in styles This file is located in the directory pblicense export footprint title gif This is an additional graphic file so that the title of the footprint generator looks nicer You also can create your own background file for the footprint title It just has to be a file with the following properties File format gif Height in pixel 60 Width in pixel 1 This file is not absolutely necessary If the footprint generator does not find the file he will show the title without the title graphic Here you can see the difference Title without the graphic file PBlicense Footprint Generator 1 0 Title with the graphic file PBlicense Footprint Generator 1 0 Page 91 of 113 PBlicense User Manual This file is located in the directory pblicense export footprint table gif This is an additional graphic file so that the table headers of the footprint generator look better Yo
7. 6 License Generator Configuration Editor License Generator License Manager File Integration Footprint License Options Start date 19 07 2011 Software grade Standard End date 30 Debug information Liste der Access Codes anzeigen access_code cfg Go to the trial frontend Licensee Peter Example PB Soft Copyright 2011 PB Soft Page 57 of 113 PBlicense User Manual lf there is a problem and therefore the license is not valid the following screen is displayed CU ui pd Sel _ PBlicense 1 6 PHP Software Licensing S i J gt http localhost 8800 pblicense main license php 7 d Google PBlicense 1 6 License Generator Configuration Editor License Generator License Manager File Integration There is no valid license available No license file found You have three choices to get this software to work 1 You would like to test PBlicense with a trial license If you would like to test PBlicense please use the Footprint Generator to create a system footprint of your host and send it to us from the form or via normal e mail We then will send you a free trial license via e mail Please also check the PBlicense User Manual for information about unlocking the software 2 You would like to purchase a full version of PBlicense If you would like to purchase PBlicense please go to the Codecanyon Website and buy our software Then use the Footprint Generator to cr
8. Generator onori 80 20 1 Create a NCCNSS HE marenie a ere 81 20 2 SENG LICENSE E 87 21 License Manage EE 88 SE LICENSE IMTOTIMAUON nersini ar EedEeg 88 22 VIEW a LICENSE FIC nonar iA 89 22 Une lg EE 90 221 Geier E 91 22 2 NIDS EE ege 94 ZZ Meel ei 95 23 COGGE ATS GF Atl ON EE 96 29 1 Display Ne PHP e e EE 96 23 2 Customize your Configuration Eie 98 23 3 Customize your Application Ee 98 23 4 License Information Array cccccccceccceceseeeceeeeeeceeeeseeeeeesseeeaeeesees 102 2A RK EE 103 24 1 PBIICENSE Frontend 103 24 2 LICENSE ANAlYSIS Ke Le RE 105 a oke e e 105 le lez BOILING le Dt de EE 105 tko AMON Z ONAN e 108 29 BACK D EEN 109 260 BUYING PBIICCNS Cs scscsenvece EE ee Eege 110 ZU le EEN 111 ZA ADACNE E EE 111 E CIN ENON ANY EE 111 21 Pile 2 ACK let 112 ZA Ae AOTC RE E EE 112 29 SUPPONI riranin EE 113 29 e e Te EE 114 Page 5 of 113 PBlicense User Manual Dear customer Thank you for using PBlicense We are sure that this software will be very useful to you and that you really will like it This manual will show you how to get started with PBlicense It provides detailed step by step instructions so that it will be easy for you to learn how to use the application First it will describe the system requirements installation steps and also detailed problem solutions in case that there are troubles during the setup Later it will explain how to unlock the software and you can see how the lic
9. Manual The shortcut CTRL SHIFT Z will test the webserver configuration httpd conf and will display error messages if the syntax in the configuration file is not correct e C Downloads PBlicense apache exe Syntax error on line 3 of C Downloads PBlicense conf httpd conf a Invalid command Timeoute perhaps mis spelled or defined by a module not inclu ded in the server configuration Mote the errors or messages above and press the lt ESC gt key to exit amp If the black command window just opens and closes again the webserver configuration is correct Normally the webserver configuration should not contain syntax errors but if you edit the webserver configuration file httpd conf this is a good way to check the functionality before starting the webserver The next five shortcuts open different directories with the windows explorer CTRL SHIFT E opens the PBlicense export directory All files generated by PBlicense like the code configurations licenses and logs and also the necessary files to include in your own projects like the footprint generator and the validation engine will be stored there CTRL SHIFT M opens the PBlicense main directory This is the place where you have to copy your valid license file CTRL SHIFT T opens the PBlicense test directory Here you will find some small test applications which can be used to test and understand the way the PBlicense application wo
10. Menu you will see the links Create New User To create a new user account press this link Copyright 2012 PB Soft PBlicense 1 6 Build 60 reate New U The Add New User form will be displayed and you can insert a new username and a corresponding password PBlicense 1 6 New User Copyright 2012 DD Soft PBlicense 1 6 Build 60 The password has to contain characters and numbers and has to be at least 6 characters long Passwords like j3yS94j 12Tau ab or Re35tOol are valid Passwords like peter 12042012 or rolf are not valid Page 39 of 113 PBlicense User Manual You have to enter the new password twice Field Password 1 and field Password 2 to be sure that there are no typing errors If the password is not valid an error message will be displayed Errors The password does not contain any characters _ GoBack If the new username and password are correct the new user account will be created If you have created the first new user the default user Admin will be deleted automatically for security reasons The default user is the same on all PBlicense installations and therefore has to be eliminated An information screen will be displayed If you press the button Login with the new user you wil be transfered to the login screen where you have to login with the new username and password Page 40 of 113 PBlicense User Manual If you later
11. Overview with information about the licensee current installation and with links to the logfile and to the footprint generator Configuration Editor The configuration editor is used to create edit or delete product configurations You can use the configuration editor to create a new configuration for one of your new products if you want to change some settings of an existing product or also if you want to delete an old configuration which you don t need anymore License Generator The license generator is used to create license files You can use it if someone requests a license file and sends you a system footprint of his installation Then you can create a new license file and send it directly back to your customer License Manager The license manager shows you an overview of all created license files You can view or download each of the license files File Integration The file integration page shows you all files which are necessary for your projects There are project files and product files You can download the files you need and also get the php code to integrate the PBlicense software into your application or projects Page 63 of 113 PBlicense User Manual 18 PBlicense Home If you start the application you will see the PBlicense Home PBlicense 1 6 Home Configuration Editor License Generator License Manager File Integration Licensee name Licensee organization PBlicense version PHP vers
12. Script filename server server name localhost A4 Server name server server addr 27 0 0 1 A4 Server address Sserver document root 2 www f f Document root Senv term not available Server environment EF a ee Specify the application user and organization This data is entered by the user into the configuration file ff Sass s sss Scheck 0 John Walker A4 Username Scheck 1 John s Pub Organization A end Specify the necessary data from the protected script This data is f normally inside the code of the protected script itself und is encoded The user does not knor this data EE Scheck 2 Calculator f Product name Scheck 3 1 2 d Product version Scheck 4 2 IP adress range Scheck 5 1 Version range Scheck 6 1111100000 d Option flags Scheck 7 Sdui4tstTezh4eTiztgqghTT3u47erftrtQtT Product key PE EE EEN Specify the script path of the protected script You are testing the license with the licensecheck script and maybe you use not the same path like the protected application ff Scheck 8 if Z www calculator Used script path Specify the md5 hash of the validation engine if evalidate md5 hash cbc1l1318 741416a56b53d2e75c6ele4 Z7 MDS hash Za Page 105 of 113 PBlicense User Manual Line 15 19 specifies the server variables which have to match the settings of the webhost whe
13. add some other users the following screen will be displayed lf you press the button Go Back you will get to the Add New User form Then you can add another new user or press the button Go Back to go to the main menu 12 Logout from PBlicense To logout from the PBlicense application press the link Login on the main menu Copyright 2012 PR Soft PBlicense 1 6 Build 60 Create New User Logout E You will get to the User Login screen and you can login with another username and password Page 41 of 113 PBlicense User Manual 13 PBlicense Main Menu The PBlicense Main Menu provides access to different tools which will be explained on the next few pages PBlicense 1 6 Main Menu Host localhost 8800 Links Same Window Copyright 2012 PB Soft PBlicense 1 6 Build 60 Add New User Logout Per default all the links and therefore tools will be opened in the same browser tab If you want to open them in a new browser tab please first click on the link Same Window The link will change to New Window and all links will open in a new browser tab PBlicense 1 6 Menu Will change to PBlicense 1 6 Menu Host localhost 8800 Links New Window E Page 42 of 113 PBlicense User Manual 13 1 PBlicense Main Application The PBlicense main application is used to create new product configurations using the Configuration Editor generate license files
14. if the PBlicense application works on your host Page 22 of 113 6 2 PBlicense User Manual Zend Optimizer not installed Check if the Zend Optimizer or the Zend Guard Loader is installed on your server A Zend decoder is necessary to run files encoded by one of the Zend encoders and it also can increase the runtime performance of the PHP scripts If no Zend decoder is installed on the host or if it is not running correct a message window will indicate the problem Depending on the running script the information window can provide more or less information on solving the problem The following image shows a screen with only few information gt 1 http localhost 8800 pblicense main footprint php The Zend Optimizer Zend Guard Loader is not installed correctly This file was encoded by Zend Guard from Zend Technologies Ltd gt Please install or reinstall the free available Zend Optimizer version 3 0 0 or later on your webserver The next screen shows detailed information about the problem LI http localhost 8800 pblicense There is a problem with the Zend Optimizer This file was encoded by Zend Guard from Zend Technologies Ltd The name of this Host is localhost 127 0 0 1 8800 The name of this PHP script is index php The script path is D Work PBlicense_Devel wwwipblicense You are running PHP version 5 2 17 This script needs PHP version 5 2 xx or LOWER You have a COM
15. license will be created and the user can save the license file to his local computer or display it in a new browser tab window Firefox _ PBlicense 1 6 Frontend gt _ http localhost 8800 pblicense front frontend php v C A v Google Trial License Generator License Information Trial License Your name Max Muster Your organization Muster Inc Your email address max muster com Product name PBlicense 1 xxxx License duration 30 days License file download 190711202958 pbl Back Powered by PBlicense 1 6 Copyright 2011 by PB Soft Page 103 of 113 PBlicense User Manual 24 2 License Analysis Tool Overview The License Analysis Tool can be used to check an existing license file get information about the validation process and see what is the problem if an error occurs during validation This tool consists of the following files e analysis php e application cfg e validate php XXXXXXXXXXXX pbl main script to analyze license files emulates the customer computer validation engine for testing MD5 hash license file which has to be checked ED ON Because normally we can not analyze the customers license on the customers computer we have to emulate or override the settings the customer computer provides for creating a system footprint The configuration file application cfg allows us to specify exactly the same settings like the customer computer
16. soft com Firefox _ PBlicense 1 6 Software Requirement Ch be http localhost 8800 check php e This script will check if the actual server meets the necessary software requirements to run PBlicense 1 6 PBlicense is a PHP Software Licensing System from D Soft For more information about the software please visit our Website 1 PHP version JK The current PHP version is 5 2 17 2 Operating system The current operating system is Windows NT 6 1 4 Zend Optimizer version The Zend Optimizer version is 3 3 3 5 Zend Guard Loader installation The Zend Guard Loader is not installed 7 Mcrypt version The Mcrypt version is 2 5 7 8 Mcrypt algorithm The Mcrypt Blowfish algorithm is supported 9 Mcrypt mode The Mcrypt CBC mode is supported There was no error and it seems that the actual server meets all the software requirements to run PBlicense Please install a trial version of PBlicense to check if everything works ok BEFORE YOU BUY A LICENSE For more information please visit our website at www pb soft com You also can see the actual host configuration with phpinfo Thank you for evaluating software from PB Soft Page 7 of 113 PBlicense User Manual You can also use the little checklist below and see if your hard and software meets the specific needs 2 1 Hardware e Host computer e Client Computer e Network which connects them 2 2 Software Host e Linux Uni
17. the Home page of the PBlicense application There you can see the licensee name and organization PBlicense Information Then on the same page but a little bit below you can see a link to the active license file Directory of the license file CUP Blicense www pblicense main License file in use License valid from 09 07 2011 License valid until 04 01 2012 Please click on this link and the content of the license file will be displayed f f Licensed to the following Username sername yay i Example ff Licensed to the following Organization Organization PE Soft Now check if the username and organization is the same as displayed on the Home page If the username and or the organization is are different change the data in the configuration file Page 60 of 113 PBlicense User Manual 16 4 Check the Product Name and Software Version Check if the product name and the software version in the license file match with the software you want to run in our case it is the PBlicense software First look on the Home page of the PBlicense application There you can see the software name and also the software version PBlicense Information Licensee name Peter Example Licensee organization PB Soft Then on the same page but a little bit below you can see a link to the active license file Directory of the license file CUP Blicense www pblicense main License file in use License valid fr
18. the requirements to run PBlicense without problems PBlicense 1 6 Software Requirement Check Mozilla Firefox File Edit View History Bookmarks Tools Help EA PBicense 1 6 Software Requirement Check localhost 3800 pblicense check php d Google This script will check if the actual server meets the necessary software requirements to run PBlicense 1 6 PBlicense is a PHP Software Licensing System from PB Soft For more information about the software please visit our Website There was no error and it seems that the actual server meets all the software requirements to run PBlicense Please install a trial version of PBlicense to check if everything works ok BEFORE YOU BUY A LICENSE For more information please visit our website at www pb soft com You also can see the actual host configuration with phpinfo Thank you for evaluating software from PB Soft If all status indicators are green there should be no problems to run PBlicense If an indicator is red you can get some information about the failing component Please try to install update this component or contact your webmaster Page 48 of 113 PBlicense User Manual 14 PBlicense Configuration 14 1 Edit the main Configuration File Attention If you use the PBlicense software in trial mode don t change the username and organization data in the configuration file just use the existing example username and organization Please open the file pbl
19. the path configuration file pblicense configuration path cfg Please search for the following entry line 90 fo SSSSSS SSS SSS SS SS SSS SSS SS SS SS SS SS SS SS SS SS SS SSS SS SSE Define the path to the product encryption key file ff SSSSSS SSS SSS sss SSS SSS SSS SS SSS SSS SSS SSS SS SS SSS SS555 detine Bi DIR Key 7 define KEY PATH ABS SITE PATH ABS KEY DIR That s it Now you can save and upload the configuration files to your webserver Page 52 of 113 PBlicense User Manual 15 Unlock the Software Now the PBlicense installation should be OK and the PBlicense software is running with the trial license With the trial license you can test the PBlicense application for at least one month before you have to decide if you want to buy the software If you need more time to evaluate our product please contact us Please make sure that you use a trial license first to check if the PBlicense application works on your host If you have tested PBlicense with the trial license and decided to buy a license you have to get a valid license file to unlock the software Please first make a system footprint with the help of the footprint generator The following steps will explain this process 15 1 Generate and send the Footprint Please click on the link PBlicense Footprint Generator on the PBlicense Main Menu Host localhost 00 Links Same Window d Copyright 2041 PB Soft PBlicense 1 6 B
20. the x mailer content line 117 fo SsSsssss sss sss sss SSS SSS SSS SSS SSS SSS SS SSS SSS 5555555 fo SsSsss sss sss SSS SS SSS SSS SSS SSS SSS SSS SS SSS SSS 5555555 Sxmailer PBlicense 1 6 www example com Page 51 of 113 PBlicense User Manual 14 3 Create new Product Keys Each product script application needs a unique product key This is necessary that someone else who uses PBlicense can t make license files for your products and it also is used as the encryption key for the license file So the product keys have to be at least 20 characters long and please keep them secret Please open the file pblicense key key cfg in your favorite text editor and enter some new product keys into the key file fo SSSSSS SSS SSS SSS SSS SS SS SS SS SSS SS SS SS SSS SSS SSS SSS SESE Product encryption keys minimum length 20 74 characters fo SSSSSS SSS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SS SS SS SSS SSS 123456789012345607 890123456789 sproduct key 1 S370 ggf Cu EC ha 4st 40 produer key Z Ogkt 90587433 ew8723hd8744re8 You can enter all the 10 keys or just one or two But remember You need product keys to create new product configurations For each of your product you need to have a product key Attention Please be sure that nobody can access your key file via Internet or another network You also have the possibility to store this important file outside the document root and then specify the path in
21. using the License Generator display information about existing licenses using the License Manager and include the PBlicense components into your own projects using the File Integration area _ PBlicense 1 6 PHP Software Licensing S gt http localhost 8800 pblicense start php language en dr el KI Google Configuration Editor PBlicense 1 6 Home License Generator License Manager File Integration Licensee name Licensee organization PBlicense version PHP version Zend Engine version Zend Optimizer version Zend Guard Loader version Mcrypt version Server IP address Client IP address More information License logfile Create a PBlicense footprint Directory of the license file License file in use License valid from License valid until PBlicense user manual Active language English PBlicense Information Peter Example PB Soft 1 6 Build 54 for PHP 5 2 xx 5 2 17 2 2 0 3 3 3 Not available 2 5 7 127 0 0 1 8800 localhost 127 0 0 1 PHPinfo license_0711 log 2 44 KB Footprint generator D Work PBlicense_Devel wwwi pblicense main 090711005020 pbI 09 07 2011 04 01 2012 PBlicense_en pdf Change to German Licensee Peter Example PB Soft Copyright 2011 PB Soft Please check the special chapter about using the PBlicense main application Page 43 of 113 PBlicense User Manual 13 2 PBlicense Fro
22. was selected the validation engine will check this name against the name specified in the encrypted license string Code line 6 The application version which is hardcoded is added to the array check on position 3 If the application version option was selected the validation engine will check this version against the version specified in the encrypted license string Code line 7 The IP address range which is hardcoded is added to the array check on position 4 If the server address option was selected the validation engine will check the server IP address with this range against the IP address specified in the encrypted license string Code line 8 The version range which is hardcoded is added to the array check on position 5 If the application version option was selected the validation engine will check the application version with this range against the version specified in the encrypted license string Page 98 of 113 PBlicense User Manual Code line 9 The option flags which are hardcoded are added to the array check on position 6 Specifies which configuration options will be checked by the validation engine 1 means enabled and O means disabled Code line 10 The product key which is hardcoded is added to the array check on position 6 The product key is used as the encryption key for the license file and always has to be encoded Code line 11 The MD5 hash which is hardcoded is stored into the vari
23. 1 by ionCube Ltd and with Zeng tension Manager 2 70 Copapioabt ex OI ZOU me Send Leach ologies lf there is no Zend decoder like Zend Optimizer or Zend Guard Loader installed on your host please download a free copy from the Zend Website http www zend com and install it Page 24 of 113 PBlicense User Manual 6 3 Wrong Zend Optimizer Version Check if the correct Zend Optimizer or Zend Guard Loader is installed on your server If your version of the Zend Optimizer is too old you will get an error message like Fatal error Incompatible file format The encoded file has format ID 2003120701 whereas the Optimizer can read up to 2002062301 or something like Fatal error Unable to read X bytes in path to script encoded script php on line 0 or something like Fatal error Maximum execution time in path to script encoded script php on line 1 If you have an old version of Zend Optimizer or Zend Guard Loader installed on your host please download a new version from the Zend Website http www zend com and install it Page 25 of 113 PBlicense User Manual 6 4 Other Zend Optimizer Problems The following output from the phpinfo function displays three important settings which will be explained below If one of these settings is wrong the Zend Optimizer will not run on your host Normally these settings are correct if you are using a third party webhosting service Please verify that the foll
24. 1 6 License Generator Home Configuration Editor License Generator License Manager File Integration There is no valid license available No license file found The displayed message will inform why the license verification has failed Please check the following steps to ensure that the installation is correct 16 1 Check if there is a License File available Check if there is a license file available in the directory which is displayed on the Home page If there exist no license file copy the license file to that directory and try again Directory of the license file CuUPBlicense www pblicense main 16 2 Check the Number of Licenses Check if there is only one license file available and that the file has the format xxxxxxxxxxxx pbl whereby the x s are numbers As an example the license filename could be 061205180528 pbl If there is another license file move it to another location or delete it len A lt pblicense main 4 Search ma Organize FE H ei 090711005020_pbl E footprint php S table gif debug php 8 highlight php Sc title git E editor php E index php E validate php E export php E license php EP footprint ctg EP manager php __ footprint ge E product_l php Page 59 of 113 PBlicense User Manual 16 3 Check the Username and Organization Check if the username and organization on the PBlicense Home page is the same like the one specified in the license file First look on
25. 1 as the start date and 26 12 2011 as the end date This license then would be valid for 3 days Page 80 of 113 PBlicense User Manual End Date As second option you have to specify the license duration or end date You can use the following format DD MM YYYY end date End date 19 08 2011 or DD license duration in days End date 30 If you use the first format the license will be valid until this date If you use the second format the license will be valid for the number of days you enter If today is January 6 and you enter 11 then the license will be valid until January 17 If you enter a character the license duration will be unlimited End date Software Grade As the third option you can specify the software grade With that parameter you can specify different editions of the same software product Here is an example With the Software grade Standard the user can add a maximum of 20 rooms for his hotel in your software Hotel Manager With the software grade Deluxe the user can add a maximum of 100 rooms for his hotel in your software Hotel Manager and has the possibility to make online reservations Page 81 of 113 PBlicense User Manual You can specify your own names and you can later check the actual software grade from your application Software grade Standard Software grade Deluxe Debug Information As the fourth and last option you can select the checkbox to see debug inform
26. 3a24659 Please copy your footprint and register the software You can send your footprint directly to PB Soft Back to the input form lf you think something went wrong maybe you misspelled the organization name you just can go back to the input form by pressing the link Back to the input form and create a new footprint You can create as much footprints as you want If you think your input data is correct you can send us the created footprint so that we can create a personalized license file for you lf your webhost supports the sending of e mails through the integrated php mail function you can send us the footprint by pressing the button Send now Page 55 of 113 PBlicense User Manual A message window will tell you if the e mail with the footprint was sent successfully eer ll Seel ERT PBlicense Footprint Generator 1 6 g BA http www pb helpdesk com pk M E CA Google PBlicense Footprint Generator 1 6 Copyright 2011 by PB Soft www pb sofi com The email to PB Soft was sent successfully You also will receive an email receipt Back to the input form lf your webhost does NOT support the sending of e mails through the integrated php mail function or there was an error during the sending process you can also send us the footprint code by e mail Just copy the footprint code into an new e mail and send it to the following e mail address support pb soft com After we got you
27. Configure Command section on Windows Unix and Linux hosts LAL Configure E mnaaga contig IS enabdle sna Command SI oshot template d php sd ap _ 2Wwe6luS6ltemplate _with php build d php enable debug p sdkisnap_5 2wcb we6iphp_build with pdo oci D php sdkioraclelinstantclient10 isdk shared with oci D php sdkioraclelinstantclientiO sdk shared without o web Page 27 of 113 PBlicense User Manual 6 5 Wrong File Transfer Mode If you upload all the files manually without the PBlicense installer script to your webserver you have to be sure that you upload nearly all php files in Binary Mode please see the exceptions in the list below That does not mean that you upload all files in binary mode because there are different kinds of files like pictures text files or CSS files Not all the files have to be uploaded in the same mode Normally you can choose the file types which are uploaded in binary mode and which are uploaded in ASCII mode Please check the settings of your FTP Client If you upload the encoded files in ASCII mode you will get errors like Fatal error Unable to read bytes in path to script encoded _ script php on line 0 or something like Fatal error Corrupted encoded data detected in path to script encoded _script php on line 0 Then please delete the encoded php files on the server and upload them again in binary mode Normally you can specify the transf
28. PATIBLE version of the PBlicense Script installed With this PHP version 5 2 17 you need the Zend Optimizer version 3 0 0 or higher to run this script There was NO DECODER PRODUCT found on your webserver gt Please Download and install the free available Zend Optimizer version 3 0 0 or higher on your webserver Please check the PHPinfo Output to make sure that the Zend Optimizer is really loaded gt Please make sure that you upload the encoded files with the BINARY file transfer mode gt Please also check the PBlicense User Manual for more information Page 23 of 113 PBlicense User Manual You can also check the phpinfo output to check if the Zend Optimizer is installed and enabled or you can ask your hosting provider If you check the phpinfo output you should search for a text similar to the following important text marked red This program makes use of the Zend Scripting Language Engine Zend Engine v2 2 0 Copyright c 1998 2010 Zend Technologies with Zend Extension Manager v1 2 0 Copyright c 2003 2007 by Zend Technologies with Zend Optimizer v3 3 3 Copyright c 1998 2007 by Zend Technologies The following image shows this part from the phpinfo output and how it should look on your host This program makes use ofthe Zend Scripting Language Engine fend Engine v2 2 0 Copyright c 1998 2010 Zend Technologies with the ionCube PHP Loader v4 0 7 Copyright c 2002 201
29. PBlicense User Manual Version 1 6 5 June 2012 22 00 Copyright 2012 PB Soft PBlicense User Manual Content TMOG U GUO WN EE 8 2 System e HE INC EE 8 ee Bo lee 9 22 SOMW ale e e EE 9 2 3 SONWANE TEE 9 E lee E ALON WEE 9 3 INSTAIALION TY E 10 el TYDE Te LOCANOS ee 10 3 2 Type 2 External Webhoset AA 10 4 SOMWare Download stees See 10 4 1 Download the PBlicense Tralvereion 10 4 2 Buy and download the PBlicense Full Version 10 5 Software NEE E de ENEE 11 5 1 Type 1 Localhost A 11 5 2 Type 2 External Webhost sciivceecteascceneedee ewan 14 5 3 Check Directory Hermmseons 20 6 instalation Probles aria a eens 22 6 1 System Requirement Hroblems 22 6 2 ZENG Optimizer NOU INSANE WEE 24 6 3 Wrong Zend Optimizer Version 26 6 4 Other Zend Optimizer Problems o nenonnennonnnnsnnnnonnsnrnnsnrerrerrrrerrrren 2 6 5 Wrong File Transfer Mode nirscanerraia a a 29 T CONtLOl Panel obeutaberHtAeeeegeben eerste Eege 30 TBs SONY CTF Ol EE 31 7 2 T XtAPpliCation ccc ccc ceccecceeceececeeeseeceeceeeeeeeeeeeeseeceeceeseeseeegeeseegeees 32 Ti SAVES V VINE EE EE ina needa aaa 32 8 Control Panel Ee LE 33 SA Stan RESA EE 33 O2 6 EE 33 EE 33 oA EE 33 O Elle 34 Page 3 of 113 PBlicense User Manual 9 Start BIC CIS G ininnaanen a aa 37 Sch MES Ee YDE ett 3 GE E Ee A Ke EE 3 LO LOGIN tO PBINGCCNSE E 38 11 Create a EE 40 12 Logout from PBlicense geseet gees 42 13 PBlicense Main Menu
30. SB9Unohgo KN1ix4it41zDWz11nSL9vObOcS 6A9b 63rDgGDKLM6C1LRNBTa38bPuG4kZ2x veLZtAdo ntotS3IKIZGILKRPSw3ZebiSDe2YtFUs4Nw020MvZWiHDBE1ui4490001899W WiLhsySqkK Hugc7E cd0abasccbei5d995e6545033a24659 Page 84 of 113 PBlicense User Manual If everything worked fine you can see the most important client and software data All the data was sent through the footprint so you don t have to enter absolutely nothing License Information Customer name Peter Example Customer organization Example Inc Customer email address peter example com Product name PBlicense 1 xxxx License duration 30 days License file link 190711080645 pbl Send email to customer lf you want you can check the license file by clicking on the link The license file which is a plain text file with an encrypted license key will be displayed in a new browser tab or window q Firefox _ http localhost 880 se 190711080645 pbl PBlicense 1 6 PHP Software Licensing System Copyright 2011 by PB Soft Website www pb soft com This copy of PBlicense 1 6 is registered to Peter Example PB Soft Creation date and time Date 19 07 2011 Time 08 06 45 Username Peter Example II Page 85 of 113 PBlicense User Manual 20 2 Send a License File Now you can send an e mail with the attached license file directly to your customer with just one mouse click Please press the button Send now to send the license file
31. SaveWinPos 0 and change it to SaveWinPos 1 After this change you only have to restart the control panel You do NOT have to delete the application path and update the whole configuration Page 31 of 113 PBlicense User Manual Control Panel Usage The PBlicense control panel is only needed to manage the webserver of the installation type 1 localhost Therefore the control panel is not available and needed for the installation type 2 external webserver To start the webserver press the button Start Then the webserver will be started and the status panel changes to green indicating that the webserver is ready Per default the PBlicense webserver will listen on the IP address 127 0 0 1 localhost and port 8800 8 1 8 2 8 3 8 4 Webserver Control Panel DI PBlicense 1 6 Start Restart If the webserver is running the button Start will change to Restart and therefore you can restart the webserver if needed if you press this button Stop The button Stop will stop the webserver but the control panel will still be available You can use this button if you want to stop the webserver and edit a configuration file Menu The button Menu will open the PBlicense User Login in the default webbrowser After you login the PBlicense Main Menu will be displayed Exit The button Exit will stop the webserver if the webserver is running and then exit the control panel Page 32 of 113 PBli
32. Send email to customer The e mail will be sent without the need of specifying the e mail address of the customer You will be informed if the e mail could be sent successfully PBlicense 1 6 License Generator Home Configuration Editor License Generator License Manager File Integration The email was sent successfully Create another license Licensee Peter Example PB Soft Copyright 2011 PB Soft The license creation is also logged to the license logfile To view the logfile please click on the link Home on the link panel There you will find the link to the license logfile License logfile To view the logfile please click on the link and the logfile will be displayed in a new browser tab or window i Firefox x M _ http localhost 880 log license_0711 log _ http localhost 8800 pblicer GI Google P AlE 127 0 127 0 127 0 127 0 127 0 05 07 2011 20 47 31 050711204731 pb1 05 07 2011 21 38 58 050711213858 pbl 11 07 2011 00 53 04 110711005303 pbl 11 07 2011 00 56 03 110711005603 pbl 11 07 2011 01 15 19 110711011519 pbl 11 07 2011 01 20 56 110711012056 pbl l l l l l l 127 0 127 0 127 0 11 07 2011 01 28 25 110711012825 pb1 11 07 2011 01 32 53 110711013253 pb1 19 07 2011 07 53 09 190711075309 pb1 127 0 127 0 127 0 19 07 2011 07 56 45 190711075645 pb1 19 07 2011 07 56 57 190711075657 pb1 19 07 2011 08 06 45 190711080645 pb1 l d d d
33. _ PBlicense 1 6 PHP Software Licensing S L http localhost 8800 pblicense main editor php S PBlicense 1 6 Configuration Editor Configuration Editor License Generator License Manager File Integration The configuration was saved agproduct_5 cig The codefile was saved ag product_3 code Generated PHP Code Long version PHP code file for Calculator 2 0 Created 19 07 2011 04 32 40 Include the username and organization from your configuration file In this example we use the variables Susername and Sorganization from our example file called configuration php Li include once configuration php Show highlighted version Licensee Peter Example PB Soft Copyright 2011 PB Soft The first link shows the configuration for the actual product The configuration was saved as product 3 cfg The product configuration is necessary to create a footprint with the footprint generator This configuration indicates what data the footprint generator has to collect and include in the footprint code This file should be encoded before it is distributed with your application Page 71 of 113 PBlicense User Manual An example of a product configuration is shown here ff Product configuration file for Calculator 2 0 if Created 19 07 2011 06 39 03 if ff Specify the product details if Sproduct name Sproduct version Sscript name product id faddress range Sversion range Ca
34. abb1af4f0562f4dd7f2ec7d3b54874f 4 94 94d349ca1ec4fa518e0a83ict784e914 3ccbcbadccf08b7731a45720360f57c6 0b5401bf5ff56c1ec21b77764783ec6s 3ec8e44fd24455c22a42064a17b1a104 65ba50d937011293f9a0d865824dc5ed 56a91008835f055b616151259cde9168 4ba52a84b49cbe831f78fce1bda34a2a 593dc3c7bd701e0dff3f290ect3ac7b7 5fe4ebd4514f4ed6ccb7307f3aa66f20 DJ Obed ed CHAT ZC D I access_check php include access_code cfg cfg configuration analysis php analysis application cfg analysis application cfg analysis calculator application cfg analysis tinyapp application php test application php testiappl_long application php testiappl_short code_create php include code_show php include code_write php include config_check php include config_copy php include config_create php include config_delete php include config_edit php include config_select php include config_write php include configuration php test debug php main download cfg configuration download php include editor cfg configuration editor en language editor ge language CON DOH Ff WH E If you want to remove this tool from the system and from the main menu you only have to delete the file phpview php in the directory pblicense The button PHPview Tool then will be removed from the main menu Page 47 of 113 PBlicense User Manual 13 7 Requirement Check Script The Requirement Check Script will display information about the actual webhost and check if the installation meet
35. able md5_hash Before the script checks the license file it checks if the validation engine was not modified and the MD 5 hash is correct If the validation engine hash does not match the application will not run Code line 12 Check if the MD5 hash of the validation engine validate php match the MD5 hash stored in the variable md5_ hash Code line 13 Begin of the code block which is executed if the MD5 hashes match Code line 14 Include the validation engine validate php into the application Code line 15 Set the license status to zero For security reasons the license status is set to NOT VALID before the license will be validated Code line 16 Call the validate function to check the license file and store the result into the array data Code line 17 End of the code block which is executed if the MD5 hashes match Code line 18 Check if the license status in valid Page 99 of 113 PBlicense User Manual Code line 19 Begin of the code block which is executed if the license status is valid Code line 20 Execute the code of your PHP application Code line 21 End of the code block which is executed if the license status is valid Code line 22 End of the PHP script Attention Be sure that your php application which contains this or a similar code is ALWAYS ENCODED Page 100 of 113 PBlicense User Manual 23 4 License Information Array The validation engine always returns an array
36. also can specify the transfer mode but maybe the menu looks a little bit different Please make sure that you do not select the transfer mode Auto because normally the automatic mode will transfer PHP files as text files ASCII and that is bad in our case It has to be the binary transfer mode After uploading the file to the webserver make sure that the installation script install php has the permissions to write to the actual directory You can set the folder permissions to 777 to be sure that the script has write access to install the PBlicense application After the installation you can set the permissions back to what they were before Page 14 of 113 PBlicense User Manual With the Filezilla FTP Client you can set permissions in a really easy way You can right click on the desired directory and choose File permissions from the context menu like on the image below Mwai ht A Download _ fav Ae Add files to queue ind Enter directory Lal oo life pee Wee T IT pbi Vie rok Create directory Refresh Delete Rename Copy URL Gel to clipboard File permissions Select A new window will show all the permission settings Please choose 777 and click on the button OK Change file attributes Please select the new attributes for the directory www Owner Permissions Read Write Execute Group permissions Read Write Execute Public permissions Read Write Execute
37. an replace the green part with the path to your webhost domain and then the path to your PBlicense directory http www mydomain com pblicense_dir main menu php As an example the direction to the PBlicense directory entered in the Firefox browser 1 PBlicense 1 6 Mozilla Firefox File Edit View History Bookmarks Tools Help A PBlicense 1 6 d i CO Fi E e LI aj anem ni U l The User Login screen will be displayed in your webbrowser Page 36 of 113 PBlicense User Manual 10 Login to PBlicense lf the User Login screen is displayed you can login with the default username and password PBlicense 1 6 User Login Please use this default login data and then create a new user Username Admin Password testi Copyright 2012 DR Soft PBlicense 1 6 Build 60 The default login data is only displayed on the login screen if you did not already create a new user You can login with the default login data Username Admin Password test12 Please be sure that you enter the password exactly like showed above The passwords are always case sensitive Page 37 of 113 PBlicense User Manual If the login is incorrect you will be warned with the following message Errors lf both the username and password is correct the PBlicense Main Menu will be displayed Page 38 of 113 PBlicense User Manual 11 Create a new User Below the last button on the Main
38. ary files for the integration of the PBlicense software into your own project 23 1 Display the PHP code The table PBlicense Product Files list all the product codes PBlicense Product Files No Name Version Configuration PHP Code 1 Calculator 2 0 DL product 1 php DL product_1 code 2 TinyApp 4 5 DL product_ php DL product_ code To download the product code file to your local computer please click on the download link DL on the left side PHP Code product_1 code DL product_ code You will be asked where you want to store the file and you can choose a local folder on your computer Opening product_l code You have chosen to open product_l code which isa code File from http localhost 8800 What should Firefox do with this file Open with Browse Do this automatically for files like this from now on Page 95 of 113 PBlicense User Manual To display the necessary php code for one of your products please click on the product code link product_x code on the right side PHP Code DL product_ code The product code for the specified product will be displayed and you can copy the php code into your application i vk http localhost 8800 pblicense main highlight php hfile D 3A 2FWork 2FPBlicen A8 Google EE File product_1 code PHP code file for Calculator 2 0 Created 19 07 2011 06 58 02 Include the username and organizati
39. ation Normally that is not necessary and you can leave the checkbox unchecked default Debug information E If you enable the Debug Information checkbox you will get a lot of debug information when creating the license file Firefox 7 EE x 1 _ PBlicense 1 6 PHP Software Licensing gt _ http localhost 8800 pblicense main license php 4 Step 1 Footprint from the form k4RSBSUnohgo KN1x4it41zDWz1l1inSL9vObOcS6A9b 3rDgGDKLM 6C1IRNBTa3sesbPuG4kZ2x veLZtAdo ntotsSssJKIZGILKRPSw3ZebiISDe2YtFUs4Nw020MvZWiHDBE1ui4490001899W WiLhsySaqk Hugc7E cd0aba4secbei5d995e65450633a24659 Step 2 Footprint without seperator initialization vector and md5 hash k4RSB9Unohgo KN1x4it41zZDWzZ11nSL9vObOcS6A9b63 rDgDkLM6C1RNBTa3 bPuG4kZ2x veLZtAdo ntotsSJKIZGILKRPSw3ZebisSDe2YtFUs4NwO020MvZWiHDBEiu String seperator 144490001899WWfLhs Initialization vector ySqK Hugc7E MD5 hash cd0aba4ccbe 15d995e65450633a24659 Decryption key diTggm24908RPcW c473F998 Step 3 Footprint base64 decoded ROO cll sfuc a A Sell yetq ed 86N Toile zs alts lop evils Buer ft B i Ze D sen 6 E0z Alimn Page 82 of 113 PBlicense User Manual To create the license file you just have to press the button Create License ResetForm Create License J The license will be created and you will see the following screen Firefox _ PBlicense 1 6 PHP Software Licensing S J gt
40. ayed e gt LI http localhost 8800 pblicense analysis analysis php bottom validate php cbc11318f741416a56b53d2e75c6e1e4 cbc11318f741416a56b53d2e75c6e1e4 If you want to remove the license analysis tool from the system and from the main menu you only have to delete the directory pblicense analysis The button License Analysis Tool then will be removed from the main menu Page 46 of 113 PBlicense User Manual 13 6 PHPview Tool The PHPview Tool will display information about the files inside the directory pblicense Firefox _ PHP view Version 1 6 be IK http localhost 8800 pblicense phpview php PHPview 1 6 Directory D Work PBlicense_Devel www pblicense a Filename Type Directory Encoded Optimizer Size KB Lines File MD5 hash 3 0 0 3 10 15 7d32a171f36e40ce826ad71d386c89de 1 08 50 27f7d4936b34def2fbd09c11a018d913 3 0 0 21 06 65c5df263b1e1e321b483884b1a0c73d 2 80 14a8f0d99b69f45807627f9380d697d2 2 80 14a8f0d99b69f45807627f9380d697d2 2 80 5f5dd9823898fda9c9652308bdabcd46 4 34 7bb042594ad4cf5bbc82e880a25859bb 4 34 7bb042594ad4cf5bbc82e880a25859bb 0 47 99ab01c9423f2007e3a834c8754adde5 5 44 29b6b844341a63be4a74649d1f19be9c 3 14 29c673ff1fd8f3c7a7ec7d348d2db6af 3 33 d58de56f5bidfedb6e5f6c010e33eafb 4 22 b7536cfde4ecd8db49484d603b8693ea 3 00 426547ed95455a653c7787d5aa786eb 3 48 1bcc67d10f5e891d46ef65dfbeeGbdcd 3 64 e13b93ee4f51956feec43c6f4d9647ab f
41. be checked Example 243 125 38 Range 4 All numbers of the IP address will be checked Example 243 125 38 15 lf your application runs on a server cluster the IP address will maybe change a lot and you can specify just a part of the IP address to be sure that your application will run without any problems Address range Then you can specify the product version range This will define how many decimals after the coma will be checked Here are some examples Example 1 If you specify 0 your customer can upgrade from version 1 0 up to version 1 9999999 Only if the number 1 changes the license will not be valid anymore Example 2 If you specify 1 your customer can upgrade from version 1 0 up to version 1 099999 But 1 1 will not work anymore Example 3 If you specify 2 your customer can upgrade from version 1 0 up to version 1 009999 But 1 01 will not work anymore Version range Page 69 of 113 PBlicense User Manual Then you can specify which options are used to protect your project Username E Script path Organization LI Server name Product name Server address Product version Document root Serer environment aac Script name If you select Username then the username will be checked If you select Organization then the organization will be checked lf you select Product name then the product name will be checked With that option selected the customer can t use the same licens
42. cense User Manual 8 5 Shortcuts There are different keyboard shortcuts available If you press the keys CTRL SHIFT S all available shortcuts will be displayed in a window PBcontro 1 0 Information The following shortcuts are available CTRL SHIFT A gt Shows the actual Apache configuration CTRL SHIFT C gt Shows the actual PBcontrol configuration CTRL SHIFT P gt Shows the actual PHP configuration CTRL SHIFT Z gt CTRL SHIFT E gt CTRL SHIFT M gt CTRL SHIFT T gt CTRL SHIFT W gt CTRL SHIFT Y gt CTRL SHIFT 1 gt CTRL SHIFT gt CTRL SHIFT X gt Checks the apache configuration Explores the Export directory Explores the Mam directory Explores the Test directory Explores the Webroot directory Explores the Analysis directory Shows the application info Shows the shortcut infos Save the window position Thank You for using software from PB Soft The first three shortcuts will open the configuration files CTRL SHIFT A Apache configuration httpd conf CTRL SHIFT C Control panel configuration PBcontrol ini CTRL SHIFT P PHP configuration php ini Normally it should not be necessary to change these configuration files but sometimes it can be necessary especially if you want to use a specialized configuration to fit your needs Page 33 of 113 PBlicense User
43. code 2 TinyApp 4 5 DL product_ 2 php DL product_ code Here is a small description for each of the files and the reason why you need them for your project product_x php This file contains all the product specific information product x for the footprint generator to create a product specific footprint All the configuration settings you made with the configuration editor are saved to this file It would be the best if you encode this file but it s not absolutely necessary lf you do not encode this configuration file your customer can change the settings before creating a footprint The only thing which will happen is that his application never will work because the created footprint will be invalid But it could be a problem if you have to support this case and you don t know that the configuration file was altered by the customer Please download the product file and copy the file to the same directory like your script which you want to protect product_x code This file contains the product specific php code which you have to copy into your application which you want to protect Please see the chapter Code Integration for information about how to integrate the product code into your own project Page 94 of 113 PBlicense User Manual 23 Code Integration To integrate the necessary files into your project please click on the link File Integration on the link panel The following window will display all the necess
44. e file for different products If you select Product version then the product version will be checked With that option selected the customer can t upgrade all the time to the newest version If you select Script name then the script name will be checked With that option selected the customer can t rename the script If you select Script path then the script path will be checked With that option selected the customer cant move the script to another directory If you select Server name then the server name will be checked With that option selected the customer can t move the script to another server if the server name changes If you select Server address then the server address IP address will be checked With that option selected the customer can t move the script to another server if the server IP address changes If you select Document root then the server document root directory will be checked With that option selected the customer cant move the script to another document root If you select Server environment then the server environment Windows Linux Freebsd will be checked With that option selected the customer can t move the script from a Linux server to a Windows server as an example Page 0 of 113 PBlicense User Manual If you have specified all the parameters you can press the button Save configuration to save the configuration and show the generated php code q Firefox
45. eate a system footprint of your host and send it to us from the form or via normal e mail We then will send you your full license via email Please also check the PBlicense User Manual for information about unlocking the software 3 You allready purchased PBlicense and want to unlock the software If you allready have purchased PBlicense please use the Footprint Generator to create a system footprint of your host and send it to us from the form or via normal e mail We then will send you your full license via email Please also check the PBlicense User Manual for information about unlocking the software Licensee Peter Example PB Soft Copyright 2011 PB Soft If you would like to try PBlicense you can get a free trial license for PBlicense and test the software at least one month You only have to create a system footprint with the Footprint Generator and send it to us We then will create and send you a free trial license lf you already have tested PBlicense with a trial license and it worked on your host you can buy PBlicense at the PB Soft Website After buying the software you also have to create a system footprint with the Footprint Generator and send it to us We then will create and send you your personalized and unlimited license Page 58 of 113 PBlicense User Manual 16 Unlock Problems lf you don t see the License Generator you probably will see the following window with an error message PBlicense
46. ebserver Control Panel Version 1 0 copyright 2011 PB Soft Patrick Biegel www pb soft com CONFIGURATION os EC TIO WN Configuration Specify the http port of the webserver Example ServerPort 8800 SserverPort 800 The control panel configuration file PBcontrol ini is directory PBlicense conf PBcontrol ini Page 29 of 113 located in the 7 1 PBlicense User Manual ServerPort You can change the default port of the webserver default 8800 to another port like 80 Therefore you have to edit the following line in the control panel configuration file changes marked red Specify the http port of the webserver Example ServerPort 8800 erverPort 8800 e 7 e 7 D 7 D 7 e 7 e 7 e 7 and change it to ServerPort 80 After this change you have to delete the application path so that the control panel application will update the whole configuration at the next start Therefore you have to edit the following line in control panel configuration file changes marked red Specifies the path of the control panel application If the path does not match the real path the tool will try to update the webserver configuration and insert the actual path This setting does not have to be changed manually Example ApplPath C PBlicense A pplPath C Downloads PBlicense and change it to ApplPath Now you have to close the control panel button Exit and start it a
47. ense 24 Licenses 25 Support 26 Feedback m CR a ECG KKK KKK BS Oho Os dud OVS iti ee Page 44 of 113 PBlicense User Manual 13 4 PBlicense Footprint Generator The footprint generator is needed to create a PBlicense footprint code which is necessary to create a customized license file for the PBlicense application Firefox ee x __ PBlicense Footprint Generator 1 6 E _ http localhost 8800 pblicense r el d Google PBlicense Footprint Generator 1 6 Copyright 2011 by DP Soft waaw pb soft com Available languages en ge Product Information Product name PBlicense Product version 1 6 Identification 1 Company name PB Soft Company website WWW D Gott Com Configuration file product_1 php Registration Information Username Max Muster Organization name Muster Ine Email address max muster com The usage will be explained in the chapter which explains how to unlock the PBlicense application Page 45 of 113 PBlicense User Manual 13 5 License Analysis Tool The license analysis tool is used to analyze an existing license file You have to copy the license to be checked into the directory of the analyzing script pblicense analysis and then also edit the configuration file application cfg and enter all the user and system information needed After running the analysis script the result will be displ
48. ensing procedure of PBlicense works Then it will explain how to use the PBlicense software create product configurations create and send license files and how to integrate PBlicense into your projects At the end it will provide some important information about buying a software license support contacts and customer feedback One of our objectives is to provide a superior support so that we have happy customers Therefore if you have questions or problems while installing or using our software please do not hesitate to contact us sincerely Patrick Biegel Page 6 of 113 PBlicense User Manual Introduction PBlicense is a PHP Software Licensing System which helps developers to protect their applications against unlicensed use The software user needs a valid license to run an application To get a license he needs to create a footprint and send it to the developer The developer then creates a license file and sends it back to the customer With the license file the application will run a limited or unlimited time depending on the license file System Requirements PBlicense has some specific hard and software requirements If you just want to check if your Webserver meets the specific software needs you can use the PBlicense software requirement check script If there are no errors found while executing the script it should be no problem to use PBlicense on your server Please download the script from our website at www pb
49. ent IP address 127 0 0 1 There is a link to the phpinfo script which shows information about the actual host More information PHPinfo d Firefox l _ phpinfoQ gt _ http localhost 8800 pblicense include information php ace A v Google CH Configure cscript nologo configure js enable snapshot build enable debug pack with Command snapshottemplate d php sdkisnap_5_ 2 wc6 x86 template with php build d php sdkisnap_5 2Wwc6 x86 php_build with pdo oci D php sdkioracle instantclient10 sdk shared with oci8 D php sdk oracle instantclient10 sdk shared without wett Con apache 20 Handle Suppo php ini Path oaded S Bu rt i L C PBlicense php ini Configuration File Scan this di additional ini files tona il E JUNE GUO Page 65 of 113 PBlicense User Manual There is a link to the license logfile to display the history of license creation License logfile license_0711 log 2 44 KB d Firefox e EH NW http localhost880 log license_0711 log ih 2 Google P t E 050711204731 050711213858 110711005303 110711005603 110711011519 110711012056 110711012625 110711013253 pb 0 0 1 0 0 1 0 0 1 0 0 1 0 0 1 0 0 1 0 0 1 0 0 1 There is also some information about the actual license and a link to the Footprint Generator Create a PBlicense foot
50. er modes ASCII or Binary in your FTP client application Attention If you choose the mode Auto in your FTP Client the php files normally will be uploaded in ASCII mode lf you still have a problem please contact our support see support section at the end of this document We are always glad to help you PHP Files which have to be uploaded in ASCII Mode There are some exceptions for php files 7 files which have to be uploaded in ASCII mode because they are not encoded First you can upload all the php files in binary mode and then delete the following files and upload them but now in ASCII mode pblicense test application php pblicense test configuration php pblicense test product_1 php pblicense test appl_long application php pblicense test appl_ short application php pblicense export config product_1 php pblicense export config product_2 php Page 28 of 113 PBlicense User Manual Control Panel Configuration The PBlicense control panel is only needed to manage the webserver of the installation type 1 localhost Therefore the control panel is not available and needed for the installation type 2 external webserver Normally you do not have to edit the control panel configuration file PBcontrol ini but sometimes it is necessary If the control panel is running and you press the shortcut CTRL SHIFT C the configuration file will be opened iE PBcontrol ini Notepad File Edit Format View Help PBcontrol w
51. external software which is listed below We would like to thank the creators for letting us use their software You can find all the following license files in the subdirectory licenses 27 1 27 2 licence_apache txt Apache License license_pblicense txt PBlicense License PHP License Zend License license_pclzip txt PCLzip License license_php txt license_zend txt Apache Webserver For the localhost installation package the Apache Webserver is used The Apache Webserver uses the Apache License Version 2 0 from January 2004 Apache Website http www apache org License Link http www apache org licenses Local License license _apache txt PclZip Library PHPCONCEPT Developers Tools For the PBlicense Installer Script the PHPConcept PclZip Library is used With this library the installer can compress and decompress files and folders during the installation The PHPConcept PciZip Library uses the GNU Lesser General Public License Version 2 1 from February 1999 Application Author Vincent Blavet PHPConcept Website http www phpconcept net License Link http www gnu org Local License license_pclzip txt Page 110 of 113 PBlicense User Manual 27 3 PHP Package For the localhost installation package the PHP package is used The PHP Package uses The PHP License Version 3 01 1999 2010 PHP Web
52. figuration Editor License Generator License Manager File Integration 2 Product Configurations available Edit a configuration Please select a configuration EN Create a new configuration Filename product_ 3 cfg Delete a configuration Please select a configuration Licensee Peter Example PB Soft Copyright 2011 PB Soft First you have to choose an existing product configuration from the existing configurations Please select one from the drop down Menu Edit a configuration After selecting the configuration press the button Edit 2 Product Configurations available Edit a configuration Create a new configuration The configuration screen will be displayed and you can edit the configuration like described in the section Create a new Product Configuration Page 77 of 113 PBlicense User Manual 19 3 Delete a Product Configuration To delete an existing product configuration please click on the link Configuration Editor on the link panel The following window will be displayed Firefox 7 _ PBlicense 1 6 PHP Software Licensing S amp gt http localhost 8800 pblicense main editor php language en KE PBlicense 1 6 Configuration Editor Configuration Editor License Generator License Manager File Integration 2 Product Configurations available Edit a configuration Please select a configuration EN Create a new configuration Filename produc
53. gain run PBcontrol exe At the next start of the control panel the tool will check the application path and realizes that the path is not correct Then it will update the whole configuration including the changed port of the webserver Page 30 of 113 7 2 7 3 PBlicense User Manual TextApplication You can also specify your favorite text editor which will be used to display the configuration files Therefore you have to edit the following line in control panel configuration file changes marked red Specify the path to the application which will be used to display the actual configuration Normally this should be a text editor like notepad from windows or your favorite text editor Example TextApplication C Windows Notepad exe TextApplication C Windows Notepad exe and change it as an example to TextApplication C Programs PSPad PSPad exe After this change you only have to restart the control panel You do NOT have to delete the application path and update the whole configuration SaveWinPos You can also specify if the window position of the control panel should be saved automatically if you exit the control panel application Therefore you have to edit the following line in control panel configuration file changes marked red Specify if the position of the control panel window has to be saved when the control panel is closed with the button Exit Example SaveWinPos 0
54. guration Filename product_ 3 cfg N D Delete a configuration Please select a configuration elete Licensee Peter Example PB Soft Copyright 2011 PB Soft There is a filename displayed for your new configuration Normally you should use this name To create a new configuration click on the button New Create a new configuration Filename product 3 cfg New Page 67 of 113 PBlicense User Manual The default product configuration will be displayed Configuration details Product id A Filename product 3 cfg Product name Application name Product version 1 0 Script name index php Address range 3 Version range 1 Username Script path E Organization Server name Product name Server address CH Product version Document root fall Script name Server environment F First you can enter a name for your product Product name Product version Then you can specify the name of the protected script This is the name of the script where you will insert the generated php code which protects your whole project Script name calc php Page 68 of 113 PBlicense User Manual Then you can specify the IP address range Here you have the following possibilities Range 1 The 1 number of the IP address will be checked Example 243 Range 2 The 1 and 2 number of the IP address will be checked Example 243 125 Range 3 The 1 2 and 3 number of the IP address will
55. hows the product code in color highlighted Show highlighted version An example of the highlighted product code is shown below Firefox File product_1 code PHP code file for Calculator 2 0 Created 19 07 2011 06 39 03 Include the username and organization from your configuration file In this example we use the variables username and Sorganization from our example file called configuration php This section contains variable information In our case the username and organization of the client This information changes with every new software user Please be sure that the username and organization is not hardcoded into your source code check 0 username Username check 1 Sorganization Organization This section contains fixed information which is hardcoded and only changes when the software changes like another software product or another software version It is extremely important that this data is encoded because it contains the product key of your software be sure that this information is hidden in the source code Scheck 2 Scheck 3 Scheck 4 Scheck 5 Calculator Product name Sages Product version IP adress range Version range O N an an The big text area also contains the product code which can be copied and pasted to your script The product configuration and also the product code will be saved and can be accessed anytime from the page File I
56. icense configuration pblicense cfg in your favorite text editor Please insert your username line 7 and organization line 8 fo sssss SSS S355 555 55 5 55 5 5 55 5 55 55 5 5 5 5 5 5 5 5 55 5 55 555 55 5 Spblicense username opblicense organization Peter Example Example Inc Please specify the preferred default language line 14 English en and German ge is available fo SSSSSS SSS SSS SSS SSS SS SS SSS SS SS SS SS SS SSS SSS SSS SSS SESE Specify the default language fo SSSSSS SSS SSS SSS SS SS SSS SS SS SS SS SS SS SS SS SS SS SS SSS SSS Slanguage en Those were the most important settings This name and organization settings are necessary to activate a personalized license file Maybe you want to change some other settings later like the default time zone the screen size or the log file settings Page 49 of 113 PBlicense User Manual 14 2 Edit the License Generator Configuration File Please open the file pblicense configuration license cfg in your favorite text editor Please specify which clients have access to the license generator line 43 Here you have to specify an IP Address or range like the following examples WWW XXX YVYY 2Z2ZZ e 124 SOs e Gr WwWw XXX YYY gt 2124004120 Www XXX gt 212 56 WWW gt 212 You can specify different addresses ranges If you specify some addresses ranges you should delete the entry all With the entry all everyone has access to
57. ion Zend Engine version Zend Optimizer version Zend Guard Loader version Mcrypt version Server IP address Client IP address More information License logfile Create a PBlicense footprint Directory of the license file License file in use License valid from License valid until PBlicense user manual 18 1 Information On the Home page you can find the name of the licensee ant the organization Licensee name Licensee organization Active language English PBlicense Information Peter Example PB Soft 1 6 Build 54 for PHP 5 2 xx 5 2 17 2 2 0 333 Not available 2 5 7 127 0 0 1 8800 localhost 127 0 0 1 PHPinfo license_0711 log 2 44 KB Footprint generator C PBlicense www pblicense main 090711005020 pbi 09 07 2011 04 01 2012 PBlicense_en pdf Change to German Licensee Peter Example PB Soft Copyright 2011 PB Soft Peter Example PB Soft Page 64 of 113 PBlicense User Manual There is also some information about the installed software and their versions PBlicense PHP Zend Engine Zend Optimizer Zend Guard Loader and Mcrypt PBlicense version 1 6 Build 54 for PHP 5 2 XX PHP version 5 2 17 fend Engine version 2 2 0 fend Optimizer version AAA fend Guard Loader version Not available Micrypt version 2 5 7 The IP address of the host and also of the client computer are displayed Server IP address 127 0 0 1 8800 localhost Cli
58. l Webhost The external webhost package contains all the files which are necessary to install PBlicense on a webhost running Windows or Linux This package needs a normal installation uploading and unpacking the archive and then edit the configuration files Software Download Please choose between the two available installation types see above and then try the PBlicense trial version first before you buy the full version You also can try both installation types The trial versions are fully functional and only have a time limit of minimum one month 4 1 Download the PBlicense Trial Version First you have to download and try PBlicense so that you can be sure that everything works on your webhost You can download both installation types from the PB Soft Website 4 2 Buy and download the PBlicense Full Version If you have tried the trial version of PBlicense and everything works fine you can buy the full version of PBlicense from the PB Soft Website If you have the trial version of PBlicense installed you only have to get a new license file You dont have to install another version of PBlicense Page 9 of 113 PBlicense User Manual 5 Software Installation 5 1 Type 1 Localhost If you have downloaded the PBlicense archive from the PB Soft Website you will get the archive PBlicense1 zip in your download folder PBlicensel zip Now you have to unpack the archive with an unzip utility like 7 Zip You can do
59. lculator meats cale php 1 K Ab if Z Specify the options flags if Soption 0 Soption 1 Soption 27 Soption 3 Soption 4 Soption 5 Soption 6 Soption T Soption 8 Soption 9 foi bt t tot tb ot wea CD OO OO k H H FRB mn KI mn an mn mn mn mn KI mn EK The first part specifies the product details like the product name product version script name product ID address range and version range The second part specifies which of the options are enabled for checking a license and are necessary to generate a new license file with the License Generator Page 72 of 113 PBlicense User Manual The second link shows the php code for the actual product This code is necessary to include the license verification into your own php script The codefile was saved as product 3 code The product code can be generated in two different versions The long version includes a lot of information about the code and indicates how to include it into your own projects The same code is also displayed in the big edit field An example is shown below lt php if if if if if PHP code file for Calculator 2 0 Created 19 07 2011 06 39 03 Include the username and organization from your configuration file In this example we use the variables username and So0rganization from our example file called configuration pobo include once configuration php if Z This section contains variable i
60. load the specified file even if it is a text file which normally would be displayed in the browser A click on one of the normal links will show configuration files text CSS files text and images in the browser but will download zip files Here is a small description for each of the project files and the reason why you need or don t need them for your project footprint zip contains the file footprint php This is the footprint main application and absolutely necessary You have to unzip the file before you use it It is compressed so that you can download and send it by e mail This file is located in the directory pblicense export footprint footprint cfg This is the footprint configuration file and is absolutely necessary and is located in the directory pblicense export footprint You can open it with a text editor and customize your company data fo SSSSSSS SSS SSS SS SSS SS SS SS SSS SS SS SS SS SSS SS SSS SSS SSS Specify the company data fo SSSSSS SSS SSS SSS SSS SS SS SS SS SS SS SS SS SS SSS SSS SS SSS SSE Scompany name PB Soft Scompany website www pb soft com Scompany reg link www pb soft com Sscompany reg email info pb soft com Page 90 of 113 PBlicense User Manual The company information is the most important data you have to customize Attention Please check that your company data especially the e mail address is correct lf you want you can also change the default language
61. me MD5 Hash Configuration Specified in pblicense cfg cbc11318f741416a56b53d2e75c6e1e4 Export pblicense exportvalidate validate php cbc11318f741416a56b53d2e75c6e1e4 Internal pblicense main validate php cbc11318f741416a56b53d2e75c6e1e4 PBlicense Product Files Name Version Configuration PHP Code Calculator 2 0 DL product_1 php DL product_1 code TinyApp 4 5 DL DL product_2 code Licensee Peter Example PB Soft Copyright 2011 PB Soft The File Integration page is divided into three areas The first area displays the project specific files Those files are needed for all the projects and all the products This files include the Footprint Generator which is used with all products to generate a system footprint and the Validation Engine which is also used by all products to validate an existing license file Page 89 of 113 PBlicense User Manual 22 1 Project Files The project files are listed in a table like the one in on the image below PBlicense Project Files File Description nnloa Size Footprint main application 15 01 KB Footprint configuration file 1 86 KB Footprint css file 10 92 KB german footprint language file 2 70 KB Footprint title graphic 0 27 KB Footprint table graphic DL i itable git 0 16 KB PBlicense validation engine POL A validate zip 1 17 KB Normally these files are exactly the same for all of your protected applications A click on one of the download links on the left side will down
62. nformation In our case the username Z and organization of the client This information changes with every Z new software user Please be sure that the username and organization Z ias not hardcoded into your source code if Scheck 0 username Username Scheck 1 o0rganization Z Organization if Z This section contains fixed information which is hardcoded and only changes when the software changes like another software product or another software version It is extremely important that this data Z is encoded because it contains the product key of your software Z Please be sure that this information is hidden in the source code if Scheck 2 Calculator Z Product name Scheck 3 2 0 Z Product version Scheck 4 2 Z IP adress range Scheck 5 Oe Version range Scheck 6 1111100000 Z Option flags Scheck 7 9dui4d8tTezh4eTiz3ghTT3u47arftT rT Z Product key This code continues on the next page Page 73 of 113 PBlicense User Manual r Z Specify the md5 hash of the validation engine script validate php Z The script will check if the md5 hash of the validation engine match Z the hash specified in this section The software will not run if the Z md5 hash does not match Please hardcode this md5 hash eee md5 hash cebc11318 741416a56b53d2zeTSc ele4 MDS hash EE Z Here the license will be checked First the md5 hash is compared to Z the specified one and then the
63. nse PBlicense PBlicense PBlicense PBlicense PBlicense PBlicense PBlicense Calculator Calculator TinyApp Licensee Peter Example PB Soft Copyright 2011 PB Soft 21 1 License information The license information for each license will be showed on one line The following is an example divided into two lines because of the limited space License Usemame Organization 1907110805045 Peter Example Example Int Email Product Version petern example com PBlicense dree Page 87 of 113 PBlicense User Manual 21 2 View a License File If you want to see an existing license file you just have to click with the mouse on the link with the name of the license file License Information License Username Organization Email Product Version Peter Example Example Inc peter example com PBlicense 1 XXXX Peter Example Example Inc peter example com PBlicense 1 XXXX The license file then will be opened in a new browser tab or window Firefox ecm e x _ PBlicense 1 6 License File 19071108064 fk _ http localhost 8800 pblicense main highlight php hfile D 3A 2FWork 2FPBlicen BS Mee GE L i Ss License File 190711080645 pbi PBlicense 1 6 PHP Software Licensing System Copyright 2011 by PB Soft Website www pb soft com This copy of PBlicense 1 6 is registered to Peter Example PB Soft Creation date and time Date 19 07 2011 Time 08 06 45 fe Licensed to
64. ntegration Page 75 of 113 PBlicense User Manual The different links can also be used to download the product configuration or product code as a text file You only have to click with the right mouse button on the link and choose Save Link As and save the file to a new location The configuration was saved as product 1 cfg The codefile was saved as prog Open Link in New Tab Open Link in New Window Generated PHP Code Lor Bookmark This Link Send Link Copy Link Location eS k Computer SYSTEM C Temp ki Search Temp Organize e New folder L Si Recent Places No items match your search Libraries E Documents al Music Pictures P Videos Bb Computer amp SYSTEM ICH Save as type All Files Hide Folders Attention If you create a new product configuration but you have not specified a product key you will get a warning Then you have to create a new product key like described in the installation section of this manual and try again Page 6 of 113 PBlicense User Manual 19 2 Edit a Product Configuration To edit an existing product configuration please click on the link Configuration Editor on the link panel The following window will be displayed Firefox _ PBlicense 1 6 PHP Software Licensing S amp gt http localhost 8800 pblicense main editor php language en Ly PBlicense 1 6 Configuration Editor Con
65. ntend The PBlicense frontend can be used to let the visitors create their own trial licenses It can be configured that every user can create aS many licenses as he wants or you can limit the license creation and the users have to enter an access code to create a license Firefox 7 J 11 http localhost 8800 pblicense front frontend php TY e Googie Trial License Generator Footprint ZGHPoDUfEdr oC2WI77hheTCaVtEfdjEuBz MWrfOYbOQEVHw4 PpCbsioleJuv52Wit 6Ds6UjczFjVHVakNHW8SsX2wSD vY 1ljwhxVhuHrx2mx03UtDZse Op yp3iSx9114670001718WWELhsfdbg4ZSdfw 5759596e0a1 6b4a0ds44fcfd7251b63 c Access code 0001_WK5o0Xp9nH826f6N Back to the license generator Powered by PBlicense 1 6 Copyright 2011 by PB Soft 13 3 PBlicense User Manual This link will display this user manual in your favorite PDF viewer 1 Introduction 2 System Requirements 3 Installation Types 4 Software Download 5 Software Installation 6 Installation Problems P B l cense 7 Control Panel Configuration W O 8 Control Panel Usage 9 Start PBlicense 10 PBlicense Main Menu 11 PBlicense Configuration User Manual 12 Unlock the Software 13 Unlock Problems 14 PBlicense Navigation 15 PBlicense Home 16 Configuration Editor 17 License Generator 18 License Manager 19 File Integration 20 Code Integration 21 Tools 22 Backup 23 Buying PBlic
66. ocal computer unzip the two compressed files and copy all the files together to the same directory like your script which you want to protect That s all MD5 Hashes The second area displays the MD5 hashes of the validation engines It is very important that this information is always correct because the application will check the MD5 hash of the validation engine before the function to check the license is included into the application Without the correct validation engine correct MD5 hash the application will never run The table displays the different validation engine hashes available Validation Engine MD5 Hashes Type Path Filename MDS Hash Configuration Specified in pblicense cfg cbc11313f741416a56b53d2e75che1e4 Export pblicense exportvalidate validate php cbc11318ff41416a56b53d27e 5cheled4 Internal pblicense main validate php cbc11318ff41416a56b53d2er5cheled If the banner is green everything is ok If the banner is red there is something wrong with the MD5 hashes maybe the specified MD5 hash in the configuration file is wrong or a validation engine file is corrupt Page 93 of 113 PBlicense User Manual 22 3 Product Files The third area displays all the product files which are necessary to configure the product specific part Normally these files are unique for each of your protected applications PBlicense Product Files No Name Version Configuration PHP Code 1 Calculator 2 0 DL product 1 php DL product 1
67. om 09 07 2011 License valid until 04 01 2012 Please click on this link and the content of the license file will be displayed if ff The license is for the following product if Z The license is for the following product version Wi f So0ttware version 1 x x Now check if the product name and the software version match the data displayed on the Home page lf the product name and or the software version is are different you have to get another license file Page 61 of 113 PBlicense User Manual 16 5 Check the License Start and Expiration Date Check if the actual license is not expired You can see that on the Home page of the PBlicense application There you will find the start and end date License file in use 090711005070 pbl If the actual date is not between the start and end date displayed this license file will not work The license is expired or will be valid in the future you have to get another license file If you still have a problems to activate the PBlicense software please contact us see the support section at the end of this document We are always glad to help you Page 62 of 113 PBlicense User Manual 17 PBlicense Navigation On the top of each window you will find the following header with different links PBlicense 1 6 Home Home Configuration Editor License Generator License Manager File Integration Main Menu Link to the PBlicense Main Menu Home
68. on from your configuration file In this example we use the variables username and Sorganization from our example file called configuration php This section contains variable information In our case the username and organization of the client This information changes with every new software user Please be sure that the username and organization is not hardcoded into your source code check 0 Susername Username Scheckt Sorganization Organization This section contains fixed information which is hardcoded and only changes when the software changes like another software product or another software version It is extremely important that this data is encoded because it contains the product key of your software Page 96 of 113 23 2 23 3 PBlicense User Manual Customize your Configuration File You can copy the definition of the username and organization to your configuration file Your customer later has to specify his name and organization red part So that part has to be in a file which is NOT encoded This is normally the configuration file of the application ME Specify the username and organization p a Susername Peter Example Sorganization Example Inc Attention Please be sure that the configuration file which contains the username and organization specification is NOT encoded The user later needs to edit this file and insert his name and organization C
69. ories included and copy the backup to a save place It s not a lot of data normally it will be less than 10 MB including this user manual Attention Please make backups frequently Page 108 of 113 PBlicense User Manual 26 Buying PBlicense PBlicense was made to help developers to protect their applications against unlicensed use Unlike other applications you dont have to worry about the number of licenses you will create With PBlicense you can create as many licenses as you want There is no extra fee for license packages or yearly fees to use PBlicense If you buy PBlicense you can use it as long as you want The purchase price includes all new versions during one year and also a superior customer support We offer trial versions for all of our software products so that you can test them and check if they run on your server without any problems and of course if you like the software We believe that you should only pay for a product that you like and only for software you can test before you have to buy it Please test the trial version before you buy a license If you like the PBlicense application you can buy an unlimited license from the PB Soft Website If you have registered PBlicense you should send us a new footprint see section Unlock the Software and we will send you the license file for the full version of PBlicense Page 109 of 113 PBlicense User Manual 2 Licenses PBlicense also uses some
70. ors and the webserver meets the specific needs of PBlicense Please download the script from our website at www pb soft com Firefox 7 PBlicense 1 6 Software Requirement Ch J hittp localhost 8800 check php This script will check if the actual server meets the necessary software requirements to run PBlicense 1 6 PBlicense is a PHP Software Licensing System from PB Soft For more information about the software please visit our Website 1 PHP version The current PHP version is 5 2 17 2 Operating system The current operating system is Windows NT 6 1 ring the check It seems that PBlicense probably will not work in the actual environment Please with your server administrator Dr more information please visit our website at www pb soft com You also can see the actual host configuration with phpinfo Thank you for evaluating software from PB Soft If the script finds a problem in the following example an old PHP version a message will show the details The current PHP version 4 5 0 is not supported You need at least version 5 27 0 1 PHP version Page 21 of 113 PBlicense User Manual After upgrading to a newer PHP version the error disappears 1 PHP version The current PHP version is 5 2 17 lf all the status indicators are green there should be no problem to run the PBlicense software on your host Please make sure that you use a trial license first to check
71. owing settings are correct on your host PHP Version 5 2 17 System Win dows NT PC4 6 1 build 7601 Virtual Directory enabled Support Configuration File C Vindows php ini Path Loaded D WorkiPBlicense Devel iphp ini Configuration File Scan this dir for none additional ini files PHP API 20041225 PHP Extension 20060613 Debug Mode If the debug mode is enabled in PHP the Zend Optimizer will not work You can check this setting if you display the phpinfo output The setting Debug Build should be set to no for Windows Unix and Linux hosts Page 26 of 113 PBlicense User Manual Thread Safety lf you are running the Zend Optimizer on a Windows host the PHP should be compiled in the ZTS mode multi threaded environment You can check this setting if you display the phpinfo output The setting Thread Safety should be set to enabled for Windows hosts Thread Safety If you are running the Zend Optimizer on a Linux Unix host the PHP should be compiled in the Non ZTS mode no multi threaded environment You can check this setting if you display the phpinfo output The setting Thread Safety should be set to disabled for Unix and Linux hosts Thread Safety Enable Versioning If the enable versioning is enabled in PHP the Zend Optimizer will not work You can check this setting if you display the phpinfo output The setting enable versioning should NOT be found in the
72. pblicense zip To install PBlicense on your webhost please upload the two files install php and pblicense zip with an FTP Client like Filezilla to your web account The file install php is the PBlicense installation script and the file pblicense zip contains all the files of the PBlicense application in a compressed archive Page 13 of 113 PBlicense User Manual If you upload the files to your webroot directory the installation script will create a new directory called pblicense in the webroot which contains all the files of the PBlicense application Here is an example The webroot directory is home www File upload install php to home www install php You upload pblicense zip to home www pblicense zip The installation directory will be home www pblicense Please check that you upload both files in binary mode It is very important that you upload the two files in binary mode because otherwise the files could be damaged during the transfer In the Filezilla application you can set the transfer if you select the menu Transfer the item Transfer type and then select Binary like you can see on the following image Di Filezilla File Edit View Server Bookmarks Help M Process Queue CTRL P Host Default file exists action Port Transfer type Auto B Preserve timestamps of transferred files CTRL U ASCI Speed limits Ee Manual transfer CTRL M In other FTP applications you
73. print Footprint generator Directory of the license file CUPBlicense lwww pblicense main License file in use 090711005020 pbl License valid from 09 07 2011 License valid until 04 01 2012 Also a link to the PBlicense user manual is available PBlicense user manual PBlicense en pdf The active language is displayed and with the help of a link the language can be switched between English and German Active language English Change to German Page 66 of 113 PBlicense User Manual 19 Configuration Editor The configuration editor is used to create edit or delete new product configurations If you have created a new project which you want to protect you have to create a new configuration for that product In the configuration you will specify the product specific details which are necessary to create the php code license files and protect your script 19 1 Create a new Product Configuration To create a new product configuration please click on the link Configuration Editor on the link panel The following window will be displayed d Firefox _ PBlicense 1 6 PHP Software Licensing be http localhost 8800 pblicense main editor php language en sl Google Faesc PBlicense 1 6 Configuration Editor Configuration Editor License Generator License Manager File Integration 2 Product Configurations available Edit a configuration Please select a configuration EN Edit ew Create a new confi
74. products You can specify the different application settings for the frontend in the configuration file pblicense configuration weblicense cfg You can open the frontend with a click on the button PBlicense Frontend on the PBlicense Main Menu through a link on the License Generator page or also directly by entering the URL Example http example com pblicense front frontend php in your browser http localhost 8800 pblicense front frontend php Trial License Generator Footprint Access code Reset Form Create License Back to the license generator Blicense 1 6 by PB Soft The frontend works similar to the license generator of the main application but the visitor can only insert the footprint and if enabled the access code to create a license file All the options are disabled The license duration is specified in the configuration file The user has to go through the following three steps to create a new license file e Copy a valid footprint into the text area e Enter his access code into the form field e Click on the button Create License Page 102 of 113 PBlicense User Manual q Firefox _ PBlicense 1 6 Frontend lt e _ http localhost 8800 pblicense front frontend php S el A Google Trial License Generator Footprint Back to the license generator Powered by PBlicense 1 6 Copyright 2011 by PB Soft lf all the input data is correct a new
75. r footprint code sent from the footprint form or sent by normal e mail we will create and then send you your personalized license file per e mail If you don t get the license file please check your spam folder Maybe the e mail with the attached license file was categorized as spam If you can t find the e mail with the license file there please contact us Page 56 of 113 PBlicense User Manual 15 2 Install the License File Please check on the PBlicense Home page which is the path to the license file The following line will show you the correct path License logfile license Dr Jon 2 44 KB Create a PBlicense footprint _ Footprint generator License file in use 090711005020 pbl License valid from 09 07 2011 License valid until 04 01 2012 Please copy the license file to that directory and make sure that it is the only license file in that directory If there is another license file copy it to another directory or delete it To make the license work you also have to enter your name and organization into the PBlicense configuration file Please check the chapter about editing the main configuration file To check if the registration process was successful Please click on the link License Generator from the link panel If the license is valid you should see the License Generator like on the following image gt D http localhost 8800 pblicense main license php language en PBlicense 1
76. re the application normally is running If you are testing on another host you have to edit these values 15 server script filename application php 16 Sserver server name localhost 17 eserver server addr Miz fo As 16 S server document root 2 www 19 Senyv term not available Line 25 26 specify the name and organization of the licensee Normally those values are provided by the configuration file of the application Please edit the settings so that they match the data of the license file you can open the license file with a text editor and copy the username and organization 25 Scheck 0 Jobn Walker 26 check 1 John s Pub Line 33 38 specify the product specific settings You can get the exact settings by opening the configuration of your product on the File Integration page 33 check 2 Calculator 34 Scheck 3 1 2 35 Scheck 4 2 36 Scheck 5 1 37 Scheck 6 1111100000 38 Scheck T Sduid stTezh4eTiz3gqgh7T3u47erfc eT Line 45 specifies the script path Please edit this variable and enter the path to the script file on the customers host 45 Scheck 8 Z wwwicalculator Line 50 specifies the MD5 hash of the validation engine 30 Svalidate md5 hash cbc11318f741416a56b53d2e75c6ele4 Page 106 of 113 PBlicense User Manual Analyze a License File If you have customized the configuration file you can run the analyzing scrip
77. reas The first area is a text input area for the footprint generated by the Footprint Generator You only have to paste a valid footprint from the clipboard into this text area The second area is an input section to specify the different license options like the start date end date and software grade Further you can select if you want to see debug information about the license creating process Page 79 of 113 PBlicense User Manual 20 1 Create a license file To create a new license file you only need to copy a valid footprint into the input field like on the following picture Footprint k4RSB9UnohgotKN1e41it41z2zDWz1linsSLovOobocs 649b63rDgDELMSClRNBTas bPuG4iksexve L t do ntocssJEITZGILERPSw3ZebiIsSDe2YtFus4nwO02o0hvZWiHDBE1u01449000189SWWrLh sySqk Hug cTE cd0abatecbel5d995e65450633a274655 Then you can specify some license options like on the following image License Options Start date Software grade End date Debug information El Start Date As the first option you can specify the license start date You have to use the following format DD MM YYYY Start date 19 07 2011 The actual day is selected so if you want the license to be valid from today you don t have to change anything If you want to change it be sure to specify a date in the future As an example you could create a license which is only valid during the Christmas days from December 24 until December 26 Just enter 24 12 201
78. rks CTRL SHIFT W opens the webroot directory This directory contains all data provided to the clients in our case the pblicense directory CTRL SHIFT T opens the PBlicense analysis directory This directory contains the License Analysis Tool which can be used to analyze a license file and check if the license is valid Page 34 of 113 PBlicense User Manual The shortcut CTRL SHIFT T displays some information about the PBlicense control panel like the application version and the build date and time RS PBcontrol 1 0 Information xX e j Application name PBcontrol Application version 1 0 Build date 10 07 2011 14 21 20 Website www pb soft com Copyright 2011 PB Soft The shortcut CTRL SHIFT X will save the actual window position of the PBlicense control panel If you save the position the window will open at the same position at the next start of the control panel Page 35 of 113 PBlicense User Manual Start PBlicense 9 1 9 2 Installation Type 1 lf you use the installation type 1 local webhost the easiest way to start PBlicense is to cklick on the button Menu on the webserver control panel like indicated on the picture below PB Ssft cor ie Ea The User Login screen will be displayed in your default webbrowser Installation Type 2 If you are using the installation type 2 external webhost please enter the following direction in your browser
79. s the directory structure on your webserver should look similar to the following example Filezilla screen Filename Filesize Filetype Last modified Permissions KE A analysis File folder 7 13 2011 11 30 00 PM drwxr xr x A configurat File folder 7 13 2011 11 30 00 PM PWANI A css File folder 7 13 2011 11 30 00 PM drwxr xr x A export File folder 7 13 2011 11 30 00 PM APWANN A front File folder 7 13 2011 11 30 00 PM drwxr xr x A gif File folder 7 13 2011 11 30 00 PM drwxr xr x A include File folder 7 13 2011 11 30 00 PM drwxr xr x A javascript File folder 7 13 2011 11 30 00 PM drwxr xr x A jpg File folder 7 13 2011 11 30 00 PM drwxr xr x A key File folder 7 13 2011 11 30 00 PM drwxr xr x A Language File folder 7 13 2011 11 30 00 PM drwxr xr x A licenses File folder 7 13 2011 11 30 00 PM drwxr xr x A main File folder 7 13 2011 11 30 00 PM drwxr xr x d 4 l mt p m Selected 2 directories First try to set the permissions not to restrictive and after the script works ok you can successively put them more restrictive Page 20 of 113 PBlicense User Manual Installation Problems If you have problems while installing or running PBlicense please check the following sections 6 1 System Requirement Problems If the system requirements are not adequate it is possible that there are problems which are difficult to detect You can run our PBlicense software requirement check script to see if there are no err
80. s program Windows Firewall has blocked some features of Apache HTTP Server on all public and private networks Name Apache HTTP Server Publisher Apache Software Foundation Path C downloads pblicense apache exe Allow Apache HTTP Server to communicate on these networks E Private networks such as my home or work network Public networks such as those in airports and coffee shops not recommended because these networks often have litte or no security What are the risks of allowing a program through a firewall Please choose Allow Access to continue and let the webserver communicate through the security application The control Panel will be displayed and the webserver is still deactivated which is indicated by the red status panel Webserver Control Pane z EE PBlicense 1 6 The installation is completed Please check the other chapters in this manual to see how to configure and use the control panel and the PBlicense application Page 12 of 113 PBlicense User Manual 5 2 Type 2 External Webhost If you have downloaded the PBlicense archive from the PB Soft Website you will get the archive PBlicense2 zip in your download folder PBlicensez zip Now you have to unpack the archive with an unzip utility like 7 Zip You can download the free 7 Zip archiver from the 7 Zip Website After unzipping the archive you will get the folder PBlicense with the following content Organize e install php
81. site http www php net License Link http www php net license Local License license_php txt 27 4 Zend Optimizer E zend For the localhost installation package the Zend Optimizer is used The Zend Optimizer uses the Zend License Agreement PHP Website http www zend com Local License license_zend txt Page 111 of 113 PBlicense User Manual 28 Support If you have a question or a problem while installing or using PBlicense please contact us we are always glad to help you You can contact us using the following methods Website http www pb soft com Webstore http www pb soft com E Mail Address support pb soft com Page 112 of 113 PBlicense User Manual 29 Feedback We always like feedback from you so that we can improve our products We don t want only positive feedback we also like constructive criticism so we can change for the better If you think there is something missing or there is an error in this manual please contact our support so we can add the missing information or fix the error in the manual Thank you a lot for your attention and have a nice day Patrick Biegel Page 113 of 113
82. t from the PBlicense Main Menu The license will be analyzed ad a detailed report will be displayed The analysis consists of 37 steps and for every step there will be a success message displayed If the message banner is green the step has completed successfully if the banner is red an error has occurred On the following image you can see the step 1 which was completed successfully Firefox _ PBlicense License Analysis Tool Versi la http localhost 8800 pblicense analysis analysis php Windows NT 6 1 5 2 17 x SS 2ST supported supported analysis php If there is an error you can see where it has occurred In the following example the error occurred in step 34 and the message indicates that the two footprint does not match Firefox PBlicense License Analysis Tool Versi G j gt _ http localhost 8800 pblicense analysis analysis php error dr S E Google 06abab5dc4086e6ed661304ef4ce357f1f1da0cf 06abab5dc4086e6ed661304ef4ce357f1f1da0cf c99d2b01570ab6630051e4cfa72ffde28915bf5c Page 107 of 113 PBlicense User Manual 25 Backup Attention Please make backups frequently If you have a backup and don t need it it s much better that if you need a backup but dont have it It s very easy to backup PBlicense You just can backup the whole PBlicense directory There is no database to backup just backup the whole directory pblicense with all subdirect
83. t_ 3 cfg Delete a configuration Please select a configuration E Licensee Peter Example PB Soft Copyright 2011 PB Soft Now you have to choose which configuration you want to delete Please use the drop down menu to select an existing product configuration Delete a configuration After selecting the configuration press the button Delete Delete a configuration Please select a configuration EN Delete Please select a configuration ula D 1 Cale TT The configuration will be deleted Page 78 of 113 PBlicense User Manual 20 License Generator The license generator is very easy to use and you can create all the licenses for your products in a very efficient and fast way To create a new license file please click on the link License Generator on the link panel The following window will be displayed Firefox idee x _ PBlicense 1 6 PHP Software Licensing be http localhost 8800 pblicense main license php7language en PBlicense 1 6 License Generator Configuration Editor License Generator License Manager File Integration Footprint License Options Start date 19 07 2011 Software grade Standard End date 30 Debug information CT Reset Form Create License Liste der Access Codes anzeigen access_code cfg Go to the trial frontend Licensee Peter Example PB Soft Copyright 2011 PB Soft The footprint screen is divided into two a
84. the following Username ZE Username Peter Example Mts Licensed to the following Organization Organization Example Inc There are also e mail links which open your default e mail application and insert the customers e mail address into the recipients field License Information License Username Organization Email Product Version 190711080645 Peter Example Example Inc eat l PBlicense 1 XXXX 190711075657 Peter Example Example Inc peter example com PBlicense 1 XXXX Page 88 of 113 PBlicense User Manual 22 File Integration To integrate the necessary files into your project please click on the link File Integration on the link panel The following window will be displayed q Firefox 7 x x _ PBlicense 1 6 PHP Software Licensing _ http localhost 8800 pblicense main export php 7language en a PBlicense 1 6 File Integration Configuration Editor License Generator License Manager File Integration PBlicense Project Files File Description Filename Size Footprint main application DL footprint zip 15 01 KB Footprint configuration file DL footprint cfg 1 86 KB Footprint css file DL footprint css 10 92 KB German footprint language file DL footprint ge 2 70 KB Footprint title graphic DL title gif 0 27 KB Footprint table graphic DL table gif 0 16 KB PBlicense validation engine DL validate zip 7 17 KB Validation Engine MD5 Hashes Type Path Filena
85. the license generator ff SSSSSS SSS SSS SSS SSS SSS SSS SS SSS SSS SSS SS SSS SSS SSS S555 Specify from which IP addresses the application can be used fo SSSSSS SSS SSS SSS SSS SSS SS SS SS SS SS SS SS SS SS SS SSS SSS SSE access ip all Please insert a string for the e mail message id line 66 Specify which name will appear in the message ID The message ID will look something like this PB4312b260a2 pb soft com It s made with a random number but you can choose the part after the sign emessage id example com Please specify the sender name line 92 and address line 93 for the e mails which will be sent eer Specify the sender name and e mail address HE Ssender name Example Ince Spender address salestexample com Page 50 of 113 PBlicense User Manual Please specify the address for e mail replies line 99 D ern Sreply address sales example com Please specify the address for errors line 105 fo sssssS SS S55 5555 555 5 5 5 5 5 55 5 5 5 5 5 5 5 5 5 5 5 5 55 5 555 5555555 fo sssssSs S555 555 5555 555 5555 5 55 5 5 5 5 5 55 5 55 5 5555555555 error address admin example com Please specify the address for returning e mails line 111 fo sssssS SS 5555555 5555 555 55 5 5 5 55 5 5 5 5 5 5 5 5 5 5 55555555555 JJ sssssSS S55 555555555 555 5555 555 5 5 5 5 555 555 55555555555 ereturn address sales example com Please specify
86. u also can create your own background file for the table header It just has to be a file with the following properties File format gif Height in pixel 35 Width in pixel 1 This file is not absolutely necessary If the footprint generator does not find the file he will show the table headers without the table graphic Here you can see the difference Table header without the graphic file Product Information Table header with the graphic file Product Information This file is located in the directory pblicense export footprint footprint ge This is an additional language file for the German language If you don t need the German language this file is not absolutely necessary If the footprint generator does not find this language file he will display only the English version If the file is present the links for the available languages will be displayed PBlicense Footprint Generator 1 6 Copyright 2011 by PB Soft wwew pb sofi com This file is located in the directory pblicense export footprint Page 92 of 113 22 2 PBlicense User Manual validate zip contains the file validate php This is the validation engine and absolutely necessary You have to unzip the file before you use it It is compressed so that you can download and send it by e mail This file is located in the directory pblicense export validate To integrate the project files into your own project just download them to your l
87. uild 54 Page 53 of 113 PBlicense User Manual The Footprint Generator window will be displayed Please insert the necessary information your username organization and e mail address into the form fields like on the image below PBlicense Footprint Generator 1 6 Copyright 2011 by DP Soft www pb soft com Available languages en ge Product Information Product name PBlicense Product version 1 6 Identification 1 Company name PB Soft Company website www pb soft com Configuration file product_i1 php Registration Information Username Organization name Email address Attention Please be sure that the username and organization is correct and check twice that your e mail address is valid so that we can send you a license file Then press the Button Create Footprint to continue and create the footprint code Page 54 of 113 PBlicense User Manual The generated footprint code will be displayed like on the following image below il Firefox _ PBlicense Footprint Generator 1 6 W Googe P E gt LI http localhost 8800 pblicense r T7 C OTO COO a a De PBlicense Footprint Generator 1 6 Copyright 2011 by DP Soft www pb soft com Generated Footprint K4RSEBSUnohgo KN1x4it41z2DWz11nSLSv0b0cS6A9b63rDgD ELMSCIRNBTas bPuG4k42eveLsZtaAdot ntorssJKIzZzGILKRPS mZebDIsDe2 Yt FUs4NwO02o0MvZW1iHDBE1014490001899WWrLh SySqkK Hugc TE cd0abatccbe15d995e6545063
88. ustomize your Application File Next we will explain the created php code which you can use in your own script without the blue line numbers 1 lt 7pnp CEET once EE EE EES e 3 Scheck 0 Susername 4 Scheck 1 Sorganization 5 check 2 Calculator P Sscheck 3 2 0 7 Scheck 4 2 0 Scheck 5 Ze 9 Scheck 6 1111100000 10 Scheck 7 9dui48t7ezh4e7fz3gh773u478rff7 11 md5 hash cbc11318 741416a56b53d2e75cbele4 12 if md5 file validate php pmd hash 13 14 include Once validave plip 15 Sdata status 0 16 data license check ocheck 17 18 if Sdata status 1 19 20 Your PHP code 21 da 2 gt Page 97 of 113 PBlicense User Manual Code line 1 Begin of the PHP script Code line 2 The configuration file configuration php of your application is included into the protected script Inside the configuration file the username and organization of the customer should be specified The customer can later edit the file and insert his name and organization Code line 3 The name of the user which was obtained from the configuration file is added to the array check on position 0 Code line 4 The name of the organization which was obtained from the configuration file is added to the array check on position 1 Code line 5 The name of the application which is hardcoded is added to the array check on position 2 If the application name option
89. validation engine is included After Z that the status of the license is set to 0 not valid just to be Z sure that we begin with the software disabled Then the function if license check will check the license file and then decide if the ff license is valid or not If the license is valid the status will be Z set to 1 valid and the software is ready to run SS eee if mds file validate php emds hash d include once validate php Sdata status 0 data license check check a aa Z Here you can test if the license status is set to 1 valid and then Z run your software To avoid manipulations the script which contains Z the license data and check has to be encoded and therefore protected Z Erom changes You can use this license check in various scripts for Z the same software product ee if data status 1 f f Your PHP code The short version includes no information and contains only the absolute minimum of code An example is shown below lt php include once configuration php Scheck array username Sorganization Calculator 2 0 2 0 1111100000 Sduilt trezh4teTiz3aghi faust ir IN if mds file validate php cbc11318f741416a56b5 3d2e75c6ele4 i include once validate php Sdata status 0 data license check check H if Sdata status 1 Your PHP code oe gt Page 74 of 113 PBlicense User Manual The last link s
90. which contains the following license information which can be used in every script data software_grade Software grade which was specified before the license file was created like Standard data start_date Contains the start date which was specified before the license file was created like 20 11 2005 data end_date Contains the end date which was specified before the license file was created like 20 12 2005 data creation_date Contains the creation date of the license file like 25 10 2005 data duration Contains the license duration in days like 30 data status Contains the license status 0 license invalid 1 license valid data message Contains a message about the validation result like License is not valid data filename Contains the filename of the license file like 301105193352 pbl After checking the license file you can use these array values in your script but check first if the value is set Example If the license file could not be read there is no start or end date available but the status or the message is available The most important array value is data status because it depends on the status if your script will run license valid or stop license not valid Page 101 of 113 PBlicense User Manual 24 Tools 24 1 PBlicense Frontend The PBlicense frontend can be used to give your website visitors access to trial licenses for your
91. wnload the free 7 Zip archiver from the 7 Zip Website After unzipping the archive you will get the folder PBlicense with the following content Organize e A cont A loncube A licenses A logs A modules Jo php A3 Ji png e libaprutil dll jy www e libhttpd dll jo zend e libmeryptdll a apache exe PBcontrol exe Gu libapr dll 5 php ini amp libapriconv dll To start the control panel for the webserver please start the executable PBcontrol exe Page 10 of 113 PBlicense User Manual If you start the control panel the first time a message will tell you that the path of the webserver does not match the configuration and that the configuration has to be updated Specified path D Work PBlicense Devel Real path C Downloads PBlicense I will try to update the configuration After some seconds the application will continue to update the configuration and a message will display the new configuration settings Server port 8800 Server root C Downloads PBlicense Document root C Downloads PBlicense waww Press the button OK to continue Page 11 of 113 PBlicense User Manual If the control panel is started the first time maybe the Windows Firewall or an other security application will ask you if you want to allow the communication of the Apache Webserver like in the following image ge Windows Security Alert e Windows Firewall has blocked some features of thi
92. would provide and therefore the license created for the customer computer will also work locally This method would also work for every script you distribute to your customers and they would not have to buy a license from you but the only difference is that your script which contains the php code to protect your product has to be ENCODED and therefore can not be altered by your customers Edit the Configuration To check a license file you first have to edit and customize the configuration file pblicense analysis application cfg and make some changes Please check the example configuration file on the next page Page 104 of 113 i D AJ o D Go ha ti D D D Wb Wb vvh va D A a u u o u o Go oh B Bi e a MM MAMA k FA k k k bh k k ki A ka Oo DD JO n Go h Oo DD Jo D D bh OD DD JO D o M OD DD JO a h O PBlicense User Manual lt php SSS eee Specify the server variables if necessary If you don t want to specify them and use instead the variables direct from the server please disable the following entries with characters if dd Example disabled Sserver server name localhost Example fenabled eserver server name localhost ff i This data is normally taken directly from the webserver but you can specify your own data if you don t check the license on the same f server as normally the aplication is running Se Sserver script filename application php jE
93. x or Windows based webserver e PHP version gt 5 2 installed e Zend Optimizer gt 3 0 installed e Mcrypt data encryption package gt 2 4 e Mcrypt blowfish algorithm support e Mcrypt CBC encryption mode support 2 3 Software Client e New webbrowser like Internet Explorer Firefox Opera e Javascript enabled in your browser e PHP Encoder for your projects like Zend Guard lonCube 2 4 Installation e Text editor to edit the configuration files like PS Pad e FTP access to your webserver e FTP client application like Filezilla e Possibility to change directory permissions Page 8 of 113 PBlicense User Manual Installation Types There are two different types of installations For each of them there is a trial version available which you should test before you buy the software If you buy the PBlicense software you will get a license for both installation types The PBlicense software for both installation types is exactly the same there are only two installation types available localhost or external webhost to make it easier for you to install the software Choose between the following two installation types 3 1 Type 1 Localhost The localhost package is a complete package for Windows which includes a very small webserver and PBlicense is working right from the start This package needs no real installation just unpacking the archive and edit the configuration files 3 2 Type 2 Externa

PBlicense User Manual - PB

Contents

Download Pdf Manuals

Related Search

Related Contents