Transcript
Page 1 of 16
Version 3.01 Update Installation Guide
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 2 of 16 END-USER LICENSE AGREEMENT (“EULA”) FOR CPV LAB This End-User License Agreement ("EULA") pertains to the CPV Lab product (called “Software" in this Agreement). Read the terms and conditions of this End-User License Agreement ("EULA") before installing, copying, or using CPV Lab. This End-User License Agreement ("EULA") is a legal agreement between you, (either an individual person or a single legal entity, who will be referred to in this EULA as "you" or "Customer"), and the owner/s of CPV Lab ("Authors"). By clicking "I accept", installing, copying, or otherwise using any part of the above Software, you agree to be bound by the terms of this EULA. If you do not agree to the terms of this EULA, promptly return the unused Software to your supplier for a full refund. 1.
GRANT OF NON-EXCLUSIVE, LIMITED LICENSE The Software is licensed, not sold. Any rights not clearly and expressly granted to you under this EULA are reserved to the Authors. Provided you have paid all applicable fees and complied with this EULA, then you are granted the following personal, perpetual (subject to termination as set forth below), non-exclusive, nontransferable, limited rights: a. You may use the Software on a single domain for personal purposes for each license you have acquired; or copy the Software for archival and disaster recovery purposes, provided any copy must contain all of the original Software's proprietary notices. Each user using the Software must own a license. b. You may not decompile, disassemble, extract or otherwise reverse engineer any of the Software. You shall not have the right to obtain or use any source code for the Software, nor copy, reproduce, or distribute the Software except as provided above. You agree not to share, rent, lease, or loan the Software. You may not make any commercial use of the Software code except as expressly permitted under this Agreement.
2.
COPYRIGHT The Software and documentation is copyrighted by the Authors. All Rights Reserved. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any human or computer language without prior written permission.
3.
WARRANTY, REMEDY, AND LIMITATIONS A. YOU ARE GRANTED A LIMITED WARRANTY THAT THE SOFTWARE WILL PERFORM IN SUBSTANTIAL ACCORDANCE WITH THE ACCOMPANYING USER MANUAL FOR 56 DAYS FOLLOWING YOUR RECEIPT OF THE SOFTWARE. THIS IS YOUR ONLY WARRANTY. B. AUTHORS' ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY FOR ANY CLAIM YOU MAY HAVE AGAINST AUTHORS SHALL BE, AT AUTHORS' OPTION, (I) RETURN OF AMOUNTS PAID FOR THE APPLICABLE SOFTWARE; OR (II) REPAIR OR REPLACEMENT OF SOFTWARE WHICH DOES NOT MEET THE ABOVE LIMITED WARRANTY.
UNLESS OTHERWISE STATED ABOVE, THE SOFTWARE AND THE DOCUMENTATION SOLD WITH THIS PUBLICATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND PARTICULAR PURPOSE. THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THIS SOFTWARE REMAINS WITH YOU. IN NO EVENT WILL AUTHORS OR ANY OF ITS SUPPLIERS BE LIABLE FOR ANY LOST PROFITS, LOST SAVINGS, INCIDENTAL OR INDIRECT DAMAGES, OR OTHER ECONOMIC OR CONSEQUENTIAL DAMAGES, EVEN IF THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. AUTHORS RESERVE THE RIGHT TO MODIFY THIS DOCUMENT AT ANY TIME WITHOUT OBLIGATION TO NOTIFY ANYONE. IN NO EVENT SHALL AUTHORS' OR ITS SUPPLIERS' LIABILITY UNDER THIS AGREEMENT EXCEED THE SUM OF ANY AMOUNTS PAID HEREUNDER BY YOU TO AUTHORS OR THE SUPPLIER. 4.
TERMINATION The license will terminate automatically if you fail to comply with the terms, conditions, or limitations contained in this EULA, including the payment of applicable license or other fees. On termination, you shall, at Authors' option, either return or destroy all copies of the Software and documentation. Otherwise, this EULA shall remain in force until terminated. You may terminate this EULA at any time by destroying all copies of the Software, deleting any copies of the Software from your hard drives, ceasing all use of the Software and documentation; and providing satisfactory proof to the Authors that you have done so. The disclaimer of warranty and limitations on liability contained in Section 3 shall continue in force even after your rights to use the Software are terminated. CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 3 of 16
Table of Contents 3.01 Update Installation Instructions……………….........................………........................... 4 Step 1) Backup your database…………………………………………………………………………………….. 5 Step 2) Check Server Requirements…………………………………………………….……………………… 5 Step 3) Upload all the files to the server………………………………………...………………………….. 8 Step 4) Apply Updates to Database…………………………………………………….………………………. 8 Step 5) Upload and Open the Check Database Page……………………………………………………. 10 Step 6) Delete install.php and/or upgrade.php from Server……………………………………….. 10 Version 3.01 Update List…………………………………………………….………………………………………. 11
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 4 of 16
3.01 Update Installation Instructions: IMPORTANT: If you purchased CPV Lab before March 10th 2015 and have not continued with the Annual Update Renewal, you will not be able to run version 3.01 You can however run the most recent version your license allowed before expiration. All update packages can be found in the users area at http://CPVLab.com/Users Or, update your license renewal at http://cpvlab.com/update_license Complete the checkout process and your license will be updated automatically. You must enter the correct email address for your existing license…if you’re unsure of your existing license email, you can: - Check your email, for your original purchase receipt - In your FTP program, Navigate to your CPV Lab Directory, Open the License Folder and then open the “license.php” file and you’ll see your existing license email address. - Check your email addressed used to login to the users area at http://cpvlab.com/users - Contact support through www.TheLabHelpdesk.com SERVER REQUIREMENTS FOR VERSION 3.01 Linux Server - VPS or Dedicated Hosting (recommended) o PHP 5.3 or Above o MySQL 5.1 or Above o minimum 100 MB of disk space o IonCube Loaders 4.4 installed on the server o 256MB of Memory allocated to PHP Process (memory_limit key from php.ini) o Required PHP Extensions iconv extension mbstring extension mysql extension session extension SimpleXML extension zip extension xmlreader PHP extension mcrypt extension CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 5 of 16
Step 1) Backup your database from the Settings Page. In your CPV Lab install, Click on “Settings”, and Export a Backup of your Database from this page. o NOTE: If you don’t have enough memory assigned to run this PHP page on your server due to the size of your backup file…you can easily backup the database manually. Use this Guide to Backup your Database Manually. IMPORTANT: If you have a very large database, the Backup process from the Settings page may time out, which will lead to an incomplete database backup that won’t be good for a restore. It’s highly recommended to use the method above for backing up the database manually using PhpMyAdmin as this backup process works at a server level and won’t timeout.
Step 2) Check Server Requirements “Check Pages” have been introduced to make sure your server is ready to have updates applied without any issues caused by requirements not being met on the server. These pages should only be executed when installing or upgrading CPV Lab and removed from the server after checks are completed. These pages are included in the CPV Lab update and install packages and should be first uploaded on the server, then called directly in your browser. A. Check Server Requirements page (check-server-requirements.php) Upload the “check-server-requirements.php” page to your server before uploading any other files from the install package. Then open this page in your browser: http://yourdomain.com/check-server-requirements.php This page will check your server and determine if requirements are met. PHP version to be at least 5.3 IonCube Loaders to be at least 4.4 License check validation enabled either through “file_get_contents” or cURL 256MB of Memory allocated to PHP Process (memory_limit key from php.ini) Required PHP extensions to be loaded All (5) of these requirements must be met before proceeding with the CPV Lab installation. If there are requirements that aren’t met, upgrade your server accordingly or ask your webhost to perform the server upgrades required to finish the installation process. CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 6 of 16
When all 5 requirements are met, the page will display the following messages:
If any requirements are not met, you will then see the error messages as below. In this case, you’ll need to upgrade your server accordingly or contact your webhost to make the necessary changes.
If you get a completely blank page when calling the Check Server Requirements page, that means there is a problem with the Version of IonCube Loaders and they should be updated to 4.4 or above.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 7 of 16
B. Check Database Version page (check-database-version.php) This page should be called only when upgrading to a new version in order to see which version of the CPV Lab database is currently running. For Users with Large Databases (High Traffic Levels), this page will display a list of the files containing the upgrade MySQL queries that you should import IN ORDER into the CPV Lab database using PhpMyAdmin to perform the upgrade. **SEE STEP #3 BELOW If you have a small database, open “http://yourdomain.com/upgrade.php” to complete the update process. **SEE STEP #3 BELOW
For example, if you have version 3.00 of the database and want to upgrade to version 3.01, the Check Database Version page will display the following:
But if you have version 2.16 of the database, you will get the following message when upgrading to version 3.01:
If you are already running version 3.01 of the database and call this page, you will get the message:
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 8 of 16
Step 3) Upload all the files to the server, overwriting the existing files Make sure that your ftp client doesn't remove files from folders that you overwrite that don't have all the previous files. For example, overwriting an existing folder that has 3 files in it...with a folder that has only 1 file. In this case, make sure that the other 2 files are left intact and the other is overwritten. This appears to only affect Mac Users FTP Clients as we haven’t seen this running Filezilla on Windows. Assign Write Permissions (777) to the “smarty/templates_c” folder.
Step 4) Apply Updates to Database…Perform Only One of the following 2 operations Option 1. Open the Upgrade Page – http://yourdomain.com/upgrade.php Click “Upgrade” Button. NOTE: This option may timeout for users with extremely large databases depending on the server configuration. If this occurs…you’ll then use the direct import option below. You must first open Cpanel PhpMyAdmin Settings SQL Queries and check the option labeled 'Ignore multiple statement errors' to avoid any queries already executed from the first run of the upgrade.php page won’t cause an error and stop the process.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 9 of 16
Option 2 - Import the 'cpvlabscript300-301.sql' directly in PhpMyAdmin NOTE: This update method should be used only by users with large databases that are used to working with PhPMyAdmin or similar. If you’re not familiar with PhpMyAdmin, use the standard update process covered above by accessing the ‘upgrade.php’ page. A. Open the PhpMyAdmin utility from cPanel, select the CPV Lab database and click on the ‘Import’ tab
B. Click on the ‘Browse’ button and select the ‘cpvlabscript300-301.sql’ file from the 3.01 update package if updating from 3.00 to 3.01 If you’re running CPV Lab 2.18, then first import 'cpvlabscript218-300.sql' file into PhpMyAdmin and then the 'cpvlabscript300-301.sql' file. Uploading and then opening the “check-database-version.php” page in your browser as mentioned in Step #2-B, will show you exactly what files you’ll need to import based on your current version. C. Click on the ‘Go’ button and PhpMyAdmin will start to execute the upgrade statements from that file. Once the process is finished you will see a confirmation message.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 10 of 16
Step 5) Upload and Open the Check Database Page in your Browser to Verify that the update process has completed successfullly Open the page in your browser – http://yourdomain.com/check-database.php The page will first check that the database reports the correct version and that the database structure was correctly updated as well. If the update process ran correctly…the page will display the following messages:
Otherwise, you will see one of the following messages: The database was not updated correctly to version 3.01. It reports version 3.00 The database objects weren’t updated correctly. Please import the script file directly in PhpMyAdmin
If you see one of these error messages, you should then import the MySQL upgrade files directly in PhpMyAdmin and check the option to “Ignore multiple statement errors” as in Step #4-Option 1.
Step 6) Delete install.php and/or upgrade.php from Server In your FTP Client, Navigate to the location of your CPV Lab installation and delete “install.php” and/or “upgrade.php” Also, remove any check pages that are present on the server… check-database.php check-database-version.php check-server-requirements.php check-ioncube-loaders.php Make sure you have Write Permissions (777) set for the following folders… smarty\templates_c\ phpbrowscap\BrowserCache WURFLres WURFLres\storage\cache WURFLres\storage\persistence CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 11 of 16
Version 3.01 Update List Tracking Domains You can now Setup and Define Multiple Tracking Domains from the General Settings Page and then select the tracking domain used for links in campaign setup pages. CPV Lab can track an unlimited number of pages and offers from 1 installation. This feature allows you to add Tracking Domains within your campaigns to create campaign URLs and base links using the selected Tracking Domain. This is done by editing the DNS A-Records and or CNAME settings at your DNS or Domain Name Provider. We’ve create a walk-through for this process here: http://cpvlab.com/v3/tracking-domains.pdf Once you have your domain settings configured, you’ll then simply enter the URLs as shown below on the General Settings Page and then Enter your Password and Click Save.
Within the Campaign Setup Page, you’ll now be able to select the tracking domain to use within each campaign. The default option is ”Current Domain” (the domain/location of your CPV Lab installation). When you select a Tracking Domain, all the tracking links from the page will be updated to reflect the selected domain.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 12 of 16
Right-Click Contextual Menus CPV Lab Version 3.01 introduces a contextual menu in the data tables in order to provide quick access to the most common options. The menu is available with a right-click on the following columns: Campaign Name Keyword/Target Page Offer Date/Time IP Address Country State City The following is a contextual menu for the Keyword/Target column in Stats:
Ajax Support for All Stats Data Tables The Stats page has been redesigned to use AJAX tables in order to allow reloading a table without a page refresh. This means that you can perform any operation on a specific table and that table will refresh its content in the background leading to an improved user experience and faster load times. The operations that can be perform with AJAX on tables include: sorting, column reordering, filtering, column changes, selecting a quick view.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 13 of 16
Ability to Mark Ads, Keywords/Targets, Pages and Offers as Inactive/Active In version 3.01 you have the option to mark Keywords/Targets, Ads, Pages and Offers as active or inactive directly from the Stats page. Inactive objects will be highlighted in light blue color. Each row of the data tables from Stats has a checkbox as the first column. Select the checkboxes corresponding to the objects you want to mark as active/inactive, then use the action dropdown just below to the corresponding table to perform a bulk action for the selected objects.
Clickbank Instant Notification Service V6.0 Integration Clickbank introduced version 6.0 of their Instant Notification Service, which is used to postback conversions in CPV Lab. Each time a conversion happens, Clickbank will notify CPV Lab by making a request to the specific tracking pixel in CPV Lab. The existing Clickbank pixel within CPV Lab version 3.00 and below, was “adclick-cb.php” that was integrated with the older version (2.0) of the Clickbank INS. This pixel will still work in CPV Lab 3.01, but it is advised to use the new tracking pixel as Clickbank will most likely phase out the use of the older service in the near future. The new tracking pixel for Clickbank Instant Notification Service 6.0 is called “adclickcb60.php” and can be setup in Clickbank in a similar manner as the old pixel. First, Edit the “constants-user.php” file from the “lib” folder, and edit the following keys to enable the Clickbank Notification Service… a. Enter Numeric String for the ‘ClickbankSecretKey’ value. Ex. 123456
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 14 of 16
Next, in your Clickbank Account, go to the My Site page under Advanced Tools, and enter the secret key that you set above, set the Instant Notification URL to: http://YourDomain.com/adclick-cb60.php , Select Version 6.0 and then Click TEST IPN.
Direct Link to Offer Option Added in Redirect Profiles You can now easily skip landing pages if you wish within Redirect Profiles and send the Visitors that match the profile directly to an offer. Simply select “Direct to Offer” in the Redirect to LP Dropdown as shown below.
FOR USERS WITH CACHING ENABLED…”GeoMaxItems” option added To further optimize server sources…this key controls the maximum number of clicks to be geo-encoded in a single run of the Cache Cron job (this happens only if the UseGeoCron key is set to "true"). The default value of the GeoMaxItems key is 20000 clicks
This value should always be greater than your CachingMax|tems value you have set.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 15 of 16
Additional Features and Functions Redirect Profiles now accessible within Campaign Setup Pages. Optimization of the Caching Cron job Remember last interval selection in the Trends page Updated Color for negative numbers in data tables Updated Email Follow Up campaign import Allow redirect values to contain commas - useful for redirect conditions with ISPs o For example, if you define a redirect condition for an ISP named “Uscarrier Telecom, LLC.”, you will have to enter it without the comma as “Uscarrier Telecom LLC.”. If you use the multi-select dropdown control and select this ISP, it will be automatically added in the correct format, without the comma.
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
Page 16 of 16
User Helpdesk & Knowledgebase
@ www.TheLabHelpdesk.com
CPV Lab 3.01 Update Installation Guide - Copyright 2010 - 2016 CPVLab.com Reproduction or Sharing of this Guide is strictly prohibited without the authorized consent from CPVLab.com
