Skip to content

Commit 2e0a6f7

Browse files
committed
More reverting of quick_install changes
1 parent e2ce4a9 commit 2e0a6f7

File tree

3 files changed

+57
-15
lines changed

3 files changed

+57
-15
lines changed

install_config/adding_hosts_to_existing_cluster.adoc

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -59,10 +59,10 @@ The recommended maximum number of nodes is 300.
5959
To add nodes to your installation:
6060

6161
. Ensure you have the latest installer and playbooks by updating the
62-
*openshift-ansible* packages:
62+
*atomic-openshift-utils* package:
6363
+
6464
----
65-
# yum update openshift-ansible
65+
# yum update atomic-openshift-utils
6666
----
6767

6868
. Run the installer with the `scaleup` subcommand in interactive or
@@ -138,11 +138,11 @@ The recommended maximum number of nodes is 300.
138138

139139
To add a host to an existing cluster:
140140

141-
. Ensure you have the latest playbooks by updating the *openshift-ansible*
142-
packages:
141+
. Ensure you have the latest playbooks by updating the *atomic-openshift-utils*
142+
package:
143143
+
144144
----
145-
# yum update openshift-ansible
145+
# yum update atomic-openshift-utils
146146
----
147147

148148
. Edit your *_/etc/ansible/hosts_* file and add *new_<host_type>* to the
@@ -263,11 +263,11 @@ preparation] steps.
263263

264264
To add an etcd host to an existing cluster:
265265

266-
. Ensure you have the latest playbooks by updating the *openshift-ansible* packages:
266+
. Ensure you have the latest playbooks by updating the *atomic-openshift-utils* package:
267267
+
268268
[source, bash]
269269
----
270-
$ yum update openshift-ansible
270+
$ yum update atomic-openshift-utils
271271
----
272272

273273
. Edit your *_/etc/ansible/hosts_* file, add *new_<host_type>* to the

install_config/upgrading/automated_upgrades.adoc

Lines changed: 44 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ ifdef::openshift-enterprise[]
2323
If you installed using the
2424
xref:../../install_config/install/quick_install.adoc#install-config-install-quick-install[quick installation] method
2525
and a *_~/.config/openshift/installer.cfg.yml_* file is available, you can use
26-
the installer to perform the automated upgrade.
26+
the quick installer to perform the automated upgrade.
2727
endif::[]
2828

2929
The automated upgrade performs the following steps for you:
@@ -141,14 +141,15 @@ channel and enable the 3.7 channel on each master and node host:
141141
----
142142

143143
. For any upgrade path, always ensure that you have the latest version of the
144-
*openshift-ansible-** packages on each RHEL 7 system
144+
*atomic-openshift-utils* package on each RHEL 7 system, which also updates the
145+
*openshift-ansible-** packages:
145146
+
146147
----
147-
# yum update openshift-ansible
148+
# yum update atomic-openshift-utils
148149
----
149150

150151
. When installing or updating *atomic-openshift-utils*,
151-
*_/usr/share/openshift/examples/_* does not get updated with the latest
152+
*_/usr/share/openshift/examples/_* does not get updated with the latest
152153
templates. To update these files:
153154
+
154155
----
@@ -187,10 +188,49 @@ xref:../../install_config/upgrading/migrating_etcd.adoc#install-config-upgrading
187188
After satisfying these steps, there are two methods for running the automated
188189
upgrade:
189190

191+
- xref:upgrading-using-the-installation-utility-to-upgrade[Using the quick installer]
190192
- xref:running-the-upgrade-playbook-directly[Running the upgrade playbook directly]
191193

192194
Choose and follow one of these methods.
193195

196+
[[upgrading-using-the-installation-utility-to-upgrade]]
197+
== Using the Quick Installer to Upgrade
198+
199+
If you installed {product-title} using the
200+
xref:../../install_config/install/quick_install.adoc#install-config-install-quick-install[quick installation] method,
201+
you should have an installation configuration file located at
202+
*_~/.config/openshift/installer.cfg.yml_*. The quick installer requires this file to
203+
start an upgrade.
204+
205+
The quick installer supports upgrading between minor versions of {product-title}
206+
(one minor version at a time, e.g., 3.5 to 3.6) as well as between
207+
xref:../../release_notes/ocp_3_6_release_notes.adoc#ocp-36-asynchronous-errata-updates[asynchronous errata updates] within a minor version (e.g., 3.6.z).
208+
209+
If you have an older format installation configuration file in
210+
*_~/.config/openshift/installer.cfg.yml_* from an installation of a previous
211+
cluster version, the quick installer will attempt to upgrade the file to the new supported
212+
format. If you do not have an installation configuration file of any format, you
213+
can
214+
xref:../../install_config/install/quick_install.adoc#defining-an-installation-configuration-file[create one manually].
215+
216+
To start an upgrade with the quick installer:
217+
218+
. Satisfy the steps in xref:preparing-for-an-automated-upgrade[Preparing for an Automated Upgrade] to ensure you are using the latest upgrade playbooks.
219+
220+
. Run the quick installer with the `upgrade` subcommand:
221+
+
222+
----
223+
# atomic-openshift-installer upgrade
224+
----
225+
. Then, follow the on-screen instructions to upgrade to the latest release.
226+
+
227+
[NOTE]
228+
====
229+
If the quick installer fails, note the error output and check
230+
xref:upgrading_known_issues.adoc#install-config-upgrading-known-issues[Known Issues] for any additional steps.
231+
====
232+
233+
include::install_config/upgrading/automated_upgrades.adoc[tag=automated_upgrade_after_reboot]
194234

195235
[[running-the-upgrade-playbook-directly]]
196236
== Running Upgrade Playbooks Directly

install_config/upgrading/manual_upgrades.adoc

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -897,12 +897,14 @@ Because RHEL Atomic Host 7 cannot use *yum* to update packages, the following
897897
steps must take place on a RHEL 7 system.
898898
====
899899

900-
Update the packages that provide the example JSON files. On a subscribed Red
901-
Hat Enterprise Linux 7 system where you can run the CLI as a user with
902-
*cluster-admin* permissions, install or update to the latest version of the *openshift-ansible* packages:
900+
Update the packages that provide the example JSON files. On a subscribed Red Hat
901+
Enterprise Linux 7 system where you can run the CLI as a user with
902+
*cluster-admin* permissions, install or update to the latest version of the
903+
*atomic-openshift-utils* package, which should also update the
904+
*openshift-ansible-* packages:
903905

904906
----
905-
# yum update openshift-ansible
907+
# yum update atomic-openshift-utils
906908
----
907909

908910
To persist *_/usr/share/openshift/examples/_* on the first master:

0 commit comments

Comments
 (0)