Like all third party commercial products, Miva Empresa and Miva Merchant are purchased and installed separately from H-Sphere. Miva Merchant requires Miva Empresa for web server XML scripting, e-commerce and database capabilities.

• MivaMerchant starting from 4.14 requires Miva Empresa 4.02 and higher (Virtual machines or 'mivavm').
  - Supported starting from H-Sphere 2.3 RC4 and higher.
• MivaMerchant 4.12 and earlier can't work with MivaEmpresa Virtual machines and require MivaEmpresa 3.91 or earlier ('miva.cgi' machines).
  - Supported starting from H-Sphere 2.3 RC3 and higher.
• MivaMerchant 4.13 is not supported with H-Sphere!

This document explains how to install and configure Miva Empresa version 3.91 and earlier and Miva Merchant version 4.12 and earlier to work with H-Sphere 2.3 RC3. For extensive coverage of Miva products, please visit www.miva.com/products.

Important:H-Sphere 2.3 RC3 doesn't support Miva Empresa 4.02 and higher as well as Miva Merchant 4.16 and higher. It can work only with Miva Empresa 3.91 and earlier and Miva Merchant 4.12 and earlier.

For manuals on Miva products, please visit www.miva.com/products. Details on the installation of Miva Empresa can be found here.

• Integration of Miva products into H-Sphere
• How does it work?

Requirements:

• Installed and properly configured H-Sphere system.
• One valid Miva Empresa license.
• At least one valid Miva Merchant license.

Integration of Miva Products into H-Sphere

1. Download Miva Empresa bundle, Miva Merchant (e.g.: MivaMerchantv4.12.tar.gz) and Miva Commerce libraries.
   Note: make sure that downloaded Miva Commerce libraries match your operation system and the version of C libraries.
2. Copy file miva from the cgi-bin directory of the Miva Empresa bundle into the /hsphere/shared/miva/ directory and rename it to miva.cgi.
3. Change permissions on miva.cgi to 755:
   chmod 755 miva.cgi
4. Put MivaMerchantvX.XX.tar.gz into the /hsphere/shared/miva/ directory.
5. Create a symlink to your Miva bundle:
   ln -s MivaMerchantvX.XX.tar.gz Merchant-v3.00-bundle.tar.gz
   where MivaMerchantvX.XX.tar.gz should be replaced with the real bundle name.
6. Put Miva Commerce Libraries into the /hsphere/shared/miva/lib/ directory.
7. Steps 2-5 should be done for each of your servers on which you want Miva features to be enabled.
   
8. Log into the H-Sphere Control Panel under administrative account and submit your Miva Merchant licenses which you want to be controlled by the H-Sphere system to Miva Merch.Manager.

Notes:

- Login and Password for Miva admin interface are the same as for FTP unless a user has activated the original Miva Merchant setup.
- If Miva is enabled, the user can't remove the cgi-bin directory and CGI hander with .cgi extension in H-Sphere.
- mivadata and all its content is not removed when Miva resource is removed.
- To make Miva work via SSL (htpps), SSL certificate is required. If a user cannot connect to his/her Miva site by SSL(https://), you should log into Miva Merchant control panel by http, go to the Domain Settings page -> Site configuration tab and check secure URLs. If they are wrong, you should enter the correct ones.
- To enable Miva Merchant Follow Symlinks in mivaroot and stddatadir, you need to add the following line into the miva.conf file:
securityoptions=15
- miva-empresa-install.sh scripts are different for Linux and FreeBSD.

How does it work?

1. A user logs into the control panel and activates the Miva resource.
2. H-Sphere finds an available license in the database and allocates it to this user.
3. The cgi-bin and mivadata directories are created inside the user's site directory, if only they haven't been created earlier.
4. miva.cgi is copied into the cgi-bin directory.
5. miva.cgi is registered in the config file, in which the mivaroot and mivadata variables are defined. mivaroot is configured to be the same as DocumentRoot for Miva-enabled site. mivadata is defined as the mivadata directory inside this user's site.
6. Permissions to these directories along with their content are changed.
7. Now the user can activate Miva Merchant. Miva Merchant is created using a web-based form containing the fields required by Miva Merchant, though a user can activate the original Miva Merchant installer by entering his site URL followed by /cgi-bin/miva.cgi?/Merchant2/setup.mv or his site URL followed by /Merchant2/setup.mv.