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).
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.....
- download the
File-System Data Storagefrom http://www.screwturn.eu/Download.ashx (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
- Verify that your system has the .NET Framework 3.5 installed (see IIS)
- Create a new directory to host your wiki, e.g. C:\inetpub\wwwroot\wiki
- You’ll find a
WebApplicationdirectory in the ZIP file; copy all the contents into the new directory
- do not copy the actual folder itself.
- Configure the new directory as
- Open the web.config file with a text editor and set the
MasterPasswordfield 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
- Navigate to
Administration >> Configuration >> General Configurationand set the wiki url to the desired URL
- I had issues when using the machine name
- NOTE: you may need to initially login using the
I’ve always had to comment out the
configSections inside of
I use a custom
|.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 asp.net 3.5 - so v2 framework
STW v4 is asp.net 4 - so v4 framework
I had some trouble with localhost resolving --
127.0.0.1 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.....
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.
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=22.214.171.124, Culture=neutral, PublicKeyToken=b77a5c561934e089' failed.
We’re sorry, an error occurred while processing your request. The error information has been registered and it will be investigated.
• Main Page
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
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
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:
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"
Handler "PageHandlerFactory-Integrated" has a bad module "ManagedPipelineHandler" in its module list
run the following command at the command prompt (64bit OS)
If I had been on a 32 bit system, it would have looked like the following:
The requested page cannot be accessed
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”