FAQ
License agreement
Change Log
Useful links
User Comments
top
Features
- Analyses common and rare configuration problems in Miva engine installation
- Unlike the official Miva Diagnostic Program (diag.mv), it provides much deeper system analyses.
- Offers advices for fixing reported problems.
- Analyses and reports security problems in Miva Empresa setup
- Verifies runaway processes in Unix Shell (if available)
- Shows available optional Miva engine features
- Measures Miva enigne performance
- Drop-in solution. No installation necessary. No configuration.
top
Description
At many hosts, Miva Empresa is too often installed in an insecure way or misconfigured in such a way that it restricts some functions (i.e. modules upload), makes the maintenance difficult, and/or disables the use of some 3rd party modules.
I found the official Miva diagnostic tool (diag.mv) as very insufficient and unreliable in many cases, and therefore have written a tool that provides much deeper analysis of the server, and besides giving some tips for solving many issues, it also reports diverse security problems.
top
Installation
Put the txdiag.mvc wherever you want in the Miva Script directory (public web area). Call it through the browser in the following way:
http://yourdomain.com/path/TxDIAG.mv
or (compiled version):
http://yourdomain.com/path/TxDIAG.mvc
or (on a local PC with Mia VM on default port 80):
http://localhost/path/txdiag.mv
or (compiled version on a local PC with Mia VM on port 8000):
http://localhost:8000/path/txdiag.mvc
From the TxDIAG interface, you can restrict access to the program - only your PC (using unique ID in a cookie) will be permitted to launch it. If you need to access TxDIAG from another PC, you'll have to delete file txdiag.conf from the Miva Data directory.
By default TxDIAG sends statistical data to the truXoft server. This data are used especially for comparing your server performance with other servers. If you do not wish that TxDIAG sends the data to truXoft, you can deny it in the txdiag.conf - replace the string 'log' with 'no'. TxDIAG never sends any data from local installation under Miva Mia, you can check the conf file after running TxDIAG locally. If you want to use it on the server, to avoid running it with reporting enabled, remove the 32bytes callerid.
top
Error Messages and Warnings
ERROR 101: Unable to Delete "xxxx" Data Directory
ERROR 102: Unable to Create "xxxx" Data Directory
ERROR 103: MvEXPORT Run-Time Error
ERROR 104: File Import Failed
ERROR 105: MvIMPORT Run-Time Error
ERROR 106: Unable to Delete Data File "xxxx"
ERROR 107: Unable to Delete "xxxx" Data Directory
ERROR 108: Unable to Delete Script File "xxxx"
ERROR 201: Unable to Delete Script File "xxxx"
ERROR 202: Unable to Delete "xxxx" Script Directory
ERROR 203: Unable to Create "xxxx" Script Directory
ERROR 204: MvEXPORT Run-Time Error
ERROR 205: Unable to Copy Data File "xxxx" to the Script Directory
ERROR 206: Unable to Move Data File "xxxx" to the Script Directory
ERROR 207: MvDO Run-Time Error
ERROR 208: MvDO Failed
ERROR 209: Unable to Delete Script File "xxxx"
ERROR 210: Unable to Delete "xxxx" Directory
ERROR 211: Cannot Change Permissions of "xxxx" Directory
ERROR 212: Cannot Change Permissions of Script File "xxxx"
ERROR 213: File export to data directory failed
ERROR 220: MvCALL failed
ERROR 221: MvCALL GET method failed
ERROR 222: MvCALL POST method failed
ERROR 225: MvCALL HTTP headers missing
ERROR 240 (250, 260, 270, 280):
- Cannot Change Permissions of "xxxx" script directory to xxx
ERROR 241 (251, 261, 271, 281):
- Unable to copy file "xxxx" to a script subdirectory with permissions xxx
ERROR 242 (252, 262, 272, 282):
- Unable to move file "xxxx" to a script subdirectory with permissions xxx
ERROR 243 (253, 263, 273, 283):
- Cannot Change Permissions of file "xxxx" in script directory to xxx
ERROR 244 (254, 264, 274, 284):
- MvDO run-time error xxxxx (permissions xxx)
ERROR 245 (255, 265, 275, 285):
- MvDO failed xxxxx (permissions xxx)
ERROR 301: Wrong Ownership
Insecure Version!
Outdated Version!
Security Warning: absolute paths are enabled!
SECURITY ALERT: data directory root is world-writable!
Security Warning: data directory root is world-readable!
SECURITY ALERT: Data directory in public space!
SECURITY ALERT: Data and Script directories identical!
Security Warning: Script directory root is world-writable!
SECURITY ALERT: New data directory is world-writable!
SECURITY ALERT: New data directory is world-readable!
Symbolic Links Not Available
Symbolic Links not available in Miva data directory
Symbolic Links not available in Miva script directory
Symbolic Links available but nonfunctional
Symbolic Links available but nonfunctional in Miva data directory
Symbolic Links available but nonfunctional in Miva script directory
Web-to-Data Symbolic Links not available
Apache .htaccess not available to Miva applications
Security Warning: .htaccess files are world-readable!
Security Warning: web directory indexes are readable!
Unix Shell Script not available to Miva applications
SECURITY ALERT: cgi-bin calls unprotected!
Miva OpenSSL support Not Available
Warning: XX runaway processes detected!
error list
ERROR 101: Unable to Delete "xxxx" Data Directory
TxDIAG was unable to delete the temporary test directory created in previous TxDIAG session. There may be numerous reasons for it. Delete it manually through Telnet/SSH or FTP to get eventually another error message telling you more precisely what is wrong.
Possible reasons:
error list
ERROR 102: Unable to Create "xxxx" Data Directory
TxDIAG was unable to create a temporary test subdirectory in Miva Data directory.
Possible reasons:
error list
ERROR 103: MvEXPORT Run-Time Error
TxDIAG was unable to create a temporary test file and write to it.
Possible reasons:
error list
ERROR 104: File Import Failed
TxDIAG was unable to read from the previously created temporary test file.
Possible reasons:
error list
ERROR 105: MvIMPORT Run-Time Error
TxDIAG was unable to access the previously created temporary test file.
Possible reasons:
error list
ERROR 106: Unable to Delete Data File "xxxx"
TxDIAG was unable to delete the temporary test file created in the Miva Data directory in a previous pass.
Possible reasons:
error list
ERROR 107: Unable to Delete "xxxx" Data Directory
TxDIAG was unable to delete the temporary test subdirectory created in the Miva Data directory in a previous pass.
Possible reasons:
error list
ERROR 108: Unable to Delete Script File "xxxx"
TxDIAG was unable to delete the temporary test file copied to the Miva Script directory in a previous pass.
Possible reasons:
error list
ERROR 201: Unable to Delete Script File "xxxx"
TxDIAG was unable to delete the temporary test file created in the Miva Script directory in a previous TxDIAG session.
Possible reasons:
error list
ERROR 202: Unable to Delete "xxxx" Script Directory
TxDIAG was unable to delete the temporary test subdirectory created in the Miva Script directory in a previous TxDIAG session.
Possible reasons:
error list
ERROR 203: Unable to Create "xxxx" Script Directory
TxDIAG was unable to create a temporary test subdirectory in the Miva Script directory.
Possible reasons:
error list
ERROR 204: MvEXPORT Run-Time Error
TxDIAG was unable to create a temporary test file and write to it.
Possible reasons:
error list
ERROR 205: Unable to Copy Data File "xxxx" to the Script Directory
TxDIAG was unable to copy a temporary test file from the Miva Data to the Miva Script directory.
Possible reasons:
error list
ERROR 206: Unable to Move Data File "xxxx" to the Script Directory
TxDIAG was unable to move a temporary test file from the Miva Data to the Miva Script directory.
Possible reasons:
error list
ERROR 207: MvDO Run-Time Error
TxDIAG was unable to execute (MvDO) a temporary test file.
Possible reasons:
error list
ERROR 208: MvDO Failed
The execution of the temporary test file gave a wrong result.
Possible reasons:
error list
ERROR 209: Unable to Delete Script File "xxxx"
TxDIAG was unable to delete the temporary test file.
Possible reasons:
error list
ERROR 210: Unable to Delete "xxxx" Script Directory
TxDIAG was unable to delete the temporary test subdirectory.
Possible reasons:
error list
ERROR 211: Cannot Change Permissions of "xxxx" Directory
Possible reasons:
error list
ERROR 212: Cannot Change Permissions of Script File "xxxx"
Possible reasons:
error list
ERROR 213: File export to data directory failed
File export did not report any problems, but the exported file was not found.
Possible reasons:
- Currently unknow. Improbable error.
error list
ERROR 220: MvCALL failed
TxDIAG was unable to make both GET and POST HTTP requests through the MvCALL command. Connections to remote servers and to local non-miva applications are not available.
Possible reasons:
- Environment variables misconfigured
- Blocking of outgoing connections for security reasons (i.e. firewalls)
- Limitation of proxy server
- No connection to the Internet
- DNS misconfiguration
- Router problems
- wrong netmask
The last case - wrong netmask was reported by Curtis Wong on a FreeBSD server:
"Systematic testing isolated the problem to a network addressing issue related to the freebsd network code implementing (virtual) ip aliasing on a common subnet. A nonconflicting netmask is needed. In our case a 0xffffffff netmask is required. It is not optional."
error list
ERROR 221: MvCALL GET method failed
TxDIAG was unable to make a GET HTTP requests through the MvCALL command. POST method works.
Possible reasons:
- Blocking of outgoing GET HTTP requests for security reasons (i.e. firewalls)
- Limitation of proxy server
error list
ERROR 222: MvCALL POST method failed
TxDIAG was unable to make a POST HTTP requests through the MvCALL command. GET method works.
Possible reasons:
- Blocking of outgoing POST HTTP requests for security reasons (i.e. firewalls)
- Limitation of proxy server
error list
ERROR 225: MvCALL HTTP headers missing
Relatively rare problem, when MvCALL return no values in http header variables and instead of it attaches the entire header to the MvCALL body in s.callvalue. It can cause problems for example in MIva Merchant modules using MvCALL to connect to a remote server for shipping calculation, fo license verfication, etc.
Possible reasons:
error list
ERROR 240 (214, 250, 260, 270, 280): Cannot Change Permissions of "xxxx" script directory to xxx
Possible reasons:
error list
ERROR 241 (251, 261, 271, 281): Unable to copy file "xxxx" to a script subdirectory with permissions xxx
Possible reasons:
error list
ERROR 242 (252, 262, 272, 282): Unable to move file "xxxx" to a script subdirectory with permissions xxx
Possible reasons:
error list
ERROR 243 (253, 263, 273, 283): Cannot Change Permissions of file "xxxx" in script directory to xxx
Possible reasons:
error list
ERROR 244 (254, 264, 274, 284): MvDO run-time error xxxxx (permissions xxx)
Possible reasons:
error list
ERROR 245 (255, 265, 275, 285): MvDO failed xxxxx (permissions xxx)
Possible reasons:
error list
ERROR 301: Wrong Ownership
Miva Empresa should be owned by the same user ID (uid) as the owner of the server account and set to run under this uid with the permission 47xx (i.e. 4755, 4700 or similar). This does not seem to be the case at this installation - runs under the uid 'nobody', what is definitely wrong.
error list
Insecure Version!
The tested Miva engine is of a version with well known very serious security flaws. An intruder could very easily break into your server. Read more details in the Security Update Log. You should contact your host or system administrator and ask them to update to the newest version immediately! Security updates are available for free from Miva Co.
error list
Outdated Version!
You are using an older, outdated Miva engine version. It is missing important features and may be considerable slower than the recently available engine. You should contact your host or system administrator and ask them to update to the newest version! Updates are available for free from Miva Co.
error list
Security Warning: absolute paths are enabled!
Your Miva Empresa is configured so that it does not use its default "sandbox" security concept, where both the data and the script files are in independent encapsulated space. Your setup allows use of absolute paths, it means Miva application can access any files on your server. It may be extremely dangerous especially in conclusion with other security flaws or use of 3rd party Miva Script applications. It can also cause run-time problems with certain Miva applications. You should contact your host or system administrator and ask them to disable absolute paths in the miva.conf file. It is controlled by the parameter securityoptions. Details may be found in the Miva Empresa Unix Configuration Manual.
error list
SECURITY ALERT: data directory is world-writable!
Miva Data directory must be not only in a space completely isolated from the public web area, but for security reasons the permissions of the directory and all its files and subdirectories must be set to be writable by the owner only (Unix permissions 700). In a Telnet or SSH session, you can change the permissions with a single command:
chmod -R 700 ~mivadata
(where mivadata is the path of your Miva Data directory)
error list
Security Warning: data directory is world-readable!
Miva Data directory must be not only in a space completely isolated from the public web area, but for security reasons the permissions of the directory and all its files and subdirectories must be set to be readable by the owner only (Unix permissions 700). In a Telnet or SSH session, you can change the permissions with a single command:
chmod -R 700 ~mivadata
(where mivadata is the path of your Miva Data directory)
error list
SECURITY ALERT: Data directory in public space!
Letting the data directory in public web folder is one of the worst mistakes an administrator can make when installing Empresa. Only the most incompetent hosts ignoring any security measures would do it. Although some hosts protect the data files from direct access by setting in Apache configuration files or through file permissions or ownerships, it is definitely insufficient protection. Usually it may be bypassed within few seconds and an intruder may be able to download your files containing valuable data (like for example credit card numbers) without any hassle.
error list
SECURITY ALERT: Data and Script directories identical!
Oh! This kind of configuration is definitely not acceptable. The ever worst case. Run away from the host as fast as you can. Data and Script directories must be completely isolated, independent, and the data directory must not be in any space addressable from the web.
error list
Security Warning: Script directory root is world-writable!
Letting script directory writable by anybody else than the owner is carefree and should be avoided. This mistake is usually made by administrators who are unable to install Miva Empresa correctly setuid.
error list
SECURITY ALERT: New data directory is world-writable!
With current Miva Empresa versions it should not be possible that a directory created by a Miva script has permissions set to be writable by 'others' and it is a very serious security flaw.
error list
SECURITY ALERT: New data directory is world-readable!
With current Miva Empresa versions it should not be possible that a directory created by a Miva script has permissions set to be readable by 'others' and it is a very serious security flaw.
error list
Symbolic Links Not Available
Symbolic links (similar to file shortcuts in Windows) may serve to a more efficient setup, are used by some Miva Script applications (i.e. the MmPASS module) for advanced features. By default they are often not available, but in case of need the may be allowed through the securityoptions setting in the miva.conf configuration file. Value 5 or 15 is in most case the best choice. Be aware of the value 16 that allows absolute paths and for security reasons should be avoided. Unlike with the absolute paths, allowing symbolic links within the security sandbox, as mentioned above, has no negative influence on the security. Details about the securityoptions parameter are available in the Miva Empresa Unix Configuration Manual.
error list
Symbolic Links not available in Miva data directory
Symbolic links are enabled only in the Miva Script directory. See also details above.
error list
Symbolic Links not available in Miva script directory
Symbolic links are enabled only in the Miva Data directory. See also details above.
error list
Symbolic Links available but nonfunctional
Symbolic links seem to be enabled, but for some reasons are not functional in both Miva Data and Miva Script directory. A possible reason may be improper ownerships in Miva Data directory or insufficient securityoptions setting. See also details above.
error list
Symbolic Links available but nonfunctional in Miva Data directory
Symbolic links seem to be enabled, but for some reasons are not functional in Miva Data directory. A possible reason may be improper ownerships in Miva Data directory or insufficient securityoptions setting. See also details above.
error list
Symbolic Links available but nonfunctional in Miva Script directory
Symbolic links seem to be enabled, but for some reasons are not functional in Miva Script directory. A possible reason may be improper ownerships in Miva Data directory or insufficient securityoptions setting. See also details above.
error list
Web-to-Data Symbolic Links not available
Symbolic links are enabled and correctly working, but cannot be use in web documents to link to files in the Miva Data directory. This restriction is usually caused either by restrictions in Apache's configuration files (Options -FollowSymLinks) or the data directory is in a tree not accessible by Apache due to a cgi-wrapper (i.e. suexec) used. Changing it is usually not necessary, and often not even easily possible.
error list
Apache .htaccess not available to Miva applications
Not any configuration problem. The warning only tells that your system setup does not seem to allow the creation or the modification of Apache configuration files through a Miva script.
error list
Security Warning: .htaccess files are world-readable!
It looks like Apache .htaccess files may be viewed by a visitor. It is not a serious security problem, but it may disclose important sensitive information about your server. It is recommended to protect configuration files from access by the following setting in httpd.conf or in the main .htaccess file:
<Files ~ "^\.ht">
Order allow,deny
Deny from all
</Files>
error list
Security Warning: web directory indexes are readable!
At directories that do not contain any index file, your server automatically generates directory indexes and displays them to the visitor. It may disclose important sensitive information about your server structure. It is recommended to protect your account with the following setting in httpd.conf or in the main .htaccess file:
Options -Indexes
error list
Unix Shell Script not available to Miva applications
Not any configuration problem. The warning only tells that your system setup does not seem to allow the use of Unix Shell script by a Miva script.
error list
SECURITY ALERT: cgi-bin calls unprotected!
Your Miva Empresa is improperly configured to use long cgi-bin formed URLs, without any protection recommended in the Miva Empresa Installation manual. If for some reason the long cgi-bin URLs have to be enabled, the validextensions parameter in miva.conf must be set. Usually, validextensions=.mv setting is sufficient. Better yet, is disabling long URLs with setting redirectonly=yes. See more details about this vulnerability in art0001.
error list
Miva OpenSSL support Not Available
Newer versions of Miva Empresa (v3.94 and v4.xx) support SSL in MvCALL commands. This feature is available only is OpenSSL library is installed on your system and properly configured. If TxDIAG reports that OpenSSL support is not available, it means that you are either using older Miva engine, or the OpenSSL library was not found.
error list
Warning: XX runaway processes detected!
On Unix systems where Shell is accessible to Miva scripts, TxDIAG verifies Unix environment for runaway processes and reports them if some found. Runaway processes may very negatively influence the performance of the server. Read more about them in art0033.htm
top
Common Mistakes
Miva Empresa not setuid
Miva Empresa in a cgi-bin wrapped account setuid
Wrong permissions of Miva Empresa binary
Missing or misconfigured Miva authorize file
Miva Empresa runs with root uid
Wrong Empresa binary used
Wrong ownership of Miva Data directory
Wrong permissions of Miva Data directory
Wrong ownership of Miva Script directory
Wrong permissions of Miva Script directory
Miva Data directory accessible from the Web
Miva Data directory identical or overlapping with Miva Script directory
Absolute paths enabled
Long cgi-bin formed URLs allowed
Long cgi-bin formed URLs allowed and unprotected
Miva Empresa not setuid
This is the very most common mistake made at Miva Empresa installation. It may be often found at many hosts and the biggest and most known ones are often the worst examples.
Miva Empresa can be installed in two modes: Server Safe and Standard. Server Safe mode is not used as often as the Standard mode, because it is little bit more complicated to set up. Most problems use to happen in the Standard Installation.
- Server Safe Installation with a common miva binary, miva.conf configuration file in the root (/etc/miva.conf) and an authorization file assigning data directories to individual accounts.
Miva Empresa binary must be owned by the 'root' uid (user id) and permissions must be set to 4755.
- Standard Installation with the Miva Empresa binary in user's private cgi-bin folder. Miva configuration file may be either in root (/etc/miva.conf) or in the same directory as Empresa. No authorization file is required. Miva Empresa binary must be owned by the uid of the account owner and must be setuid (permissions 4755, or preferably 4700). The only exception is an Apache server that is configured to use suexec (cgi wrapper) - in such case the miva binary must be still owned by the account uid, but must NOT be setuid (i.e. permissions 111 or 755). See also below.
So the conclusion: on a Unix server, there are currently only three correct ways to install Miva Empresa:
- Server Safe Install - owned by root, setuid 4755 (srwxr-xr-x)
- Standard Install - owned by account uid, setuid 4755 (srwxr-xr-x)
- Wrapped Install - owned by account uid, permissions 755 (rwxr-xr-x)
(suexec wrapper must be enabled!)
Using any other uid than the one of the account owner (resp. 'root' uid in case of Server Safe installation) is definitely wrong. Esecially wrong is using Apache's uid, generic uid like 'nobody', or using 'root' uid in Standard or Wrapped installation mode!
Normally, the setuid permissions (4755) tell the system to use the owner's uid (user id) whenever the file is run, including when it is run by others (like for example when launched from the web by a visitor - that happens at every Miva driven page). If the binary is setuid, Miva Empresa can access data files owned by the account owner. If it is not setuid, it runs with the permission of the visitor (usually 'nobody') and cannot access any data files unless they are owned by the same uid or set world readable and writable - both of such configurations would be very wrong, but unfortunately are quite common at many hosts who are not security aware or are not interested enough in running their business professionally.
common mistakes
Miva Empresa in a cgi-bin wrapped account setuid
As written above, at Apache servers using suexec cgi wrapper for higher security, Miva Empresa cannot be setuid and its permissions have to be set to 755. Setuid setting (4755) would cause 500 Internal Server Error. The same effect would have using another than uid than the one of the account owner. For these reasons, cgi wrapped accounts are usually correctly configured - the wrapper practically does not allow wrong setting (at least as long as the wrapper itself is correctly configured, of course).
common mistakes
Wrong permissions of Miva Empresa binary
The correct permissions of Miva Empresa binary in different installation modes are explained above. Practically there are only three posibilities:
- Server Safe Install - owned by root, setuid 4755 (srwxr-xr-x)
- Standard Install - owned by account uid, setuid 4755 (srwxr-xr-x)
- Wrapped Install - owned by account uid, permissions 755 (rwxr-xr-x)
(suexec wrapper must be enabled!)
The group and world permissions (last two digits) may be usually set to 1 or even 0, without any impact on the functionality.
common mistakes
Missing or misconfigured Miva authorize file
When Miva Empresa is installed in the Secure Safe mode (common miva binary in the root), it requires so-called authorization file with definitions of users' privileges and data directories. Details about settings in authorization file may be found in the Unix Authorization File Reference Manual
common mistakes
Miva Empresa runs with root uid
As explained above, miva binary must be owned by root when (but ONLY WHEN) Server Safe installation is used with a common binary and the authorization file in the root. Using the 'root' uid at a binary in the Standard Installation mode (miva in private cgi-bin directory) would be a deadly and very dangerous mistake!
common mistakes
Wrong Empresa binary used
Miva Corporation offers many Empresa builds for different OS and hardware platforms. For the very common Linux servers, there are three versions available (at least at Miva Empresa 3.xx). You have to use the one that corresponds to the Libc library available on your server. Practically all current Linux servers have the Glibc v2 library installed, and some of them even one of the Libc v5.3 or v5.4. The Libc builds are faster than the Glibc version, but if your server does not have the correct library, it may lead to weird problems.
Another common problem is at some Cobalt servers - there is a Cobalt version available at ftp.miva.com too, but some Cobalt servers are in fact PC based Linux machines and the Linux Empresa has to be used.
common mistakes
Wrong ownership of Miva Data directory
Miva Data directory must be owned by the same user id (uid) as the account owner. It means that practically all files that can be found in the account, should be owned by the same uid - both data and script files.
This is a very common mistake made by system administrators who did not read or did not understand the Miva Empresa Installation manual and did not setuid the Miva Empresa binary as described there and also above. When Miva Empresa runs with a wrong user id, inexperienced system administrators try to "fix" it by changing the ownership or permissions of the data and script directories. They usually mistakenly change the ownerships to the 'nobody' uid or made the entire directory structure world writable and readable - very dangerous!
It makes the problem even much worse than it already was and exposes the data to potential disclosure due to this serious security flaw.
common mistakes
Wrong permissions of Miva Data directory
Same as above: inexperienced or incompetent system administrators, to bypass problems caused by wrong non-setuid Miva Empresa installation, often change the permissions of the Miva Data directory tree to be world writable and readable! Very serious security flaw!
common mistakes
Wrong ownership of Miva Script directory
Practically the same as written in Wrong ownership of Miva Data directory applies also in the case of the Miva Script directory.
common mistakes
Wrong permissions of Miva Script directory
Practically the same as written in Wrong permissions of Miva Data directory and Wrong ownership of Miva Data directory applies also in the case of the Miva Script directory.
common mistakes
Miva Data directory accessible from the Web
One of the very worst mistakes made by hosts and system administrators at Miva Empresa installation, is ignoring instructions and all security notes written in the Miva Empresa Installation manual and creating the Miva Data directory within a space accessible or addressable from the Web. In the better case they naively think that protecting the data with a .htaccess file or with removing the world permission is a sufficient protection, but they do not know how very far they are from the truth.
If, by accident, you are hosted by such a company who either mixes both Miva Data and Miva Script files in the same directory tree, or has the Miva Data in a publicly accessible space, do not wait any minute more and run away as quick as you can. Find a new host who understands at least the very basic principles of security. Better yet, find a host who is responsible and specialized in Miva hosting. You will find tips in the Miva user groups.
common mistakes
Miva Data directory identical or overlapping with Miva Script directory
Explained above. If the setup was made by your host, do not walk, RUN AWAY!
common mistakes
Absolute paths enabled
Using absolute paths violates the principles of the Miva Empresa's security concept with encapsulated and separate Miva Data and Miva Script containers (so called "sandbox" principle). Although Miva Empresa allows configuration using absolute paths, instead of the default paths with roots in the two Data and Script directories, it is intended for advanced applications made by very experienced and well security aware developers for solving complicated special tasks. Absolute paths are in no case necessary in any common Miva Empresa installation, and they are never needed for Miva Merchant.
With using absolute paths, some administrators mask their incompetence to set up Miva Empresa properly. If your host uses absolute paths without any well grounded reason, you should better turn back very quickly and look for a professional provider specialized in Miva hosting.
common mistakes
Long cgi-bin formed URLs allowed
Miva scripts may be called in two ways:
- Redirects (http://domain/script.mv) - the redirection for the .mv extension must be set in one of Apache's configuration files. It may be defined also locally in .htaccess:
AddType application/x-httpd-Miva mv
Action application/x-httpd-Miva /cgi-bin/miva
This is today the standard and recommended way.
- Direct calls with miva binary in the URL - cgi-bin formed URLs. This way is insecure (see details at art0001) and if possible should be completely avoided. It can be disabled in miva.conf with the setting redirectsonly=yes.
It is a very common mistake of almost all hosts I know, that the long cgi-bin formed URL has to be used at accounts with an SSL certificate of the host instead of an own one (i.e. https://domain.host.com). It is a wrong assumption, Miva Empresa may be configured to use short redirect URL in secure mode too. More details may be found in art0014
If long URL's are allowed, they must be protected with the validextensions=.mv setting in miva.conf, to avoid the most serious consequecies.
common mistakes
Long cgi-bin formed URLs allowed and unprotected
See detailed explanation above. In this case not only that the long URL's are not disabled, but they are not even protected by the validextensions configuration directive in miva.conf! I would recommend leaving a host with such configuration immediately - it clearly shows their ignorance of very basic security principles of web hosting.
top
Limitations and known bugs
not reported any
top
Support
truXoft offers a limited free suport within 30 days after the date of the purchase for modules bought directly at truXoft Co. or at affiliated resellers as listed below. The support is limited to fixing evident unknown bugs. It does not include any help with configuration or installation of your Miva Empresa or Miva Mia. Before submitting any support query, please be absolutely sure to have entirely read the chapters Limitations and known bugs and FAQ.
Some questions may be already answered in the FAQ or may be solved with the help of other more experienced users on the Miva Script User List. I am monitoring all Miva user lists and, if possible, will help with related problems posted to the user groups.