Knowledgebase: Miva Empresa VM
Miva Merchant Virtual Machine: Install - Part 1
Posted by - NA -, Last modified by Wayne Smith on 19 July 2013 03:51 PM

Author: Quiche Jackson

Summary

This article is the first of many that will get you going on the install of our Miva Merchant Virtual Machine. Starting off with a simple interview to determine which install method you will use. Followed with a FILE MAP to break down what are all the pieces that make up the MIVA VM install package. Continued on to Part 2

Resolution


SERVER ADMINISTRATOR INTERVIEW
	* suEXEC is NOT running?
	 	- Y: Use MivaVM GLOBAL INSTALL
		- N: Use MivaVM PRIVATE INSTALL

	* Do you want to install and maintain a single instance/installation of the Miva VM?
	 	- Y: Use MivaVM GLOBAL INSTALL
		- N: Use MivaVM PRIVATE INSTALL

	* Do you want to keep resource/processor usage to a minimum?
	 	- Y: Use MivaVM GLOBAL INSTALL
		- N: Use MivaVM PRIVATE INSTALL
	
	* Do you want all users/sites to have the same version the MIVA VM?
	 	- Y: Use MivaVM GLOBAL INSTALL
		- N: Use MivaVM PRIVATE INSTALL

	* You do NOT use shared SSL to secure multiple sites? (all site have there own ssl certificate or run non-securely)
	 	- Y: Use MivaVM GLOBAL INSTALL
		- N: Use MivaVM PRIVATE INSTALL

FILE MAP: (examples assume linux glibc2 distribution 'mivavm-v5.19-linux.tar.gz' is extracted to a dir called 'mivavm-v5.19' from '/')
*Extracted Distribution Layout

Miva Merchant Software
mivavm-v5.19/
	certs/
                 raw/
		      (224 cert files)
		                        
                 *openssl-0.9/  
                      (224 cert files)

                 *openssl-1.0
                      (224 cert files)
* New in v5.12 or higher of Miva Merchant Empresa

* If your UNIX distribution uses OpenSSL v0.9.x, you must change the value of HTTP_MvCONFIG_DIR_CA to end in "openssl-0.9"
* If your UNIX distribution uses OpenSSL v1.0.x, you must change the value of HTTP_MvCONFIG_DIR_CA to end in "openssl-1.0"

* If your UNIX distribution uses OpenSSL v0.9.x, you must change the value of cadir to end in "openssl-0.9"
* If your UNIX distribution uses OpenSSL v1.0.x, you must change the value of cadir to end in "openssl-1.0"

	cgi-bin/
		mivavm-v5.19
	doc/
		LICENSE.txt  
		README.txt  
		RELNOTE.txt
	lib/
		builtins/
			archive.so
			crypto.so
			file.so
                        logging.so
			math.so
                        mvlibgd.so
			string.so
			system.so
			template.so
			time.so
	
        	commerce/
                        linkpoint.so  

		config/
			3x.so
			env.so
		
                databases/
			mivasql.so
			mysql.so

	tools/
		diagtool.mvc

FILE DESCRIPTIONS:  
mivavm-v5.19-linux.tar.gz 	
- This is the tar gunziped file that you will extract to 'mivavm-v5.19' when installing the Miva Merchant Virtual Machine  

mivavm-v5.19/certs/* 
- This folder contains all the certificates used for secure processes in Miva Script and Miva Merchant 5 
   03e16f6c.0 is an example of the total 224 cert files  

mivavm-v5.19/cgi-bin/
-The 'mivavm-v5.19' is the Miva Merchant Empresa Binary the actual 'Miva VM' this article is about 
- Copy this file to your private or global cgi-bin
- MVM GLOBAL INSTALL  : Determine the location usually ScriptAlias'ed in the Apache Configuration File (httpd.conf)
- MVM PRIVATE INSTALL : There is usually a cgi-bin the site root directory  

mivavm-v5.19/doc/ 	
- License info, readme and release notes  

mivavm-v5.19/lib/builtins/ 
- All the builtin libraries that the MVM uses to execute Miva Merchant Script built in functionality  mivavm-v5.19/lib/commerce/ 
- A Commerce Library is a file that is stored on the server which allows for secure transactions with other website using Miva Merchant. 
- By default only one commerce library (linkpoint.so) is distributed.   

mivavm-v5.19/lib/config/ 	
- This release of the Miva Virtual Machine ships with two configuration libraries: "lib/config/3x.so" and "lib/config/env.so".   
   "3x.so" is a configuration library that provides compatibility with the configuration file used by v3.x of Miva Empresa.  
   "env.so" is a configuration library that obtains configuration values from  environment variables.          
The Miva Virtual Machine first looks for its configuration library as "libmivaconfig.so" in the current directory.   
If this file is not found, then the engine tries to load the DSO identified by the environment variable MvCONFIG_LIBRARY (if set).  
For security reasons, the owner of the configuration library must be either the same as the user executing the Miva Virtual Machine, or root.  	
MVM GLOBAL INSTALL  : env.so 	
MVM PRIVATE INSTALL : 3x.so 	 
Which ever library you will be using copy it to the same location as you mivavm (in the cgi-bin) and rename it to libmivaconfig.so  

mivavm-v5.19/lib/databases/ 	 
- Database libraries that allow you to access multiple data sources with the same Miva Merchant Script language and Miva Merchant 5 shopping cart   

mivavm-v5.19/tools/
- Miva Merchant Diagnostic Application diagtool.mvc is a Miva Merchant Script Compiled file that you can run in your Public Web dir to test if your Miva VM install is working correctly. 	  
To install the application, upload it directly into your document root/home directory and run it by typing the URL into your browser, www.yourdomain.com/diagtool.mvc?
Click here to read more about the diagtool.mvc
(662 vote(s))
This article was helpful
This article was not helpful

Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments:
CAPTCHA Verification 
 
Please enter the text you see in the image into the textbox below. This is required to prevent automated registrations and form submissions.

Help Desk Software by Kayako support.miva.com/supportsuite/index.php?