Upgrading Miva Merchant

• Miva Merchant v3.0 Release Notes
• Miva Merchant 3.0 Press Release

Because of the many enhanced features contained in this new version of Miva Merchant, you should strongly consider upgrading as soon as possible.

See instructions below for:

• Upgrading from v2.x
• Upgrading from v1.x

Upgrading from v2.x

1. Connect to your Virtual Server via Telnet or SSH. Change to your Miva Merchant store directory and unpack the new Miva Merchant distribution.

   FreeBSD Miva Merchant 3.0
   % cd ~/www/htdocs/store
   % tar xvzf /usr/local/contrib/mvmerchant.tar.gz
   
   BSD/OS Miva Merchant 2.22
   % cd ~/www/htdocs/store
   % tar xvf /usr/local/contrib/mvmerchant.tar
   
   SunOS Miva Merchant
   unavailable
   

   NOTE: If your Miva Merchant store is installed in a different directory, change to that directory instead of ~/www/htdocs/store. For instance, your store directory might be ~/www/htdocs/Merchant2.

2. Visit the following URL and follow the instructions contained on that page. Your current configuration should be okay if your v2.0 store was already working correctly.

   http://YOUR-DOMAIN.NAME/store/upgrade.mv

3. If you will be using the new UPS Shipping Module, you may need to add the following line to your Miva configuration file (~/etc/miva.conf).

   <COMMERCE-LIB METHOD = "UPSRSS" LIBRARY = "/usr/local/etc/httpd/miva/lib/upsrss.so">
   

4. Verify that the upgrade was successful by visiting the following URL.

   http://YOUR-DOMAIN.NAME/store/admin.mv

Upgrading from v1.x

1. Connect to your Virtual Server via Telnet or SSH and issue the command that matches your Virtual Server O/S.

   FreeBSD Miva Merchant 3.0
   % /usr/local/bin/mvmerchant1-upgrade
   
   BSD/OS Miva Merchant 2.22
   % /usr/local/contrib/mvmerchant-upgrade
   
   SunOS Miva Merchant
   unavailable
   

2. This should create a ~/www/htdocs/Merchant2/ directory on your Virtual Server and instruct you to begin configuring your Miva store by running a script like this:

   http://YOUR-DOMAIN.NAME/Merchant2/setup.mv

3. The setup requires you to register and individually activate your new license. To do this, on the registration form, click on the link "Activate Upgrade License". Alternatively, you may do this by going to the following URL:

   http://www.miva.com/upgrade/merchant/2.0/

4. After registration, click the "Install" button. You should now be at a screen where you can enter your site configuration. The default settings are acceptable for all the options except for those involving the Secure Server. Choose the second option that Miva suggests (i.e. do NOT choose "None", unless you do not want to offer secure transaction support). NOTE: your Mail Server can be "smtp.YOURDOMAIN.NAME".

5. After site configuration, click the "Install" button. Now, you will be required to add an administrative user.

After the administrative user is created, Miva Merchant will complete its installation. However, before your new store will look and function like your old v1.x store, you must import the data into the new database. To do this:

1. Access the administrative interface using a URL like:

   http://YOUR-DOMAIN.NAME/Merchant2/admin.mv

2. Login and click on the expandable "Store" menu. Click on "Add Store".

3. Enter just the basic store configuration information required.

4. Once the store has been added to your menu list, expand its menu, then its "Utilities" menu, and finally its "Import Data" menu. Documentation on this Import utility can be found in the Miva Merchant User Manual in the Miva Product Documentation.

5. Finally, choose "Miva Merchant v1.x Store Import" and follow the prompts to import your old store data into your new store.

6. After you have thoroughly examined your new store and its new features, you can go live by simply renaming its directory to the name of your old store directory. Of course, this will require you to rename the old store directory first to something like mivastore.old.