Upgrading Miva Merchant

What's New in IT	IT Consulting	Phones/VoIP	Internet	Security	About Us	Home

	Web Site Hosting	Web Design	Broadband/Access	E-Mail Solutions	Accept Credit Cards	Hosting Support

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

NOTE: The upgrade to Miva Merchant 3.0 or higher requires an upgrade license. If you have lost your license or did not receive one, contact our Support Staff.

See instructions below for:

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

NOTE: Before upgrading your Miva Merchant, it is a good idea to make sure you are running the most recent version of Miva Empresa (which Merchant uses). If you are not, upgrade Empresa.

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.

Back-up your current miva installation. From the SSH or Telnet prompt, run the following commands:
```
% cd ~/www
% cp -R miva miva.bak
```
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.
- If you don't know the Virtual Private Server O/S, try the following:
  - Which O/S Is Your Virtual Private Server Running?
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
If you will be using the UPS Shipping Module, you may need to add the following (one) line to your Miva configuration file (~/etc/miva.conf).

<COMMERCE-LIB METHOD = "UPSRSS" LIBRARY = "/usr/local/etc/httpd/miva/lib/upsrss.so">
Verify that the upgrade was successful by visiting the following URL.

http://YOUR-DOMAIN.NAME/store/admin.mv
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.

Back-up your current miva installation. From the SSH or Telnet prompt, run the following commands:
```
% cd ~/www
% cp -R miva miva.bak
```
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.
- If you don't know the Virtual Private Server O/S, try the following:
  - Which O/S Is Your Virtual Private Server Running?
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
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/
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.
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:

Access the administrative interface using a URL like:

http://YOUR-DOMAIN.NAME/Merchant2/admin.mv
Log in and click on the expandable Store menu. Click on Add Store.
Enter just the basic store configuration information required.
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.
Finally, choose Miva Merchant v1.x Store Import and follow the prompts to import your old store data into your new store.
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.
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
```

Please note: the information on this page applies to ITS web hosting plans. It may or may not apply to other environments. If you are looking for a feature described here, or better support from your hosting provider, please consider hosting your site with ITS!

Contact ITS	Search	Site Map	StartCenter	Privacy Policy	Terms/Legal

1555 N Naperville/Wheaton Road, Suite 107
Naperville, IL 60563

phone 630.420.2550
fax 630.420.2771