Prev 2.2. VirtueMart Installation Next

2.2.7. Installation FAQ

2.2.7.1.1. The Installer tells me "ERROR: Could not find an XML setup file in the package". What's wrong?
2.2.7.1.2. The Joomla! 1.5 installer fails to install VirtueMart with the error message "There was an error uploading this file to the server.". What's the problem?
2.2.7.1.3. The installation on Joomla! 15 fails with the error “Your Extension appears to be written for an older version of Joomla!. You must enable the System - Legacy Plugin in the Plugin Manager if you wish to complete this task.”.
2.2.7.1.4. The Installer tells me "Another component is already using the directory com_virtuemart"
2.2.7.1.5. When using the automatic installation nothing happens after clicking on "Upload & Install" or the installer tells me "Failed to move to /media directory" What's the cause?
2.2.7.1.6. What are those tar.gz files, aren't those for Unix/Linux systems only?
2.2.7.1.7. On an upgrade from mambo-phpShop, the VirtueMart installer won't recognise my existing tables! What to do now?
2.2.7.1.8. After the installation I try to access VirtueMart, but it just prints out an error like "store is not a valid VirtueMart module...". What's wrong?
2.2.7.1.9. After having installed the component, I add a Main Menu Link to the VirtueMart component. But clicking on that link only displays the text "Welcome to Washupito's....." What's wrong?
2.2.7.1.1. The Installer tells me "ERROR: Could not find an XML setup file in the package". What's wrong?
2.2.7.1.2. The Joomla! 1.5 installer fails to install VirtueMart with the error message "There was an error uploading this file to the server.". What's the problem?
2.2.7.1.3. The installation on Joomla! 15 fails with the error “Your Extension appears to be written for an older version of Joomla!. You must enable the System - Legacy Plugin in the Plugin Manager if you wish to complete this task.”.
2.2.7.1.4. The Installer tells me "Another component is already using the directory com_virtuemart"
2.2.7.1.5. When using the automatic installation nothing happens after clicking on "Upload & Install" or the installer tells me "Failed to move to /media directory" What's the cause?
2.2.7.1.6. What are those tar.gz files, aren't those for Unix/Linux systems only?
2.2.7.1.7. On an upgrade from mambo-phpShop, the VirtueMart installer won't recognise my existing tables! What to do now?
2.2.7.1.8. After the installation I try to access VirtueMart, but it just prints out an error like "store is not a valid VirtueMart module...". What's wrong?
2.2.7.1.9. After having installed the component, I add a Main Menu Link to the VirtueMart component. But clicking on that link only displays the text "Welcome to Washupito's....." What's wrong?
2.2.7.1.1.

The Installer tells me "ERROR: Could not find an XML setup file in the package". What's wrong?

Mostly this problem arises because you have not unpacked the file VirtueMart_x.x_COMPLETE_PACKAGE.zip before and tried uploading / installing this file.

2.2.7.1.2.

The Joomla! 1.5 installer fails to install VirtueMart with the error message "There was an error uploading this file to the server.". What's the problem?

The most common reason for this problem is that the File you have uploaded is too big. The File Size Upload Limit on your Server is set too low to allow larger files to be uploaded. By default PHP allows files up to 2 MB, but this limit needs to be set to 4 MB in order to upload the VirtueMart Component Install File.

If you have access to the php.ini, then change the directive upload_max_filesize to "4M" and reload the server configuration.

If you are running PHP in CGI mode on Apache, you can place an .htaccess file in your Joomla! root directory and place the following code inside:

php_value upload_max_filesize 4M

2.2.7.1.3.

The installation on Joomla! 15 fails with the error “Your Extension appears to be written for an older version of Joomla!. You must enable the System - Legacy Plugin in the Plugin Manager if you wish to complete this task.”.

You have probably uploaded an old Version of VirtueMart or an old Module, which is not ready for Joomla! 1.5. Make sure you have downloaded the Virtuemart Package for Joomla! 1.5 (with the file extension ".j15.zip").

VirtueMart 1.0.x is not compatible to Joomla! 1.5 and no efforts are taken to achieve compatibility.

2.2.7.1.4.

The Installer tells me "Another component is already using the directory com_virtuemart"

Please delete the directories /site_root/components/com_virtuemart and /site_root/administrator/components/com_virtuemart. If you can't delete the directories using ftp, try the file manager for Joomla!, eXtplorer, instead.

2.2.7.1.5.

When using the automatic installation nothing happens after clicking on "Upload & Install" or the installer tells me "Failed to move to /media directory" What's the cause?

VirtueMart is a big component, its installer file archive has a size of more than 2 MB. When uploading this file to your server you can wait a long time until the file is completely transferred to your server. You can use the Remote Installer for VirtueMart instead! (Remote Installer for VirtueMart)

2.2.7.1.6.

What are those tar.gz files, aren't those for Unix/Linux systems only?

tar.gz Archives come from the Unix World, but they can be used on Windows and Mac systems as well. On Windows you can unpack them using Winzip or Winrar. Gzip has a much much better compression than Zip, that's one reason why most Open Source projects use it for their distributions.

2.2.7.1.7.

On an upgrade from mambo-phpShop, the VirtueMart installer won't recognise my existing tables! What to do now?

Sometimes the tables beginning with jos_pshop_ or mos_pshop_ are not found. Before you click on "Install sample data" or "Go directly to the shop" you can just type in this URL in the addess bar of your browser:

index2.php?option=com_virtuemart&install_type=update12pl3

After that the upgrade procedure begins!

2.2.7.1.8.

After the installation I try to access VirtueMart, but it just prints out an error like "store is not a valid VirtueMart module...". What's wrong?

The installation is corrupt. The registered functions and core modules, which are used by VirtueMart to check the acccess permissions are missing. You need to make sure that the tables "jos_vm_functions" and "jos_vm_modules" have been created in your database and contain records. If they are missing, you can add those tables manually by using the SQL installer file /sql/virtuemart.installation.joomla.sql. Search for those tables, copy the SQL code and paste it into the textarea in phpMyAdmin's SQL execution screen.

2.2.7.1.9.

After having installed the component, I add a Main Menu Link to the VirtueMart component. But clicking on that link only displays the text "Welcome to Washupito's....." What's wrong?

VirtueMart is no component-only script. It's programmed to be used together with the corresponding VirtueMart Main Module. VirtueMart will not operate properly without the VirtueMart Main Module.