NOTE: These instructions are intended for people upgrading an existing version of Miva Empresa to a more recent version. If you do not already have Miva Empresa installed on your Virtual Private Server, see the installation instructions.

We have designed a script to help make upgrading your version of Miva Empresa as simple as possible. Because there are two different versions of Miva Empresa available for use on your Virtual Private Server, please see the main Miva Empresa information page to determine which version is right for you.

If you are using Miva Merchant, you will need to upgrade the version of Merchant you are running at the same time you upgrade your Miva Empresa version. Please note that major version upgrades (version 3.x to 4.x, for example) require you to purchase an upgrade license from Miva before performing the upgrade. Miva Merchant may not work if you upgrade Empresa without also upgrading to the appropriate version of Miva Merchant at the same time.

Once you are ready to begin the upgrade, connect to your Virtual Private Server via SSH or telnet. The first step you will need to do is back-up your current version of Miva Empresa. To do this, run the following command.

% cp -R ~/usr/local/miva ~/usr/local/miva.backup

If you are using Miva Merchant, you will also need to back-up the directory where your store information is located. Depending on which version of Miva Merchant you are using, the name of this directory may vary. Use the cp -R command as illustrated above to create a copy of your store.

Once you have all your essential information backed up, you can run the upgrade script by running the following command.

% vinstall miva-upgrade

The upgrade script will detect which version of Miva Empresa you currently have and list the available upgrade options. Select the appropriate upgrade option, and the script will install the appropriate files and update the information in your ~/www/conf/httpd.conf file.

After installing the new version of Miva Empresa, the upgrade script will ask you if you also want to upgrade your version of Miva Merchant. If you are ready to upgrade Miva Merchant (you have already backed up your Merchant information and have an upgrade license if applicable), select yes, otherwise select no.

Once you are certain that the upgraded version of Miva is working properly and that you have not lost any data during the upgrade process, you may delete the back-ups from your server.

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!

1555 N Naperville/Wheaton Road, Suite 107
Naperville, IL 60563
phone 630.420.2550
fax 630.420.2771