Skip to content

Commit 8cbd092

Browse files
author
James Calcaben
committed
MAGETWO-91956: Update PageBuilder installation guide
- Add Troubleshooting section for people having access problems
1 parent 9992c63 commit 8cbd092

File tree

2 files changed

+32
-4
lines changed

2 files changed

+32
-4
lines changed
Loading

app/code/Magento/PageBuilder/docs/install.md

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
1. [Composer installation](#composer-installation)
99
1. [GitHub installation](#github-installation)
1010
1. [Activation](#activation)
11+
1. [Troubleshooting](#troubleshooting)
1112
3. [Contribution guide]
1213
4. [Developer documentation]
1314
5. [Roadmap and known issues]
@@ -32,13 +33,22 @@ Use this method if you are testing and evaluating PageBuilder for your Magento s
3233

3334
### Prerequisites
3435

35-
* You submitted us MAGEID and github username and received access to 2.3 alpha and PageBuilder 100.0.0 alpha. If you didn't submit us github username with will send you an email and request it.
36+
* You submitted your MAGEID and github username and received access to 2.3 alpha and PageBuilder 100.0.0 alpha.
37+
If you didn't submit this information, send us an email to request access.
3638

3739
### Installation steps
3840

39-
1. If you have installed 2.3.0 alpha or Page Builder 100.0.0 alpha version installed, run `composer clearcache` before installing again. If you don’t clear the cache, Composer will not download the latest alpha release from the repo. It will instead use your locally cached packages.
41+
1. If you already have 2.3.0 alpha or Page Builder 100.0.0 alpha version installed, run the following command before installing again:
42+
``` sh
43+
composer clearcache
44+
```
45+
If you don’t clear the cache, Composer will not download the latest alpha release from the repo and will use the local, cached packages instead.
4046
2. Navigate to the directory where you want to install Magento and Page Builder.
41-
3. Install 2.3.0 alpha Commerce package, run composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.3.0-alpha.
47+
3. Install the 2.3.0 alpha Commerce package using the following command:
48+
``` sh
49+
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.3.0-alpha
50+
```
51+
4252
Enter the access keys for your account (Marketplace / My Profile / Access Keys)
4353
4. Install Page Builder
4454
``` sh
@@ -104,4 +114,22 @@ Follow these steps to activate PageBuilder in the Admin:
104114
2. In the **Stores** tab, select **Configuration** under the Settings group.
105115
3. In the **General** group on the page, select **Content Management**.
106116
4. Under **Advanced Content Tools**, select **Yes** for **Enable Page Builder**.
107-
5. Click **Save Config**
117+
5. Click **Save Config**
118+
119+
## Troubleshooting
120+
121+
If you are having trouble installing PageBuilder, please verify that the `mageID` account you provided for the Early Access Program (EAP) belongs to an active Magento partner account.
122+
123+
**Note:**
124+
*Your company may have multiple Magento accounts, and only one or two may be active.*
125+
*Ask your company to provide you with an active Magento account.*
126+
127+
Log into www.magento.com and see if the **Support** and **Downloads** tabs are available.
128+
129+
![Support and downloads tabs](images/support-downloads-tab.png)
130+
131+
If these tabs do not appear in your Magento account, it is not an active Magento partner account, and
132+
you will not be able to access PageBuilder.
133+
134+
If you provided incorrect `mageID` by mistake and have another one that is valid, please resubmit this form:
135+
https://goo.gl/forms/unvuDikl9wydmKt12

0 commit comments

Comments
 (0)