Bug 1375036

Summary: [docs] should mention that Satellite needs to sync extra mirror registry (or remove the information about Satellite)
Product: OpenShift Container Platform Reporter: Kenjiro Nakayama <knakayam>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED EOL QA Contact: Vikram Goyal <vigoyal>
Severity: unspecified Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 3.2.1CC: aos-bugs, jokerman, mmccomas
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-08-10 06:46:03 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Kenjiro Nakayama 2016-09-12 01:56:42 UTC 
Document URL:

  https://docs.openshift.com/enterprise/3.2/install_config/install/disconnected_install.html

Section Number and Name: 

  "Red Hat Satellite 6.1 also introduces the ability to act as a Docker registry, and it can be used to host the OpenShift Enterprise containerized components. Doing so is outside of the scope of this document."

Describe the issue: 

  Above statement looks like Satellite could solve docker images disconnected installation. However, Satellite cannot export the images as RPM, and users need extra mirror registry to sync.

Suggestions for improvement: 

  Until this bug fixed https://bugzilla.redhat.com/show_bug.cgi?id=1348338 (Red Hat private), above statement should not say in OpenShift documentation.

Additional information: 

  This is a feedback from users. If users configure with Satellite, they need much extra configuration (please see comment#1). The documentation could mislead the users.
Comment 1 Kenjiro Nakayama 2016-09-12 02:00:34 UTC 
* Current Satellite need following steps to sync the registry without this fix https://bugzilla.redhat.com/show_bug.cgi?id=1348338

---
1. Setup a system with internet connectivity  and install docker and docker-distribution packages.

  For rhel 7.2
  # subscription-manager repos --enable=rhel-7-server-extras-rpms

  Install below packages -
  # yum install docker docker-distribution

2. Start both the services on the docker system.

3. Now pull the container image from Redhat portal
           # docker pull rhel7

4. tag and push the image to the local registry/distribution.

   # docker tag <image-id> <ipof-server:5000/<image-name>    [image id of step 3 can be found using docker images]
   # docker push <ipof-server:5000/<image-name>

5. On the Satellite server, create a Product and a docker repository to sync from the server mentioned above
   WebUI ==> content ==> Products ==> New Product

   URL: <ipof-server:5000
   Upstream Repository Name: <image-name>

   and then sync from this registry

6. Finally, docker pull can work.

  # docker pull  URL/image
  URL: It is the mention in "Published At" of the product which you have created.
       WebUI ==> content ==> Products ==> docker product ==> Repositories.