Miva Installation for Windows

Last modified: 27 Dec 2007

Like all third party commercial products, Miva Empresa and Miva Merchant are purchased and installed separately from H-Sphere. Miva Merchant requires Miva Empresa (also known as Miva Virtual Machine or 'mivavm') for web server XML scripting, e-commerce and database capabilities.

• MivaMerchant 5.x is supported starting from H-Sphere 2.4.3 Patch 1 inclusive. It requires Miva Empresa 5.02 and higher.
• MivaMerchant 4.14 and later is supported from H-Sphere 2.3 RC 4 inclusive. It requires Miva Empresa 4.02 and higher.
• MivaMerchant 4.13 and older is no longer supported with H-Sphere 2.4.3 Patch 1 and up!

It is recommended to install Miva products prior to H-Sphere winbox software. If you choose to do so, simply install Miva Empresa and Miva Merchant following Miva documentation. Afterwards, install H-Sphere winbox software, and the installation wizard will guide you through the Miva configuration procedure. If you need to install Miva on a running winbox, you need to do the following:

1. Install Miva Empresa using Miva instructions.
2. Install Miva Merchant using Miva instructions.
3. Go to your admin control panel, select E.Manager -> L.Servers, click the Windows server, and at the bottom of the page that appears specify the version of Miva Merchant. For H-Sphere 3.1 Beta 2 and up, specify also its location on your box:

   

4. For H-Sphere 3.1 Beta 2 and up, run H-Sphere Update Wizard.
5. Optionally, install miva commerce libraries.
6. (Deprecated since H-Sphere 3.1 Beta 2 and up) Open the configuration file <hsdir>\scripts\conf.inc (<hsdir> is H-Sphere installation directory).
7. (Deprecated since H-Sphere 3.1 Beta 2 and up) Set Miva Empresa, Miva Merchant, and optionally Miva commerce libraries directory paths in the Miva constants section by changing values to the mivaDirectory, mivaMerchant, and mivaCommerceLibDir parameters.
8. (Deprecated since H-Sphere 3.1 Beta 2 and up) Open the configuration file hsphere.net\bin\hsphere.config and find the following string:
   - for HS 2.5 branch:
   <prop name="mivamerchant" value="" description="Miva merchant directory" />
   - for 3.0 branch:
   <prop name="miva-merchant-path" value="" description="Miva Merchant location" />,
   and add the path into the value parameter, e.g.: <prop name="mivamerchant" value="D:\\Miva5\\" description="Miva merchant directory" />.
9. (Deprecated since H-Sphere 3.1 Beta 2 and up) Optionally, remove unused libraries from mivaLibNames and mivaLibMethods.
10. (Deprecated since H-Sphere 3.1 Beta 2 and up) Restart HSsvc and H-Sphere services to apply changes.
11. Log into your admin Control Panel, select Miva Merchant Lic. in the 3rd party Tools menu and enter your Miva Merchant licenses:

    

12. Enable Miva in your hosting plans.

Once you have enabled Miva, users can turn them on in their control panels. User's miva login and password are same as for FTP. See related user documentation.