Skip to content
This repository was archived by the owner on Nov 19, 2024. It is now read-only.

Commit 63f7c5e

Browse files
authored
Merge branch 'master' into update_errors
2 parents 7835b0d + fa745a0 commit 63f7c5e

File tree

137 files changed

+128
-373
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

137 files changed

+128
-373
lines changed

src/_data/toc/live-search.yml

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,6 @@ pages:
44
url: /live-search/overview.html
55
versionless: true
66

7-
- label: Install Live Search
8-
url: /live-search/install.html
9-
versionless: true
10-
117
- label: Storefront Popover
128
url: /live-search/storefront-popover.html
139
versionless: true
@@ -45,7 +41,3 @@ pages:
4541
- label: Events
4642
url: /live-search/events.html
4743
versionless: true
48-
49-
- label: Release Notes
50-
url: /live-search/release-notes.html
51-
versionless: true

src/_data/whats-new.yml

Lines changed: 65 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,72 @@ description: This page contains recent changes that we think you'd like to know
44
We exclude from this list proofreading, spelling checks, and all minor updates.
55
link: "/whats-new.html"
66
thread: "/whatsnew-feed.xml"
7-
updated: Mon Nov 29 15:40:15 2021
7+
updated: Mon Dec 6 15:38:46 2021
88
entries:
9+
- description: Added instructions to manage [_Outgoing emails_ configuration](https://devdocs.magento.com/cloud/project/project-webint-basic.html) for Adobe
10+
Commerce on cloud Staging and Production environments using the Magento Cloud
11+
CLI command `magento-cloud environment:info`.
12+
versions: 2.x
13+
type: Technical
14+
date: December 1, 2021
15+
link: https://github.com/magento-commerce/devdocs/pull/2668
16+
merge_commit: abb2648eaf97973f7bc2f4bd449069a2d43f860b
17+
contributor: meker12
18+
membership: true
19+
labels:
20+
- 2.x
21+
- Technical
22+
- description: Added [Payment Services](https://devdocs.magento.com/payment-services/index.html)
23+
topics with the latest information of the new marketplace extension.
24+
versions: 2.4.x
25+
type: Major Update
26+
date: November 30, 2021
27+
link: https://github.com/magento-commerce/devdocs/pull/2555
28+
merge_commit: cacf3206b238119950bd247d7c99e4513c3ef64d
29+
contributor: shrielenee
30+
membership: true
31+
labels:
32+
- Major Update
33+
- 2.4.x
34+
- description: Added new topics about [buying](https://devdocs.magento.com/marketplace/sellers/subscriptions/buying-subscriptions.html)
35+
and [selling](https://devdocs.magento.com/marketplace/sellers/subscriptions/selling-subscriptions.html)
36+
subscription-based extensions.
37+
versions: 2.x
38+
type: New Topic
39+
date: November 30, 2021
40+
link: https://github.com/magento/devdocs/pull/9266
41+
merge_commit: 15e085d7855e3f6b31d38dc71a9a831743641531
42+
contributor: igorin
43+
membership: true
44+
labels:
45+
- 2.x
46+
- Internal Dev
47+
- New Topic
48+
- 'Progress: done'
49+
- description: Published [release notes](https://devdocs.magento.com/quality-patches/release-notes.html)
50+
for the 1.1.7 Quality Patches Tool (QPT) package release.
51+
versions: 2.x
52+
type: Major Update
53+
date: November 29, 2021
54+
link: https://github.com/magento-commerce/devdocs/pull/2670
55+
merge_commit: fab5665a3fc37f662a3ce6565e4c5eda0dc54da0
56+
contributor: agorbivskyi
57+
membership: true
58+
labels:
59+
- 2.x
60+
- Major Update
61+
- description: Restored the original Adobe Commerce [lifecycle policy](https://devdocs.magento.com/release/lifecycle-policy.html)
62+
page and added a new end of software support table.
63+
versions: 2.x
64+
type: New Topic
65+
date: November 29, 2021
66+
link: https://github.com/magento-commerce/devdocs/pull/2658
67+
merge_commit: b1d4477825c7358b8069d3cef6c68ae49106881b
68+
contributor: jeff-matthews
69+
membership: true
70+
labels:
71+
- 2.x
72+
- New Topic
973
- description: Added the 'Reindexing in parallel mode` section to the [Manage the
1074
indexers](https://devdocs.magento.com/guides/v2.4/config-guide/cli/config-cli-subcommands-index.html)
1175
topic.

src/_includes/config/redis-verify.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,10 @@ If you use Redis for page caching, you'll see output similar to the following:
5050
... more ...
5151
```
5252

53+
### Inspecting compressed data
54+
55+
To inspect compressed Session data and Page Cache, the [Redis Desktop Manager](https://flathub.org/apps/details/dev.rdm.RDM) supports the automatic decompression of Magento 2 Session and Page cache and displays PHP session data in a human-readable form.
56+
5357
### Redis ping command
5458

5559
Enter the following command:

src/cloud/cdn/configure-fastly.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -150,11 +150,11 @@ When domain validation completes, Adobe provisions the Let's Encrypt TLS/SSL cer
150150

151151
During the initial Fastly setup process, you can use the following URLs to configure and test Fastly caching in Staging and Production environments:
152152

153-
- Pro projects:
153+
- For Pro Staging and Production:
154154
- `mcprod.<your-domain>.com`
155155
- `mcstaging.<your-domain>.com`
156156

157-
- Starter projects:
157+
- For Starter Production only:
158158
- `mcprod.<your-domain>.com`
159159

160160
{:.bs-callout-info}

src/cloud/project/project-multi-sites.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ functional_areas:
1111
You can configure {{site.data.var.ee}} to have multiple websites or stores, such as an English store, a French store, and a German store. See [Understanding websites, stores, and store views]({{ site.baseurl }}/cloud/configure/configure-best-practices.html#sites).
1212

1313
{:.bs-callout-warning}
14-
Be aware that catalog data expands as you increase the number of websites and stores. Depending on your project architecture, the additional stores can lead to a longer indexing process and slower response times for non-cached catalog pages. Adobe recommends that you monitor site performance closely.
14+
Catalog data expands as you increase the number of websites and stores. Depending on your project architecture, the additional stores can lead to a longer indexing process and slower response times for non-cached catalog pages. Adobe recommends that you monitor site performance closely.
1515

1616
The process to set up multiple stores depends on whether you choose to use unique or shared domains.
1717

@@ -36,15 +36,17 @@ To add a store view to the site base URL, you do not have to create multiple dir
3636

3737
## Add New Domains
3838

39-
The process to add a new domain depends on the type of Cloud account:
39+
Custom domains can be added to Pro Staging and any Production environment; they cannot be added to Integration environments.
4040

41-
- For Pro
41+
The process to add a domain depends on the type of Cloud account:
4242

43-
You must open a Support ticket to request new domains to be added to the cluster.
43+
- For Pro Staging and Production
4444

45-
- For Starter
45+
Add the new domain to Fastly, see [Manage domains][], or open a support ticket to request assistance. In addition, you must open a Support ticket to request new domains to be added to a cluster.
4646

47-
You can add the new domain to Fastly for Production, or you can create a support ticket to request assistance. You must add the new domain to the **Domains** tab in the Program UI: `https://<zone>.magento.cloud/projects/<project-ID>/edit`
47+
- For Starter Production only
48+
49+
Add the new domain to Fastly, see [Manage domains][], or open a support ticket to request assistance. In addition, you must add the new domain to the **Domains** tab in the Project Web Interface: `https://<zone>.magento.cloud/projects/<project-ID>/edit`
4850

4951
## Configure local installation
5052

@@ -337,3 +339,4 @@ Adobe recommends fully testing in the Staging environment before pushing to the
337339

338340
[addstorecode]: {{ site.baseurl }}/guides/v2.4/config-guide/multi-site/ms_websites.html#multi-storecode-baseurl
339341
[config-multiweb]: {{ site.baseurl }}/guides/v2.4/config-guide/multi-site/ms_over.html
342+
[Manage domains]: {{ site.baseurl }}cloud/cdn/configure-fastly-customize-cache.html#manage-domains

src/cloud/project/project-upgrade.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,6 @@ Review the [{{site.data.var.ece}} service versions][version compatibility matrix
2222
- Upgrade third-party extensions to the latest supported version.
2323
- Update the `.gitignore` file.
2424

25-
{:.bs-callout-info}
26-
If you upgrade the PHP version, you must also submit a Support ticket to update the New Relic service.
27-
2825
### Configuration management
2926

3027
Older versions of {{site.data.var.ee}}, such as 2.1.4 or later to 2.2.x or later, used a `config.local.php` file for Configuration Management. {{site.data.var.ee}} version 2.2.0 and later use the `config.php` file, which works exactly like the `config.local.php` file, but it has different configuration settings that include a list of your enabled modules and additional configuration options.

src/cloud/project/project-webint-basic.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,6 @@
11
---
22
group: cloud-guide
3-
subgroup: 100_project
43
title: Configure your project
5-
menu_title: Configure your project
6-
menu_order: 5
7-
menu_node:
84
functional_areas:
95
- Cloud
106
- Configuration
@@ -30,7 +26,7 @@ The Project Web Interface provides several ways to access your project and envir
3026
To access projects and environments through the Project Web Interface:
3127

3228
1. [Log in to your project](https://account.magento.com/customer/account/login/).
33-
1. Click **Access Project** for a list of URLs and SSH.
29+
1. Click **Access Site** for a list of URLs for web access and the command for SSH access.
3430

3531
![Access your project by URL or SSH]({{ site.baseurl }}/common/images/cloud/cloud_project-access.png){:width="600px"}
3632

src/cloud/project/project-webint-snap.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@ functional_areas:
55
- Cloud
66
---
77

8-
You can back up and restore specific environments at any time using a snapshot. Snapshot options are available for all Starter environments and Pro Integration environments. You cannot snapshot Pro Staging or Production environments.
8+
You can back up and restore specific environments at any time using a snapshot. Snapshot options are available for all Starter environments and Pro Integration environments. The snapshot feature does not apply to the Pro Staging and Production environments.
9+
10+
The Pro Staging and Production environments receive regular backups for disaster recovery purposes by default, see [Pro Backup & Disaster Recovery]({{ site.baseurl }}/cloud/architecture/pro-architecture.html#backup-and-disaster-recovery). However, these backups are not publicly accessible because they are stored in a separate system. You can open a ticket to request a backup with a specific date, time, and timezone. Then we can extract it from the external system and provide it to you.
911

1012
A _snapshot_ is a complete backup of an environment that includes all persistent data from all running services (for example, your MySQL database, Redis, and so on) and any files stored on the mounted volumes. Because an environment deploys as a read-only file system, restoring a snapshot is very fast.
1113

src/cloud/project/services-mysql.md

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,13 @@ redirect_from:
88
- /cloud/project/project-conf-files_services-mysql.html
99
---
1010

11-
The `mysql` service provides persistent data storage based on [MariaDB](https://mariadb.com/) versions 10.2-10.4, supporting the [XtraDB](https://www.percona.com/software/mysql-database/percona-server/xtradb) storage engine and reimplemented features from MySQL 5.6 and 5.7.
11+
The `mysql` service provides persistent data storage based on [MariaDB](https://mariadb.com/) versions 10.2 to 10.4, supporting the [XtraDB](https://www.percona.com/software/mysql-database/percona-server/xtradb) storage engine and reimplemented features from MySQL 5.6 and 5.7.
1212

1313
{% include install/maria-db.md %}
1414

1515
{:.bs-callout-warning}
1616
Be careful when upgrading MariaDB from version 10.1 to 10.2.
17-
MariaDB 10.1 is the last version that support XtraDB as the storage engine. Version 10.2 uses InnoDB for the storage engine. Once you upgrade from 10.1 to 10.2, you cannot rollback the change. {{site.data.var.ee}} supports both storage engines; however, you must check extensions and other systems used by your project to make sure they are compatible with MariaDB 10.2. Read about this [backwards incompatible change](https://mariadb.com/kb/en/upgrading-from-mariadb-101-to-mariadb-102/#incompatible-changes-between-101-and-102).
17+
MariaDB 10.1 is the last version that supports XtraDB as the storage engine. Version 10.2 uses InnoDB for the storage engine. Once you upgrade from 10.1 to 10.2, you cannot rollback the change. {{site.data.var.ee}} supports both storage engines; however, you must check extensions and other systems used by your project to make sure they are compatible with MariaDB 10.2. Read about this [backwards incompatible change](https://mariadb.com/kb/en/upgrading-from-mariadb-101-to-mariadb-102/#incompatible-changes-between-101-and-102).
1818

1919
{% include cloud/service-config-integration-starter.md %}
2020

@@ -50,12 +50,12 @@ MariaDB 10.1 is the last version that support XtraDB as the storage engine. Vers
5050

5151
## Set up multiple database users
5252

53-
Optionally, you can set up multiple databases as well as multiple users with different permissions.
53+
Optionally, you can set up multiple databases and multiple users with different permissions.
5454

55-
An _endpoint_ is a set of credentials (or users) with specific privileges. By default, there is one endpoint named `mysql` that has administrator access to all defined databases. To set up multiple database users, you must define multiple endpoints in the services.yaml file and declare the relationships in the .magento.app.yaml file.
55+
An _endpoint_ is a set of credentials (or users) with specific privileges. By default, there is one endpoint named `mysql` that has administrator access to all defined databases. To set up multiple database users, you must define multiple endpoints in the services.yaml file and declare the relationships in the `.magento.app.yaml` file. For Pro Staging and Production environments, submit a Support ticket to request the additional user.
5656

5757
{:.bs-callout-warning}
58-
You cannot use multiple _databases_ with {{site.data.var.ee}} at this time, but you **can** create multiple endpoints to restrict access to the `main` database.
58+
You cannot use multiple _databases_ with {{site.data.var.ee}}, but you **can** create multiple endpoints to restrict access to the `main` database.
5959

6060
Use a nested array to define the endpoints for specific user access. Each endpoint can designate access to one or more schemas (databases) and different levels of permission on each.
6161

@@ -87,13 +87,13 @@ mysql:
8787
main: rw
8888
```
8989

90-
In the preceding example, the `admin` endpoint provides admin-level access to the `main` database, the `reporter` endpoint provides read-only access, and the `importer` endpoint provides read-write access. This means that:
90+
In the preceding example, the `admin` endpoint provides admin-level access to the `main` database, the `reporter` endpoint provides read-only access, and the `importer` endpoint provides read-write access, which means:
9191

9292
- The `admin` user has full control of the database.
9393
- The `reporter` user has SELECT privileges only.
9494
- The `importer` user has SELECT, INSERT, UPDATE, and DELETE privileges.
9595

96-
You must add the endpoints defined in the above example to the `relationships` property of the `.magento.app.yaml` file. For example:
96+
Add the endpoints defined in the above example to the `relationships` property of the `.magento.app.yaml` file. For example:
9797

9898
```yaml
9999
relationships:
@@ -103,13 +103,17 @@ relationships:
103103
```
104104

105105
{:.bs-callout-info}
106-
If you configure one MySQL user, you cannot use the [`DEFINER`](http://dev.mysql.com/doc/refman/5.6/en/show-grants.html) access control mechanism for stored procedures and views.
106+
If you configure one MySQL user, you cannot use the [`DEFINER`](https://dev.mysql.com/doc/refman/5.6/en/show-grants.html) access control mechanism for stored procedures and views.
107107

108108
## Connect to the database
109109

110-
Accessing the MariaDB database directly requires you to use a SSH to log in to the remote server, and connect to the database.
110+
Accessing the MariaDB database directly requires you to use a SSH to log in to the remote Cloud environment, and connect to the database.
111111

112-
1. Log in to the remote server using SSH.
112+
1. Use SSH to log in to the remote environment.
113+
114+
```bash
115+
magento-cloud ssh
116+
```
113117

114118
1. Retrieve the MySQL login credentials from the `database` and `type` properties in the [$MAGENTO_CLOUD_RELATIONSHIPS]({{ site.baseurl }}/cloud/project/magento-app-properties.html#relationships) variable.
115119

@@ -147,7 +151,7 @@ Accessing the MariaDB database directly requires you to use a SSH to log in to t
147151
],
148152
```
149153

150-
1. Connect to the database:
154+
1. Connect to the database.
151155

152156
- For Starter, use the following command:
153157

@@ -161,13 +165,16 @@ Accessing the MariaDB database directly requires you to use a SSH to log in to t
161165
mysql -h <hostname> -P <number> -u <username> -p'<password>'
162166
```
163167

168+
{:.bs-callout-tip}
169+
You can use the `magento-cloud db:sql` command to connect to the remote database and run SQL commands.
170+
164171
## Connect to secondary database
165172

166-
In some cases, you might need to connect to the secondary database, for example to improve database performance or resolve database locking issues. If this configuration is required, use `"port" : 3304` to establish the connection. See the [{{ site.data.var.ece }} database best practice](https://support.magento.com/hc/en-us/articles/360049045351) article in the _{{site.data.var.ee}} Help Center_.
173+
Sometimes, you have to connect to the secondary database to improve database performance or resolve database locking issues. If this configuration is required, use `"port" : 3304` to establish the connection. See the [{{ site.data.var.ece }} database best practice](https://support.magento.com/hc/en-us/articles/360049045351) article in the _{{site.data.var.ee}} Help Center_.
167174

168175
## Troubleshooting
169176

170-
See the following {{site.data.var.ee}} Support articles for help troubleshooting MySQL problems:
177+
See the following {{site.data.var.ee}} Support articles for help with troubleshooting MySQL problems:
171178

172179
- [Checking slow queries and processes MySQL](https://support.magento.com/hc/en-us/articles/360030903091-Checking-slow-queries-and-processes-MySQL-)
173180
- [Create database dump on Cloud](https://support.magento.com/hc/en-us/articles/360003254334-Create-database-dump-on-Cloud)
Binary file not shown.

0 commit comments

Comments
 (0)