Bug 1296622 - [SME] Install Quick Start need to include basic PV setup for registry setup
Summary: [SME] Install Quick Start need to include basic PV setup for registry setup
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Vikram Goyal
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-01-07 16:46 UTC by Peter Larsen
Modified: 2017-12-29 03:50 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-12-29 03:50:23 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Peter Larsen 2016-01-07 16:46:33 UTC
Document URL: https://docs.openshift.com/enterprise/3.1/install_config/install/quick_install.html

Section Number and Name: n/a

Describe the issue: 
For a basic install using Quick Start, the guide should include setting up a basic NFS server on the master (or another node) to provision space for the registry.

A separate section that covers basic configuration of PVs (including the backend from a clean install) would work too.

Suggestions for improvement: 

Include instructions for:
1) Enable rpcbind service
2) Enable nfs-server service
3) Add disk for VG to use for storage
4) Create VG and LV for registry
5) mkfs.xfs LV
6) Create mount point /mnt/nfs/registry and /etc/fstab entry for registry volume
7) mount /mnt/nfs/registry
8) Create entry in /etc/exports for /mnt/nfs/registry - run exportfs -r

This could be a part of the installation process too or a separate script we can provide to make it easier for the unexperienced user.

Section for setting up registry should then simply be shorted to use the oc volume and this NFS share. 

Additional information: 

It's important to note, that the quick-start guide is used by non ops and for evaluation purposes. Covering a basic NFS server even though it's never going to be used in production will help a user easily get OSE installed and working with a proper configuration.

Comment 1 Vikram Goyal 2017-12-29 03:50:23 UTC
We added some details on PV creation in the 3.6 release docs: https://docs.openshift.com/container-platform/3.6/getting_started/configure_openshift.html#create-persistent-storage-for-registry

For the rest, we would consider that out of scope. I am going to close this bug, but please feel free to reopen and provide reasoning why.


Note You need to log in before you can comment on or make changes to this bug.