Installing TurnKey as an Azure WebApp
No edit summary
m ((username removed) (log details removed))
 
(37 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__NOTOC__


== Introduction ==
This tutorial will help you set up '''MDriven Turnkey on Microsoft Azure'''.
All the components needed to run MDriven Turnkey is available from the download page.


You can run MDriven Turnkey on your own IIS or on your own Azure account. To setup IIS see [[Installing MDriven Server]]
All the components needed to run MDriven Turnkey (the latest versions of MDriven Server & MDriven Turnkey) are available [https://mdriven.net/server here for MDrivenServer] and [https://mdriven.net/turnkey here for MDrivenTurnkey] - you will need both.


=== First ===
You can run MDriven Turnkey on your Azure account or set it up on your local IIS. To set up on a local IIS, see [[Installing MDriven Server on Windows|Installing MDriven Server on Windows.]]
1. Create your site “YourSite” as webapplication


2. Create another webapplication under “YourSite” called “__MDrivenServer” (double underscore) so that it ends up like this: “YourSite/__MDrivenServer”
== Setting Up on Azure ==
To start setting up your Turnkey application, go to [https://portal.azure.com '''https://portal.azure.com''']  and log in under your existing account or create the new one.


3. In “YourSite/__MDrivenServer” you install the MDriven Server zip from the download page
First, you need to create a '''new Web app''' to run your Turnkey application.
[[File:Create new Web app.png|none|thumb|528x528px|Create a new Web app on Azure]]Enter the name of your application and create or choose an existing App Services Plan.
[[File:Name your app and choose App Services Plan.png|none|thumb|533x533px|Name your app and choose App Services Plan]]
Now, we need to add a virtual directory, because two applications (MDriven Server & MDriven Turnkey) are running on one site.


4. In “YourSite” you install the MDriven Turnkey zip from the download page
Go to "'''Application Settings'''" and scroll down to "'''Virtual applications and directories'''" and create another application called “__MDrivenServer” (double underscore).


That is all as far installation requirements – the rest is configuration
Don't forget to make sure the __MDrivenServer is an application of its own (the application check box next to the folder name must be checked).
[[File:Create another webapp called " MDrivenServer".png|none|thumb|685x685px|Create another web app called "__MDrivenServer"]]
Now, we need to download the publish profile - go to "'''Overview'''" and press "'''Get publish profile'''".
[[File:Get publish profile from Azure.png|none|thumb|690x690px|Get the publish profile from Azure]]
When all these steps are done, we are ready to go to [https://portal.mdriven.net '''https://portal.mdriven.net''']


=== Second ===
'''Note:''' It is best to do at least the first deploy with Portal (as described below) since you then get the strong password set and init files updated for your installation - but after initial setup, you can easily deploy new code for Turnkey + server via OneDrive as described here: [[Deploy_Turnkey_on_your_own_Azure_with_OneDrive]]
1. Make sure your MDrivenServer works


2. Set up the YourSite/App_Data/TurnkeySettings.xml by looking in the one already there called “TurnkeySettings – NotInEffect.xml”
== Setting Up on MDriven Portal ==
Open https://portal.mdriven.net and log in under your account.


3. You can now use your “a” account and pwd from MDrivenDesigner cloud dialog to upload a model to the MDrivenServer
Go to "'''Views"''' -> "'''Show my Turnkey Sites"''' and "'''Register a New Site"'''.


4. After this you can run the prototyper against MDrivenServer
Name your application and upload the publish profile to MDriven Portal and press "Create Turnkey Site" and "Save".


=== Third ===
Now, go back to "Show my Turnkey Sites" where you can see that your new site is registered, but not deployed. Click on it and choose "Manage Turnkey Site".
1. You need a ViewModel named Index and one named About, If you have those you should see them showing up as index page and as https://<yoursite>/MDriven/About
[[File:Manage your Site page.png|none|thumb|694x694px|Manage your site from MDriven Portal]]
On the "Manage" page, you can request a deploy of your website. To request deploy, you need to press the "Request Deploy" button and save it. Deploy takes no more than 5 minutes. When the status of your site changes to "Deployed", press "Send Settings and Restart" and save.


2. You may however want to override these with your own styled static pages. Create Index.cshtml and About.cshtml in <YourSite>\Views\EXT_OverridePages\ The file content can make use of the data in your ViewModels if needed – if so these pages are strictly MVC5 and not AngularJS
After these steps, you can revisit your site and see your Turnkey application.
[[File:First look of Turnkey app.png|none|thumb|696x696px|First look at the Turnkey app]]
'''Note!''' Each Turnkey app must have an Index ViewModel. 


3. Other ViewModels you add will be defaulted to AngularJS. If you instead want MVC5 for a specific page you set a tagged value on the ViewModel : “MVC=True”
You can go back to https://portal.mdriven.net/ and open MDriven Designer to start modeling.


=== Fourth ===
== Video Tutorial ==
1. You can now run the ”YourApp” as AngularJS app


2. You can run the WPF-Fat-client against the “YourSite” url
<html>
 
3. You can now make model updates and evolve your system from MDrivenDesigner


===Video tutorial===
<p class="video-warn">
<html>
  To make your experience smooth, we set the main tags mentioned in the video to the right bar menu of this mini-player. Choose an interesting subtitle on the list and immediately get to the exact theme navigation item place in the video. Now you can pick any topic to be instructed on without watching the whole video.
<p class='warn'>
</p>
<em>To make your experience more comfortable, we set the main tags mentioned in the video to the right bar menu of this mini player. Choose the interesting subtitle on the list and immediately get to the exact theme timeplace in the video. Now you can pick any topic to be instructed without watching the whole video.</em>
<style type="text/css">
p.warn {
opacity: 0.7;
}
</style>
</p class='warn'>


<style>
<div class="video">
#video12 {
   <div class="video__wrapper">
  position: relative;
    <iframe src="https://www.youtube.com/embed/mVVCsM09vXE?rel=0&autoplay=0" frameborder="0" allowfullscreen></iframe>
  height: 500px;
   </div>
  width:560px;
  <div class="video__navigation">
  padding-bottom: 10px;
     <span class="navigation-item" data-video="mVVCsM09vXE" data-start="0" tabindex="0"> Setting up MDriven Turnkey on Microsoft Azure </span>
}
     <span class="navigation-item" data-video="mVVCsM09vXE" data-start="33" tabindex="0"> Setting up on Microsoft Azure </span>
#video12 iframe {
     <span class="navigation-item" data-video="mVVCsM09vXE" data-start="287" tabindex="0"> Setting up on MDriven Portal </span>
  position: absolute;
  </div>
  min-height: auto;
  min-width: auto;
}
#video12 div {
  position: absolute;
  top: 0;
  left:760px;
  width: 260px;
  height: 100%;
  padding-left: 10px;
  overflow-y: auto;
}
span {
    font-size: 18;
    display:block;
    padding-bottom: 0.5;
    padding-top: 0.5;
}
span:hover {
   color: #0000FF;
  cursor: pointer;
}
span:focus {
  color: blue;
</style>
</br>
<div id="video12">
<iframe width="740" height="500" src="https://www.youtube.com/embed/EOozaKVGuqQ?rel=0&autoplay=0" frameborder="0" allowfullscreen></iframe>
   <div>
    <span data-video="EOozaKVGuqQ" data-start="17" tabindex="0"> creating site </span>
     <span data-video="EOozaKVGuqQ" data-start="115" tabindex="0"> Installing the MDriven server software </span>
    <span data-video="EOozaKVGuqQ" data-start="153" tabindex="0"> Pouring in information for IIS </span>
    <span data-video="EOozaKVGuqQ" data-start="242" tabindex="0"> Checking MDriven server  </span>  
     <span data-video="EOozaKVGuqQ" data-start="305" tabindex="0"> Adding a certificate</span>
    <span data-video="EOozaKVGuqQ" data-start="428" tabindex="0"> Register a user </span>
    <span data-video="EOozaKVGuqQ" data-start="575" tabindex="0"> Set up Turnkey Settings</span>  
     <span data-video="EOozaKVGuqQ" data-start="763" tabindex="0"> Uploading the Model</span>
  <ul> <span data-video="EOozaKVGuqQ" data-start="822" tabindex="0"> Creating Index ViewModel </span>  
    <span data-video="EOozaKVGuqQ" data-start="900" tabindex="0"> ASPNETIdentity Snippets </span></ul>
</div> 
</div>
</div>
</div>


<script>
</html>The MDriven Book - See: [[Set up MDriven Turnkey on premise]]
var IMG = document.querySelectorAll('#video12 span'),
[[Category:MDriven Turnkey]]
    IFRAME = document.querySelector('#video12 iframe');
[[Category:Installation]]
for (var i = 0; i < IMG.length; i++) {
[[Category:Tutorial]]
  IMG[i].onclick = function() {
    IFRAME.src = 'http://www.youtube.com/embed/' + this.dataset.video + '?rel=0&autoplay=1';
    if(this.dataset.end) IFRAME.src = IFRAME.src.replace(/([\s\S]*)/g, '$1&end=' + this.dataset.end);
    if(this.dataset.start) IFRAME.src = IFRAME.src.replace(/([\s\S]*)/g, '$1&start=' + this.dataset.start);
    this.style.backgroundColor='rgba(0,0,0,.2)';
  }
}
</script>
</html>

Latest revision as of 07:02, 9 January 2024


This tutorial will help you set up MDriven Turnkey on Microsoft Azure.

All the components needed to run MDriven Turnkey (the latest versions of MDriven Server & MDriven Turnkey) are available here for MDrivenServer and here for MDrivenTurnkey - you will need both.

You can run MDriven Turnkey on your Azure account or set it up on your local IIS. To set up on a local IIS, see Installing MDriven Server on Windows.

Setting Up on Azure

To start setting up your Turnkey application, go to https://portal.azure.com and log in under your existing account or create the new one.

First, you need to create a new Web app to run your Turnkey application.

Create a new Web app on Azure

Enter the name of your application and create or choose an existing App Services Plan.

Name your app and choose App Services Plan

Now, we need to add a virtual directory, because two applications (MDriven Server & MDriven Turnkey) are running on one site.

Go to "Application Settings" and scroll down to "Virtual applications and directories" and create another application called “__MDrivenServer” (double underscore).

Don't forget to make sure the __MDrivenServer is an application of its own (the application check box next to the folder name must be checked).

Create another web app called "__MDrivenServer"

Now, we need to download the publish profile - go to "Overview" and press "Get publish profile".

Get the publish profile from Azure

When all these steps are done, we are ready to go to https://portal.mdriven.net

Note: It is best to do at least the first deploy with Portal (as described below) since you then get the strong password set and init files updated for your installation - but after initial setup, you can easily deploy new code for Turnkey + server via OneDrive as described here: Deploy_Turnkey_on_your_own_Azure_with_OneDrive

Setting Up on MDriven Portal

Open https://portal.mdriven.net and log in under your account.

Go to "Views" -> "Show my Turnkey Sites" and "Register a New Site".

Name your application and upload the publish profile to MDriven Portal and press "Create Turnkey Site" and "Save".

Now, go back to "Show my Turnkey Sites" where you can see that your new site is registered, but not deployed. Click on it and choose "Manage Turnkey Site".

Manage your site from MDriven Portal

On the "Manage" page, you can request a deploy of your website. To request deploy, you need to press the "Request Deploy" button and save it. Deploy takes no more than 5 minutes. When the status of your site changes to "Deployed", press "Send Settings and Restart" and save.

After these steps, you can revisit your site and see your Turnkey application.

First look at the Turnkey app

Note! Each Turnkey app must have an Index ViewModel.

You can go back to https://portal.mdriven.net/ and open MDriven Designer to start modeling.

Video Tutorial

To make your experience smooth, we set the main tags mentioned in the video to the right bar menu of this mini-player. Choose an interesting subtitle on the list and immediately get to the exact theme navigation item place in the video. Now you can pick any topic to be instructed on without watching the whole video.

Setting up MDriven Turnkey on Microsoft Azure Setting up on Microsoft Azure Setting up on MDriven Portal

The MDriven Book - See: Set up MDriven Turnkey on premise

This page was edited 126 days ago on 01/09/2024. What links here
Retrieved from "https://wiki.mdriven.net/index.php?title=Training:Installing_TurnKey_as_an_Azure_WebApp&oldid=15225"

© MDRIVEN . All Rights Reserved

Glossary API Docs
MDriven World | Portal | Blog | YouTube | StackOverflow | Facebook

© MDRIVEN . All Rights Reserved