Migration to latest from versions less than or equal to v2.1.0.2

Previous release Zip package is provided for the User Management Server Azure App Serivce deployment from this release it is automated using Azure ARM template.

Follow the below steps to upgrade the User Management Server App Service to latest source from older versions.

  • Get existing Azure Blob Storage details.
  • Create new Syncfusion User Management App Service.
  • Update existing Azure Blob Storage details in latest App Service.
  • Restart App Service and WebJobs.
  • Site URL Configuration.

Get existing Azure Blob Storage details

In existing User Management Server all the resources are stored in Azure blob Storage. All items are needed while upgrading to latest version User Management App Service.

Previously the Azure Blob Storage details are configured in the web.config file.

Follow the belows steps and get the existing Azure Blob Storage details from the web.config file.

  1. Login to Azure portal: https://portal.azure.com.

  2. Select App Services.

  3. Select the existing Syncfusion User Management Server Site and then click on Get publish profile.

    Get Publish profile

  4. Save the <App service name>.PublishSettings file and open it.

  5. The file contains 2 <publishProfile> sections for Web Deploy and FTP.

  6. From the FTP <publishProfile> section copy the following values:
    • publishUrl
    • userName
    • userPWD

    FTP Publish profile details

  7. Use these credentials in an FTP client FileZilla, simply plug these values into the Host, Username, and Password fields as shown here and click on Quickconnect.

    Filezila client

  8. Download the web.config file from “/site/wwwroot” folder in Existing Azure App Service through FileZilla .

    Download Old Web App web.config file

  9. Get the below Azure Blob Storage details in the existing App service web.config file

    • AzureStorageAccountName
    • AzureStorageBlobServiceEndpoint
    • AzureStorageAccessKey
    • AzureStorageContainerName
    • AzureStorageConnectionType
    • AzureStorageBlobURL

Create new Syncfusion User Management App Service

Click here and follow the steps to create latest Syncfusion User Management Server Azure App Service.

IMPORTANT

Select storage type as File Storage for Creating new User Management Server App Service for update or upgrade.

Update existing Azure Blob Storage details in latest App Service

Follow the below steps to configure the existing Azure Blob Storage details to the latest User Management Server

  1. Login to Azure portal: https://portal.azure.com

  2. Click on App Services.

  3. Select the lastest Syncfusion User Management Server App Serivce.

  4. Select Application Settings in the left panel of the Latest User Management Server App Service.

    Application Settings

  5. Existing App Service Azure Blob Storage details need to configured in the new App Service, App Setting section in Application settings tab.

    Update App setting in Azure web app

  6. Add the below details in the App setting section.
    • AzureStorageAccountName
    • AzureStorageBlobServiceEndpoint
    • AzureStorageAccessKey
    • AzureStorageContainerName
    • AzureStorageConnectionType
    • AzureStorageBlobURL

  7. Update the StorageType value as AzureBlob in the app setting section.

  8. Click on Save button.

    Save button

Restart App Service and WebJobs

Once the Azure Blob Storage details are configured in the latest User Management Server application, must to restart the Latest User Management Server App Service and WebJobs.

Follow the below steps to restrat the App Service and WebJobs.

  1. Select WebJobs in the left panel of the Latest User Management Server App Service.

    Overview

  2. Click on the Restart button.

    Restart Azure App Service

  3. Select WebJobs in the left panel of the Latest User Management Server App Service.

  4. Select UserManagementServerScheduler WebJobs and click on Stop button.

    Stop Web job

  5. Once the stauts for UserManagementServerScheduler WebJobs changed to Stopped then click on Start button.

    Start Web job

Site URL Configuration

Navigate to administration page in the DUser Management Server App Service <User Management server App Serivce Name>.azurewebsites.net/en-us/administration and update the Site URL field with latest User Management Server App Service URL.

Site URL Update

Once updated click on Save button at the bottom.