ScrewTurnWiki.Installation History

Hide minor edits - Show changes to output - Cancel

July 24, 2014, at 01:15 PM by MichaelPaulukonis -
Added lines 1-165:

!! [[#installation]] Installation
!!! [[#prerequisites]] Prerequisites
The following software must be installed on the server in order to run ScrewTurn Wiki:

* Internet Information Services (IIS) 5.1/6/7/7.5
* Microsoft .NET Framework 3.5 SP1 (ASP.NET 3.5 SP1)
* Microsoft SQL Server 2005/2008 Express or greater (optional).

!!! [[#sqlinstall]] SQL Server provider
I haven't installed using SQL Server, yet.
Because I failed sat getting it to work when I tried.
Of course, I also knew almost nothing about administering SQL Server at that time.
And now, I know ''next'' to nothing, so, I should try again.....

!!! [[#fileinstall]] files provider

# download the [@File-System Data Storage@] from [[]] (NOTE: this may change as the project is migrated)

[[|This page]] describes how to install ScrewTurnWiki using the file-system data storage.
#  Download the File-System Data Storage ZIP package from [[|the download page]]
## archived copy of [[]]
#  Verify that your system has the .NET Framework 3.5 installed (see [[WebDevelopment/IIS]])
#  Create a new directory to host your wiki, e.g. C:\inetpub\wwwroot\wiki
#  You'll find a [@WebApplication@] directory in the ZIP file; copy all the '''contents''' into the new directory
## do not copy the actual folder itself.
#  Configure the new directory as [@Application@] or [@Website@] in IIS
#  Open the web.config file with a text editor and set the [@MasterPassword@] field with a password that will be used for the built-in admin account, for example:
##  [@<add key="MasterPassword" value="my_password_123" />@]
#  In the new directory, set the permissions of the public directory so that the ASP.NET Worker Process has "Modify" permissions on it
## on IIS 7/7.5 in Integrated Pipeline Mode, set permissions for the user account defined by the Application Pool that runs the wiki
## on IIS 7/7.5 in Classic Pipeline Mode or IIS 6, set permissions for "NETWORK SERVICE"
## on IIS 5 or 5.1, set permissions for "ASPNET"
#  Launch a browser and navigate to your wiki
#  Login with admin and the password set in web.config.
## NOTE: you may need to initially login using the [@http://localhost/<wikiname>@] url.
## Navigate to [@Administration >> Configuration >> General Configuration@] and set the wiki url to the desired URL
## I had issues when using the machine name

I've always had to comment out the [@configSections@] inside of [@web.config@]

I use a custom [@Application Pool@]:
||border=1 width=80%
||.NET Framework||v2.0* (see below)||
||Managed Pipeline mode||Integrated||

Remember that identity, and be sure that you use the same identity for the app-pool as you do when you set folder permissions.

STW v3 is 3.5 - so v2 framework
STW v4 is 4 - so v4 framework

I had some trouble with localhost resolving -- [@] worked fine -- but it was an IIS/Windows 7 thing, not screwturn.
I took a number of steps to resolve it -- so don't know what did the trick.
hosts file localhost was commented out. uncommenting/re-commenting seemed to make no difference.
I restarted the DNS Client service
I restarted the IIS service a couple of times.
Eventually, it started working.....

!!!! Installation Errors
!!!!! Cannot write into the public directory - check permissions
(:source lang=text:)
Cannot write into the public directory - check permissions
  Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.

 Exception Details: ScrewTurn.Wiki.PluginFramework.InvalidConfigurationException: Cannot write into the public directory - check permissions

SOLUTION: make sure that your folder permissions are granted to the same user as the wiki's app-pool. Are you sure? '''double-check the app-pool.'''

!!!!! Security Exception
(:source lang=text:)
Security Exception
  Description: The application attempted to perform an operation not allowed by the security policy.  To grant this application the required permission please contact your system administrator or change the application's trust level in the configuration file.

 Exception Details: System.Security.SecurityException: Request for the permission of type 'System.Web.AspNetHostingPermission, System, Version=, Culture=neutral, PublicKeyToken=b77a5c561934e089' failed.


Solution: [[]]

!!!!! We're sorry, an error occurred while processing your request. The error information has been registered and it will be investigated.
(:source lang=text:)
Welcome Guest, you are in: <root>• Login

ScrewTurn Wiki

• Main Page

System Error

We're sorry, an error occurred while processing your request. The error information has been registered and it will be investigated.
Please restart from the Main Page.

SOLUTION: click on the link for the Main Page. Who knows. This is the screen I got when everything started working.

!!!! migrating data from an existing instance
# copy the contents of [@public >> pages@]
# possibly, copy the [@web.config@] file

->the setup instructions are not optimized for IIS-foreigners. When I first tried to install STW, I had been using pmwiki (and others) on Apache or XAMP-stacks for years.
It took me more than a month of trial, error, googling, and more trying and erroring before I actually got the install to work.

I certainly doesn't help that the instructions are for a .NET 3.5 project, and every server I've had to install it on is already running 4.0

!!! [[#installerrors]] errors
!!!! redirect to IP address on admin-login
You attempt to login, but are shown a message that the page (IP Address) is not responding
Go back/open another tab for any wiki page, and you will be shown to have logged in
You need to set the URL under [@Admin >> Configuration >> Wiki URL@] to match what your site URL actually is
In my case, it was set to an IP address (auto-detected during install. whatever).

!!!! [=System.Web thrown System.Web.HttpRequestValidationException=]
Trying to view changes, nothing happens (silent failure).
Trying to save changes, the following error occurs:

(:source lang=text wrap=OUTPUT_WIDTH:)
System.Web.HttpRequestValidationException (0x80004005):
A potentially dangerous Request.Form value was detected from the client (ctl00$CphMasterSA$editor$txtMarkup="[....]"

[[|You must run STW in a .NET 2.0 app pool as .NET 4.0 is not supported.]]
Indeed, changing the app-pool from 4.0 to 2.0 got it to work.

!!!! [="PageHandlerFactory-Integrated" has a bad module "ManagedPipelineHandler"=]
(:source lang=text wrap=OUTPUT_WIDTH:)
HTTP Error 500.21 - Internal Server Error
Handler "PageHandlerFactory-Integrated" has a bad module "ManagedPipelineHandler" in its module list

>>clip lrindent<<
run the following command at the command prompt (64bit OS)

[@%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i@]

If I had been on a 32 bit system, it would have looked like the following:

[@%windir%\Microsoft.NET\Framework\v4.0.21006\aspnet_regiis.exe -i@]

!!!! The requested page cannot be accessed
(:source lang=text:)
The requested page cannot be accessed because the related configuration data for the page is invalid.

HTTP Error 500.19 - Internal Server Error
The requested page cannot be accessed because the related configuration data for the page is invalid.

Config Error There is a duplicate 'system.web.extensions/scripting/scriptResourceHandler' section defined

Comment out the entire section group "system.web.extensions"