Training:Set up MDriven Turnkey on premise

There can be several reasons for running the MDriven Turnkey software on premise rather than in the cloud. And it is easy to achieve.

To run MDriven Turnkey on your own IIS you need to do the following:

Create a new IIS application:

Download these application packages, MDriven Server and MDriven Turnkey:

1.      Make sure you understand how to make the IIS server use https and how you can either self-sign of acquire your own certificate. This is key for making the internal WCF communication in MDriven Turnkey to work.

2.      Import the Application Package for MDriven turnkey into your IIS app

Now import the package for MDriven Server into your first application:

Name the application __MDrivenServer – with two underscores :

You will in the end have this:

Configure for https (not described in this book – IIS specific knowledge)

Notice the __MDrivenServer/logs catalog; things will work better if you application can access this – so find it in File Explorer and give read/write access to “IIS AppPool\NameOfTheAppPool”.

To configure your system navigate to the __MDrivenServer application:

https://localhost/MyMDrivenTurnkeyApp1/__MDrivenServer/

You should see this:

This is the server’s response to not finding the expected database – it creates it and sets things up to the best of its ability. Click Index to go back to default page:

We are prompted with a login – but we need to register a user that the MDriven Turnkey app will use to access the MDriven Server. You will also want to access the MDriven Server in order to upload and evolve models – so create a user “b” and remember the password:

Now log into MDriven Server with this user:

In the admin area choose user admin:

In UserAdmin you can control the existing users on your MDrivenServer – we need an account to be used by your turnkey site.

To tighten security for our MDrivenServer we are going to:

1.       Assign the users we want to have access the role SuperAdmin

2.       Check the box for Admin require Identification

3.       Check the box for Services require identification

Check the box for Turn off registration

This way we will enforce user identification and we have turned off the ability to register as a new user. It is important that you remember the password for the users you have – otherwise you will be locked out.

When you have accidently locked yourself out you can find the admin database, open it with SqlServerCompact tools. Find table admin_GlobalSettings and set column TurnOffRegistration to 0 (false) – now you may register a new user and regain control.

The database is located in __MDrivenServer\App_Data\DatabaseCompact.sdf

Now the MDrivenServer is fully configured and we will look at the MDriven Turnkey application that will use it.

Pointing our browser at the Turnkey application will give us this: https://localhost/MyMDrivenTurnkeyApp1

The reason is that the turnkey application expects to find a file with information about what user and password to use to access __MDrivenServer. The file should be in the App_Data folder and its name must be TurnkeySettings.xml. 

As we see there is a template file “TurnkeySettings – NotInEffect.xml” – copy this and name it “TurnkeySettings.xml”

This file is normally managed from the LicenseAndTicket web site – but since we are now installing Turnkey locally the LicenseAndTicket has no access to help us with this. We need to edit it manually.

Open the file and fill in the user name and password you picked for MDriven:

Once this is done we try our app again (you must restart your app-pool so that the file is re-read):

image

When we use MDriven Designer we will also need to enter the address to our MDriven Server manually – so skip the first login page and go for the second page:

(image)

We must fill in the user and password that has access to MDriven Server, we need to say it is slot A0 and we need to check “Automated Deploy” – that means an upload of model is automatically deployed. The server address is the same we use to access MDriven Server: https://localhost/MyMDrivenTurnkeyApp1/__MDrivenServer

And now we have everything set up to run the development loop or production in house – nothing on in the cloud.

To update the site with fresh binaries for MDriven Turnkey or MDriven server we can simply reapply fresh packages from the build server. 

(images x2)

Just make sure to choose “Append files” – because if you “delete” you will lose the settings we just did and the database with any models and