View Full Version : Miva 4 to Miva 5 upgrade problems Did this happen to you?

04-01-2007, 09:07 PM
I have a miva 4 store that I wanted to upgrade to miva 5. So i bought the upgrade license from westhost and upgraded. Upgrading messed up my miva 4 store.

Westhost said that I cannot upgrade because OpenUI (in my miva 4 store) is messing up the upgrade. They want me to unistall my miva 4 store and then do the upgrade. Well I can't shut down my store to develop the new one. I'd lose money.

My question is: Has anyone succesfuly upgraded a miva 4 store to miva 5 and your miva 4 store was using openui?



05-14-2007, 06:05 AM
Have spent last three days trying to do this. WH direction email had wrong URL to use and then when I finally got them to fix this I keep getting message that my license number (current) doesn't exist even though it clearly shows on my Miva Merchant registration page. Wonder if WH has ever actually done this upgrade??!!!

WestHost - MCox
05-25-2007, 09:42 AM
Here are very detailed instructions for upgrading Miva 4 to Miva 5:

NOTE: You will need a ‘Miva Merchant 5 Upgrade License' to upgrade your Miva Merchant 4 stores to Miva Merchant 5. You may purchase this license at https://corp.westhost.com/addons/

Step 1: Install Miva Merchant 5

From the Site Applications Section of your Site Manager, install the “Miva Merchant 5 Upgrade” Site Application. (If you are reading this from your VPS, you have already completed this step successfully.)

Step 2: Run Setup for Miva Merchant 5

Use the “Setup 5” link from your administrative links to run Setup for Miva Merchant 5. You'll find setup instructions as another administrative link. Be sure to read the setup instructions carefully, the paths to admin.mvc and store.mvc have changed with Miva Merchant 5.

Setup 3: Add the Store Manager to the Users List in Miva Merchant 5

Before the store can be created via the provisioning file, the user who was the store manager in Miva Merchant 4 must exist in the new domain-level users list in new Miva Merchant 5. A store cannot be imported if the manager is not present in the users list. The store manager's password in Miva Merchant 5 does not need to match their old password.

If the Miva Merchant 5 domain owner is also the store manager, they will already exist as a user. In that case, all you need to do is ensure that the spelling and capitalization is the same as it was in the Miva Merchant 4 store.

To add a user, in the Miva Merchant 5 administration interface, locate Users [Add] in the left navigation area. Click [Add].

If you want to designate a new store manager, either make that change in your existing store, before creating the provisioning file, or add the outgoing manager to the users list in Miva Merchant 5 for the purpose of importing the store, then specify a new manager after the store has been imported.

Step 4: Maintenance Mode

Put the Miva Merchant 4 store into maintenance mode. Detailed instructions on working with Maintenance Mode are available here: Edit Store / Maintenance Mode (Miva help topic).

Leave it in this state until you are comfortable with the new store, and your have finished processing any open orders in the old store. Keeping the store "closed for maintenance" will prevent orders from being placed there after you have switched operations to your Miva Merchant 5 store. If orders were to be placed in both stores, inventory levels would get out of synch, and you would have two sets of data to maintain, and two sets of incoming orders to manage.

There is a 6-month transition period, during which your Miva Merchant 4 store remains fully functional. Once you are secure with the new Miva Merchant 5 store, and have completed any unfinished business in the old store, you can delete the store.

Also see the suggested meta refresh technique, described below under Handle Links Coming in to The Store. By using this technique, you can direct shoppers to your new store.

Step 5: Create the Provisioning File (provide.xml) from Your Miva Merchant 4 Store

When you installed the Miva Merchant 5 Upgrade Site Application, two upgrade modules were uploaded to your VPS. Download the module you need to your local computer before proceeding.

* upgrade5.mv (for Miva Merchant 4.00 through 4.13)
* upgrade5.mvc (for Miva Merchant 4.14 and higher)

These modules are located at: /home/<username>/Miva5Upgrade/ within your VPS.

From Miva Merchant 4:
In the left navigation area, at the domain level, expand the Modules menu, and click Add Module. Click the round Upload File button to locate the file on your computer. Click Add to add the export module to your store.

Once the appropriate module is installed at the domain level, it will be available in the Utilities area of each store in the domain.

In the left navigation area, under Stores, expand the menu for the store you want to export. Expand the Utilities submenu, then the Export Data submenu. Select Export Store to Miva Merchant 5.x.

Click Export, or change the name of the export file and then click Export. Check marks will indicate progress through list of tasks as they are completed. When the entire file has been created, Export Complete will appear at the bottom of the task list.

Note that if you name the file something other than provide.xml, it will need to be renamed back to provide.xml before it can be imported into your Miva Merchant 5 store, but you may want to change the name here to reflect the store name, such as MyStoreNo3Export.xml, if there are several stores in the domain.

Step 6: Move the File

In the store data directory for your Miva Merchant 4 store, there will be an export folder, such as DATA\Merchant2\00000001\export, for the first store. In that directory, locate the file provide.xml (or a file by the name you specified).

Copy this file to your Miva Merchant 5.00 root data directory - the same directory where the Merchant2 and Merchant5 directories are located. If you specified a different name for the file earlier, rename it now to provide.xml.

Step 7: Log In to Miva Merchant 5

When you log in to the new administration interface, Miva Merchant will detect the provide.xml file, and will automatically import the store. A message will appear to inform you that Miva Merchant is performing automated configuration operations. Do not close the browser window during the import process.

This will create the store, and populate it with the products, categories, settings, and so on that you exported from your Miva Merchant 4 store.

Any errors (invalid codes, etc.) will be recorded in the Miva Merchant 5.00 data directory in a file named provide.log.

Once the file has been processed, it will be renamed provide.xml-processed-yyyymmdd-hhmm, where yyyymmdd is the date, and hhmm is the time that the provide.xml file was processed.

Step 8: Copy the Store Image Files

For each Miva Merchant 4 store, there will be a graphics directory containing all the images used in the store, including product images, category images, and the images used for buttons and navigation features. There is a separate graphics directory for each store, such as HTML (or Web)\Merchant2\graphics\00000001 for the first store.

So that your images will appear in the new Miva Merchant 5 store, copy all the files in the store graphics directory into the corresponding new store graphics directory, such as HTML (or Web)\mm5\graphics\00000001.

NOTE: Do not copy the entire \ graphics directory, only each individual store directory. If you were to replace the entire Miva Merchant 5 graphics directory with the one from Miva Merchant 4, it would overwrite the images used throughout the administration interface and wizards.

Step 9: Install Any Third-party Modules

Because Miva Merchant 5 and previous versions use significantly different database technology, most third-party modules designed for earlier versions will need to be upgraded. Some modules may no longer be necessary. Before adding any third-party module to your Miva Merchant 5 system, contact the module developer to assess compatibility issues and/or the need for upgrades.

When you are ready to add new modules to the system, in the left navigation area, at the domain level, locate Modules [Add]. Click [Add]. Click the Upload button to locate the module file on your computer. Click Add to add the module to your store. Repeat for each new module.

Step 10: Handle Links Coming in to The Store

Your own site, and others, including search engines, may link to your store, or even to individual product screens. Take advantage of these sources of shoppers by providing an easy way for them to continue to find your store.

Links from Your Own Web Site

If your Miva Merchant store is incorporated into a Web site, update any links to reflect the new store URLs. To learn the URL for a store screen, go to that page directly, and make a note of it, or click the Links button, available throughout the administration interface, in the upper-right corner of many screens.

Meta Refresh - "Make a Note of Our New Address"

You can alert others to the change, and give them an opportunity to update their links or bookmarks, by using a HTML meta refresh tag in the maintenance message for the old store. This works much like a paper Change of Address card for a brick and mortar store. It alerts people to the fact you have a new address, and it is only available for a limited time.

When a shopper attempts to access any area of your store, they will see the maintenance message. After a few moments (an interval which you specify), they can be automatically taken to the storefront screen for your Miva Merchant 5 store.

Here is a simple example of a maintenance message that will send a visitor on to your new storefront. Insert your new store URL in place of the example URL shown here. Notice that content="10", in the first line, gives an approximately 10 second pause before going to the new screen. You can specify any amount of time you like. Keep in mind that people need longer to read text than you might expect.

<meta http-equiv="refresh" content="10; URL=http://www.Miva.com/docs/merchant/mm5/DocsIndex.html">

%store_name% has moved to a new location. <br><br>

Please update your bookmarks, and visit us at:<br>

<a href="http://www.Miva.com/docs/merchant/mm5/DocsIndex.html">Visit Our New Store</a><br>

Click the link above, or wait to be taken to the above site in about 10 seconds.

The message will appear, and send visitors to your new store, during the 6-month transition period, while your old store is left in maintenance mode.

Server Redirect - They Won't Even Notice a Change

If you manage your own server, you can use a server redirect. If your store is provided as part of an e-commerce package, contact your hosting company for assistance. The server redirect can be used in addition to the meta refresh described above, and should be, if your server or host supports it.

There are several advantages to using this method. First, the shopper is delivered to the exact page they were looking for, rather than being taken to the storefront. Second, you can keep the server redirect available as long as you like, where the meta refresh technique will only be available during the 6-month transition period from Miva Merchant 4 to 5.

Update Any Search Engine Listings

If your store is listed with services that submit it to search sites, update your listings to include the new URLs.

Resynchronize Miva Marketplace

If you are using Miva Marketplace throughout the store, resynchronize to update all the listings at once. If you only have a few products listed, or just your storefront, manually update those listings to point to the updated URLs.

Step 11: Process Any Outstanding Orders from your Miva Merchant 4 Store

Remember, order information is not transferred to the new store. Leave the old store in maintenance mode (to prevent shoppers from placing any new orders), and finish processing any orders that are still open in your old store. The old store will remain available to you for six months. That is, the license allows for a 6-month overlap period, when you can get the new store up and running, and close out the old one.

Updating Additional Stores?

Log out of Miva Merchant 5.

Follow the same steps outlined above, beginning with creating the provisioning file. Remember to find the provisioning file, provide.xml, in the export directory for the store you are upgrading at the moment.

If you named the file anything other than provide.xml, rename it to provide.xml now.

Remember that the store manager must already be a user in your Miva Merchant 5 system before their store can be created.

When you are ready, log in to Miva Merchant 5 again, and the additional store will be created.

Be careful to copy any store images to the correct store graphics directory.


If you encounter any of the following situations, try the following solutions.

I created the file, and logged in to Miva Merchant 5, but it didn't create the store.

There are several possible reasons that the store would not be created. Depending on the situation, there may be a log file, provide.log, which you can open and read with any text editor.

* First, if you named the provisioning file anything other than provide.xml, be sure to change the name back to provide.xml. If the file name had been changed, log out of Miva Merchant 5, and rename the provisioning file to provide.xml. When you log into Miva Merchant 5 again, the store will be created.
* Check to see that the file is in the same directory where the Merchant5 directory is located ( not in the Merchant5 directory). If the file was not in the that directory, log out of Miva Merchant 5, and move the provisioning file, provide.xml, into the directory. When you log into Miva Merchant 5 again, the store will be created.
* Confirm that the store manager from your version 4 store is in the user list for your version 5 domain. Make sure the name is spelled and capitalized the same way. If the store manager is not found, the log file will include the error: User '<ManagerName>' not found. The many subsequent reported errors are only a result of the store not being created. To resolve this issue, create a user in Miva Merchant 5 having the same name as that of the store manager, then log out of Miva Merchant 5. Next, rename the provisioning file back to provide.xml (it will have been renamed to indicate that it was processed). Finally, log into Miva Merchant 5, and the store will be created.

My store was created, but all the graphics are missing.

Remember that you must copy the image files into the new store graphics directory. They are not imported via the provisioning file (but all references to them are). Review the instructions above, under Copy the Store Image Files. Once you have copied the image files, refresh your browser window to see them appear in the new store.

NOTE:This Document was taken from Miva's online help document: http://www.miva.com/docs/merc_5.x_help/providexml.html, slight modifications were made to include instructions specific to this hosting environment.

WestHost - MCox
05-25-2007, 10:11 AM
The above information should get the upgrade process completed successfully. If you are having license problems, please contact us at http://members.westhost.com/contactus.html and we'll get the license problem resolved for you.