Bug 1300882 - Cockpit needs to be introduced in installation docs
Summary: Cockpit needs to be introduced in installation docs
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: ---
Assignee: Ashley Hardin
QA Contact: Yadan Pei
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-01-22 00:46 UTC by James Radtke
Modified: 2019-10-10 10:58 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-06-10 21:25:17 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description James Radtke 2016-01-22 00:46:48 UTC
Document URL: 
https://docs.openshift.com/enterprise/3.1/install_config/install/index.html

Section Number and Name: 
Unknown/TBD

Describe the issue: 
Cockpit was introduced in OSE 3.1 and there does not seem to be any supporting documentation specific to OSE.

Suggestions for improvement:
There should be mention of Cockpit in the docs.  Why it was included, what purpose it serves (or will serve).
Update the host port requirements that define what ports are listening on the Nodes.

Additional information:

Comment 4 Yoana Ruseva 2016-03-21 13:16:53 UTC
Hi Ashley, how can I help? You can check the current draft for Cockpit for Atomic here: https://access.qa.redhat.com/documentation/en/red-hat-enterprise-linux-atomic-host/version-7/getting-started-with-cockpit/

At the moment it is just installing and enabling it. I am working on providing examples with Docker and Kubernetes.

Comment 5 Peter Larsen 2016-03-21 14:32:21 UTC
(In reply to Yoana Ruseva from comment #4)
> Hi Ashley, how can I help? You can check the current draft for Cockpit for
> Atomic here:
> https://access.qa.redhat.com/documentation/en/red-hat-enterprise-linux-
> atomic-host/version-7/getting-started-with-cockpit/
> 
> At the moment it is just installing and enabling it. I am working on
> providing examples with Docker and Kubernetes.

This guide would be a poor fit for OSE. Cockpit is already installed and enabled with OSE - it's not a question of installing it, but using it. A guide should cover "getting started" and how the screens work in an OpenShift perspective. Ie. covering how the authentication is tied to the host, how it's tied to OSE and how the "cluster" connection works with OpenShift.  The user should understand when to use "add host" in Cockpit and what the cluster screens cover namespace wise.

Comment 6 Ashley Hardin 2016-03-21 19:03:36 UTC
(In reply to Peter Larsen from comment #5)
> (In reply to Yoana Ruseva from comment #4)
> > Hi Ashley, how can I help? You can check the current draft for Cockpit for
> > Atomic here:
> > https://access.qa.redhat.com/documentation/en/red-hat-enterprise-linux-
> > atomic-host/version-7/getting-started-with-cockpit/
> > 
> > At the moment it is just installing and enabling it. I am working on
> > providing examples with Docker and Kubernetes.
> 
> This guide would be a poor fit for OSE. Cockpit is already installed and
> enabled with OSE - it's not a question of installing it, but using it. A
> guide should cover "getting started" and how the screens work in an
> OpenShift perspective. Ie. covering how the authentication is tied to the
> host, how it's tied to OSE and how the "cluster" connection works with
> OpenShift.  The user should understand when to use "add host" in Cockpit and
> what the cluster screens cover namespace wise.

Thanks, Yoana and Peter.
Yes, I think the initial thought is to leave the bulk of the Cockpit content in the AH docs (linking to it as necessary from OpenShift docs), but incorporating OpenShift-specific Cockpit content in the OpenShift docs. Peter, may I pick your brain so that I can start getting some content drafted?

Comment 8 Ashley Hardin 2016-06-06 18:49:08 UTC
Work in progress: https://github.com/openshift/openshift-docs/pull/2222

Comment 9 openshift-github-bot 2016-06-07 18:42:28 UTC
Commits pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/f771a936bbd7c043ec346c7a0f3be5aa5a1a4ce8
Bug 1300882, added introductory Cockpit content

https://github.com/openshift/openshift-docs/commit/9897535e7d8b440a72f7928d8879c27e03175c5e
Merge pull request #2222 from ahardin-rh/cockpit-overview

Bug 1300882, added introductory Cockpit content


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