1) Description of problem:

The RHCS1.3 installation guide in section "2.1. Executing ceph-deploy", mentions the following:

"""When executing ceph-deploy with Red Hat Ceph Storage, ceph-deploy will need to retrieve Ceph packages from the /opt/calamari directory on your Calamari admin host, so you need to ensure that ceph-deploy has access to the .cephdeploy.conf file that was written to ~, /root and your local working directory when you executed ice_setup."""

and 

"""The ceph-deploy utility will output files to the current directory. Ensure you are in this directory when executing ceph-deploy, and ensure that ceph-deploy points to the .cephdeploy.conf file."""

"ceph_deploy" is to be executed after running "ice_setup" from /home/<ceph-user>/ceph-config/. "ice_setup" will create the "cephdeploy.conf" file in /home/<ceph-user>/ceph-config/ and /root/. Since both 'ceph-deploy' and "ice_setup" needs to be run from /home/<ceph-user>/ceph-config/, the file 'cephdeploy.conf' file will definitely be in /home/<ceph-user>/ceph-config/.

Hence, we may need to change the above documentation line which mentions three locations where cephdeploy.conf will be written to (~, /root and your local working directory) to something like:

"""Ensure you execute 'ceph-deploy' inside '/home/<ceph-user>/ceph-config/'. 'ceph-deploy' will read the 'cephdeploy.conf' written to the said directory ('/home/<ceph-user>/ceph-config/') by 'ice_setup', pull the packages from the repositories mentioned in it, and start the installation."""

This will make sure the installation documentation is much easier to read and understand.

2) Version-Release number of selected component (if applicable):

RHCS1.3 Installation documentation