Troubleshooting

Also available in Deutsch, Русский


Any problems with the install, paste below or in comments to this page or the discussion section in the forum.
-> see also FAQ



Installing is very straightforward overall, however there are two things to look out for:

  1. general: the unzipped directory and all contained files and subdirectories have (secure but not web-readable) permissions set so that the web-based installer is not found. The fastest way to get things running, but which also makes the install less secure is to go into the folder that contains the 'wacko' directory and run chmod -R 755 wacko. Alternatively, go through all the directories and adjust permissions as necessary.
  2. perhaps a problem on some webhosts: the .htaccess file gave my web host's configuration trouble, i.e. it couldn't find anything within the wacko folders. deleting .htaccess solved the problem.

You’ll need an empty database. If you’re not sure how to create a new database or find this information, ask your web host.

1. Setup

1.1. SessionFileStore: inaccessible directory "/tmp"

Usually caused by a missing /tmp folder on Windows. Try to create the /tmp folder in root of disk or choose another option.

1.2. Necessary adjustments for XAMPP Windows

For XAMPP Windows you first need to enable the GD and Intl extension in php.ini, both of which are required by WackoWiki.


  1. Open the php.ini file (e.g. C:\xampp\php\php.ini).
  2. Search for ;extension=gd and ;extension=intl.
  3. Remove ; from both entries and then restart Apache server.

Furthermore, in the config/constants.php file, the value for the session directory should be changed.
const CACHE_SESSION_DIR = '/xampp/tmp';


Adjust the paths according to your environment, in the example above XMAPP Windows was installed under C:\xampp.

1.3. Install under subdirectory and mode_rewrite

Went to install R5.0 on my cloud server under the subdirectory /wiki/ and was given a 404 when accessing the /devwiki/ directory. Furthermore, accessing the index.php directly was loading but not loading any CSS/JS files for the installation.


Solution:
The fix for this was to add the following line to the root directory's .htaccess, right after the line that reads RewriteEngine on:

RewriteBase /wiki/

see also

1.4. NGINX Rewrite Rules

WackoWiki is server-agnostic, but if you turn rewrite_mode on, your wiki may become inaccessible.
Please turn rewrite_mode in the installer or the secondary config off, if you haven't configure the NGINX rewrite rules yet.


off on
rewrite_mode
wiki/?page=HomePage wiki/HomePage

location / {
  rewrite ^(.*)$ /index.php break;
}

  1. Converting Apache Rewrite Rules to NGINX Rewrite Rules
  2. Pitfalls and Common Mistakes
  3. Creating NGINX Rewrite Rules

1.5. I have No WikiEdit toolbar

  • check if your client/browser settings accepts JS (e.g. white list your wiki in NoScript / uMatrix)

2. Enabling debug output

Turning PHP error reporting in config/constants.php on.

const PHP_ERROR_REPORTING			= 6;

For more details read the Debugging section.

Comments

  1. Error loading WackoWiki DBAL

    Warning: mysqli_connect(): (HY000/1049): Unknown database 'db_name' in /wacko/class/dbmysqli.php on line 17
    Error loading WackoWiki DBAL: could not establish database connection.

    STEPS:
    1. create missing database
    2. go to constants.php and set
      • const RECOVERY_MODE					= 1;
    3. call admin.php (requires valid recovery_password)
    4. Database -> Restore
    • WikiAdmin
    • 08.04.2021 17:24 edited