| Index: trunk/testing/installer/QUICKSTART |
| — | — | @@ -26,6 +26,11 @@ |
| 27 | 27 | |
| 28 | 28 | 6. Full path syntax |
| 29 | 29 | |
| | 30 | +7. Common problems |
| | 31 | +7.1 Database problems |
| | 32 | +7.2 mixing up instances_dir with base_scriptpath |
| | 33 | + |
| | 34 | + |
| 30 | 35 | =============== |
| 31 | 36 | 1. Installation |
| 32 | 37 | =============== |
| — | — | @@ -300,3 +305,52 @@ |
| 301 | 306 | tag use a particular (svn) tag |
| 302 | 307 | limit n limits output to at most n items (analogous to the sql command of same name) (useful with ls) |
| 303 | 308 | |
| | 309 | + |
| | 310 | + |
| | 311 | +================== |
| | 312 | +7. Common problems |
| | 313 | +================== |
| | 314 | + |
| | 315 | +----------------------------- |
| | 316 | +7.1 Database problems |
| | 317 | +----------------------------- |
| | 318 | + |
| | 319 | +Symptoms: |
| | 320 | +* "WARNING: Mysql settings do not seem to be correct." |
| | 321 | +* "Cannot access database. (Is your settings.py correct?)" |
| | 322 | + |
| | 323 | +Check to make sure your settings.py is set up correctly, |
| | 324 | +then try again. |
| | 325 | + |
| | 326 | +if you get a |
| | 327 | +* "Failed to create admin user on ..." |
| | 328 | +The database was set up correctly, but for some reason the |
| | 329 | +wiki maintenance scripts can't find it. |
| | 330 | + |
| | 331 | +Check in your mediawiki directory to see if you can locate |
| | 332 | +the problem in LocalSettings.php or InstallerUniqueSettings.php |
| | 333 | +, and please report a bug, if |
| | 334 | +appropriate. |
| | 335 | + |
| | 336 | +------------------------------------------------ |
| | 337 | +7.2 mixing up instances_dir with base_scriptpath |
| | 338 | +------------------------------------------------- |
| | 339 | + |
| | 340 | +Symptom: |
| | 341 | + the installer finishes installing and reports |
| | 342 | + that it has completed successfully, but |
| | 343 | + apache can't find the wiki, or won't run it. |
| | 344 | + |
| | 345 | +* Apache reports 403 Forbidden: |
| | 346 | + * Add Options indexes to your apache settings, vhost, or .htaccess file |
| | 347 | + * Make sure the directory you installed the wiki is world readable. |
| | 348 | + * instead of cehcking base_scriptdir, try point your browser at base_scriptdir/<the name of your wiki> |
| | 349 | + |
| | 350 | +* Apache reports 404: |
| | 351 | + * Are you sure the installer ran ok? |
| | 352 | + * your base_scriptdir is likely set wrong, try place a simple test.html in the directory |
| | 353 | + you are installing in, and see what happens. |
| | 354 | + |
| | 355 | + |
| | 356 | +* Apache fails to run PHP: |
| | 357 | + * make sure php is properly installed. |