Bug 1391308

Summary:	Document details of atomic host command in non-atomic host machines
Product:	Red Hat Enterprise Linux 7	Reporter:	Alex Jia <ajia>
Component:	atomic	Assignee:	Lokesh Mandvekar <lsm5>
Status:	CLOSED CURRENTRELEASE	QA Contact:	atomic-bugs <atomic-bugs>
Severity:	low	Docs Contact:
Priority:	medium
Version:	7.4	CC:	bbaude, dwalsh, pthomas
Target Milestone:	rc	Keywords:	Extras
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2020-05-05 14:32:04 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:

Description Alex Jia 2016-11-03 02:05:19 UTC

Description of problem:
We don't support atomic host command in non-atomic host machines, but I haven't tell users about this in man page.

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

# cat /etc/redhat-release 
Red Hat Enterprise Linux Server release 7.3 (Maipo)

# rpm -q atomic
atomic-1.13.5-1.el7.x86_64

How reproducible:
always

Steps to Reproduce:
1. atomic host -h
2. man atomic-host


Actual results:


Expected results:


Additional info:

Comment 2 Daniel Walsh 2016-11-04 11:28:36 UTC

https://github.com/projectatomic/atomic/pull/746 fixes this bug

Comment 3 Alex Jia 2017-05-26 01:07:17 UTC

<atomic_host_manpage>
NAME
       atomic-host - Manage Atomic Host Commands

SYNOPSIS
       atomic host [OPTIONS] COMMAND

       This  command  is  a  high-level wrapper for the underlying rpm-ostree tool which can perform upgrades, rollbacks, and system state inspection.  It is used for implementations of the
       Project Atomic Host pattern.

       #NOTE The host subcommand is only available on Atomic Host Systems.

...
</atomic_host_manpage>

[root@dell-per630-02 ~]# atomic host
atomic: invalid choice: 'host' (choose from 'containers', 'diff', 'help', 'images', 'info', 'install', 'mount', 'pull', 'push', 'upload', 'run', 'scan', 'sign', 'stop', 'storage', 'migrate', 'top', 'trust', 'uninstall', 'unmount', 'umount', 'update', 'verify', 'version')
Try 'atomic --help' for more information.