Bug 1703095 - [DOCS] Installation fails with the following problem -> The PersistentVolume "BS31369_ocp_registry-volume" is invalid: [...] a DNS-1123 subdomain must consist of lower case alphanumeric characters, '-' or '.'
Summary: [DOCS] Installation fails with the following problem -> The PersistentVolume ...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 1.0.0
Hardware: Unspecified
OS: Unspecified
low
high
Target Milestone: ---
: 3.7.0
Assignee: Vikram Goyal
QA Contact: Anping Li
Vikram Goyal
URL:
Whiteboard: 3.7-release-plan
Depends On: 1488366
Blocks:
TreeView+ depends on / blocked
 
Reported: 2019-04-25 13:44 UTC by Candace Sheremeta
Modified: 2020-04-10 22:11 UTC (History)
11 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of: 1488366
Environment:
Last Closed: 2020-04-10 22:11:02 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Comment 1 Candace Sheremeta 2019-04-25 13:52:50 UTC
I have cloned BZ1488366 as a docs bug because the resolution to BZ1488366 needs to be included in the docs, as well. This is for all versions of OpenShift (or, at least, 3.7+).

The resolution of BZ1488366 was to add the following text to the example inventory file that is shipped with the openshift RPMs (in 3.7, /usr/share/doc/openshift-ansible-docs-3.7.0/docs/example-inventories/hosts.example):

# nfs_directory must conform to DNS-1123 subdomain must consist of lower case
# alphanumeric characters, '-' or '.', and must start and end with an alphanumeric character
#openshift_hosted_registry_storage_nfs_directory=/exports

This requirement is still the case in 3.11, but it is not in the documentation at all, so customers who are not specifically looking at the example inventory files shipped with the RPMs (which is probably most of them) will not see this. 

I will leave it up to the professionals on how/where to do this, but the following sections are where we may want to start with this sort of information:

https://docs.openshift.com/container-platform/3.11/install/configuring_inventory_file.html#advanced-install-cluster-metrics-storage

https://docs.openshift.com/container-platform/3.11/install/configuring_inventory_file.html#advanced-installation-logging-storage

https://docs.openshift.com/container-platform/3.11/install/configuring_inventory_file.html#advanced-install-registry-storage

https://docs.openshift.com/container-platform/3.11/install/configuring_inventory_file.html#configuring-oab-storage

Comment 2 Candace Sheremeta 2019-08-16 13:47:13 UTC
https://github.com/openshift/openshift-docs/pull/16280


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