diff --git a/core/data/System/InstallationGuide.txt b/core/data/System/InstallationGuide.txt index 6a0d40a19b..0d197734e0 100644 --- a/core/data/System/InstallationGuide.txt +++ b/core/data/System/InstallationGuide.txt @@ -1,4 +1,4 @@ -%META:TOPICINFO{author="ProjectContributor" date="1490124221" format="1.1" version="1"}% +%META:TOPICINFO{author="ProjectContributor" date="1494206626" format="1.1" version="1"}% %META:TOPICPARENT{name="AdminDocumentationCategory"}% ---+!! Installation Guide @@ -414,6 +414,12 @@ And the configuration can then be checked, with optional verbose output: tools/configure -check -verbose +File system permissions can also be checked for any of +={DataDir}=, ={LocalesDir}=, ={PubDir}=, ={ScriptDir}=, ={TemplateDir}=, ={ToolsDir}= and ={WorkingDir}=, for ex: + +tools/configure -check {DataDir} -method validate_permissions + + Configuration settings can be searched and queried as well: tools/configure -search Umask diff --git a/core/data/System/UpgradeGuide.txt b/core/data/System/UpgradeGuide.txt index e669cba9c5..57599d0a92 100644 --- a/core/data/System/UpgradeGuide.txt +++ b/core/data/System/UpgradeGuide.txt @@ -1,4 +1,4 @@ -%META:TOPICINFO{author="ProjectContributor" comment="" date="1494199312" format="1.1" version="1"}% +%META:TOPICINFO{author="ProjectContributor" comment="" date="1494206626" format="1.1" version="1"}% %META:TOPICPARENT{name="AdminDocumentationCategory"}% %STARTINCLUDE% ---+ Foswiki Upgrade Guide @@ -413,6 +413,18 @@ In your new installation, default copies of the following topics were installed: If you customized these topics in your old installation, transfer the changes to these topics in the new installation. Use the corresponding files in the =<oldwiki>/<old_system_web>/= directory as a reference. +---+++ Check your configuration and installation +Configure provides some tools to validate your installation. They should be +run as the web server userid: + +cd +sudo -u www-data tools/configure -check +sudo -u www-data perl tools/configure -check {DataDir} -method validate_permissions +sudo -u www-data perl tools/configure -check {PubDir} -method validate_permissions + ... also can be run on: + {LocalesDir} {ScriptDir} {TemplateDir} {ToolsDir} {WorkingDir} + + ---+++ Validate your Wiki applications and other key functionality Execute your test plan to validate the Wiki applications and other key functionality that need to be up and running after the upgrade.