From 896a313d08394de9cc33e555d605188934a6499c Mon Sep 17 00:00:00 2001
From: Adrian Plata <51415348+adrian-plata@users.noreply.github.com>
Date: Mon, 25 Nov 2019 12:59:35 -0800
Subject: [PATCH] adding additional linux ubuntu install instructions (#9934)

* adding additional linux ubuntu install instructions

Signed-off-by: Adrian Plata <adrian.plata@docker.com>

* emphasizing on order

* specifying version

* word changes
---
 install/linux/docker-ee/ubuntu.md | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/install/linux/docker-ee/ubuntu.md b/install/linux/docker-ee/ubuntu.md
index 3a76382bb0..6e1dd5be63 100644
--- a/install/linux/docker-ee/ubuntu.md
+++ b/install/linux/docker-ee/ubuntu.md
@@ -247,13 +247,20 @@ To upgrade Docker Engine - Enterprise, follow the steps below:
 ### Install from a package
 
 If you cannot use Docker's repository to install Docker Engine - Enterprise, you
-can download the `.deb` file for your release and install it manually. You need
-to download a new file each time you want to upgrade Docker Engine - Enterprise.
+can download the `.deb` files for your release and install them manually. You
+need to download a new file or set of files each time you want to upgrade Docker
+Engine - Enterprise.
 
 1.  Go to the Docker Engine - Enterprise repository URL associated with your
     trial or subscription in your browser. Go to
-    `ubuntu/x86_64/stable-<VERSION>` and download the `.deb` file for the
-    Docker Engine - Enterprise version and architecture you want to install.
+    `ubuntu/dists/<distribution>/pool/stable-<VERSION>` and download the `.deb`
+    file(s) for the Docker Engine - Enterprise version and architecture you want
+    to install.
+
+    > **Note:**
+    > Starting with 19.03, you have to download three `.deb` files. They
+    > are `docker-ee-cli_<version>.deb`, `containerd.io_<version>.deb`, and
+    > `docker-ee_<version>.deb`.
 
 2.  Install Docker, changing the path below to the path where you downloaded
     the Docker Engine - Enterprise package.
@@ -262,6 +269,15 @@ to download a new file each time you want to upgrade Docker Engine - Enterprise.
     $ sudo dpkg -i /path/to/package.deb
     ```
 
+    Or, if you downloaded the three `.deb` files, **you must** install them in
+    the following order:
+
+    ```bash
+    $ sudo dpkg -i /path/to/docker-ee-cli_<version>.deb
+    $ sudo dpkg -i /path/to/containerd.io_<version>.deb
+    $ sudo dpkg -i /path/to/docker-ee_<version>.deb
+    ```
+
     The Docker daemon starts automatically.
 
 3.  Verify that Docker is installed correctly by running the `hello-world`