Skip to content

Commit

Permalink
Commerce installation additions for 2.3 alpha install (#2547)
Browse files Browse the repository at this point in the history
* First draft of commerce installation additions for 2.3 alpha install

* Added info and link for installing Commerce B2B extension

* Updated composer commands to fit new numbered alphas

* Update 2.3.0-alpha-install.md

Modified B2B wording
  • Loading branch information
bdenham committed Jul 20, 2018
1 parent 04bf86f commit a9aaa8d
Showing 1 changed file with 17 additions and 14 deletions.
31 changes: 17 additions & 14 deletions guides/v2.3/release-notes/2.3.0-alpha-install.md
Expand Up @@ -9,37 +9,37 @@ github_link: release-notes/2.3.0-alpha-install.md

In addition to the [standard Magento prerequisites]({{ site.baseurl }}/guides/v2.3/install-gde/prereq/prereq-overview.html), make sure you have obtained and installed:

* *Authentication keys*. The {{site.data.var.ce}} 2.3.0 Alpha Composer package is available to everyone. For access to the {{site.data.var.ee}} 2.3.0 Alpha Composer package, contact [Magento Support](https://magento.com/support). See [Get your authentication keys]({{page.baseurl}}/install-gde/prereq/connect-auth.html) for more information.
* *Open Source Access*. The Open Source 2.3.0 Alpha Composer package is available to everyone with Magento authentication keys. If you do not have authentication keys, see [Get your authentication keys]({{page.baseurl}}/install-gde/prereq/connect-auth.html) for more information.
* *Commerce Access*. The Commerce 2.3.0 Alpha Composer package is only available to Magento partners, as well as approved merchant developers and independent extension developers. In addition, access is granted only to those who complete and sign [Magento's Pre-Release Software Agreement](https://partners.magento.com/portal/pre-release-agreement). You will be notified of your approval to access the {{site.data.var.ee}} 2.3.0 Alpha repository within three business days. After you receive approval you will be able to install {{site.data.var.ee}} 2.3.0 Alpha using these installation instructions.
* *PHP 7.1 or 7.2 and extensions*. See instructions here: [Install PHP 7.1 for Ubuntu]({{ site.baseurl }}/guides/v2.3/install-gde/prereq/php-ubuntu.html#instgde-prereq-php71-ubuntu) or [Install PHP 7.1 for Centos]({{ site.baseurl }}/guides/v2.3/install-gde/prereq/php-centos.html#php-centos-71).
* *Composer*. Install using:
```bash
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer
```

## Install 2.3.0 Alpha

{:.bs-callout .bs-callout-info}
Currently, the Magento 2.3.0 Alpha is only available for Open Source modules. Alpha for Commerce, including the Magento Commerce for B2B extension, will be made available soon.

1. Install the Open Source or Commerce alpha package.

<div class="bs-callout bs-callout-warning" id="info" markdown="1">
If you have installed a 2.3.0 alpha version before, 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.
</div>
1. Install the Open Source or Commerce Alpha package.

**Open Source**

Available to everyone with Magento authentication keys. If you do not have authentication keys, complete the instructions in [Get your authentication keys]({{page.baseurl}}/install-gde/prereq/connect-auth.html) before continuing.
```bash
composer create-project --repository=https://repo.magento.com/ magento/project-community-edition=2.3.0-alpha <install-directory-name>
composer create-project --repository=https://repo.magento.com/ magento/project-community-edition=2.3.* --stability=alpha <install-directory-name>
```

**Commerce**

Only available to Magento partners, merchant developers, and independent extension developers who have signed [Magento's Pre-Release Software Agreement](https://partners.magento.com/portal/pre-release-agreement) and been approved to access the Commerce 2.3.0 Alpha repositories. If you have not signed the pre-release software agreement and been granted access, you must do so before continuing.
```bash
composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition=2.3.0-alpha <install-directory-name>
composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition=2.3.* --stability=alpha <install-directory-name>
```

When prompted, enter your authentication keys. Your *public key* is your username; your *private key* is your password.

<div class="bs-callout bs-callout-info" id="info" markdown="1">
If you encounter errors, such as `Could not find package...` or `...no matching package found`, make sure there aren't any typos in your command. If you still encounter errors, you may not have access to our pre-release Composer repositories. Contact [Magento support](https://magento.com/support) for help.
</div>

2. Set file permissions as follows:
```terminal
Expand All @@ -49,21 +49,21 @@ Currently, the Magento 2.3.0 Alpha is only available for Open Source modules. Al
chown -R :www-data . // Ubuntu
chmod u+x bin/magento
```

For more information, refer to [Set file system ownership and permissions]({{ page.baseurl }}/install-gde/prereq/file-system-perms.html).

3. Install Magento using the CLI or the Web Setup Wizard.

**Using the CLI.** This example assumes that the Magento install directory is named `magento2ee`, the `db-host` is on the same machine (`localhost`), and that the `db-name`, `db-user`, and `db-password` are all `magneto`:

```bash
bin/magento setup:install --base-url=http://localhost/magento2ee --db-host=localhost --db-name=magento --db-user=magento --db-password=magento --backend-frontname=admin --admin-firstname=admin --admin-lastname=admin --admin-email=admin@admin.com --admin-user=admin --admin-password=admin123 --language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1
```
For a full description of the CLI install options, refer to [Install the Magento software from the command line]({{ site.baseurl }}/guides/v2.3/install-gde/install/cli/install-cli-install.html#instgde-install-cli-magento).

**Using the Web Setup Wizard.** As an alternative to the CLI, use your browser to navigate to Magento's setup wizard:

```url
```
http://<Magento-host-or-IP>/<path-to-magento-root>/setup
```
For example: `http://localhost/magento2ee/setup`
Expand All @@ -74,3 +74,6 @@ Currently, the Magento 2.3.0 Alpha is only available for Open Source modules. Al
bin/magento sampledata:deploy
```
When prompted, enter your authentication keys. Your *public key* is your username; your *private key* is your password.

## B2B for Commerce 2.3.0 Alpha
B2B features are only included in Magento Commerce and are not available for Magento Open Source. Only users with access to the Magento Commerce 2.3 Alpha can evaluate and test B2B features. To install B2B for Commerce 2.3.0 Alpha, refer to [Install the B2B extension](https://devdocs.magento.com/guides/v2.3/comp-mgr/install-extensions/b2b-installation.html).

0 comments on commit a9aaa8d

Please sign in to comment.