Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update azure-web-apps.md umbraco load balancing settings json snippets #6610

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update azure-web-apps.md umbraco load balancing settings json snippets #6610

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ed72d6d
Update azure-web-apps.md umbraco load balancing settings
mattou07 Oct 31, 2024
e329bae
Update azure-web-apps.md
sofietoft Nov 7, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 34 additions & 1 deletion 14/umbraco-cms/fundamentals/setup/server-setup/load-balancing/azure-web-apps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,17 @@ The single instance Backoffice Administrative Web App should be set to use [Sync

The multi-instance Scalable Public Web App should be set to use [TempFileSystemDirectoryFactory](file-system-replication.md#examine-directory-factory-options).

```json
{
"Umbraco": {
"CMS": {
"Examine": {
"LuceneDirectoryFactory" : "TempFileSystemDirectoryFactory"
}
}
}
}
```
## Umbraco TEMP files

When an instance of Umbraco starts up it generates some 'temporary' files on disk. In a normal IIS environment, these would be created within the folders of the Web Application. In an Azure Web App, we want these to be created in the local storage of the actual server that Azure happens to be used for the Web App. So we set this configuration setting to 'true' and the temporary files will be located in the environment temporary folder. This is required for both the performance of the website as well as to prevent file locks from occurring due to the nature of Azure Web Apps shared files system.
Expand Down Expand Up @@ -63,7 +74,29 @@ By default **Umbraco v9.4 & 9.5** uses a system-wide semaphore locking mechanism

Apply this setting to both the **SCHEDULINGPUBLISHER** Administrative server and the **SUBSCRIBER** scalable public-facing servers.

## Steps to set-up an environment
You can also copy the following JSON directly into your Azure Web App configuration via the Advanced Edit feature.

![image](https://github.com/umbraco/UmbracoDocs/assets/11179749/ae53a26b-c45a-4b71-932a-0682f3d264a8)

```json
{
"name": "UMBRACO__CMS__Global__MainDomLock",
"value": "FileSystemMainDomLock",
"slotSetting": false
},
{
"name": "UMBRACO__CMS__Hosting__LocalTempStorageLocation",
"value": "EnvironmentTemp",
"slotSetting": false
},
{
"name": "UMBRACO__CMS__Examine__LuceneDirectoryFactory",
"value": "TempFileSystemDirectoryFactory",
"slotSetting": false
}
```

## Steps to set up an environment

1. Create an Azure SQL database
2. Install Umbraco on your backoffice administrative environment and ensure to use your Azure SQL Database
Expand Down
Loading