Description of problem:

In official Red Hat guide section
3.3.3. Calamari Server Installation:
https://access.redhat.com/documentation/en/red-hat-ceph-storage/2/single/installation-guide-for-red-hat-enterprise-linux#calamari_server_installation

after installation calamari-server in point 2.
In point 3. there is following command:
$ sudo calamari-ctl clear --yes-i-am-sure

On fresh installation this command cause error message:

# calamari-ctl clear --yes-i-am-sure
Loading configuration..
Dropping tables
(OperationalError) could not connect to server: Connection refused
	Is the server running on host "localhost" (::1) and accepting
	TCP/IP connections on port 5432?
could not connect to server: Connection refused
	Is the server running on host "localhost" (127.0.0.1) and accepting
	TCP/IP connections on port 5432?
 None None
We are sorry, an unexpected error occurred.  Debugging information has
been written to a file at '/tmp/2016-09-28_1026.txt', please include this when seeking technical support.

The error message is saying that calamari server is not running. That is normal after fresh installation.

Command:
# calamari-ctl clear --yes-i-am-sure
This command is only needed if you want to remove old installation db, if it is fresh installation, this command is not needed.

The description should be more accurate to avoid of confusion


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

How reproducible:
Easy

Steps to Reproduce:
1. Fresh calamari-server installation, # yum install calamari-server
2. run: # calamari-ctl clear --yes-i-am-sure
3.

Actual results:
Non accurate description in guide can cause confusion. 


Expected results:
Add info panel to the command
 # calamari-ctl clear --yes-i-am-sure
With information:
This command is only needed if you want to remove old installation db:


or divide the panel with commands + example
# calamari-ctl clear --yes-i-am-sure
# calamari-ctl initialize --admin-username <uid> --admin-password <pwd> --admin-email <email>

+ example
# calamari-ctl clear --yes-i-am-sure
# calamari-ctl initialize --admin-username admin --admin-password admin --admin-email cephadm

and add more accurate description to the work-flow.

Additional info: