4221 improvements to dedicated docs

.platform/routes.yaml

@@ -139,8 +139,8 @@ https://{default}/:
 
       # Deprecate Hugo aliases
       "/guides/general/mysql-replication.html":  { "to": "/add-services/mysql/mysql-replication.html", "code": 301 }
-      "/dedicated.html":  { "to": "/dedicated-gen-2.html", "code": 301 }
-      "/dedicated/(.*).html":  { "to": "/dedicated-gen-2/$1.html", "code": 301, "regexp": true }
+      "/dedicated.html":  { "to": "/dedicated-environments/dedicated-gen-2.html", "code": 301 }
+      "/dedicated/(.*).html":  { "to": "/dedicated-environments/dedicated-gen-2/$1.html", "code": 301, "regexp": true }
       "/guides/general/deploy-button.html":  { "to": "/development/deploy-button.html", "code": 301 }
       "/frameworks/deploy-button.html":  { "to": "/development/deploy-button.html", "code": 301 }
       "/development/public-ips.html":  { "to": "/development/regions.html", "code": 301 }
@@ -169,8 +169,8 @@ https://{default}/:
       "/dedicated-gen-2/architecture/scalability.html": { "to": "/environments/scalability.html", "code": 301 }
 
       # Redirects for new DG2 and DG3 sections
-      "/dedicated-gen-3/overview.html" : { "to": "/dedicated-gen-3.html", "code": 301 }
-      "/dedicated-gen-2/overview/onboarding.html" : { "to": "/dedicated-gen-2.html", "code": 301 }
+      "/dedicated-gen-3/overview.html" : { "to": "/dedicated-environments/dedicated-gen-3.html", "code": 301 }
+      "/dedicated-gen-2/overview/onboarding.html" : { "to": "/dedicated-environments/dedicated-gen-2.html", "code": 301 }
 
       # Redirects for broken backlinks
       "/administration/web/email.html" : { "to": "/development/email.html", "code": 301 }
@@ -303,7 +303,7 @@ https://docs.upsun.com/:
       "/anchors/cli/tokens.html": { "to": "/administration/cli/api-tokens.html", "code": 301, "prefix": false }
       # Dedicated not relevant on Upsun at MVP
       "/anchors/cli.html": { "to": "/administration/cli.html", "code": 301, "prefix": false }
-      "/anchors/dedicated/incident-handling.html": { "to": "https://docs.platform.sh/dedicated/overview/monitoring.html#availability-incident-handling-procedure", "code": 301, "prefix": false }
+      "/anchors/dedicated/incident-handling.html": { "to": "https://{default}/dedicated-environments/security-monitoring.html#performance-monitoring", "code": 301, "prefix": false }
 #      "/anchors/cli.html": { "to": "/administration/cli.html", "code": 301, "prefix": false }
       # Repeated again for the below.
       # "links.documentation.CLI": "https://docs.platform.sh/development/cli.html#cli-command-line-interface",
@@ -312,7 +312,7 @@ https://docs.upsun.com/:
       "/anchors/create-project.html": { "to": "/get-started/here.html", "code": 301, "prefix": false }
       "/anchors/deploy-key.html": { "to": "/administration/web/configure-project.html#deploy-key", "code": 301, "prefix": false }
       # Dedicated not relevant on Upsun at MVP
-      "/anchors/dedicated.html": { "to": "https://docs.platform.sh/dedicated/overview.html", "code": 301, "prefix": false }
+      "/anchors/dedicated.html": { "to": "https://{default}/dedicated-environments/overview.html", "code": 301, "prefix": false }
       "/anchors/dns.html": { "to": "/domains/steps.html#1-get-the-target-for-your-project", "code": 301, "prefix": false }
       "/anchors/download-code.html": { "to": "/get-started/here.html", "code": 301, "prefix": false }
       "/anchors/domain.html": { "to": "/domains/steps.html", "code": 301, "prefix": false }
@@ -347,8 +347,8 @@ https://docs.upsun.com/:
       # "links.documentation.metrics": "https://docs.platform.sh/increase-observability/metrics.html",
       "/anchors/observability/metrics/grid.html": { "to": "/increase-observability/metrics.html", "code": 301, "prefix": false }
       # Not relevant for Upsun.
-      "/anchors/observability/metrics/dedicated.html": { "to": "https://docs.platform.sh/increase-observability/metrics/dedicated.html", "code": 301, "prefix": false }
-      "/anchors/observability/metrics/dedicated-gen-3.html": { "to": "https://docs.platform.sh/increase-observability/metrics/dedicated-generation-3.html", "code": 301, "prefix": false }
+      "/anchors/observability/metrics/dedicated.html": { "to": "https://{default}/increase-observability/metrics/dedicated.html", "code": 301, "prefix": false }
+      "/anchors/observability/metrics/dedicated-gen-3.html": { "to": "https://{default}/increase-observability/metrics/dedicated-generation-3.html", "code": 301, "prefix": false }
       "/anchors/integrations/activities.html": { "to": "/integrations/activity.html", "code": 301, "prefix": false }
       "/anchors/integrations/activity-scripts.html": { "to": "/integrations/activity.html#configuring-scripts", "code": 301, "prefix": false }
       "/anchors/integrations/source.html": { "to": "/integrations/source.html", "code": 301, "prefix": false }

sites/platform/.yaml

@@ -562,6 +562,7 @@ nodejs:
       - '4.7'
       - '0.12'
     supported:
+      - '22'
       - '20'
       - '18'
       - '16'
@@ -963,6 +964,7 @@ solr:
       - '4.10'
       - '3.6'
     supported:
+      - '9.6'
       - '9.4'
       - '9.2'
       - '9.1'
@@ -979,6 +981,8 @@ solr:
       - '4.10'
   versions-dedicated-gen-3:
     supported:
+      - '9.6'
+      - '9.4'
       - '9.2'
       - '9.1'
       - '8.11'

sites/platform/src/administration/pricing/_index.md

@@ -115,7 +115,7 @@ don't hesitate to [contact support](https://console.platform.sh/-/users/~/ticket
 
 For more resources along with triple redundancy on every element of the stack, use a {{% names/dedicated-gen-3 %}} plan.
 
-Learn more about [{{% names/dedicated-gen-3 %}}](../../dedicated-gen-3/_index.md).
+Learn more about [{{% names/dedicated-gen-3 %}}](/dedicated-environments/dedicated-gen-3/_index.md).
 
 To discuss how {{% names/dedicated-gen-3 %}} could work for you, [contact Sales](https://platform.sh/contact/).
 

sites/platform/src/dedicated-environments/_index.md

@@ -0,0 +1,6 @@
+---
+title: "Dedicated environments"
+weight: -18
+# layout: single
+description: "Our Dedicated environments provide increased resources and high availability for organizations that require higher security, better compliance, robust storage and isolated hosting."
+---

sites/platform/src/dedicated-environments/backups-restores.md

@@ -0,0 +1,65 @@
+---
+title: "Dedicated backup and restores"
+weight: 1
+sidebarTitle: "Dedicated backups"
+layout: single
+description:  "Backups are retained for different periods depending on various factors and whether you’re using a Dedicated Gen 2 or Dedicated Gen 3 Environment. These processes can be either manual or automated."
+---
+
+{{% description %}}
+
+
+## Dedicated Generation 2 Backups
+
+Platform.sh takes a byte-for-byte snapshot of Dedicated Gen 2 production environments every 6 hours. Backups are retained for different durations depending on when they were taken. 
+
+| Backup retention period     | Retention            |  # of backups from time period available |
+|----------------|---------------------|--------------------|
+| 1–3 days ago          | Every backup taken in that period | 6 (1 day) to 18 (3 days) |  
+| 4-6 days ago         | One backup per day in that period  |   1 (4 days) to 3 (6 days) |
+| 2–6 weeks ago      | One backup per week | 1 (2 weeks) to 5 (6 weeks) |
+| 8–12 weeks ago   | One bi-weekly backup | 1 (8 weeks) to 3 (12 weeks) |    
+| 12–22 weeks ago    | One backup per month | 1 (12 weeks) to 3 (22 weeks)  |
+
+Put another way, the number of backups available for restoration - in each of the backup age groupings described above - might look as follows for a few Dedicated environment ages:
+
+|  Environment age    | 72 hours old or younger  | 4-6 days old | 2-6 weeks old | 8-12 weeks old | 12-22 old  | Total |
+|----------------|---------------|--------------|----------------|-----------------|-------------------|-----|
+| 1 week               |         18            |        3             |          0                |            0              |              0                |   21  |
+| 12 weeks           |         18            |        3              |            5            |         3                   |               0               |  29  |
+| 52+ weeks        |         18            |        3              |            5            |         3                  |           3                    |   32 |
+
+Backups are created using snapshots saved to encrypted elastic block storage (EBS) volumes. An EBS snapshot is immediate, but the time it takes to write to the storage service depends on the volume of changes.
+
+-   Recovery Point Objective (RPO) is 6 hours (maximum time to last backup).
+-   Recovery Time Objective (RTO) depends on the size of the storage. Large EBS volumes take more time to restore.
+
+These backups are only used in cases of catastrophic failure and can only be restored by Platform.sh. To request a restoration, open a [support ticket](/learn/overview/get-support.md).
+
+## Dedicated Generation 2 restoration
+
+The restoration process for Dedicated Generation 2 Environments may take a few hours, depending on the infrastructure provider in use. In the ticket, specify if you want backups of files, MySQL, or both. Uploaded files are placed in an SSH-accessible directory on the Dedicated Gen 2 cluster. 
+
+MySQL is provided as a MySQL dump file on the server. You may restore these to your site at your leisure. You are also free to make your own backups using standard tools (mysqldump, rsync, etc.).
+
+{{< note title="Note" theme="info" >}}
+
+Platform.sh does not proactively overwrite your production site with a backup. You are responsible for determining a “safe” time to restore the backup, or for selectively restoring individual files if desired.
+
+{{< /note >}} 
+
+## Dedicated Generation 3 
+
+For Dedicated Generation 3 Environments, [automated backups](environments/backup.md#use-automated-backups) are retained for a specific amount of time depending on their type and your [backup schedule](/environments/backup.md#backup-schedule). [Manual backups](/environments/backup.md#create-a-manual-backup) are retained until you delete them or replace them with another backup.
+
+|Type            |Basic                |Advanced         |Premium    |
+|----------------|---------------------|-----------------|-----------|
+| 6-hourly       | -                   | -               |1 day      |                
+| Daily          | 2 days              | 1 week          |1 month    |
+| Weekly         | -                   | 4 weeks         |-          |
+| Monthly        | -                   | 1 year          |1 year     | 
+
+
+## Dedication Generation 3 restores
+
+Dedicated Generation 3 Environments allow for backups and restores the same way as Grid, so you can use them with the management console and the [Platform.sh CLI](/administration/cli/_index.md).

sites/platform/src/dedicated-gen-2/_index.md → sites/platform/src/dedicated-environments/dedicated-gen-2/_index.md

@@ -1,5 +1,5 @@
 ---
 title: "{{% names/dedicated-gen-2 %}}"
-weight: -18
+weight: -19
 description: "{{% names/dedicated-gen-2 %}} is a robust, redundant layer. This section contains all resources concerning the {{% names/dedicated-gen-2 %}} product."
 ---

sites/platform/src/dedicated-environments/dedicated-gen-2/development.md

@@ -0,0 +1,78 @@
+---
+title: "Dedicated Gen 2 Development"
+weight: 1
+sidebarTitle: "DG2 development"
+description: "Learn about the cluster infrastructure of Dedicated Generation 2, and discover key details about split architecture, deployment, storage limits and memory."
+
+---
+
+Learn about the [cluster infrastructure](#cluster-infrastructure) of Dedicated Generation 2, and discover key details about [split architecture](#split-architecture), [deployment](#deployment), [storage limits](#storage) and [memory](#memory).
+
+### Cluster infrastructure
+
+Dedicated Gen 2 clusters (sometimes referred to below as DG2) are launched into a Triple Redundant configuration consisting of 3 hosts. This is an N+1 configuration that’s sized to withstand the total loss of any one of the 3 members of the cluster without incurring any downtime. Every service is replicated across all three hosts in a failover configuration (as opposed to sharding), allowing a site to remain up even if one of the hosts is lost entirely.
+
+Each instance hosts the entire application stack, allowing this architecture superior fault tolerance to traditional N-Tier installations. Moreover, the Cores assigned to production are solely for production. 
+
+##### Build process
+
+The build process for your application is identical for both the Grid Environment and the Dedicated Gen 2 cluster. However, because the hosts are provisioned by Platform.sh, not as a container, service configuration must be done by Platform.sh’s Customer Success team. The flexibility for DG2 and Grid can be made to be the same but only via opening a [support ticket](/learn/overview/get-support.md).
+
+For more information, learn about [default storage settings](#storage) and how your app can [connect to services](dedicated-environments/dedicated-gen-3/overview.md#available-services).
+
+### Split architecture
+
+Split architecture works under Dedicated Generation 2 and allows to give more resources globally to a project. Services (data services, caching service or search engines) are split from application runtimes. Services will be running on a cluster of core nodes, and the application will be running on a cluster of web nodes.
+
+This allows us to grant more room for the application or the services regarding resources. Both clusters can differ in size. Split architecture clusters can horizontally scale the application by adding additional nodes. 
+
+![Split architecture](/images/dedicated/split-architecture.svg "0.50")
+
+### Deployment
+
+The production branch of your Git repository is designated for production and a staging branch is designated for staging. Any code merged to those branches automatically triggers a rebuild of the production or staging environment in the Dedicated Gen 2 cluster. 
+
+Any defined users or environment variables are also propagated to the Dedicated Gen 2 cluster.
+
+{{< note title="Note" theme="info" >}}
+
+There is no automatic cloning of data from the Dedicated Gen 2 cluster to the development environment the way there is between branches in the development environment. 
+
+{{< /note >}} 
+
+Production data may still be replicated to the development environment [manually](https://docs.platform.sh/administration/cli/reference.html#environmentsynchronize). Deployments of other branches don’t trigger rebuilds of the Dedicated Gen 2 cluster Environments.
+
+#### Deployment process 
+
+When deploying to the Dedicated Gen 2 cluster the process is slightly different than when working with Platform.sh on the Grid.
+
+-   The new application image is built in the exact same fashion as for the Grid.
+-   Any active background tasks on the cluster, including cron tasks, are terminated.
+-   The cluster (production or staging) is closed, meaning it doesn’t accept new requests. Incoming requests receive an HTTP 500 error.
+-   The application image on all three servers is replaced with the new image.
+-   The deploy hook is run on one, and only one, of the three servers.
+-   The cluster is opened to allow new requests.
+
+The deploy usually takes approximately 30-90 seconds, although that is dependent on how your deploy hook has been configured.
+
+During the deploy process the cluster is unavailable. All Dedicated Gen 2 instances are fronted by the Fastly Content Delivery Network (CDN) unless you decide to bring your own CDN. You can also decide that you'd rather not use Fastly. Fastly can be configured to allow a “grace period”, meaning that requests to the origin that fail are served from the existing cache, even if that cache item is stale. We configure a default grace period that is longer than a typical deployment, and can extend that time upon request. That means anonymous users should see no interruption in service at all. Authenticated traffic that can’t be served by the CDN still sees a brief interruption.
+
+For more information about deployment, see the [overview of the build and deploy phases](/learn/overview/build-deploy.md).
+
+### Storage
+
+The development environment for a Dedicated Gen 2 project provides production and staging branches linked to the Dedicated Gen 2 cluster and 3 additional active environments for development. This number can be increased if needed for an [additional fee](https://platform.sh/pricing/). 
+
+The default storage for Dedicated Gen 2 contracts is 50GB per environment (production, staging, and each development environment). This comprises total storage for your project and is inclusive of any databases, uploaded files, writable application logging directories, search index cores, and so on. The storage amount for your development environment reflects the amount in your Enterprise contract and can be altered based on the terms you agree.
+
+A project may have up to six users associated with it at no additional charge. Additional users may be added for an additional fee. These users have access to both the development environment and the Dedicated Gen 2 cluster.
+
+{{< note title="Note" theme="info" >}}
+
+While your DG2 production and staging Environments are on dedicated virtual machines, your development environments run on the [Grid](/glossary.md#grid). This means that, by default, all containers in development environments are standard sized, as they have limited traffic needs. For more resource-intensive applications this size can be increased for an additional fee.
+
+{{< /note >}}
+
+### Memory
+
+Dedicated Generation 2 includes a single node dedicated staging with 2 CPUs. This runs the same software configuration as the production cluster but only on a single node. This is usually enough for functional testing before moving to production. You can choose to upgrade your staging to a more powerful machine or add more than one dedicated staging system. Those will still be a single machine.