You can manually deploy or refresh MDriven Turnkey and MDrivenServer files in an Azure WebApp through OneDrive; this guide is for administrators who already have an Azure WebApp available.
What this installation does
This procedure copies the application files for MDriven Turnkey and MDrivenServer from a local OneDrive folder to the Azure WebApp deployment slot. Use it when:
- you want to deploy the application files yourself rather than use the Azure portal deployment option;
- you need to refresh an existing installation; or
- you need to update the versions of MDriven Turnkey and MDrivenServer.
This page covers file deployment only. For creating the Azure WebApp, use Documentation:Installing TurnKey as an Azure WebApp.
Before you begin
Prepare the following:
- An Azure WebApp and access to its Azure portal settings.
- OneDrive available on the computer from which you will deploy.
- The desired MDriven Turnkey and MDrivenServer installation packages downloaded from mdriven.net/downloads.
- Permission to stop and start the Azure WebApp.
The procedure uses two zip files: one MDriven Turnkey package and one MDrivenServer package. Do not copy the zip files themselves to the deployment folder; copy the contents of each package's Application folder as described below.
Deploy files through OneDrive
1. Connect the WebApp deployment center to OneDrive
- In Azure, open the WebApp that will host the application.
- Open Deployment Center.
- Choose OneDrive.
- Complete the wizard and provide a folder name. By default, the folder name is the WebApp name.
After the wizard completes, Azure creates a local OneDrive folder in this form:
C:\Users\<YourName>\OneDrive\Apps\Azure Web Apps\<YourApp>
This folder is the deployment source for the Azure app slot. Azure deploys its contents when you select Sync in Deployment Center.
2. Add the MDriven Turnkey application files
- Open the downloaded MDriven Turnkey zip file.
- Open its
Applicationfolder. - Copy all contents of that folder.
- Paste the copied contents into the OneDrive deployment folder for the WebApp.
For example, if the WebApp folder is C:\Users\Alex\OneDrive\Apps\Azure Web Apps\MyApp, copy the contents of the Turnkey package's Application folder directly into MyApp.
3. Add the MDrivenServer application files
- In the same OneDrive deployment folder, create a directory named
__MDrivenServer. - Ensure that the name begins with two underscore characters:
__MDrivenServer. - Open the downloaded MDrivenServer zip file.
- Open its
Applicationfolder. - Copy all contents of that folder into
__MDrivenServer.
The resulting deployment layout is:
<YourApp>\
[contents of the MDriven Turnkey Application folder]
__MDrivenServer\
[contents of the MDrivenServer Application folder]
4. Sync the files to Azure
- Return to the WebApp in the Azure portal.
- Stop the WebApp before synchronizing. This helps avoid a sync being blocked by locked files.
- In Deployment Center, select Sync.
- Monitor the deployment progress and log in Deployment Center until the update finishes.
- Start the WebApp after the deployment has completed.
Update an existing installation
Use the same procedure to update MDriven Turnkey or MDrivenServer:
- Download the desired replacement package or packages.
- Replace the relevant contents in the local OneDrive deployment folder:
- Replace the root application contents for MDriven Turnkey.
- Replace the contents of
__MDrivenServerfor MDrivenServer.
- Stop the Azure WebApp.
- Select Sync in Deployment Center and review the deployment log.
- Start the WebApp when synchronization is complete.
Deployment choices
| Situation | Recommended guide |
|---|---|
| You need to create or configure an Azure WebApp for Turnkey. | Documentation:Installing TurnKey as an Azure WebApp |
| You want to deploy or update the application files from OneDrive. | Follow this page and Documentation:Deploy Turnkey on your own Azure with OneDrive. |
| You are deploying to Windows IIS and want repeatable command-line updates. | HowTos:Automate Deployment of Turnkey and MDrivenServer on IIS |
| You are deploying locally or on Linux. | HowTos:Local Installation |
| You need to consider Azure scale-out behavior. | Documentation:Scaling out Turnkey on Azure |
