Upgrading Miva Merchant
Miva Merchant 4.12 is currently the latest version of Miva Merchant available for the Virtual Private Server

See instructions below for:

• Upgrading from v2.x or 3.x
• Upgrading from v1.x

Upgrading from v2.x or 3.x
If you already have Miva Merchant 2.x or 3.x installed, follow these directions to install the latest version.

1. Back-up your current miva installation. From the SSH or Telnet prompt, run the following commands:

   % cd ~/www
   % cp -R miva miva.bak
         

2. Install the new Miva Merchant distribution, according to the instructions that correspond to your Virtual Private Server O/S.

   • FreeBSD and Solaris [Miva Merchant 4.12]
     Connect to your server via Telnet or SSH and issue these commands:

     % cd ~/www/htdocs/store
     % tar xvzf /usr/local/contrib/mvmerchant.tar.gz
             

     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.

   • BSD/OS Upgrade! [Miva Merchant 2.22]
     Connect to your Virtual Private Server via Telnet or SSH and issue these commands:

     % cd ~/www/htdocs/store
     % tar xvf /usr/local/contrib/mvmerchant.tar
             

     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.

   • Huh?
     If you don't know the Virtual Private Server O/S, try the following:

     • Which O/S Is Your Virtual Private Server Running?
   
   

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

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

4. If you will be using the 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">

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

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

6. Once you are sure that your new store is working, you may delete the backup of your old store. From the SSH or telnet prompt, type:

   % cd ~/www
   % rm -Rf miva.bak
         

Upgrading from v1.x
If you have Miva Merchant 1.x installed, follow these directions to install the latest version.

1. Back-up your current miva installation. From the SSH or Telnet prompt, run the following commands:

   % cd ~/www
   % cp -R miva miva.bak
         

2. Run the upgrade script that corresponds to your Virtual Private Server O/S.

   • FreeBSD and Solaris [Miva Merchant 4.12]
     Connect to your server via Telnet or SSH and issue this command:

     % /usr/local/bin/mvmerchant1-upgrade

     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.

   • BSD/OS Upgrade! [Miva Merchant 2.22]
     Connect to your Virtual Private Server via Telnet or SSH and issue this command:

     % /usr/local/contrib/mvmerchant-upgrade

     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.

   • Huh?
     If you don't know the Virtual Private Server O/S, try the following:

     • Which O/S Is Your Virtual Private Server Running?
   
   

3. A ~/www/htdocs/Merchant2/ directory will be created on your Virtual Private Server and the script should instruct you to begin configuring your Miva store by running a script like this:

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

4. 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/

5. 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.YOUR-DOMAIN.NAME.

6. 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. 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. Log in 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.

7. Once you are sure that your new store is working, you may delete the backup of your old store. From the SSH or telnet prompt, type:

   % cd ~/www
   % rm -Rf miva.bak