<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<meta http-equiv="Content-Type" content="$HTMLDocType" />
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>CoolCleveland.com - PmWiki - Troubleshooting</title>
<link href='https://wiki.coolcleveland.com/wiki/pub/skins/triad/css/pm-core.css' rel='stylesheet' type='text/css' />
<!--HTMLHeader--><style type='text/css'><!--
span.anchor {
float: left;
font-size: 10px;
margin-left: -10px;
width: 10px;
position:relative; top:-0.1em;
text-align: center;
}
span.anchor a { text-decoration: none; }
span.anchor a:hover { text-decoration: underline; }
ol.toc { text-indent:-20px; list-style: none; }
ol.toc ol.toc { text-indent:-40px; }
div.tocfloat { font-size: smaller; margin-bottom: 10px;
border-top: 1px dotted #555555; border-bottom: 1px dotted #555555;
padding-top: 5px; padding-bottom: 5px;
width: 38%; float: right; margin-left: 10px; clear: right;
margin-right:-13px; padding-right: 13px; padding-left: 13px;
background-color: #eeeeee; }
div.toc { font-size: smaller;
padding: 4px; border: 1px dotted #cccccc;
background: #f7f7f7;
margin-bottom: 10px; }
#left-box { width: 170px; }
#right-box { width: 170px; }
--></style><script type="text/javascript">
function toggle(obj) {
var elstyle = document.getElementById(obj).style;
var text = document.getElementById(obj + "tog");
if (elstyle.display == 'none') {
elstyle.display = 'block';
text.innerHTML = "hide";
} else {
elstyle.display = 'none';
text.innerHTML = "show";
}
}
</script> <meta name='robots' content='noindex,nofollow' />
<script type='text/javascript' >
var fontSizeDefault = 90;
var increment = 10;
var cookieName = 'setfontsize';
var fsLabel = 'Text Size';
var fsBigger = 'bigger';
var fsNormal = 'default';
var fsSmaller = 'smaller';
</script>
<script type='text/javascript' src='https://wiki.coolcleveland.com/wiki/pub/skins/triad/fontsizer.js'></script>
<script type='text/javascript' >
var toggleCookies = '1';
var lcookie = 'triad_setLshow';
var rcookie = 'triad_setRshow';
var lshow = '1';
var rshow = '1';
var show = 'Show';
var hide = 'Hide';
var lwidth = '170px';
var rwidth = '170px';
</script>
<script type='text/javascript' src='https://wiki.coolcleveland.com/wiki/pub/skins/triad/togglebars.js'></script>
<link href='https://wiki.coolcleveland.com/wiki/pub/skins/triad/css/layout-triad.css' rel='stylesheet' type='text/css' />
<link href='https://wiki.coolcleveland.com/wiki/pub/skins/triad/css/layout-main.css' rel='stylesheet' type='text/css' />
<link href='https://wiki.coolcleveland.com/wiki/pub/skins/triad/css/layout-print.css' rel='stylesheet' type='text/css' media='print' />
<link href='https://wiki.coolcleveland.com/wiki/pub/skins/triad/css/font-verdana.css' rel='stylesheet' type='text/css' media='screen' />
<link href='https://wiki.coolcleveland.com/wiki/pub/skins/triad/css/c-white.css' rel='stylesheet' type='text/css' media='screen' />
<script type="text/javascript" src="https://wiki.coolcleveland.com/wiki/pub/js/coolcleveland.js"></script>
<link rel="stylesheet" href="https://wiki.coolcleveland.com/wiki/pub/css/user_management.css" type="text/css" />
</head>
<body >
<script type='text/javascript' ><!--
document.cookie = 'javascript=1; path=/';
if (fontSize) { fontSize.fontSizeInit();}
// document.write("<a href='#'></a >");
--></script>
<table id="outer-box" border="0" cellspacing="0" cellpadding="0" >
<tr>
<td id="header-box" colspan="3" valign="top">
<!--PageHeaderFmt-->
<div id='header' class='pageheader'><div class='rfloat' >
<form class='wikisearch' action='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting' method='get'><div><input type='text' name='q' value='Search' class='inputbox searchbox' size='18'
onfocus="preval=this.value; this.value=''; " /> <input type='submit' class='inputbutton searchbutton' value='Go' /><input type='hidden' name='focus' value='on' /><input type='hidden' name='action' value='search' /></div></form> <span style='font-size:83%'>
<script type='text/javascript' >
<!--
if (fsinit==1) document.write(fontSize.allLinks);
else if (fontSize) {
fontSize.fontSizeInit();
document.write(fontSize.allLinks); }
--></script>
</span>
</div><div class='lfloat' >
<p><span style='color: maroon;'><big><strong><a style='color: maroon' class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/HomePage'>CoolCleveland Sandbox</a></strong></big></span>
</p></div>
<div class="clearer"><!-- this is a clearer div --></div>
</div>
<!--/PageHeaderFmt-->
<!--PageTopMenuFmt-->
<div id="topnavbox">
<div id="topnav" class="nav">
<div id="toggleleft">
<script type='text/javascript' ><!--
if (toggleLeft) document.write("<input name='lb' type='button' class='togglebox' value='Hide ↓' onclick='toggleLeft()' />")
--></script>
</div>
<div id="toggleright"><script type='text/javascript' ><!--
if (toggleRight) document.write("<input name='rb' type='button' class='togglebox' value='↓ Hide' onclick='toggleRight()' />")
--></script>
</div>
<div class='lnav' >
</div>
<div class='rnav' >
<ul><li><big><a accesskey='e' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=edit'>Edit</a></big>
</li><li><big><a accesskey='ak_htmlt' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?type=htmlsource'>HTML</a></big>
</li><li><big><a accesskey='ak_attr' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=attr'>Attr</a></big>
</li><li><big><a accesskey='ak_attr' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/GroupAttributes?action=attr'>GroupAttr</a></big>
</li><li><big><a accesskey='h' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=diff'>History</a></big>
</li><li><big><a accesskey='c' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/RecentChanges'>Recent Changes</a></big>
</li></ul></div>
</div></div>
<!--/PageTopMenuFmt-->
</td>
</tr>
<tr>
<!--PageLeftFmt-->
<td id="left-box" valign="top">
<div id='sidebar'>
<div id='sidebarpage'><p><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/Admin'>Sandbox Admin</a><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/ThomasMulready'>TM</a></span></strong><br /><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/Podcasts'>PODCASTS</a></span></strong><br /><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/Jenna'>Jenna</a></span></strong><br /><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/Stephan'>Stephan</a></span></strong><br /><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/ThomasMulreadyAds'>ADS</a></span></strong><br /><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/NewsletterSandbox'>ISSUES</a></span></strong><br /><br /><br />
<strong><span style='font-size:144%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/CurrentIndex'>CURRENT</a></span></strong><br /><br /><br /><br />
</p>
<p class='vspace'><span style='font-size:69%'><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/SideBar?action=edit'>Edit this Menu</a></span>
</p>
</div>
<div id="sidebarfooter">
<p><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/TriadSkin'>TriadSkin</a><br />powered by <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PmWiki'>PmWiki</a>
</p>
</div>
</div>
</td><!-- end div left -->
<!--/PageLeftFmt-->
<td id="center-box" valign="top">
<div id="contentbox">
<!--PageTitleFmt-->
<div id= 'titlebarbox'>
<div id='titlebar' >
<div class='pagegroup' >
<p><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PmWiki'>PmWiki</a>
</p></div><div class='pagetitle' style='text-align: center;' >
<h1></h1>
</div>
</div>
</div>
<!--/PageTitleFmt-->
<div id='content'>
<!--PageText-->
<div id='wikitext'>
<p>
<a name='trailstart' id='trailstart'></a>
</p><div style='clear:right; float:right; font-size:smaller; background-color:#eee;' >
<p><span class='wikitrail'>< <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/FAQ'>| Frequently answered questions</a> | <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Documentation?action=edit'>index(#trailstart#trailend)|+</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Documentation?action=edit'>?</a> | <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Available?action=edit'>actions</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Available?action=edit'>?</a> ></span>
</p></div>
<div style='clear:right;' ><span class='frame rfloat' style='font-size: smaller; background-color: #ffffcc; clear: right;'>administrators </span>
</div>
<p class='vspace'><span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PmWiki'>Pm Wiki</a></span> is pretty robust and can automatically adapt to a very wide variety of environments.
However, sometimes things don't go as we expect, so we're cataloging common errors and their fixes here.
</p>
<div class='vspace'></div><h2>Troubleshooting Frequently Asked Questions</h2>
<div class='indent'><span style='font-style: italic; color: green;'> Note: This page on pmwiki.org is probably not the best place to post questions. Consider <a style='color: green' class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/HowToGetAssistance' rel='nofollow'>| seeking assistance</a> from the pmwiki-users <a style='color: green' class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Mailing?action=edit'>list(s)</a><a style='color: green' rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Mailing?action=edit'>?</a>, or post your question on the <a style='color: green' class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/Questions' rel='nofollow'>PmWiki:Questions</a> page.</span>
</div><div class='vspace'></div><div class='faq' > <a name='faq' id='faq'></a>
<p class='vspace'><a name='create_function' id='create_function'></a>
</p><p class='question'> My wiki displays warnings "Deprecated: Function create_function() is deprecated".</p>
<p class='vspace'> PHP version 7.2 deprecated a function which <span class="wikiword">Pm Wiki</span> used for markup definitions and pattern replacements. It is recommended to <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/UpgradesUpgrade?action=edit'>upgrades|upgrade</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/UpgradesUpgrade?action=edit'>?</a> to the latest <span class="wikiword">Pm Wiki</span> version and update all addons and skins from the <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/Cookbook/Cookbook?action=edit'>Cookbook</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/Cookbook/Cookbook?action=edit'>?</a>. Addons in the <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/Category/PHP72?action=edit'>PHP72</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/Category/PHP72?action=edit'>?</a> category are reported to be compatible with PHP 7.2. If you need a specific addon that has not yet been updated please contact us. To update your own addons, you probably need to update your calls to Markup(), see the pages <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Custom?action=edit'>markup</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Custom?action=edit'>?</a>, <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Functions'>Functions</a> and <a class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/CustomPagelistSortOrder' rel='nofollow'>CustomPagelistSortOrder</a>.
</p>
<p class='vspace'> How to track down the addons that cause the warnings, see the <a href='#deprecatednext'>section</a>.
</p>
<p class='vspace question'> <a name='deprecated' id='deprecated'></a> <a name='preg_replace' id='preg_replace'></a> My wiki displays warnings "Deprecated: preg_replace(): The /e modifier is deprecated, use preg_replace_callback instead".</p>
<p> This is caused by a change in PHP version 5.5 for the <a class='urllink' href='http://php.net/preg_replace|preg_replace' rel='nofollow'>http://php.net/preg_replace|preg_replace</a> function. <span class="wikiword">Pm Wiki</span> no longer relies on the deprecated feature since version 2.2.56 (it is recommended to upgrade to the latest version) but many recipes do. Note that even if the warning points to a line in pmwiki.php, the problem comes from a local configuration or recipe.
</p>
<p class='vspace'> Recipes and Skins are currently being updated for PHP 5.5. Check if there are more recent versions published by their maintainers on the <a class='urllink' href='http://www.pmwiki.org/wiki/Cookbook/Cookbook' rel='nofollow'>Cookbook</a>. If you update your <span class="wikiword">Pm Wiki</span> and recipes, and still see the warnings, here is how to find out which recipes cause them:
</p>
<p class='vspace'> For <span class="wikiword">Pm Wiki</span> version 2.2.71 or newer, in config.php, enable diagnostic tools: <br /><code><a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/DebugVariables#EnableDiag'><code class='varlink'>$EnableDiag</code></a> = 1;</code><br />Then visit your wiki with the action 'ruleset', for example <a class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/PmWiki?action=ruleset' rel='nofollow'>http://www.pmwiki.org/wiki/PmWiki/PmWiki?action=ruleset</a> or follow a link like <code class='escaped'>[[HomePage?action=ruleset]]</code>. This page will list all markup rules; those potentially incompatible with PHP 5.5 will be flagged with filenames, line numbers and search patterns triggering the warning.
</p>
<p class='vspace'> If the ?action=ruleset page shows no flagged rules, it is possible that either your recipes call the preg_replace() function directly, or they define various search-replace patterns in incompatible ways. In these cases, your warning should display the file name and line number causing problems, if not, here is how to track it. In config.php disable all recipes: included files from the cookbook directory, or a custom skin, or any line containing "Patterns". You can insert # at the beginning of a line to disable it. Then test the wiki: if you have disabled everything, the warning message should disappear.
</p>
<p class='vspace'> Next, re-enable your customizations one after another, every time testing the wiki. If at some point the warnings re-appear, you'll know that the customization you just enabled is not compatible with PHP 5.5.
</p>
<p class='vspace'> You can contact the authors of the broken recipes and (kindly) ask them to update their recipes for PHP 5.5 - recent <span class="wikiword">Pm Wiki</span> versions add new helper functions which make it easy, see <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/CustomMarkup'>CustomMarkup</a>. If you cannot have the recipes fixed by their authors, <a class='urllink' href='http://www.pmwiki.org/wiki/PITS/01319|tell' rel='nofollow'>us</a> and we'll try to fix them.
</p>
<p class='vspace'> Note that many hosting providers allow you to run different versions of PHP. See the documentation of your hosting plan to learn how to enable a PHP version earlier than 5.5.
</p>
<p class='vspace'> Finally, it is possible to suppress these warnings in PHP 5.5, by setting this line at the beginning of config.php: <br /><code>error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);</code><br />This should be a temporary solution, left only until your recipes are fixed.
</p>
<p class='vspace'><a name='crypt' id='crypt'></a>
</p><p class='question'> My wiki displays warnings "PHP Deprecated: crypt(): Supplied salt is not valid for DES. Possible bug in provided salt format".</p>
<p> You probably have configuration settings that worked on older PHP versions. Here is how to hunt and try to fix this.
</p>
<p class='vspace'> In your (farm)config.php or other local or cookbook files, any call to <code>crypt</code> can be replaced with <code>pmcrypt</code>, eg <br /><code><a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/SecurityVariables#DefaultPasswords'><code class='varlink'>$DefaultPasswords</code></a>['edit'] = crypt("my_password");</code> # <span style='color: red;'>DEPRECATED</span><br /><code><a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/SecurityVariables#DefaultPasswords'><code class='varlink'>$DefaultPasswords</code></a>['edit'] = <strong>pmcrypt</strong>("my_password");</code> # <span style='color: green;'>OK</span><br /><code><a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/SecurityVariables#DefaultPasswords'><code class='varlink'>$DefaultPasswords</code></a>['edit'] = array(<strong>pmcrypt</strong>("pass1"), <strong>pmcrypt</strong>("pass2"));</code> # <span style='color: green;'>OK</span>
</p>
<p class='vspace'> Additionally, if there are locked passwords with a star <code>*</code>, you should replace those with <code class='escaped'>@lock</code>: <br /><code><a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/SecurityVariables#DefaultPasswords'><code class='varlink'>$DefaultPasswords</code></a>['edit'] = '*';</code> # <span style='color: red;'>DEPRECATED</span><br /><code><a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/SecurityVariables#DefaultPasswords'><code class='varlink'>$DefaultPasswords</code></a>['edit'] = '@lock';</code> # <span style='color: green;'>OK</span> (and no pmcrypt)
</p>
<p class='vspace'> The <a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/SecurityVariables#DefaultPasswords'><code class='varlink'>$DefaultPasswords</code></a> variables usually have keys like 'edit', 'attr', 'read', 'upload', 'publish'.
</p>
<p class='vspace'> Some of your page files may still have the old star <code>*</code> locking. Files that in the past shipped with the star lock were <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/GroupAttributes'>Site.Group Attributes</a></span>, <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/SiteAdmin/GroupAttributes'>Site Admin.Group Attributes</a></span>, <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/AuthUser'>Site.Auth User</a></span> and/or <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/GroupAttributes?action=edit'>Pm Wiki.Group Attributes</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/GroupAttributes?action=edit'>?</a></span> in the directories wikilib.d and/or wiki.d. You need to edit them in a text editor and replace any line among these:<br /><code>passwdedit=*</code><br /><code>passwdattr=*</code><br /><code>passwdread=*</code><br /><code>passwdpublish=*</code><br /><code>passwdupload=*</code>
</p>
<p class='vspace'>Edit the file and replace the star <code>*</code> with the word <code class='escaped'>@lock</code> on every existing line. <em>Do not add these lines if they are not already in the file, and do not change the lines if there is something other than a single star after the = equals sign</em>. Save the file, upload it back to your wiki and the warnings should disappear. (If you run a wiki farm, you may have such files in several <code>wiki.d</code> directories.)
</p>
<p class='vspace'><a name='blank_sections' id='blank_sections'></a>
</p><p class='question'> After a PHP upgrade, some of the pages on my wiki are completely blank, empty, some have blank or missing sections, but the sidebar and the action links are visible.</p>
<p> This can be caused by a change in PHP 5.4 which affects the function <code>htmlspecialchars()</code>.
</p>
<p class='vspace'> The easiest temporary fix would be in your <code>php.ini</code>, or in <code>.user.ini</code> to change the <code>default_charset</code> directive to an 8-bit charset, for example cp1252:
</p>
<div class='vspace'></div><pre> default_charset = "Windows-1252"
</pre><p class='vspace'> Or, this may sometimes work in <code>pmwiki/local/config.php</code>:
</p>
<div class='vspace'></div><pre> ini_set("default_charset", "Windows-1252");
</pre><p class='vspace'> A more permanent fix would be to <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/UpgradesUpgrade?action=edit'>Upgrades|upgrade</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/UpgradesUpgrade?action=edit'>?</a> your installation to a more recent <span class="wikiword">Pm Wiki</span> version, your recipes, and in your own recipes or modules replace all calls to <code>htmlspecialchars()</code> with <code>PHSC()</code>, a <span class="wikiword">Pm Wiki</span> helper function for such cases.
</p>
<p class='vspace'> The "blank" pages come from the fact that in PHP 5.4 the default encoding switched from an 8-bit encoding to variable-bit validated UTF-8, and that an incorrect UTF-8 string will be rejected. If your wiki uses an 8-bit encoding, it is virtually certain that it is not valid UTF-8. Worse, even if you do use UTF-8 some browsers may submit invalid bits. So the always pretends that it converts an 8-bit encoding where all bits are allowed.
</p>
<p class='vspace question'> Why am I seeing strange errors after <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Upgrades'>upgrading</a>?</p>
<p> Make sure all of the files were updated, in particular <code>pmwiki.php</code> and all files in the <code>scripts/</code> directory.
</p>
<p class='vspace'> This question sometimes arises when an administrator hasn't
followed the advice, which used to be less prominent, on the
<a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Installation#notes'>installation</a> and
<a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Initial?action=edit'>setup tasks(#dontmodify)</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Initial?action=edit'>?</a> pages and has renamed
<em>pmwiki.php</em> instead of creating an <em>index.php</em> wrapper script.
If you have renamed <em>pmwiki.php</em> to <em>index.php</em>, then the upgrade procedure
won't have updated your <em>index.php</em> file. Delete the old version and
create a wrapper script so it won't happen again.
</p>
<p class='vspace'> Sometimes an FTP or other copy program will fail to transfer all of the
files properly. One way to check for this is by comparing file sizes.
</p>
<p class='vspace'> Be sure all of the files in the <em>wikilib.d/</em> directory
were also upgraded. Sometimes it's a good idea to simply delete the <em>wikilib.d/</em>
directory before upgrading. (Local copies of pages are stored in <em>wiki.d/</em> and not <em>wikilib.d/</em>.)
</p>
<p class='vspace'> Make sure that the <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/File?action=edit'>permissions</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/File?action=edit'>?</a> are correct. The official files have a restricted set of permissions that might not match your site's needs.
</p>
<p class='vspace'> If you use a custom pattern for <a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/BasicVariables#GroupPattern'><code class='varlink'>$GroupPattern</code></a> make sure that it includes Site (<a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/BasicVariables#SiteGroup'><code class='varlink'>$SiteGroup</code></a>) and since <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/PMWiki?action=edit'>PM Wiki</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PMWiki?action=edit'>?</a></span> 2.2 also <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/SiteAdmin/SiteAdmin'>Site Admin</a></span> (<a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/BasicVariables#SiteAdminGroup'><code class='varlink'>$SiteAdminGroup</code></a>).
Otherwise migration may fail (e.g. missing <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/SiteAdmin/SiteAdmin'>Site Admin</a></span> for <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/PMWiki?action=edit'>PM Wiki</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PMWiki?action=edit'>?</a></span> 2.2 and later) and/or login does not work.<br />Additionally Main (<a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/BasicVariables#DefaultGroup'><code class='varlink'>$DefaultGroup</code></a>) should be included too.
</p>
<p class='vspace'><a name='flock' id='flock'></a>
</p><p class='question'> I'm suddenly getting messages like "<code>Warning: fopen(wiki.d/.flock): failed to open stream: Permission denied...</code>" and "<code>Cannot acquire lockfile</code>"... what's wrong?</p>
<p class='vspace'> Something (or someone) has changed the <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/FilePermissions'>| permissions</a> on the <em>wiki.d/.flock</em> file or the <em>wiki.d/</em> directory such that the webserver is no longer able to write the lockfile. The normal solution is to simply delete the <em>.flock</em> file from the <em>wiki.d/</em> directory -- <span class="wikiword">Pm Wiki</span> will then create a new one. Also be sure to check the permissions on the <em>wiki.d/</em> directory itself. (One can easily check and modify permissions of the <em>wiki.d/</em> directory in <a target='_blank' class='urllink' href='http://filezilla-project.org/' rel='nofollow'>| FileZilla</a> (open-source FTP app) by right-clicking on the file > File attributes)
</p>
<p class='vspace'><a name='sidebar' id='sidebar'></a>
</p><p class='question'> My links in the sidebar seem to be pointing to non-existent pages, even though I know I created the pages. Where are the pages?</p>
<p class='vspace'> Links in the sidebar normally need to be qualified by a <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/WikiGroup'>WikiGroup</a> in order to work properly (use [[Group.Page]] instead of [[Page]]).<br />Also: Make sure you type Side<strong>B</strong>ar with a capital B.
</p>
<p class='vspace'><a name='headers' id='headers'></a>
</p><p class='question'> Why am I seeing "<code>PHP Warning: Cannot modify header information - headers already sent by ...</code>" messages at the top of my page.</p>
<p class='vspace'> If this is the first or only error message you're seeing, it's usually an indication that there are blank lines, spaces, or other characters before the <code class='escaped'><?php</code> or after the <code class='escaped'>?></code> in a <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Local?action=edit'>customization(s)</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Local?action=edit'>?</a> files such as <code>config.php</code>. Double-check the file and make sure there is nothing before the initial <code class='escaped'><?php</code>. It's often easiest and safest to eliminate any closing <code class='escaped'>?></code> altogether. On Windows, it may be, but shouldn't be, necessary to use a hex editor to convert LFCR line endings to LF line endings in the <code>local\config.php</code> file.
</p>
<p class='vspace'> When you save the file, the encoding/charset should be either cp1252/Windows1252 or UTF-8 without Byte Order Mark. <a class='urllink' href='https://notepad-plus-plus.org/' rel='nofollow'>| NotePad++</a> is an editor that can do this.
</p>
<p class='vspace'> When you transfer the files, tell your FTP manager to use text mode transfer, or, if that doesn't help, binary mode transfer.
</p>
<p class='vspace'> If the warning is appearing after some other warning or error message, then resolve the other error and this warning may go away.
</p>
<p class='vspace'><a name='session_write_close_error' id='session_write_close_error'></a>
</p><p class='question'> How do I make a PHP Warning about <code>function.session-write-close</code> go away?</p>
<p class='vspace'> If you are seeing an error similar to this
</p>
<div class='vspace'></div><div class='indent'><pre class='escaped'>
Warning: session_write_close() [function.session-write-close]:
open(/some/filesystem/path/to/a/directory/sess_[...]) failed: No such file
or directory (2) in /your/filesystem/path/to/pmwiki.php on line NNN
</pre>
</div><p class='vspace'><span class="wikiword">Pm Wiki</span> sometimes does session-tracking using PHP's
<a class='urllink' href='http://php.net/session' rel='nofollow'>| session-handling functions</a>.
For session-tracking to work, some information needs to be written
in a directory on the server. That directory needs to exist and
be writable by the webserver software. For this example, the
webserver software is configured to write sessions in this
directory
</p>
<div class='vspace'></div><div class='indent'><code class='escaped'>/some/filesystem/path/to/a/directory/</code>
</div><p class='vspace'>but the directory doesn't exist. The solution is to do at least one
of these:
</p><ul><li><strong>Create the directory</strong> and make sure it's writable by the webserver software
</li><li>Provide a session_save_path value that points to a directory that is writable by the server, e.g. in config.php:
</li></ul><div class='vspace'></div><div class='indent'><code class='escaped'>session_save_path('/home/someuser/tmp/sessions');</code> # unix-type OS
</div><div class='indent'><code class='escaped'>session_save_path('C:/server/tmp/sessions');</code> # Windows
</div><p class='vspace'><a name='multiplepwprompts' id='multiplepwprompts'></a>
</p><p class='question'> Why is <span class="wikiword">Pm Wiki</span> prompting me multiple times for a password I've already entered?</p>
<p class='vspace'> This could happen like out of nowhere if your hosting provider upgrades to PHP version 5.3, and you run an older <span class="wikiword">Pm Wiki</span> release. Recent <span class="wikiword">Pm Wiki</span> releases fix this problem.
</p>
<p class='vspace'> Alternatively, this may be an indication that the browser isn't accepting cookies, or that PHP's session handling functions on the server aren't properly configured. If the browser is accepting cookies, then try setting <a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/DebugVariables#EnableDiag'><code class='varlink'>$EnableDiag</code></a>=1; in <em>local/config.php</em>, run <span class="wikiword">Pm Wiki</span> using <code class='escaped'>?action=phpinfo</code>, and verify that sessions are enabled and that the session.save_path has a reasonable value. Note that several versions of PHP under Windows require that a session_save_path be explicitly set (this can be done in the <em>local/config.php</em> file). You might also try setting session.auto_start to 1 in your php.ini.
</p>
<p class='vspace'> See also the question <a href='#configphp-orderI'>have to log in twice</a> below.
</p>
<p class='vspace question'> I edited <em>config.php</em>, but when I look at my wiki pages, all I see is "<code>Parse error: parse error, unexpected T_VARIABLE in <em>somefile</em> on line <em>number</em>.</code>"</p>
<p class='vspace'> You've made a mistake in writing the PHP that goes into the <em>config.php</em> file. The most common mistake that causes the T_VARIABLE error is forgetting the semi-colon (;) at the end of a line that you added. The line number and file named are where you should look for the mistake.
</p>
<p class='vspace question'> Searches and pagelists stopped working after I upgraded -- no errors are reported, but links to other pages do not appear (or do not appear as they should) -- what gives?</p>
<p class='vspace'> Be sure all of the files in the <em>wikilib.d/</em> directory
were also upgraded. In particular, it sounds as if the <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/PageListTemplates'>Site.Page List Templates</a></span> page is either missing (if no links are displayed) or is an old version (if the links do not appear as they should). Also make sure that read-permissions (attr) are set for the pages <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/PageListTemplates'>Site.Page List Templates</a></span> and Site.Search.
</p>
<p class='vspace'><a name='mod_security' id='mod_security'></a>
</p><p class='question'> Some of my posts are coming back with "403 Forbidden" or "406 Not Acceptable" errors, or "Internal Server Error". This happens with some posts but not others.</p>
<p class='vspace'> Your webserver probably has <a class='urllink' href='http://modsecurity.org' rel='nofollow'>| mod_security</a> enabled. The mod_security "feature" scans all incoming posts for forbidden words or phrases that might indicate someone is trying to hack the system, and if any of them are present then Apache returns the 403 Forbidden or 406 Not Acceptable error. Common phrases that tend to trigger mod_security include "curl ", "wget", "file(", and "system(", although there are many others (depending on the configuration, percent signs, html tags, international characters).
</p>
<p class='vspace'>Since mod_security intercepts the requests and sends the "forbidden"
message before <span class="wikiword">Pm Wiki</span> ever gets a chance to run, it's not a bug in <span class="wikiword">Pm Wiki</span>, and
there's little that <span class="wikiword">Pm Wiki</span> can do about it. Instead, one has to alter the
webserver configuration to disable mod_security or reconfigure it to allow
whatever word it is forbidding. Some sites may be able to disable mod_security
by placing <code class='escaped'>SecFilterEngine off</code> in a <em>.htaccess</em> file.
</p>
<p class='vspace question'> I get the following message when attempting to upload an image, what do I do?</p>
<p><span style='font-size:83%'><code><strong>Warning</strong>: move_uploaded_file(): SAFE MODE Restriction in effect. The script whose uid is 1929 is not allowed to access /home/onscolre/public_html/pmwikiuploads/Photos owned by uid 33 in <strong>/home/onscolre/public_html/pmwiki/scripts/upload.php</strong> on line <strong>198</strong></code></span>
</p>
<p class='vspace'><code><strong><span class="wikiword">Pm Wiki</span> can't process your request</strong></code>
</p>
<p class='vspace'><span style='font-size:83%'><code>?cannot move uploaded file to /home/onscolre/public_html/pmwikiuploads/<span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/Photos/FoundationPupilsIn1958?action=edit'>Foundation Pupils In 1958</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/Photos/FoundationPupilsIn1958?action=edit'>?</a></span>.jpeg</code></span>
</p>
<p class='vspace'><span style='font-size:83%'><code>We are sorry for any inconvenience.</code></span>
</p>
<p class='vspace'> Your server is configured with PHP <a class='urllink' href='http://php.net/manual/en/features.safe-mode.php|Safe' rel='nofollow'>Mode</a> enabled. Configure your wiki to use a , then create the <em>uploads/</em> directory manually and set 777 permissions on it (rather than letting <span class="wikiword">Pm Wiki</span> create the directory).
</p>
<p class='vspace'><a name='TableRowIndexMax' id='TableRowIndexMax'></a> <a name='divisionbyzero' id='divisionbyzero'></a>
</p><p class='question'> I'm starting to see "Division by zero error in pmwiki.php..." on my site. What's wrong?</p>
<p class='vspace'> It's a bug in <span class="wikiword">Pm Wiki</span> that occurs only with the <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Tables'>tables</a> markup and only for versions of PHP >= 4.4.6 or >= 5.2.0. Often it seems to occur "out of nowhere" because the server administrator has upgraded PHP. Try <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Upgrades'>upgrading</a> to a later version of <span class="wikiword">Pm Wiki</span> to remove the error, or try setting the following in <em>local/config.php</em>:
</p>
<div class='vspace'></div><pre> <a class='varlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/LayoutVariables#TableRowIndexMax'><code class='varlink'>$TableRowIndexMax</code></a> = 1;
</pre><p class='vspace'><a name='configphp-order' id='configphp-order'></a>
</p><p class='question'> I have to log in twice <span style='font-size:83%'>(two times) (2 times)</span>. -or- My password is not being required even though it should. -or- I changed the password but the old password is still active. -or- My config.php password is not over-riding my farmconfig.php password.</p>
<p> It could happen if (farm)config.php, or an included recipe, directly calls the functions <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/CondAuth?action=edit'>Cond Auth</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/CondAuth?action=edit'>?</a></span>(), or <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/RetrieveAuthPage?action=edit'>Retrieve Auth Page</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/RetrieveAuthPage?action=edit'>?</a></span>(), <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/PageTextVar?action=edit'>Page Text Var</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PageTextVar?action=edit'>?</a></span>(), <span class="wikiword"><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/PageVar?action=edit'>Page Var</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/PageVar?action=edit'>?</a></span>() and possibly others, before defining all passwords and before including <span class="wikiword"><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/AuthUser'>Auth User</a></span> (if required).
</p>
<p class='vspace'>The is very significant.
</p>
<p class='vspace'><a name='CrashWhenEditing' id='CrashWhenEditing'></a>
</p><p class='question'> When editing an existing page, The "Save" causes a no-response of your server (not a blank page, no response at all, an endless connexion try). To get back the hand, it is necessary to request for another page (by clicking on its link in the menu for instance). And horror!, the ...?action=edit is then inhibited, it becomes impossible to edit any page.</p>
<p> When the editing of a page is initiated a file names <code class='escaped'>.flock</code> is created in the <code class='escaped'>wiki.d</code> repository. As long as this file exists it is impossible to edit any page. This file denotes an edition in progress and is automatically destroyed when leaving successfully an edit action by "Save". In case of a crash of the editing, this file is not destroyed. The remedy is, with an FTP client parameterized to show hidden files, to remove the <code class='escaped'>.flock</code> file. And all get back OK. This behavior is typically caused by a bug which provokes (directly or indirectly), an endless loop in a recipe concerned by the edited page.
</p>
<p class='vspace question'> I get the error "Data Mismatch - Locking FAILED!"</p>
<p> This is probably not a <span class="wikiword">Pm Wiki</span> error. <span class="wikiword">Pm Wiki</span> cannot create a lock file due to an underlying file system problem.
For example the disk quota has been exceeded (e.g. by an error log file or file uploads), or there are problems with file system permissions.
</p></div><div style='clear:right; float:right; font-size:smaller; background-color:#eee;' >
<p><span class='wikitrail'>< <a class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/FAQ'>| Frequently answered questions</a> | <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Documentation?action=edit'>index(#trailstart#trailend)|+</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Documentation?action=edit'>?</a> | <a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/Available?action=edit'>actions</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Available?action=edit'>?</a> ></span>
</p></div>
<p><a name='trailend' id='trailend'></a>
<a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/PmWiki/LtLt?action=edit'><<</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/PmWiki/LtLt?action=edit'>?</a>
</p><div style='background-color: #ffe; border-top: 1px solid black; font-size: .8em;' >
<p>This page may have <span class='commentout-pmwikiorg'> a more recent version on <a class='urllink' href='http://www.pmwiki.org' rel='nofollow'>pmwiki.org</a>: <a class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/Troubleshooting' rel='nofollow'>PmWiki:Troubleshooting</a>, and </span> a talk page: <a class='urllink' href='http://www.pmwiki.org/wiki/PmWiki/Troubleshooting-Talk' rel='nofollow'>PmWiki:Troubleshooting-Talk</a>.
</p></div>
</div>
<div class="clearer"><!-- this is a clearer div --></div>
</div>
</div><!-- end div contentbox -->
<!--PageFootMenuFmt-->
<div id ='footnavbox'>
<div id='footnav' class='navbuttons'><ul><li><a rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=edit'>Edit</a>
</li><li><a rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=diff'>Page History</a>
</li><li><a accesskey='ak_source' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=source'>Source</a>
</li><li><a accesskey='ak_upload' rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/PmWiki/Troubleshooting?action=upload'>Attach File</a>
</li><li><a rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/Search?q=link=PmWiki.Troubleshooting'>Backlinks</a>
</li><li><a rel='nofollow' class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/Search?q=PmWiki/'>List Group</a>
</li></ul><div class='vspace'></div><div class='indent'><em>Page last modified on January 10, 2018, at 08:21 AM</em>
</div>
</div>
</div>
<!--/PageFootMenuFmt-->
</td><!-- end div center -->
<!--PageRightFmt-->
<td id="right-box" valign="top">
<div id="rightbar"><p><br />
</p><ul><li><a class='urllink' href='http://www.coolcleveland.com/' rel='nofollow'>Home</a>
</li><li><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Sandbox/Admin'>Admin</a>
</li><li><a class='urllink' href='https://wiki.coolcleveland.com/wiki/AdminPanel/AdminPanel' rel='nofollow'>Admin Panel</a>
</li><li><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Main/UserSettings'>UserSettings</a>
</li><li><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Main/UserAccount'>UserAccount</a>
</li></ul><p class='vspace'><span class='rfloat'> </span>
<small><a class='wikilink' href='https://wiki.coolcleveland.com/wiki/Site/RightBar?action=edit'>Edit this menu</a></small>
</p>
<div class='vspace'></div>
</div>
</td><!-- end div right -->
<!--/PageRightFmt-->
</tr>
<tr>
<!--PageFooterFmt-->
<td id="footer-box" colspan="3" valign="top">
<div id="footer"><p style='text-align: center;'><a class='createlinktext' rel='nofollow'
href='https://wiki.coolcleveland.com/wiki/Site/Triad-ConfigurationSkin?action=edit'>config</a><a rel='nofollow'
class='createlink' href='https://wiki.coolcleveland.com/wiki/Site/Triad-ConfigurationSkin?action=edit'>?</a> <em>** pmwiki-2.2.107 **</em>
</p>
</div>
</td>
<!--/PageFooterFmt-->
</tr>
</table><!-- end div outer -->
<!--HTMLFooter-->
</body>
</html>