Bug 1270618 - [DOCS] [3.1] [Feature] Document the various improvements to the Installer
Summary: [DOCS] [3.1] [Feature] Document the various improvements to the Installer
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2015-11-13
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.0.0
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: ---
: ---
Assignee: Alex Dellapenta
QA Contact: Gaoyun Pei
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-10-11 23:26 UTC by Vikram Goyal
Modified: 2017-03-08 18:13 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-11-19 17:55:09 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Vikram Goyal 2015-10-11 23:26:38 UTC
There are several improvements coming in the Installer for 3.1 (using the script):

* removal of the cntl-d escape
* ability to uninstall
* ability to add additional nodes post installation

(the last one seems to be delayed and may not make it for 3.1)

Check the productization board:
https://trello.com/b/wJYDst6C/productization

Comment 2 brice 2015-10-15 05:20:40 UTC
Trello card for adding additional nodes:

https://trello.com/c/IEkIu7n2/40-8-oo-install-support-for-adding-nodes-scale-up

Comment 3 Brenton Leanhardt 2015-10-15 12:37:48 UTC
We'll definitely have the ability to add nodes post install.  The other two will likely miss official devcut but should make it as well.  What "removal of the cntl-d escape" means is simply that the UI for entering hostnames will be different.  This isn't really something worth calling out in my opinion.  I would just put it in a bucket of general usability improvements.

One thing I mentioned to Alex that should be documented is that we're planning to do away with the "curl to your shell" install method.  We're going to ship a container that includes the installer wizard and the ansible playbook.  Admins could technically yum install the installer too.  That should settle within a week or so and you should have something to try out.

Comment 4 Jason DeTiberus 2015-10-15 15:06:42 UTC
We can use https://github.com/openshift/openshift-ansible/blob/master/playbooks/adhoc/atomic_openshift_tutorial_reset.yml as the starting point for the official uninstall.

Comment 5 brice 2015-10-16 03:30:07 UTC
Brenton, thanks for that. I'll talk to Alex and see if he's got something going on for the new installer. 

Jason, that link would be good to provide some context. I don't suppose there's more information? Say a possible use case (even I'm confused why we'd want to plug a uninstaller) and how to implement it? 

Thanks for the help, guys!

Comment 6 Jason DeTiberus 2015-10-22 20:42:35 UTC
Brice,

Brenton has a PR to generalize the uninstall playbook here: https://github.com/openshift/openshift-ansible/pull/713

Comment 7 Brenton Leanhardt 2015-10-22 21:03:08 UTC
We're still hoping to add support to the installer wizard for this too.

Comment 8 brice 2015-10-23 00:01:01 UTC
Jason, Brenton, I forgot to mention that Alex is going to take care of this card with his installer work on this BZ:

https://bugzilla.redhat.com/show_bug.cgi?id=1267431

I'll change the assignee over.

Comment 9 Alex Dellapenta 2015-11-06 04:07:42 UTC
Some pieces of this have merged, still working on it:

https://docs.openshift.com/enterprise/3.1/install_config/install/quick_install.html

Comment 10 Alex Dellapenta 2015-11-12 22:47:51 UTC
This can be reviewed now in the 3.1 Preview build:

https://docs.openshift.com/enterprise/3.1/install_config/install/quick_install.html

Comment 11 Ma xiaoqiang 2015-11-16 05:38:15 UTC
I am only  focused on the ansible installation. Not clear about these content in https://docs.openshift.com/enterprise/3.1/install_config/install/quick_install.html.

thanks

Comment 13 Ma xiaoqiang 2015-11-16 09:28:44 UTC
I have reviewed advanced installation, there is no issue.

Comment 14 Alex Dellapenta 2015-11-16 13:15:50 UTC
This BZ was meant to cover the improvements to the installation utility (atomic-openshift-utils, f/k/a oo-install), as documented in the Quick Installation method.

Xiaoqiang, when you say you are only focused on the Ansible installation, are you saying you only QE the Advanced Installation and I should be pinging someone else for review of the Quick Installation? I was using the matrix in https://mojo.redhat.com/docs/DOC-1026387 to find a QE contact.

What is not clear about the Quick Installation topic?

Thanks.

Comment 15 Alex Dellapenta 2015-11-16 13:18:28 UTC
(In reply to Alex Dellapenta from comment #14)
> This BZ was meant to cover the improvements to the installation utility
> (atomic-openshift-utils, f/k/a oo-install)

^ I meant to say atomic-openshift-installer here (atomic-openshift-utils being the package that provides the command).

Comment 16 Ma xiaoqiang 2015-11-17 00:32:27 UTC
Now gpei is focus on testing the installation utility(atomic-openshift-utils). maybe he can help to review the doc. thx

Comment 17 Alex Dellapenta 2015-11-17 01:41:19 UTC
@gei, setting you to QA content per Xiaoqiang's comment 16. Please let me know if you're able to review these docs on atomic-openshift-installer for OSE 3.1:

https://docs.openshift.com/enterprise/3.1/install_config/install/quick_install.html

Thanks!

Comment 18 Gaoyun Pei 2015-11-17 05:35:37 UTC
Hi Alex,

I checked the doc, most contents look ok for me. 
One thing I'm not sure about is the "containerized: true" in https://docs.openshift.com/enterprise/3.1/install_config/install/quick_install.html#defining-an-installation-configuration-file 
"Example 1. Installation Configuration File Specification"

Since we never test with this configuration before, and not sure whether this option will be supported in OSE-3.1 release.

Comment 19 Alex Dellapenta 2015-11-17 05:38:24 UTC
Thanks for reviewing. The callout description for that field says "Containerized installations are in Technology Preview in OpenShift Enterprise 3.1" and it is mentioned in the Release Notes as being in Technology Preview, so it is OK to mention here for OSE 3.1.

Comment 20 Alex Dellapenta 2015-11-17 05:47:28 UTC
See comment 19. Is that acceptable?

Comment 21 Gaoyun Pei 2015-11-17 05:57:32 UTC
Okay, thanks.
Move this bug to VERIFIED according to https://bugzilla.redhat.com/show_bug.cgi?id=1270618#c19

Comment 22 Alex Dellapenta 2015-11-17 05:58:27 UTC
Cool, thank you!

Comment 23 Alex Dellapenta 2015-11-19 18:16:54 UTC
Published in the following topic, which was updated per the new atomic-openshift-installer tool:

https://docs.openshift.com/enterprise/latest/install_config/install/quick_install.html


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