Bug 1380731

Summary:	[DOC] add notification to the commands used for Calamari installation [RHEL]
Product:	Red Hat Ceph Storage	Reporter:	Tomas Petr <tpetr>
Component:	Documentation	Assignee:	Erin Donnelly <edonnell>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vasishta <vashastr>
Severity:	low	Docs Contact:
Priority:	low
Version:	2.0	CC:	asriram, edonnell, hnallurv, kdreyer, vumrao
Target Milestone:	rc
Target Release:	2.1
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1380737 (view as bug list)		Environment:
Last Closed:	2016-11-28 09:37:40 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Bug Depends On:
Bug Blocks:	1380737

Description Tomas Petr 2016-09-30 12:38:28 UTC

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: