anchor.diff:  - Base OS: Red Hat Enterprise Linux (RHEL) 7.1 with "Minimal" installation
   option
   endif::[]
  -- Docker 1.6 or later
  +- Docker 1.6.2 or later
   - 1 vCPU
   - Minimum 8 GB RAM
   - Minimum 15 GB hard disk space
   - An additional minimum 15 GB unallocated space to be configured using
   *docker-storage-setup*; see link:#configuring-docker-storage[Configuring
   Docker Storage] below.
  +
  +|link:../../admin_guide/persistent_storage_nfs.html[Persistent Storage]
  +a| - NFS persistent storage volumes per your application needs. Currently NFS
  +is fully supported, however other options are available as
  +link:../whats_new/ose_3_0_release_notes.html#technology-preview[Technology
  +Preview], see
  +link:../../dev_guide/persistent_volumes.html[Using Persistent Volumes] for more information
  +
   |===
   
   [[security-warning]]
  
positive.code: 
  *Installing Docker*
  
  Docker version 1.6 or later
  ifdef::openshift-enterprise[]
  from the *rhel-7-server-ose-3.0-rpms* repository
  endif::[]
  
negative.code: Enterprise Linux 7.
  ====
  
  [IMPORTANT]
  ====
  Before using Docker or OpenShift please verify that the docker-pool logical
  volume is large enough to meet your needs. The docker-pool volume should be
  60% of the available volume group and will grow to fill the volume group
  via LVM monitoring.
  ====
  
  
  . Create the docker-pool volume using one of the following three options:
  
  ** [[docker-storage-a]]*Option A) Use an additional block device*
  +
  In *_/etc/sysconfig/docker-storage-setup_* set *DEVS* to the path of the block
  device you wish to use. Set *VG* to the volume group name you wish to create,
  *docker-vg* is a reasonable choice. Run *docker-storage-setup* and review the
  output to ensure the *docker-pool* volume was created.
  +
  ----
  # cat <<EOF > /etc/sysconfig/docker-storage-setup
  DEVS=/dev/vdc
  VG=docker-vg
  EOF
  
  # docker-storage-setup                                                                                                                                                                                                                                [5/1868]
  0
  Checking that no-one is using this disk right now ...
  OK
  
  Disk /dev/vdc: 31207 cylinders, 16 heads, 63 sectors/track
  sfdisk:  /dev/vdc: unrecognized partition table type
  
  Old situation:
  sfdisk: No partitions found
  
  New situation:
  Units: sectors of 512 bytes, counting from 0
  
     Device Boot    Start       End   #sectors  Id  System
  /dev/vdc1          2048  31457279   31455232  8e  Linux LVM
  /dev/vdc2             0         -          0   0  Empty
  /dev/vdc3             0         -          0   0  Empty
  /dev/vdc4             0         -          0   0  Empty
  Warning: partition 1 does not start at a cylinder boundary
  Warning: partition 1 does not end at a cylinder boundary
  Warning: no primary partition is marked bootable (active)
  This does not matter for LILO, but the DOS MBR will not boot this disk.
  Successfully wrote the new partition table
  
  Re-reading the partition table ...
  
  If you created or changed a DOS partition, /dev/foo7, say, then use dd(1)
  to zero the first 512 bytes:  dd if=/dev/zero of=/dev/foo7 bs=512 count=1
  (See fdisk(8).)
    Physical volume "/dev/vdc1" successfully created
    Volume group "docker-vg" successfully created
    Rounding up size to full physical extent 16.00 MiB
    Logical volume "docker-poolmeta" created.
    Logical volume "docker-pool" created.
    WARNING: Converting logical volume docker-vg/docker-pool and docker-vg/docker-poolmeta to pool's data and metadata volumes.
    THIS WILL DESTROY CONTENT OF LOGICAL VOLUME (filesystem etc.)
    Converted docker-vg/docker-pool to thin pool.
    Logical volume "docker-pool" changed.
  ----
  
  ** [[docker-storage-b]]*Option B) Use a specified volume group*
  +
  In *_/etc/sysconfig/docker-storage-setup_* set *VG* to the desired volume group.
  Run *docker-storage-setup* and review the  output to ensure the *docker-pool*
  volume was created.
  +
  ----
  # cat <<EOF > /etc/sysconfig/docker-storage-setup
  VG=docker-vg
  EOF
  
  # docker-storage-setup
    Rounding up size to full physical extent 16.00 MiB
    Logical volume "docker-poolmeta" created.
    Logical volume "docker-pool" created.
    WARNING: Converting logical volume docker-vg/docker-pool and docker-vg/docker-poolmeta to pool's data and metadata volumes.
    THIS WILL DESTROY CONTENT OF LOGICAL VOLUME (filesystem etc.)
    Converted docker-vg/docker-pool to thin pool.
    Logical volume "docker-pool" changed.
  ----
  
  
  ** [[docker-storage-c]]*Option C) Use the remaining free space from the volume group where your root
  filesystem is located*
  +
  Verify that the volume group where your root file system resides has the desired
  free space then run *docker-storage-setup* and review the output to ensure the
  *docker-pool* volume was created.
  +
  ----
  # docker-storage-setup
    Rounding up size to full physical extent 32.00 MiB
    Logical volume "docker-poolmeta" created.
    Logical volume "docker-pool" created.
    WARNING: Converting logical volume rhel/docker-pool and rhel/docker-poolmeta to pool's data and metadata volumes.
    THIS WILL DESTROY CONTENT OF LOGICAL VOLUME (filesystem etc.)
    Converted rhel/docker-pool to thin pool.
    Logical volume "docker-pool" changed.
  ----
  
  . Verify your configuration. You should have *dm.thinpooldev* value in the
  *_/etc/sysconfig/docker-storage_* file and a *docker-pool* logical volume:
  +
  ====
  ----
  # lvs
    LV          VG   Attr       LSize  Pool Origin Data%  Meta%  Move Log Cpy%Sync Convert
    docker-pool rhel twi-a-t---  9.29g             0.00   0.12
  
  # cat /etc/sysconfig/docker-storage
  DOCKER_STORAGE_OPTIONS=--storage-opt dm.fs=xfs --storage-opt
  