Upgrading Core With the Installer
If the cluster that you want to upgrade was installed using the Installer, use the Installer to upgrade core.
Prerequisites
IMPORTANT Installer 1.18.0.0 does not support upgrades. Use a later version
of the Installer, or perform the upgrade using manual steps. See Upgrading Core Without the Installer.
Before you begin, review
Planning Your Core Upgrade, and verify that your
cluster is prepared for an upgrade. In
some cases, a maintenance update can be performed rather than a version upgrade. For
more information, see Performing a Maintenance UpdateWARNING The Version Upgrade operation is an
offline operation. Service failures, job failures, or the loss of
customized configuration files can occur if you do not perform the steps to prepare
the cluster for an upgrade.
NOTE To upgrade to
release 6.0 or later using the Installer, release
5.2.x and EEP 3.0.1 or later must be
installed on your cluster. If security is enabled on the cluster, you cannot use the
Installer or Stanzas to upgrade. You must perform
the upgrade manually.
About this task
Procedure
-
Update the Installer. For more information, see
Updating the Installer.
This step ensures that the Installer has access to the latest packages.
-
Halt jobs and applications. Stop accepting new jobs and applications, and stop
YARN applications.
# yarn application -list # yarn application -kill <ApplicationId>
You might also need specific commands to terminate custom applications.
-
Launch the Installer URL
(
https://<hostname/IPaddress>:9443
) -
Select the Version Upgrade option to complete the upgrade through the
Installer. The installer allows you to
specify the core version, the Ezmeral Ecosystem Pack (EEP) version, and the components and
services you want to install.
NOTE
- Incorporate a brief delay when you use the Version Upgrade screen. After specifying the core version, the EEP version, and the services you need, wait a minute or two before clicking Next to advance to the next screen. This delay gives the Installer time to process the selections that you made.
- Do not refresh the browser page during the upgrade sequence. Doing so can cause errors. For more information, see IN-1915 in MapR Installer Known Issues.
- If you upgrade a non-secure cluster to release 6.0.1 or later and
metrics monitoring is enabled, the Installer asks you to specify a password for the Grafana
administrator ID (
admin
). You must specify a password. For more information about Grafana password requirements, see Logging on to Grafana. - If the Installer indicates that the
version upgrade failed, or if the following error message is
displayed, use the Import State command to
revert the cluster to the last known state. See Importing or Exporting the Cluster State.
Custom secure cluster < MapR core 6.0.0 cannot be upgraded
- Once the upgrade through the Installer is complete, perform the post-upgrade steps. See Finishing the Core Upgrade.