Login/Register

Troubleshooting Guide

First Things To Try


Known Issues


Installatron Errors


Task Errors


Application Errors




Frequently Asked Questions

Installatron Requirements

Before anything else, check that your server configuration meets Installatron's server, firewall, and PHP requirements.

Installatron Repair

If you are the server administrator or webhosting provider then the first thing to try when attempting to fix any problem is Installatron Repair.

Firstly, read about Installatron requirements here and make sure that your firewall allows access to and from the listed IPs and domain, and that the user's PHP configuration has the requires PHP modules & extensions enabled.


If fixing requirements didn't help then the Installatron Repair Utility is designed to fix most problems that can occur with Installatron Plugin and Installatron Server. This utility can be executed any time that difficulties are experienced. There is no harm in executing the utility; it's always the first thing to try.

Run these commands as root (DON'T RUN THESE COMMANDS IF YOU ARE USING INSTALLATRON SERVER!):

rm -fr /usr/local/installatron/lib /usr/local/installatron/bin
rm -f /usr/local/installatron/etc/php.ini
curl -O https://data.installatron.com/installatron-plugin.sh
chmod +x installatron-plugin.sh
./installatron-plugin.sh -f --quick

Tip: To run repair in interactive mode, remove -f from the last command.

Pro tip: Quick switch between Installatron channels

Run these as root to quickly switch between any of the 3 Installatron channels:

/usr/local/installatron/repair -f --quick --release
/usr/local/installatron/repair -f --quick --stable
/usr/local/installatron/repair -f --quick --edge
To perform a repair on Installatron Plugin Windows, follow the same setups used to install Installatron Plugin.
See: https://installatron.com/plugin/download/pleskwindows
Run these commands as root (DON'T RUN THESE COMMANDS IF YOU ARE USING INSTALLATRON PLUGIN!):

rm -fr /usr/local/installatron/lib
rm -f /usr/local/installatron/etc/php.ini
curl -O https://data.installatron.com/installatron-server.sh
chmod +x installatron-server.sh
./installatron-server.sh -f --quick

Tip: To run repair in interactive mode, remove -f from the last command.

Pro tip: Quick switch between Installatron channels

Run these as root to quickly switch between any of the 3 Installatron channels:

/usr/local/installatron/repair -f --quick --release
/usr/local/installatron/repair -f --quick --stable
/usr/local/installatron/repair -f --quick --edge
To perform a repair on Installatron Server Windows, re-run the installatron-server.exe wizard.

Check your PHP configuration

Create a file named "phpinfo.php" in the directory where you are trying to install the app or where the application currently resides, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

REQUIREMENTS

Each application that is supported by Installatron has its own PHP requirements although we have collected together the ideal minimum configuration in the second box here.

The PHP requirements listed on that page are shown in two groups; the first group, beginning with allow-url-fopen, show required values and then the second set, beginning with bcmath, show required modules and extensions.

Search for each item on your phpini.php page; if it's a value and the item exists then check that the value is correct. If the item doesn't exist then ignore it. For the second group; if the listed item doesn't exist as its own block in the long list of modules on that phpinfo page (eg. if bcmath doesn't exist as one of the first modules) then that module or extention should be added.

That doesn't mean that adding the missing module or fixing an incorrect value will solve the specific problem that you're having, but it will be a positive step towards that and certainly may well be the cause of your problem.

Most of the application errors listed below are caused by missing requirements.

SOLUTION

If you find that a value is wrong or a module is missing; search your webhosting control panel for a tool that allows you to change your PHP configuration. Your webhosting provider might not provide such a tool, in which case you will need to ask your provider to make the changes for you.

Tools for changing your PHP configuration can come in two flavors; the first is a tool that allows you to change your PHP version entirely. This can be useful if the app you wish to install has a minimum PHP version and your current PHP version (shown at the top-left of the phpinfo.php page) is too old. Note that changing your PHP version will also reset your PHP configuration (ie. the values and the modules).

Another other type of PHP configuration tool allows you to directly edit PHP values. This is typically a small sub-section of values, from memory_limit to error handling.

And the final type of PHP configuration tool allows you to directly select which PHP modules are enabled in your PHP configuration. This same tool also usually allows you to change your PHP version and edit a large number of PHP values, so this is the best one. But which type you have access to, if any at all, depends on what your provider has made available through the control panel.

And you can always ask your provider to fix any problems that you're unable to fix yourself.

ps. we are not your webhosting provider -- we are Installatron.

Installatron displays a 401 error (cPanel only)

SOLUTION

Double check that the "Installatron" feature is enabled within WHM's Feature List tool for the feature lists where it should be enabled.

Within WHM's Feature List tool, the first entry ("Installatron") refers to the Installatron system itself and must be enabled to activate Installatron, and the second entry ("Installatron Widget") activates the dashboard section that lists top apps and installed apps right on the main cPanel menu.

Tasks never progress beyond "Waiting..."

SOLUTION

Try clearing the task queue by executing this command as root:

/usr/local/installatron/repair -f --quick
/usr/local/installatron/installatron --tasks --restart --clear-install-locks

That should solve the problem!

Now, those previous two commands were safe to run on both Installatron Plugin and Installatron Server, however the next fix is NOT SAFE FOR INSTALLATRON SERVER! So if the previous two commands didn't solve the problem for your Installatron Server task queue then contact us and we'll work through it there.

But if your server is definitely using Installatron Plugin then run this as root to rebuild the Installatron cache:

/usr/local/installatron/repair -f --quick
mv /var/installatron/data.db /var/installatron/data.db.bak20240416
rm -f /var/installatron/data.db-*
/usr/local/installatron/installatron --repair --recache
/usr/local/installatron/installatron --send-update-report

Tasks never complete or terminate prematurely

CAUSE

A crontab process may be active that is designed to terminate PHP processes that are executing "too long".

SOLUTION

Disable the offending crontab process, or replace it with a crontab process that grants immunity to Installatron-created processes.

The below bash code, when executed as a crontab process every so often, will only kill PHP processes that have been executing longer than 600 seconds and show up in the output of "ps -eo command" as containing "/usr/bin/php". This will work without modification on most fastcgi environments. Feel free to modify this code to match your environment.

ps -eo uid,pid,lstart,command |
    tail -n+2 |
    while read PROC_UID PROC_PID PROC_LSTART_WDAY PROC_LSTART_MONTH PROC_LSTART_DAY PROC_LSTART_TIME PROC_LSTART_YEAR PROC_COMMAND; do
        SECONDS=$[$(date +%s) - $(date -d"$PROC_LSTART_WDAY $PROC_LSTART_MONTH $PROC_LSTART_DAY $PROC_LSTART_TIME $PROC_LSTART_YEAR" +%s)]
        if [[ "$PROC_COMMAND" == */usr/bin/php* ]]; then
	        if [ $PROC_UID -gt 0 -a $SECONDS -gt 600 ]; then
    	        echo $PROC_PID
        	fi
        fi
     done |
     xargs kill

Installed applications are missing from My Applications
Backups are missing from My Backups

CAUSE

If installed applications do not appear at the My Applications tab then there is an error within Installatron's cached data. This can happen if a user is moved to a server with a different configuration than the one the installs were created on. Typically no action is necessary when this occurs--the issue will automatically correct itself the next time the daily Installatron Update process executes--but if the change is significant then it can require that the cache be rebuilt.

SOLUTION

Execute these commands:

/usr/local/installatron/repair -f --quick
/usr/local/installatron/installatron --repair --recache
/usr/local/installatron/installatron --send-update-report

SECONDARY SOLUTION (INSTALLATRON PLUGIN ONLY)

For Installatron Plugin servers only: If the first solution does not remedy the problem, execute these commands:

/usr/local/installatron/repair -f --quick
mv -f /var/installatron/data.db /var/installatron/data.db.bak20240416
rm -f /var/installatron/data.db-*
/usr/local/installatron/installatron --repair --recache
/usr/local/installatron/installatron --send-update-report

TERTIARY SOLUTION (WEBMIN/VIRTUALMIN SERVERS ONLY)

For Installatron Plugin on Webmin/Virtualmin servers only: If the first two solutions don't solve the problem, execute this command:

virtualmin set-global-feature --enable-feature virtualmin-installatron

The 'Installatron Applications Installer' or 'Installatron Admin' links go to a blank page

INSTALLATRON SERVER SOLUTION

Execute these commands:

/usr/local/installatron/repair -f --quick
/usr/local/installatron/installatron --repair --recache
/usr/local/installatron/installatron --send-update-report

INSTALLATRON PLUGIN SOLUTION

Execute these commands:

/usr/local/installatron/repair -f --quick
mv /var/installatron/data.db /var/installatron/data.db.bak20240416
rm -f /var/installatron/data.db-*
/usr/local/installatron/installatron --repair --recache
/usr/local/installatron/installatron --send-update-report

Unable to connect to any licensing server

Firewall configurations that whitelist addresses must allow outgoing port 80 connections to these addresses.

dal01.installatron.com (North America - Dallas)
dal02.installatron.com (North America - Dallas)

Based on a server's geographic location, or for added redundancy, additionally allowing connections to these addresses is recommended. When multiple addresses are available the closest geographically will always be tried first.

nue01.installatron.com (Europe - Nuremberg)
phx01.installatron.com (North America - Phoenix)
tok01.installatron.com (Asia Pacific - Tokyo)

It's also possible to create an internal mirror for your company following the FAQ here: How do I create an Installatron Fast Update server?

Unable to download the remote file `https://data.installatron.com/manifest.md5'.

CAUSE

The SSL connection to data.installatron.com could not be established. To verify, test with this command:

curl -v https://data.installatron.com/manifest.md5

SOLUTION 1

If the server is older, the server root certificates may be out of date.

SOLUTION 2

If you're unable to get the server to accept this certificate, add a --no-check-certificate argument to the original command.

PHP Fatal error: Uncaught Error: Using $this when not in object context in /var/installatron/installers/...

CAUSE

The format used by Administration » Customization code changed when Installatron added support for PHP 7. This error means that you are using Installatron on PHP 7 but the Customization code is using the older PHP-5-compatible format.

SOLUTION

The changes that you need to make to your customization code are minimal and you can find them described in the highlighted box at the top of Installatron Administration Documentation: Customization.

`lspci' does not exist.
`pciconf' does not exist.
`ifconfig' does not exist.

CAUSE

net-tools is not installed on this server.

SOLUTION 1

Execute this command:

yum -y install net-tools

FileSystem::mkdir(/path/to/installed/application/directory)

CAUSE

This type of error can sometimes occur when an account is out of available disk space. However, in most cases a more graceful error is displayed.

SOLUTION

Check that the web hosting account has enough available disk space. If additional space is required, contact your service provider directly to add additional disk space.

2011-09-19T04:57:55-04:00 FAILURE [2] http://yoursite.com/installdir/anyfile.php

CAUSE

A .htaccess file is likely interfering with a HTTP request.

SOLUTION

Check the installation directory and parent directories (public_html) for a .htaccess file that could interfere with requests to the aforementioned URL. You either can fix the .htaccess file or temporarily rename it and try again.

You have reached your maximum allotment of databases

You have exceeded the maximum allowed databases

A few variations of these errors exist. The errors are often returned from the control panel software verbatim.

CAUSE

This happens when the control panel software is unable to create a database on behalf of Installatron. Most likely this means the account has no databases remaining.

SOLUTION

An existing database can be selected for the install by choosing the "Let me manage the database settings" option on the Database step, or most likely additional databases can be purchased.

Unable to get list of databases. There is a communication problem with the control panel API.

A few variations of these errors exist. The errors are returned from the control panel software verbatim.

CAUSE

This happens when Installatron is unable to retrieve a list of user's database via the control panel's plugin API.

GENERAL SOLUTION

Typically logging out of the control panel and re-trying the task will solve the problem.

DIRECTADMIN SOLUTION

Try changing the "Fetch/HTTP driver" in Administration > Settings. It may be that the default driver is not suitable for your server setup. A CURL binary should be selected whenever possible.

If the the control panel uses https:// then it may be that the CURL options lack functional OpenSSL support. This can be tested for CURL binaries with:

curl -v -k 'https://127.0.0.1:2222'

Failed to save cache file “/var/cpanel/userhomes/cpanel/.cpanel/nvdata.cache” because of an error: (XID 3r5mm4)

CAUSE

This is a cPanel/WHM bug introduced in v80.

SOLUTION

Run these commands from SSH (or Terminal from WHM) as the root user:

mkdir -vp /var/cpanel/userhomes/cpanel/.cpanel
chmod 700 /var/cpanel/userhomes/cpanel/.cpanel

Installatron displays an "encoded", blank, or non-loading page

Error: All loaders have failed

Error: PHP is not installed

CAUSE

By default Installatron uses the system's installed version of PHP. In the vast majority of cases this works flawlessly. However, in some cases this may not be compatible.

When this occurs, compiling a dedicated PHP binary just for Installatron's internal use is the most reliable solution.

SOLUTION (INSTALLATRON PLUGIN ONLY)

Try installing a dedicated PHP binary just for Installatron's internal use. Webspace PHP settings will not be modified. Do not run these commands if you are using Installatron Server, they are for Installatron Plugin only!

First, install the system dependencies required to compile PHP. This will depend on the specific operating system and version.

Debian:

apt install build-essential autoconf libtool bison re2c pkg-config libxml2-dev libzip-dev libssl-dev libsqlite3-dev libcurl4-gnutls-dev libpng-dev libonig-dev

RHEL/CentOS/AlmaLinux/Rocky Linux/etc:

yum install gcc libcurl-devel libxml2-devel openssl-devel libpng-devel zlib-devel sqlite-devel oniguruma-devel

Second, compile the new PHP version using the following commands. These commands are the same regardless of operating system. If you see any errors, check that the required dependencies are installed.

mkdir -p /usr/local/installatron && cd /usr/local/installatron
curl -L -O https://php.net/distributions/php-8.1.27.tar.gz
tar xzf php-8.1.27.tar.gz && cd php-8.1.27
./configure --prefix=/usr/local/installatron/php --disable-dom --enable-posix --enable-mbstring --enable-ftp --enable-sockets --enable-gd --without-pear --without-iconv --with-openssl --with-curl --with-zip --with-zlib --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd --with-gettext
make && make install
cd .. && rm -fr php-8.1.27 php-8.1.27.tar.gz /usr/local/installatron/bin

Next, follow the steps at the top of this page to execute a "repair" of Installatron.

That's it! Installatron should now be working.

TIP: If you now see an error that ends with "No such file or directory" or "Unable to connect to Plesk MySQL database" then running the next fix will solve that.

Error: mysql database connection failed: No such file or directory.
Error: Unable to connect to Plesk MySQL database

CAUSE

There is a problem communicating with MySQL.

SOLUTION

If databases are actually being created, try specifying a MySQL socket value in /usr/local/installatron/etc/php.ini. For example:

mysql.default_socket = /var/lib/mysql/mysql.sock
mysqli.default_socket = /var/lib/mysql/mysql.sock

(Note that both mysql and mysqli are included to provide for PHP <7 and >=7 cases, and allow for seamless swapping between them.)

Technical Error: DBD::mysql::st execute failed: There is no such grant defined…

CAUSE

The cPanel API failed to create a database for Installatron Plugin.

SOLUTION

Check if either of the below values exist in /etc/my.cnf:

skip-name-resolve
skip-host-cache

If either value exists, comment the value out, restart mysql, and then try the action within Installatron Plugin again. If the problem is still not solved, check if the user has their own my.cnf file within their home directory.

open3: exec of file - failed at /usr/local/cpanel/bin/register_cpanelplugin line 33

CAUSE

The RPM package "file" is missing.

SOLUTION

Install the missing RPM package:

yum install file

Then re-execute the Installatron Repair Utility at the top of this page.

Technical Error: 1064 You have an error in your SQL (GoDaddy only)

CAUSE

At the time of writing (2023-02-07) GoDaddy are moving database data around, or something of that nature, and it will occasionally cause this error.

SOLUTION

It might be worth waiting a few hours and then trying again. But if the error continues then you will need to contact GoDaddy for assistance.

And for clarity, this is not only an error in Installatron: if you try to export the database using phpMyAdmin (from your webhosting control panel) you'll find the same "You have an error in your SQL syntax" somewhere in its output.

Email notifications bounce with message: "This message has been rejected because it has an overlength date field which can be used to subvert Microsoft mail programs"

CAUSE

Microsoft.

SOLUTION

Try going to Installatron administration > Email and switch the Sender field from "PHP" to "SMTP" and enter values of the server's SMTP service (which might be "mail.{YOUR_DOMAIN}") and an administration email address for that service.

A test of the selected domain has failed

CAUSE

Load your website into a couple of web browsers (eg. Firefox and Chrome) and consider the following;

Does your website say that your webhosting account is suspended?

Does your website say that your website isn't "redirecting properly"?

SOLUTION

Contact your webhosting provider or server administrator and ask about unsuspending your account.

Redirecting problems are usually caused by redirection-loops, where a redirection points back to itself or a redirection points to somewhere that points back to the original page. Redirections are sometimes set up through a "Redirection" tool in your webhosting control panel or manually using files named ".htaccess" in your account's files. The redirection problem will need to be fixed before Installatron can do anything further with the application.

A test of the selected domain has failed (continued)

CAUSE

First, see the previous entry to check that the domain is working correctly.

While Installatron doesn't require domains to resolve prior to use, Installatron does check for any domain or web server misconfiguration that would prevent the installed application from functioning, including IP mismatches and firewall blocks.

SOLUTION

Check your /var/installatron/logs/fetch* log files for information on why the tests failed.

If the domain check fails with a "(HTTP error: 502)" error then this is a "Bad Gateway" error message and it means that your web server is misconfigured. Speak to your webhosting provider or server administrator.

INSTALLATRON SERVER API SOLUTION

To enable interaction with non-resolving domains, including the "url-ip" argument with Installatron Server API queries, which will inform Installatron Server where it should resolve the domain.

A test of the selected domain has failed (HTTP error: 0) -- [http code=0; timeout=7]

BACK STORY

Installatron tests your domain before it proceeds with any application-related task (install, update, clone, etc). It tests the domain by creating a file called "deleteme.????.php" (where ???? is a series of random characters) in the application's directory and then runs the script over HTTP using the domain. For example, the file might be created here:

~/public_html/deleteme.chakd2oh.php

And it will be run by loading something like:

http://www.yourdomain.com/deleteme.chakd2oh.php

CAUSE

If Installatron doesn't receive the expected answer from the deleteme.????.php script then you will receive this error and the task will be aborted. The actual path, URL, and filename will be included in the error message.

A [http code=0; timeout=7] at the very end of the error message means that when Installatron tried to run the deleteme.????.php script it wasn't able to make a connection with your server -- and to be clear here; Installatron is making the call from the same server that it's trying to make the call to. It's a HTTP call that it should be able to make.

The likely cause is that your server's own IP address or domain (or even 127.0.0.1 or localhost) is blacklisted by the server itself or by the MySQL server.

SOLUTION

Ask your webhosting provider or server administrator if one of these addresses might be blacklisted.

ADDDB API failure

CAUSE

Installatron is unable to communicate with the webhosting control panel's plugin API, or the plugin API is unable to communicate with the MySQL/database server.

SOLUTION

Contact your webhosting provider or server administrator and ask them to look into it for you. The /var/installatron/logs/panel_log log might be of use to them. And if the server is using MariaDB they should check that it is enabled as a feature in the control panel.

ADDUSER API failure

CAUSE

Installatron is unable to communicate with the webhosting control panel's plugin API, or the plugin API is unable to communicate with the MySQL/database server.

SOLUTION

Contact your webhosting provider or server administrator and ask them to look into it for you. The /var/installatron/logs/panel_log log might be of use to them. And if the server is using MariaDB they should check that it is enabled as a feature in the control panel.

On some cPanel/WHM configurations this error can be caused by usernames that are considered too long.

Compression failed -- Import

BACK STORY

Installatron is trying to create an archive comprising the application's files and database but the compression process has failed.

CAUSE

If your webhosting account is low on disk space then this is likely due to the process running out of disk space during compression. The process generally disk space the equivalent of the current application size (files+database) plus an additional 30% overhead and it requires this space at both the Source account and Destination accounts.

(eg. if the combined disk space+database is currently 12MB, you need 16MB free space on both source and destination accounts--or 32MB if it's the same account--in order to perform this task)

If enough disk space is available then the compression process might be timing out, which could happen if the application is especially large. When a process takes longer than a server time-limit the server will simply kill the process.

SOLUTION

Check your disk usage and limit from your webhosting control panel. If disk space is low then you might be able to free some space by uninstalling applications that you don't need (be careful not to uninstall something you use!), otherwise you will need to speak to your webhosting provider about increasing your disk space quota.

There are three PHP values that might also be involved in a time-out:

  • PHP's max_execution_time
  • PHP's default_socket_timeout
  • MySQL's mysql.connect_timeout (my.cnf or php.ini)

Values of 360 are good starting points for all three.

If your webhosting control panel allows you to edit your PHP configuration then you can possibly change these values from there, otherwise you'll need to ask your webhosting provider to change those values for you. And the MySQL value might be something that only your provider can change.

Ideally, you'll change these values on both the Source and Destination servers, but change them where you can and see if that helps.

Successfully detected the source installed application's database information, but the information isn't working.

BACK STORY

During a local or remote Import, Installatron here has found the application's configuration file and has been able to parse the application's database information from the config, but when it then attempted to connect to the server's MySQL database server using those newly-extracted details it wasn't able to connect.

CAUSE

If the final part of the error contains the phrase "No such file or directory", please ask your webhosting provider or server administrator to run this fix.

If the final part of the error contains the phrase "Access denied" then it it's possible that your server's own IP address or domain (or even 127.0.0.1 or localhost) is blacklisted by the server itself or by the MySQL server.

SOLUTION

Ask your webhosting provider or server administrator if one of these addresses might be blacklisted.

Error: FTP Connection Refused

CAUSE

The remote server has refused the connection.

SOLUTION

Check that the FTP values you gave Installatron are correct. If you can test them in another FTP utility (eg. Filezilla) then that's worth doing as a test.

If you're sure that the values are correct and you can FTP login through another tool then it means the FTP server is actively blocking Installatron. Installatron is making the connection from the server that Installatron is installed on (usually the same server as your domain, or from here on installatron.com if you're using Installatron Remote). You can try the different FTP protocols to see if one of them is allowed but if none of them work you'll need to ask your webhosting provider to check their FTP logs in order to find why the connections are being rejected.


[http code=301] -- CMS Made Simple

CAUSE

This is likely to be caused by a known problem between the web server "LiteSpeed" and the PHP extension "Phar".

Phar is used to install CMSMS but LiteSpeed, at the time of writing, causes an infinite redirection loop (the '301' error is a usually harmless redirection notice meaning "Moved Permanently") when using PHP's 'phar' extension. More can be found about this bug here: https://bugs.php.net/bug.php?id=71465

SOLUTION

Contact your webhosting provider or server administrator and suggest that they disable the CMSMS installer from Installatron's Access Control tool in administration.

[http code=401]

CAUSE

The HTTP error code '401' means "Unauthorized".

This usually means that there is some sort of extra level of security wrapped around your website that Installatron can't get through, usually in the form of a login popup but it could also be a blacklisted IP address or domain.

You have probably forgotten the security is there because you are already logged in or your IP/domain isn't banned.

SOLUTION

Disable the security; perform the Installatron task; re-instate the security.

If you don't know where the security is coming from: check your webhosting control panel for a 'password protection' tool (this might be among the other tools, alongside Installatron, or you might find it inside the 'file manager'/'files' tool); use the 'file manager'/'files' tool to look for files named ".htaccess" (*) starting in the account's home directory and following the path to where the app is installed -- these files have the potential to block access (but they can also perform important tasks so be careful); similarly, look for directories named ".passwds/"; ask your webhosting provider or server administrator for advice.

* note that files and directories beginning with '.' might be hidden until you set '[x]show hidden files' somewhere first.

[http code=500] -- ClientExec

CAUSE

ClientExec requires that the PHP 'mbstring' extension is enabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mbstring" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

[http code=500] -- Drupal

CAUSE

Drupal requires that the PHP 'mbstring' extension is enabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mbstring" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

[http code=500] -- OrangeHRM

CAUSE

OrangeHRM requires that the PHP 'mysqli' extension is enabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mysqli" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

[http code=500] -- Oxwall

CAUSE

Oxwall requires that the server's "/tmp" directory exists and is writable.

SOLUTION

Contact your webhosting provider or server administrator and ask them to check that the "/tmp" directory exists and that it is CHMOD 777.

If they don't wish to create this directory or make it writable to everyone then they should disable the Oxwall installer from Installatron administration » Access Control.

[http code=500] -- PrestaShop

CAUSE

PrestaShop requires these PHP extensions and modules:

curl, fileinfo, gd, mcrypt, pdo_mysql, openssl, simplexml, soap, zip

PrestaShop requires that the PHP 'allow_url_fopen' value is set to "On".

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

You'll find the version at the top-left of the page.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix any of the PHP-related problems from there, otherwise for a PHP-related problem will need to contact your webhosting provider or server administrator to ask them to change them for you.

If your MySQL version is not sufficient to run Magento then you will need to ask your webhosting provider or server administrator to update it for you.

[http code=500] -- Pydio

CAUSE

Pydio requires that the PHP 'mcrypt' extension is enabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mcrypt" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

[http code=500] -- WordPress

CAUSE

Pydio requires that the PHP 'mcrypt' extension is enabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mcrypt" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

[http code=503]

CAUSE

A HTTP '503' error means 'Service Unavailable' and there are 5 known possible causes:

1. If you just recently changed your PHP version then you might see that error until the changes are finished being processed by your server. It doesn't usually take more than a few minutes.

2. The server is in maintenance mode. This is probably the main reason you should see a 503 error (unless you're getting a 503 for the wrong reason).

3. The server was experiencing too many connection attempts at that exact moment that Installatron tried to make that call and the server wasn't able to process the call.

4. Server time limits have been known to cause this error (though, they shouldn't).

5. If your webhosting service is with GoDaddy then it's likely that the "lsapi_backend_max_process_time" server time limit is set too low.

SOLUTIONS

1. Wait a few minutes and try again.

2. If it gives the same error, try loading your domain directly into your web browser; if it shows a message stating that the server is in maintenance mode then there's nothing you can do except wait for your webhosting provider to finish what they are doing. Though, if the message remains for more than a few hours you could contact them to ask if they know how long it will remain so.

3. If there's no maintenance message on the domain's website then you could just try the Installatron task again, because if the problem is caused by item (3) above -- a high server load -- then you would expect that eventually an attempt to perform the task will work. But I wouldn't try it more than 3 or 4 times in total because that's enough to test this theory.

Finally, if you've reached this far and you're still seeing only 503 errors then it might be caused by (4) above. In this case, try setting these PHP time limits:

max_execution_time = 360
default_socket_timeout = 360
request_terminate_timeout = 0 (php-fpm only)

If your webhosting control panel allows you to customize your PHP configuration then you can possibly change these values from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to increase these values for you.

5. Contact GoDaddy and ask them to check /etc/apache2/conf.d/lsapi.conf for the current value of lsapi_backend_max_process_time. If the value is less than 3000 then set it to 3000, or if there is no value set for lsapi_backend_max_process_time then add it and set it to 3000.

The reason this increase is required is that Magento + demo content is a very large application (about 1GB) and the default time limit of 300 might be too low.

The server administrator may also need to kill the lsphp processes and restarted Apache afterwards. And even then we have heard of it taking some time before the new value takes effect.

[http code=507]

CAUSE

The HTTP '507' error means that your Dropbox quota is exceeded.

SOLUTION

Check your Dropbox quota and try again when you have storage available.


A database query has failed -- CMS Made Simple

CAUSE

If the server uses the PHP suhosin extension then this is likely to be caused by a problem involving Phar.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "suhosin" to confirm that this is the likely cause of the error.

SOLUTION

Add this line to the relevant php.ini:

suhosin.executor.include.whitelist="phar" (http://php.net/manual/en/book.phar.php)

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to change this for you.

A database query has failed -- Drupal

CAUSE

Drupal requires that the PHP 'memory_limit' value is set to at least 64M.

Drupal requires that the PHP 'mbstring' extension is enabled.

Drupal requires that the PHP 'mbstring.http_input' feature is disabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "memory_limit", "mbstring", and "mbstring.http_input" to confirm that one of these is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to change them for you.

A database query has failed -- Elgg

CAUSE

Elgg has a minimum requirement of PHP version 5.5.9.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

You'll find the version at the top-left of the page.

SOLUTION

If your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to change it for you.

A database query has failed -- Group Office

CAUSE

Group Office requires that the PHP 'pdo_mysql' extension is installed.

Group Office requires that the PHP 'mysqli' extension is installed.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

< phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "pdo_mysql" and "mysqli" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add these for you.

A database query has failed -- Live Site

CAUSE

Live Site requires that a PHP version lower than 5.5.

Live Site requires that the PHP 'mbstring' extension is enabled.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

The PHP version is found at the top-left of the page, and search for "mbstring" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to change them for you.

A database query has failed -- Magento

CAUSE

Magento requires that a PHP version lower than 7.0. At the time of writing (see here for the latest information), Magento supports these PHP versions:

5.5.22–5.5.x
5.6.x
7.0.2
7.0.6–7.0.x

Magento requires these PHP extensions and modules:

curl, gd, intl, mbstring*, mcrypt, mhash, openssl, pdo_mysql, simplexml, soap, xml, xsl, zip, json**, iconv**
* some webhosting providers will not include this by default
** required only for PHP 7

Magento requires that the PHP 'proc_close()' function is enabled.

Magento requires that the PHP 'php_uname()' function is enabled.

Magento requires that the PHP 'always_populate_raw_post_data' value is set to "-1" to disable it.

Magento requires that the PHP 'max_execution_time' value is set to more than the default 30 -- we recommend 360.

Magento requires that the PHP 'memory_limit' value is set to at least 256M.

Magento requires that the PHP 'sql.safe_mode' value is set to "Off" to disable it.

Magento does not usually install when PHP's 'open_basedir' restrictions are in use.

You can check these extensions, functions, and values by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

The PHP version is found at the top-left of the page, and search for the other values and extension names to determine if any of them are the likely cause of the error.

Magento requires MySQL 5.6+ (or the MariaDB equivalent). The MySQL version can probably be found in your webhosting control panel (under "server information" or similar) otherwise you will need to ask your webhosting provider.

Magento requires Composer be installed on the server.

Magento requires read/write access to the server's /tmp directory.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix any of the PHP-related problems from there, otherwise for a PHP-related problem will need to contact your webhosting provider or server administrator to ask them to change them for you.

If your MySQL version is not sufficient to run Magento then you will need to ask your webhosting provider or server administrator to update it for you.

Composer errors are something only your webhosting provider or server administrator can check and address.

A database query has failed -- Omeka

CAUSE

Omeka requires that Apache's 'mod_rewrite' module is installed or your server's equivalent.

Omeka requires that the PHP 'pdo_mysql' extension is installed.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mysqli" to confirm that this is the likely cause of the error.

SOLUTION

If 'mysqli' is missing from your PHP configuration and if your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

A 'mod_rewrite' problem is something that only your webhosting provider or server administrator can check and address.

A database query has failed -- OwnCloud

CAUSE

OwnCloud requires that PHP's 'intl.default_locale' setting has a default value. Not all webhosting services will include a default value in in their PHP configurations. This error will be shown at the (incompletely-installed) web page:

Setting locale to en_US.UTF-8/fr_FR.UTF-8/es_ES.UTF-8/de_DE.UTF-8/ru_RU.UTF-8/pt_BR.UTF-8/it_IT.UTF-8/ja_JP.UTF-8/zh_CN.UTF-8 failed
Please install one of these locales on your system and restart your webserver.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "intl.default_locale" to confirm that this is the likely cause of the error.

OwnCloud requires that MySQL's binary logging is disabled or BINLOG_FORMAT = STATEMENT. This is much less likely to be the cause of an OwnCloud problem but needs to be considered if the above is correct.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there by giving this setting a value of "en_US.UTF-8" (for example), otherwise you will need to contact your webhosting provider or server administrator to ask them to add the value for you.

OwnCloud's MySQL server configuration requirements are detailed here.

A database query has failed -- Oxwall

CAUSE

Oxwall requires that the PHP 'mbstring' extension is installed.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mbstring" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add it for you.

A database query has failed -- PrestaShop

CAUSE

PrestaShop requires that either the PHP 'mysql' or 'mysqli' extension is installed. Or both, but not neither.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mysql" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add them for you.

A database query has failed -- SilverStripe

CAUSE

There is a problem with SilverStripe's Italian translation that prevents it from being installed with that locale selected.

SilverStripe requires these PHP extensions and modules:

dom, gd, fileinfo, hash, iconv, mbstring, mysql or mysqli, session, simplexml, tokenizer, xml
* some webhosting providers will not include this by default

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for those extensions (especially "mbstring") to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add the missing extension for you.

A database query has failed -- WHMCS

CAUSE

The WHMCS administrator password must be at least 5 characters long.

WHMCS requires that the MySQL 'sql_mode' value is not set to strict. This can only be checked by your webhosting provider or server administrator.

Oxwall requires that the PHP 'ioncube' extension is installed.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "ioncube" to confirm that this is the likely cause of the error.

SOLUTION

Make sure that the administrator password that you enter for the application is at least 5 characters long.

Ask your webhosting provider or server administrator to edit this file:

/etc/my.cnf

Find the sql_mode= line and change it to:

sql_mode=""

If your webhosting control panel allows you to select your PHP version then you can possibly fix missing extensions from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add the missing extension for you.

A database query has failed -- WordPress

CAUSE

WordPress requires that either the PHP 'mysql' or 'mysqli' extension is installed. Or both, but not neither.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mysql" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to select your PHP version then you can possibly fix this from there, otherwise you will need to contact your webhosting provider or server administrator to ask them to add them for you.


An error has occurred while executing the application API -- Dada Mail

CAUSE

Dada Mail requires that the "Perl DBI" and "DBD-mysql" modules are enabled.

SOLUTION

Look for a way to enable these modules from your webhosting control panel. If you can't find them then ask your webhosting provider or server administrator to add them for you.

An error has occurred while executing the application API -- MODx

CAUSE

MODx requires that PHP's 'date.timezone' parameter has a value.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "date.timezone" to confirm that this is the likely cause of the error.

SOLUTION

Look for a way to enable these modules from your webhosting control panel. If you can't find them then ask your webhosting provider or server administrator to add a value for you.

An error has occurred while executing the application API -- phpScheduleIt

CAUSE

phpScheduleIt requires that the PHP 'mysqli' extension is installed.

You can check this by creating a file named "phpinfo.php" in the directory where you are trying to install the app, and give it this content:

<? phpinfo(); ?>

And you will then be able to see your PHP configuration here:

http://{YOURDOMAIN_COM}/{POSSIBLE_PATH}/phpinfo.php

Search for "mysqli" to confirm that this is the likely cause of the error.

SOLUTION

If your webhosting control panel allows you to customize your PHP configuration then you can possibly fix this from there, otherwise you will need to ask your webhosting provider or server administrator to add it for you.

Error: MySQL Barracuda format is not available -- Moodle

CAUSE

As of version 3.5, Moodle requires the Barracuda SQL disk format. The Barracuda disk format is only standard on MySQL 5.6+ (or the MariaDB equivalent). Earlier versions of MySQL/MariaDB will default to the older Antelope disk format.

You can read about it on the Moodle website here: Converting InnoDB tables to Barracuda

SOLUTION

This is not something that Installatron can automatically handle, unfortunately, so we recommend that if an administrator wants Moodle 3.5+ to be installable on their server then they should update MySQL to a version that defaults to Barracuda.

Here is a tip for ensuring that MySQL 5.6 databases default to the Barracuda disk format:

. It might be only only necessity to add/edit one line in my.cnf or my.ini:

innodb_file_format=Barracuda

-and restart mysql.

. All old dbs will continue to use the old Antelope format.
. All new dbs will use Barracuda.
. (I don't know if the same edit works for earlier versions of MySQL)
	

All of the above gets your server ready to work with Moodle 3.5 but it doesn't cover the situation where you have an existing Moodle that uses the older Antelope MySQL disk format and now you want to upgrade to 3.5 where it requires Barracuda. There are essentially two options here:

  1. Remain on the 3.4.x branch. I suspect a lot of people will do this because the Barracuda requirements are too difficult to deal with, and I expect that Moodle's developers will continue to support this branch for a good while (because a lot of people will continue to use it).
  2. Update your existing database to Barracuda format. The steps to do this are described at the link above. We definitely recommend extracting a full copy of the database using phpMyAdmin before you try changing the format.

Note that it's likely that everything described here can only be performed by the webhosting provider or server administrator.

php-pdo-mysql-version-minimum v1 (detected: OFF)

CAUSE

A number of apps require the PDO MYSQL PHP extension, which is not standard on all hosting control panels.

SOLUTION

Add the PDO MYSQL extension to PHP, or disable affected apps within Installatron Admin » Application: Access Control.

Zurmo requires MySQL 'max_sp_recursion_depth' to be set at a value of '100' or higher

CAUSE

Zurmo requires that MySQL's 'max_sp_recursion_depth' parameter has a value of 100 or more.

SOLUTION

Ask your webhosting provider or server administrator to increase the value for you.

Why does Installatron connect to my domain with a URL like http://123.123.123.123/apiwt.php?width=656?

This process updates the preview image for the application in the user's My Applications tab, in Installatron.

What should I enter as the Path value for a Migration (aka. remote Import)?

Finding the correct value to enter for Path when importing a remote application (ie. a Migration) can be difficult because it depends on how the local and remote servers are configured. But the correct value will be one of these:

    1. An absolute path relative from the remote account's home directory to the application's files

    This means a path starting with "/" and then proceeding from the source account's home directory to the application's files. Some examples:

    /public_html/
    /public_html/blog/
    /public_html/sourcedomain.com/
    /domains/sourcedomain.com/public_html/
    /domains/sourcedomain.com/public_html/shop/
    /sourcedomain.com/

    2. An absolute server path to the application's files

    This means a full, absolute server path to the application's files. These look the same as the above paths except they include the path from the root to the account's home directory. Some examples:

    /home/yourusername/public_html/
    /home/yourusername/public_html/blog/
    /home/yourusername/public_html/sourcedomain.com/
    /home2/yourusername/domains/sourcedomain.com/public_html/
    /home2/yourusername/domains/sourcedomain.com/public_html/shop/
    /var/www/vhosts/sourcedomain.com/
    C:\inetpub\vhosts\sourcedomain.com\

    3. A relative server path to the application's files from where the login logs in

    This means a path that does not start with "/", that goes from where the FTP/SSH login logs in to the application's files. Some examples:

                       (if the FTP/SSH login logs in directly to the app's files then you can leave Path blank)
    public_html/       (if the FTP/SSH login logs in to the account's home directory)
    blog/              (if the FTP/SSH login logs in to the domain's public document root)

So there you have the 3 possible Path values that might be needed in this field. We described them in that order for clarity however we recommend trying them in this order: 1, 3, 2

Why that order? Because it's the most likely order that they will work in. And in most cases we find that the paths described by '1' are correct.

How do you find the path?

Your webhosting control panel will often tell you the absolute path to your account's home directory, which is required by '2', should you need it. From there you can use the Files or File Manager tool from your control panel to explore the path structure from your account's home directory to the location of your application's files.

Alternatively, you can create a file named "pwd.php" in the application's main directory and give the file this content:

<? pwd(); ?>

Then load this URL into your web browser:

http://{YOURDOMAIN}/{POSSIBLE_PATH}/pwd.php

And that will show you the full, absolute server path to the location of that file (and therefore to the application's files). That will tell you the value of '2' and from there you can work out what to remove to find the '1' path value.

© 2004 - 2023 Installatron LLC. All rights reserved. Privacy Policy.