You can use this legacy procedure to run MDriven Server locally on Windows 7 Enterprise when the standard Windows IIS installation does not work.
When to use this procedure
This procedure uses Microsoft WebMatrix and IIS Express rather than a full IIS deployment. Use it for a local Windows 7 Enterprise installation that cannot be completed with the standard Windows installation procedure.
For Windows 8, Windows 10, Windows Server 2012 R2, or Windows Server 2016, use Installing MDriven Server on Windows instead. That procedure describes the IIS features, application pool settings, Web Deploy setup, and file permissions for a standard IIS-hosted installation.
Before you start
Prepare the following:
- A local folder containing the MDriven Server files.
- Microsoft Web Platform Installer 5.0. Download it from Microsoft Web Platform Installer 5.0 if it is not already installed.
- Microsoft WebMatrix 3, installed through Web Platform Installer.
- IIS Express. Visual Studio installations commonly include IIS Express; otherwise, install it from Web Platform Installer.
This is a local-development-style setup. WebMatrix runs the selected MDriven Server folder through IIS Express.
Install the required Microsoft tools
- Install Microsoft Web Platform Installer 5.0 if it is not already present.
- Open Microsoft Web Platform Installer.
- Select the Products tab.
- Find and install Microsoft WebMatrix 3.
- Confirm that IIS Express is installed. If it is not installed, find IIS Express in Web Platform Installer and install it.
Open the MDriven Server site
- Start Microsoft WebMatrix.
- Select Open, then select Folder.
- Browse to and select the folder that contains MDriven Server.
- In WebMatrix, select Site at the bottom of the workspace.
- Select Settings.
- Enable SSL Connection.
- Select Run.
WebMatrix shows a link next to the SSL Connection setting. Open that link in your default browser to reach the local MDriven Server site.
Create and prepare the administrator account
When MDriven Server opens for the first time, it displays the registration screen.
- Register a new administrator account, for example
admin. - Do not initially register the account name
a. MDriven Turnkey uses that account name. - Sign in with the administrator account you created.
- Open Admin area.
- Open Infos, errors and MDrivenServer evolve.
- Select Evolve Admin database.
Evolving the Admin database prepares the administrative data used by MDriven Server.
Reserve the Turnkey account name
MDriven Turnkey uses a user account named a. If an existing user already has that name, rename that user before registering the Turnkey account.
- While signed in as the administrator, open AutoForm.
- Select
databaseIdentityand set it toadmin. - Select ASP_User, then select Show.
- Locate the user named
a. It appears at the top of the user list. - Select Details for that user.
- Change the user name to a different name and save the change.
- Sign out.
- Register a new user named
a, using the password you want MDriven Turnkey to use.
For example, if an automatically created a user exists, rename it to legacy-a. You can then register a with the password intended for Turnkey.
Verify the installation
Confirm all of the following before connecting Turnkey:
- WebMatrix starts the site with Run.
- The SSL link opens the MDriven Server registration or sign-in screen.
- You can sign in with the administrator account.
- Evolve Admin database completes.
- The
aaccount is available for MDriven Turnkey.
Troubleshooting
| Symptom | Check |
|---|---|
| WebMatrix cannot run the site | Verify that IIS Express is installed and that you opened the folder containing the MDriven Server files. |
| The expected local site does not open | In Site → Settings, verify that SSL Connection is enabled, then use the link shown next to that setting. |
| You receive a 403 error when starting MDriven Server | Verify that ASP.NET 4.7 or later is installed. See Installing MDriven Server on Windows. |
| The login screen returns Error 405, method not allowed | In a standard IIS installation, enable .NET Framework WCF Services HTTP Activation. See Installing MDriven Server on Windows. |
| You cannot use the intended Turnkey password | Check ASP_User while databaseIdentity is set to admin. Rename any existing a user, then register a again with the intended password.
|
Next steps
After the local server is running, use Configure and Maintain MDriven Server for administration, security, maintenance, and recovery guidance. If you need Windows-integrated sign-in rather than the MDriven Server user account flow described here, see MDrivenServer with Windows authentication.