-
Notifications
You must be signed in to change notification settings - Fork 1.7k
/
3.4-upgrade-sharded-cluster.txt
86 lines (59 loc) · 2.64 KB
/
3.4-upgrade-sharded-cluster.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
.. _3.4-upgrade-sharded-cluster:
================================
Upgrade a Sharded Cluster to 3.4
================================
.. default-domain:: mongodb
.. contents:: On this page
:local:
:backlinks: none
:depth: 1
:class: singlecol
.. note::
- Starting in MongoDB 3.4.21, MongoDB 3.4-series removes support for Ubuntu 16.04 PPCLE.
- .. include:: /includes/admonition-power-ubuntu-restriction.rst
.. include:: /includes/3.4-upgrade-replacements.rst
.. include:: /includes/upgrade-copy.rst
.. include:: /includes/warning-mixed-version-rs-config.rst
``mongos`` and Earlier Versions of ``mongod`` Instances
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Version |newversion| :binary:`~bin.mongos` instances cannot connect to
earlier versions of :binary:`~bin.mongod` instances.
The 3.2 and earlier :binary:`~bin.mongo` shell is not compatible with 3.4
clusters.
Prerequisites
-------------
- Version |oldversion| or Greater
To upgrade a sharded cluster to |newversion|, **all** members of the
cluster must be at least version |oldversion|. The upgrade process checks
all components of the cluster and will produce warnings if any
component is running version earlier than |oldversion|.
- Config Server as Replica Set (CSRS)
Starting in |newversion|, the use of the deprecated mirrored
:binary:`~bin.mongod` instances as config servers (SCCC) is no longer
supported.
Before you can upgrade your sharded clusters to 3.4, you must
convert your config servers from SCCC to a replica set (CSRS). To
convert your config servers from SCCC to CSRS, see
:doc:`/tutorial/upgrade-config-servers-to-replica-set`.
- :ref:`Disable the balancer <sharding-balancing-disable-temporarily>`
- Back up the ``config`` Database
*Optional but Recommended.* As a precaution, take a backup of the
``config`` database *before* upgrading the sharded cluster.
Download |newversion| Binaries
------------------------------
Use Package Manager
~~~~~~~~~~~~~~~~~~~
.. include:: /includes/fact-upgrade-with-package-mgr.rst
Download |newversion| Binaries Manually
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you have not installed MongoDB using a package manager, you can
manually download the MongoDB binaries from the `MongoDB Download
Center <https://www.mongodb.com/download-center?jmp=docs>`_.
See |installationdoc| for more information.
Upgrade Process
---------------
.. include:: /includes/steps/3.4-upgrade-sharded-cluster.rst
Additional Upgrade Procedures
-----------------------------
- To upgrade a standalone, see :ref:`3.4-upgrade-standalone`.
- To upgrade a replica set, see :ref:`3.4-upgrade-replica-set`.