Upgrading from Affiliate Manager version 1 to version 2

Upgrading from JAM version 1 to JAM version 2 requires a number of different steps, and so you have to bear a few things in mind.

 

First, it is not a one step upgrade.  It will require a number of steps to accomplish as the upgrade will migrate certain data from your current version of JAM to the new one.

 

There will be some downtime, due to the migration of data from one database to another. How long this takes depends on the size of your data.

 

Second, because the new version of JAM has been rewritten from the ground up, certain data will not be migrated automatically.  

These tables include:

• jx_affiliate_groups - the commission levels for each program will be migrated as affiliate groups, so you will have to create custom groups manually after the migration.
• jx_content - the affiliate content pages, including program description, privacy policy, and terms of service. These must be manually recreated.
• jx_custom_commissions - custom commissions that are set for each affiliate member.  The new version uses affiliate groups instead.
• jx_downloads - downloadable files will not be migrated and will have to be manually recreated in the new version
• jx_notes - affiliate notes are no longer created in the new version.

 

Other data, such as banner images, will have to be manually copied from the /banners folder to the /images/banners folder of the new affiliate software install.

 

 Steps for upgrading JAM

1. Yo must first install the new version of JAM on a separate folder, apart from your JAM version 1 install. For example /affiliates2.  Instructions for installing JAM are available here:
2. Once it is installed, you will have to copy all of your banners from your version 1 /banners  folder to your version 2  /images/banners folder.
3. Finally, you will have to switch out the following files with update ones located in the /docs/upgrade folder:
• jrox.php 
• sale.php
• image.php
4.  Copy those files to the root folder of your new version of JAM. Those new files will be used for the old affiliate links so that they will be redirected to the correct URLs once you have finished migration.
5. Once you have installed it, login to the affiliate admin area for JAM version 2.  To begin the migration, click on Settings > Data Import.  Click here to watch a video on the data migration:
6. The module for JAM version 1 Database Import will be listed. To begin migration, click on the Run Module settings.
7. The script will now try and migrate your database tables over to the new JAM. This can take a while if you have a lot of data.
8. If you have a large database, you may have to change the PHP Memory Limit in Settings > Global Configuration > System > System Settings > PHP Memory Limit.  You can set it t 256M or 512M.
9. Once the migration has been finished, check your Members, Programs, Commissions, and Payments areas.
10. Now, open up the /system/application/config/config.php file on your new version and change the subfolder  to point to your old one:
    
    $config['base_folder_path'] = '/affiliates';
    
11. Finally, rename the folder name of your new version of JAM to your old version:  /affiliates2  to /affiliates

 

 * If you need help in migration, we offer migration services for a nominal fee.  Please don't hesitate to contact us. As always, remember to back up your data before making any major changes.

---