Bug 1327937

Summary: [DOCS] Document RHEL Container for Docker Migration
Product: Red Hat Enterprise Linux 7 Reporter: Vikram Goyal <vigoyal>
Component: doc-RHEL-AtomicAssignee: Chris Negus <cnegus>
Status: CLOSED CURRENTRELEASE QA Contact: Vikram Goyal <vigoyal>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: high    
Version: 7.2CC: cnegus, jlebon, miabbott, yruseva, zdover
Target Milestone: rcKeywords: Documentation, Reopened
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-09-17 06:13:44 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:
Bug Depends On: 1318406    
Bug Blocks:    
Deadline: 2016-05-06   

Description Vikram Goyal 2016-04-18 04:50:27 UTC
Document the new RHEL Container for Docker Migration based on the work being done in this bug: https://bugzilla.redhat.com/show_bug.cgi?id=1318406

This should go in the Getting Started with Containers guide:
https://access.redhat.com/documentation/en/red-hat-enterprise-linux-atomic-host/version-7/getting-started-with-containers/

Comment 2 Zac Dover 2016-05-03 02:22:35 UTC
*** Bug 1320826 has been marked as a duplicate of this bug. ***

Comment 4 Chris Negus 2016-05-11 04:18:26 UTC
This issue is now covered in the 7.2.4 release notes. The note says that we are not providing a migration tool to move existing container images from Docker 1.9 to Docker 1.10. Instead, customers should simply change over to Docker 1.10 and re-pull the container images as needed.

Comment 5 Vikram Goyal 2016-06-01 03:13:13 UTC
Opening this bug as it is now being targeted for 7.2.5.

Apparently they want this documented for 7.2.5. Here are a few issues:
* When docker 1.10 becomes the default, the migrator must be run before reboot to docker 1.10 on an upgrade.
* The docker 1.8 and 1.9 daemons can run with converted meta-data (because the old meta-data is still there).
* The migrator tool packaged with docker 1.10 = "docker-latest" can work with "docker" data store.
* We need to document this for 7.2.5.
When will docker = docker 1.10?
* Can't have docker be 1.10 until OSE supports it. OSE is starting testing now.
* OSE moves to docker 1.10 for 3.2.1 GA (June 23).
* 7.2.5 GA is June 21 (May 31 code freeze). Need to ask about this since it's after the 7.2.5 release date.
* Are any docker 1.9 updates planned? Yes, 1 fix needed if don't ship docker 1.10.  - Lokesh - give docker 1.9 with fix to Martin ASAP so QE can test it now and we can use as a fall back if needed.
* What are the 7.2.6 docker and docker-latest versions?  7.2.6 GA: Aug-02 (docker = TBD; docker-latest= TBD)? Ben / Subhendu
Where does v1.10 migratool need to go?:
* rhel-tools: Migrator tool is a sub-package of docker-latest package that will be included in rhel-tools container (Ian) 
* No plans for separate container image for migration tool.
* Not needed in OStree
* Already in Extras from 7.2.4