From 09ab9bf9425466dd2e1599dd24d911197ddf3ee9 Mon Sep 17 00:00:00 2001 From: Sofie Date: Tue, 15 Nov 2022 10:25:08 +0100 Subject: [PATCH 1/3] Add new system requirements #4525 --- .../fundamentals/setup/requirements.md | 73 ++++--------------- 1 file changed, 16 insertions(+), 57 deletions(-) diff --git a/umbraco-cms/fundamentals/setup/requirements.md b/umbraco-cms/fundamentals/setup/requirements.md index cd71b85d924..b5f46f146f1 100644 --- a/umbraco-cms/fundamentals/setup/requirements.md +++ b/umbraco-cms/fundamentals/setup/requirements.md @@ -1,8 +1,8 @@ -# Requirements +# System Requirements ## Browsers -The Umbraco UI should work in all modern browsers: +The Umbraco UI works in all modern browsers: * Chrome (Latest) * Edge (Chromium) @@ -11,35 +11,17 @@ The Umbraco UI should work in all modern browsers: ## Local Development -{% tabs %} -{% tab title="Umbraco 10" %} * Either OS: - * Microsoft Windows 7 SP1, 8.1, 10 and 11 + * Microsoft Windows 10 or 11 * MacOS High Sierra 10.13 * Linux (Ubuntu, Alpine, CentOS, Debian, Fedora, openSUSE and other major distributions) * One of the following .NET Tools or Editors: * [Visual Studio Code](https://code.visualstudio.com/) with the [IISExpress extension](https://marketplace.visualstudio.com/items?itemName=warren-buckley.iis-express) - * [Microsoft Visual Studio](https://www.visualstudio.com/) 2022 - * [JetBrains Rider](https://www.jetbrains.com/rider) **version 2020.3 and higher** + * [Microsoft Visual Studio](https://www.visualstudio.com/) 2022 v17.4 + * [JetBrains Rider](https://www.jetbrains.com/rider) **version 2022.3 and higher** * .NET Core CLI -* .NET 6.0.5+ +* .NET 7.0 * SQL connection string (SQL Server) -{% endtab %} - -{% tab title="Umbraco 9" %} -* Either OS: - * Microsoft Windows 7 SP1, 8.1, 10 and 11 - * MacOS High Sierra 10.13 - * Linux (Ubuntu, Alpine, CentOS, Debian, Fedora, openSUSE and other major distributions) -* One of the following .NET Tools or Editors: - * [Visual Studio Code](https://code.visualstudio.com/) with the [IISExpress extension](https://marketplace.visualstudio.com/items?itemName=warren-buckley.iis-express) - * [Microsoft Visual Studio](https://www.visualstudio.com/) 2019 **version 16.8 and higher** - * [JetBrains Rider](https://www.jetbrains.com/rider) **version 2020.3 and higher** - * .NET Core CLI -* .NET 5.0 -* SQL connection string (SQL Server) -{% endtab %} -{% endtabs %} ## Hosting @@ -47,57 +29,34 @@ The Umbraco UI should work in all modern browsers: For the best experience, we would recommend that you ensure your hosting environment has the following to run Umbraco CMS: -{% tabs %} -{% tab title="Umbraco 10" %} -* Windows Server 2019 and higher -* IIS 10 and higher -* SQL Server 2019 and higher -* .NET 6.0.5+ -* Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically) -{% endtab %} - -{% tab title="Umbraco 9" %} * Windows Server 2019 and higher * IIS 10 and higher * SQL Server 2019 and higher -* .NET 5.0 +* .NET 7.0 * Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically) -{% endtab %} -{% endtabs %} -{% hint style="info" %} -You can use Umbraco Cloud to manage the hosting infrastructure. All Umbraco Cloud plans are hosted on Microsoft Azure, which gives your site a proven and solid foundation. -{% endhint %} +:::tip +You can use [Umbraco Cloud](https://umbraco.com/products/umbraco-cloud/) to manage the hosting infrastructure. All Umbraco Cloud plans are hosted on Microsoft Azure, which gives your site a proven and solid foundation. +::: ### Miminium requirements to run Umbraco Umbraco can run on an environment with the minimum requirements stated below: -{% tabs %} -{% tab title="Umbraco 10" %} * Windows Server 2012 R2 and higher * IIS 8.5 and higher -* SQL Server 2012 and higher -* .NET 6.0.5+ +* SQL Server 2012 and higher / SQLite 3.38.0 or higher +* .NET 7.0 * Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically) -{% endtab %} -{% tab title="Umbraco 9" %} -* Windows Server 2012 R2 and higher -* IIS 8.5 and higher -* SQL Server 2012 and higher -* .NET 5.0 -* Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically) -{% endtab %} -{% endtabs %} - -_For more information, see the_ [_Host and deploy ASP.NET Core applications_](https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/?view=aspnetcore-6.0) _article in the Microsoft documentation._ +*For more information, see the [Host and deploy ASP.NET Core applications](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/?view=aspnetcore-7.0) article in the Microsoft documentation.* ## Database Account Roles -The database account used in the connection string will need permissions to read and write from tables as well as create schema during installs and upgrades: +The database account used in the connection string will need permissions to read and write from tables. It will also require permission to create schema during installs and upgrades: * The `db_owner` role has full permissions on the database. + * To use an account with more restricted permissions, the `db_datareader` and `db_datawriter` roles will be needed for normal use to read from and write to the database. The `db_ddladmin` role, which can modify the database schema, is required for installs and upgrades of the CMS and/or any packages that create database tables. -For more information on the Database-level roles, see the [Microsoft documentation](https://docs.microsoft.com/en-us/sql/relational-databases/security/authentication-access/database-level-roles?view=sql-server-ver16#fixed-database-roles). +For more information on the Database-level roles, see the [Microsoft documentation](https://docs.microsoft.com/en-us/sql/relational-databases/security/authentication-access/database-level-roles?view=sql-server-ver16#fixed-database-roles). \ No newline at end of file From 23be1790b47338d91fb483383856badc6ff0066e Mon Sep 17 00:00:00 2001 From: Sofie Date: Tue, 15 Nov 2022 10:27:48 +0100 Subject: [PATCH 2/3] Add #4560 --- .github/styles/UmbracoDocs/Acronyms.yml | 3 +- .../installdefaultdatasettings.md | 61 +++++++++++++------ 2 files changed, 46 insertions(+), 18 deletions(-) diff --git a/.github/styles/UmbracoDocs/Acronyms.yml b/.github/styles/UmbracoDocs/Acronyms.yml index 73baf282d6d..3a3ac16f654 100644 --- a/.github/styles/UmbracoDocs/Acronyms.yml +++ b/.github/styles/UmbracoDocs/Acronyms.yml @@ -48,4 +48,5 @@ exceptions: - XSLT - AJAX - YAML - - PNG \ No newline at end of file + - PNG + - ISO \ No newline at end of file diff --git a/umbraco-cms/reference/configuration/installdefaultdatasettings.md b/umbraco-cms/reference/configuration/installdefaultdatasettings.md index 22328f7f130..e2e0f5b8b9f 100644 --- a/umbraco-cms/reference/configuration/installdefaultdatasettings.md +++ b/umbraco-cms/reference/configuration/installdefaultdatasettings.md @@ -21,23 +21,24 @@ The following example configuration shows how this default data installation can "Umbraco": { "CMS": { "InstallDefaultData": { - "Languages": { - "InstallData": "Values", - "Values": [ - "en-US" - ] - }, - "DataTypes": { - "InstallData": "ExceptValues", - "Values": [ - "0225af17-b302-49cb-9176-b9f35cab9c17" - ] - }, - "MediaTypes": { - "InstallData": "All", - }, - "MemberTypes": { - "InstallData": "None" + "Languages": { + "InstallData": "Values", + "Values": [ + "en-US" + ] + }, + "DataTypes": { + "InstallData": "ExceptValues", + "Values": [ + "0225af17-b302-49cb-9176-b9f35cab9c17" + ] + }, + "MediaTypes": { + "InstallData": "All", + }, + "MemberTypes": { + "InstallData": "None" + } } } } @@ -50,6 +51,32 @@ Each `InstallData` setting can be one of the following values: - `ExceptValues` - all default data except those specified will be installed. - `None` - no default data of the type will be installed. +## Data Identifiers + +For `DataTypes`, `MediaTypes` and `MemberTypes` the Guid identifiers for the default data items need to be provided in the `Values` collection. + +For `Languages`, the `Values` collection expects the standard language ISO codes to be provided. Given this code is enough to fully specify a language, it's possible to use this collection to install additional default data. + +As an example, the following configuration would omit the default "English (United States)" language and instead install the "English (United Kingdom)" and "Italian" languages. As "English (United Kingdom)" is provided first, it would be created as Umbraco's default language for content creation. + +```json +"Umbraco": { + "CMS": { + "InstallDefaultData": { + "Languages": { + "InstallData": "Values", + "Values": [ + "en", + "it" + ] + } + } + } +} +``` + +## Reference + The Guid values representing the default Data, Media, and Member Types installed are as follows. Data types: From d703df81bda86aad6e8de9c111d3ecac61a74f2f Mon Sep 17 00:00:00 2001 From: Sofie Date: Tue, 15 Nov 2022 10:39:59 +0100 Subject: [PATCH 3/3] Update note formatting --- umbraco-cms/fundamentals/setup/requirements.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/umbraco-cms/fundamentals/setup/requirements.md b/umbraco-cms/fundamentals/setup/requirements.md index b5f46f146f1..cec38a20a88 100644 --- a/umbraco-cms/fundamentals/setup/requirements.md +++ b/umbraco-cms/fundamentals/setup/requirements.md @@ -35,9 +35,9 @@ For the best experience, we would recommend that you ensure your hosting environ * .NET 7.0 * Ability to set file permissions to include create/read/write (or better) for the user that "owns" the Application Pool for your site (NETWORK SERVICE, typically) -:::tip +{% hint style="success" %} You can use [Umbraco Cloud](https://umbraco.com/products/umbraco-cloud/) to manage the hosting infrastructure. All Umbraco Cloud plans are hosted on Microsoft Azure, which gives your site a proven and solid foundation. -::: +{% endhint %} ### Miminium requirements to run Umbraco