diff options
author | Matthieu Aubry <matt@piwik.org> | 2013-10-30 03:01:45 +0400 |
---|---|---|
committer | Matthieu Aubry <matt@piwik.org> | 2013-10-30 03:01:45 +0400 |
commit | be58a1cdd16e53dbcf18c27f4b472960c18123f8 (patch) | |
tree | dd689221981f134e905086155ae7ff08affb832f /tests/README.troubleshooting.md | |
parent | 5c0ff108a970c4029f32457f1fddc63689c09a11 (diff) |
Create README.troubleshooting.md
Diffstat (limited to 'tests/README.troubleshooting.md')
-rw-r--r-- | tests/README.troubleshooting.md | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/tests/README.troubleshooting.md b/tests/README.troubleshooting.md new file mode 100644 index 0000000000..8bf1e5a5f1 --- /dev/null +++ b/tests/README.troubleshooting.md @@ -0,0 +1,44 @@ +# Troubleshooting Piwik Tests + +If you have problems with running Piwik tests see below. + +If you cannot solve your issues please [ask in the forums](http://forum.piwik.org/list.php?9) + +## Using latest GIT version +On ubuntu to use the latest GIT: + +``` +sudo add-apt-repository ppa:git-core/ppa +sudo apt-get update +sudo apt-get upgrade +``` + +## PHP 5.5: also update PHPUnit to latest + +See [PHPUnit update](http://phpunit.de/manual/current/en/installation.html) or try this command: + + $ sudo pear install -a phpunit/PHPUnit + +## Troubleshooting failing tests + +If you get any of these errors: + * `RuntimeException: Unable to create the cache directory ( piwik/tmp/templates_c/66/77).` + * or `fopen( piwik/tmp/latest/testgz.txt): failed to open stream: No such file or directory` + * or `Exception: Error while creating the file: piwik/tmp/latest/LATEST` + * or `PHP Warning: file_put_contents( piwik/tmp/logs/piwik.test.log): failed to open stream: Permission denied in [..]` + +On your dev server, give your user permissions to write to the directory: + + $ sudo chmod 777 -R piwik/tmp/ + +## Troubleshooting SLOW tests + +If the tests are running incredibly slow on your machine, maybe you are running mysql DB on an ext4 partition? +Here is the tip that will save you hours of research: if you use Mysql on ext4 partition, +make sure you add "nobarrier" option to /etc/fstab to disable some super slow IO feature. + +Change from: + `UUID=83237e54-445f-8b83-180f06459d46 / ext4 errors=remount-ro 0 1` +to this: + `UUID=83237e54-445f-8b83-180f06459d46 / ext4 errors=remount-ro,nobarrier 0 1` + |