The QuickSetup and ConfiguringFlexWiki pages both give instructions for installing FlexWiki within a new, empty virtual server. However, it is possible to install FlexWiki within an existing virtual server. This page explains where you need to deviate from the standard instructions to use an existing virtual server.

First of all, there is the trivial case. Follow all the standard instructions, but ignore the parts that say "you'll need an empty virtual server." Be aware, however, that if you have any existing files with the same names as those in the FlexWikiBinaries ZIP file, the existing files will be overwritten by the FlexWiki versions.

The safer way to install FlexWiki within an existing virtual server is to make FlexWiki a subdirectory of your existing virtual server. The rest of this page explains how this installation differs from the standard installation instructions given in QuickSetup.

The warning on the QuickSetup page still applies: These instructions assume you are an experienced adminstrator of ASP.NET applications. If you are not an experienced ASP.NET administrator, STOP HERE!

1 - Get the software

No changes in this step. Get the FlexWikiBinaries ZIP file as directed in QuickSetup.

2 - Install

Replace the QuickSetup instructions with the following steps:

1. Extract the contents of the FlexWikiBinaries ZIP file to a folder of your choosing within your existing virtual server. For example, if your existing virtual server is located at C:\inetpub\wwwroot, you might extract the files to C:\inetpub\wwwroot\YourFolderName. ''Note: the folder name you choose becomes part of your url. You should avoid spaces in the folder name.
2. Turn the folder into a web application using the following steps:
1. Open the Internet Information Services manager.
2. In the left hand treeview pane, navigate to the folder you created in step 1 and select it.
3. Open the properties dialog for your folder. (Alt-Enter or right-click-context-menu/Properties or Actions menu/Properties)
4. The bottom half of the dialog has the heading Application Settings. The first setting is Application Name, which will be filled in by default with the folder name. Leave the name alone, but click the Create button to the right of the name. The text on the button will change to Remove. (Don't click Remove - this will return the folder to a regular, non-application, folder)

1. Click OK to close the dialog. You can also close the Internet Information Services manager - we are done with it.

3 - Edit web.config

No changes - follow the instructions in the standard QuickSetup.

4 - Create the federation configuration

No changes - follow the instructions in the standard QuickSetup.

5 - Create the content base

No changes - follow the instructions in the standard QuickSetup.

6 - View your new page

The only change here is the url for your wiki. You should be able to navigate to your new page by visiting http://<yourserver>/default.aspx/YourFolderName/HomePage.html

Troubleshooting

No changes here, either. You should start your troubleshooting by using the ConfigurationChecker