MCP Release Compatibility Matrix Q4`18 documentation

MCP Release Compatibility Matrix

MCP components compatibility matrices

The MCP components compatibility matrices included in this document are aimed to provide the deployment logic for a certain MCP release. By using the matrices, you will be able to:

  • Learn about the versions of MCP components that are included in a certain MCP release

  • Determine the potential upgrade paths between component versions when upgrading from one MCP version to another

Note

The versions compatibility between the MCP components does not necessarily mean that the Mirantis support currently covers all possible combinations of the components. For the official Mirantis support details, see Mirantis OpenStack Releases.


MCP version history

Version

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0 current release

Release date

26-Sep-2017

31-Jan-2018

24-Apr-2018

15-Aug-2018

04-Oct-2018

26-Nov-2018

08-Feb-2019

23-Jul-2020


MCP lifecycle management components compatibility matrix

Component

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0 current release

DriveTrain

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0

Aptly

0.9.7

1.2.0

1.2.0

1.3.0

1.3.0

1.3.0

1.3.0

1.3.0

aptly-publisher

0.12.4-1

0.12.4-1

0.12.11

0.12.11

0.12.11

0.12.11

0.12.12

0.12.12

Gerrit

2.13.6

2.13.6

2.13.6

2.13.6

2.13.6

2.13.6

2.13.6

2.15.17

jenkins-master

2.52

2.93

2.100

2.121.2, 2.100

2.121.2, 2.100

2.121.2, 2.121.3

2.138.3

2.150.3

Jenkins pipeline-library

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0

MAAS

2.3.0

2.3.0

2.3.0

2.3.3

2.3.3

2.3.5

2.3.5

2.3.5

OpenLDAP

2.4.40

2.4.40

2.4.40

2.4.40

2.4.40

2.4.40

2.4.44

2.4.44

PostgreSQL

9.6.2

9.6.6-1

9.6.6-1

9.6

9.6

9.6

9.6.10

9.6.10

Reclass

1.4.1

1.4.1

1.4.1

1.4.1-1tcp4

1.4.1-1tcp4

1.5.1-1tcp4

1.5.6-1.0~u16.04+mcp0

1.5.6-1.0~u16.04+mcp0

Reclass model

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0

SaltStack

2016.3

2016.3.8

2016.3.8

2017.7

2017.7

2017.7.7

2017.7.8

2017.7.8

Salt formulas

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0

sosreport

n/a

n/a

n/a

n/a

n/a

n/a

n/a

3.8.0-1~u16.04+mcp1 1


MCP operations support components compatibility matrix

Component

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0 current release

StackLight

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0

Alerta

-

-

-

5.2.0

5.2.0

5.6.10

6.5.0

6.5.0

Alertmanager

0.6.2

0.11.0

0.14.0

0.14.0

0.14.0

0.14.0

0.15.3

0.14.0

Ceilometer

version depends on OS version

version depends on OS version

- moved to OS

- moved to OS

- moved to OS

- moved to OS

- moved to OS

- moved to OS

Elasticsearch

2.4.5

5.6.5

5.6.5

5.6.9

5.6.9

5.6.12

6.5.2

6.8.0

Fluentd

-

-

1.0.2

1.0.2

1.0.2

1.0.2

1.2.6

1.2.6

Grafana

4.3.2

4.5.2

5.0.3

5.1.3

5.1.3

5.2.4

5.3.4

5.3.4

Heka

0.10.1

0.10.1

0.10.1

0.10.1

0.10.1

0.10.1

0.10.1

0.10.1

InfluxDB

1.3.3-1

1.4.2

1.4.2

1.5.2-1

1.5.2-1

1.5.2-1

1.5.2-1

1.5.2-1

jmx-exporter

-

-

0.10~20170912072743

0.10~20180716100330

0.10~20180716100330

1:0.9-2~u16.04+mcp21

1:0.9-2~u16.04+mcp21

2:0.3.2-2~u16.04+mcp4

Kibana

4.6.4

5.6.5

5.6.5

5.6.9

5.6.9

5.6.12

6.5.2

6.8.0

libvirt-exporter

-

-

0.1~20180319200151

0.1~20180319200151

0.1~20180319200151

0.1-1~u16.04+mcp0

0.1-1~u16.04+mcp0

0.1-1~u16.04+mcp8

MongoDB

-

-

-

2.6.10

2.6.10

2.6.10

2.6.10

2.6.10

Prometheus

1.6.3

2.0.0

2.2.1

2.2.1

2.2.1

2.2.1

2.5.0

2.12.0

Pushgateway

0.4.0

0.4.0

0.4.0

0.4.0

0.4.0

0.4.0

0.6.0

0.6.0

Telegraf

1.2

1.5

1.5.3

1.5.3

1.5.3

1.5.3

1.9.1

1.9.1


MCP infrastructure components compatibility matrix

Component

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0 current release

OpenStack

Kilo

-

-

-

-

-

-

-

Liberty

-

-

-

-

-

-

-

Mitaka

Mitaka

Mitaka

-

-

-

-

-

Ocata

Ocata

Ocata

Ocata

Ocata

Ocata

-

-

-

-

Pike

Pike

Pike

Pike

Pike

Pike

-

-

-

-

-

Queens

Queens

Queens

Aodh

-

-

P

P

P

P

P

P

Barbican

-

-

P

P

P

P

P

P

BGP VPN

-

-

P

P

P

P

P

P

Ceilometer

-

-

P

P

P

P

P

P

Cinder

*

*

*

*

*

*

*

*

Designate

-

-

O

O

O

O

O

O

Glance

*

*

*

*

*

*

*

*

Gnocchi

-

-

P

P

P

P

P

P

Heat

*

*

*

*

*

*

*

*

Horizon

*

*

*

*

*

*

*

*

Ironic

TechPr

TechPr

TechPr

TechPr

TechPr

TechPr

TechPr

Keystone

*

*

*

*

*

*

*

*

L2 Gateway

-

-

P

P

P

P

P

P

Manila

-

-

P

P

P

P

P

P Deprecation notice

Networking ODL ML2 plugin

-

-

P

P

P

P

P

P

Neutron

*

*

*

*

*

*

*

*

Nova

*

*

*

*

*

*

*

*

Octavia

-

-

-

-

-

P

P

P

Panko

-

-

P

P

P

P

P

P

Kubernetes

1.6, 1.7

1.7.5-2,
1.8.5-4 TechPr

1.8.11

1.10.4

1.10.4

1.11.3

1.12.4

1.13.6 Support termination notice

CNI-Genie

-

-

-

1.0-138

1.0-138

1.0-138

2.0-1

2.0-1

CNI plugins

-

-

-

0.7.1-48

0.7.1-48

0.7.1-48

0.7.2-151

0.7.2-173

CoreDNS

-

-

-

-

-

1.2.2-12

1.2.6-4

1.4.0

Dashboard

1.5.1

1.5.1

1.5.1

1.5.1

1.8.3

1.10.0-4

1.10.1-2

1.10.1-2

ExternalDNS

0.5.3

0.5.3

0.5.3

0.5.3

0.5.3

0.5.6-2

0.5.9-3

0.5.11

Flannel

-

-

-

0.10.0-amd64

0.10.0-amd64

0.10.0-amd64

0.10.0-amd64

0.10.0-amd64

MetalLB

-

-

-

0.6.2

0.6.2

0.7.3-2

0.7.3-2

0.7.3-2

Metrics Server

-

-

-

-

-

-

0.3.1

0.3.1

NGINX Ingress controller

-

-

-

-

-

0.19.0-1

0.21.0-3

0.23.0

OpenStack cloud provider

-

-

-

-

-

-

0.3.0-1

0.3.0-1

Virtlet

0.8.2

0.9.3

1.0.0

1.1.2

1.1.2

1.4.1

1.4.4

1.5.0

OpenContrail networking

OS O

OS O

OS O

OS O, P

OS, k8s

k8s, OS O, P, TechPr for Queens

OS O, P, Q

OS O, P, Q

Cassandra

2.1.20

2.1.20

2.1.20 OC 3.2

2.2.12 OC 4.0, 2.1.20 OC 3.2

2.2.12 OC 4.0, 2.1.20 OC 3.2

2.2.12

2.2.12 OC 4.0, 3.10 OC 4.1

2.2.12 OC 4.0, 3.10 OC 4.1

Kafka

0.10.2.0

2.9.2-0.8.2.0-0contrail0

2.9.2-0.8.2.0-0contrail0 OC 3.2

2.11-0.9.0.1-0contrail1 OC 4.0
2.9.2-0.-0contrail0 OC 3.2
2.11-0.9.0.1-0contrail1 OC 4.0
2.9.2-0.-0contrail0 OC 3.2

2.11-0.9.0.1-0contrail1

2.11-0.9.0.1-0contrail1 OC 4.0
confluent-kafka-2.11 1.1.1-1 OC 4.1
2.11-0.9.0.1-0contrail1 OC 4.0
confluent-kafka-2.11 1.1.1-1 OC 4.1

OpenContrail

3.1.1.x OS O
3.2.3.x OS O
3.1.1.x OS O
3.2.3.x OS O
3.2.3.x OS O
3.2.10.0 OS O
3.2.11.0 OS O
4.0.4.0 OS P
3.2.11.0 OS O
4.0.4.0 OS P, k8s

4.0.4.0 k8s, OS O, P, TechPr for Queens 0

4.0.4.0 OS P, Q 0
4.1.3.0 OS P, Q 0

4.1.4.0 OS P, Q

ZooKeeper

3.4.5

3.4.5

3.4.5 OC 3.2

3.4.8 OC 4.0
3.4.5 OC 3.2
3.4.8 OC 4.0
3.4.5 OC 3.2

3.4.8

3.4.8 OC 4.0
3.4.8-1 OC 4.1

3.4.8-1 OC 4.1

Calico networking k8s

Calico

2.3.0

2.6.1

2.6.1

2.6.10

2.6.10

3.1.3

3.3.1

3.3.1

Calico CNI

1.10.0

1.11.0

1.11.0

1.11.6

1.11.6

3.1.3

3.3.1

3.3.1

etcd

3.2.2

2.2.5

3.3.x

3.3.8

3.3.8

3.3.8

3.3.10

3.3.12

Ceph OS

Luminous,
Jewel

Luminous

Luminous

Luminous

Luminous

Luminous 12.2.8

Luminous 12.2.8

  • Nautilus 14.2.6

  • Luminous 12.2.13

RadosGW


MCP underlay system components compatibility matrix

Component

Q3-2017

2017.12

2018.4.0

2018.8.0

2018.8.0-milestone1

2018.11.0

2019.2.0

2019.2.0 current release

containerd k8s

-

-

-

-

-

-

1.2.1-1~u16.04+mcp

1.2.5-2~u16.04+mcp

CRI Proxy k8s

0.9.4

0.9.4

0.10.0

0.11.1

0.11.1

0.12.0

0.14.0

0.14.0

etcd Operator k8s

-

-

-

-

-

0.9.2

0.9.3

0.9.3

Docker

1.13

1.3.1

17.12.x SL OC CI/CD,
1.12.6 k8s
docker-ce 18.03.1 SL OC CI/CD,
docker-engine 1.13.1 k8s
docker-ce 18.03.1 SL OC CI/CD,
docker-engine 1.13.1 k8s
docker-ce 18.06.1 SL OC CI/CD,
docker-engine 1.13.1 k8s

docker-ce 5:18.09.0~3-0~ubuntu-xenial

docker-ce 5:18.09.0~3-0~ubuntu-xenial

Galera

25.3.10-1~u14.04+mcp1

25.3.14-1

25.3.14

25.3.14

25.3.14

25.3.14

25.3.14

25.3.20

Git

2.7.4-0ubuntu1

2.7.4

2.7.4

2.7.4

2.7.4

2.7.4

2.7.4

2.7.4

GlusterFS

3.7

3.8.15

3.8.15

3.8.15

3.8.15

3.8.15

3.8.15

5.5

HAProxy

1.6.3-1~u14.04+mcp1

1.6.3

1.6.3

1.6.3

1.6.3

1.6.3

1.6.3

1.6.3

libvirt

1.3.1

1.3.1

4.0.0-1.7~u16.04+mcp1

4.0.0-1.7~u16.04+mcp2

4.0.0-1.7~u16.04+mcp2

4.0.0-1.7~u16.04+mcp3

4.0.0-1.8.5~u16.04+mcp1

4.0.0-1.8.10~u16.04+mcp1

MySQL

5.6.23

5.6.35

5.6.35

5.6.35

5.6.35

5.6.35

5.6.35-0.1~u16.04+mcp2

5.6.41-1~u16.04+mcp1

NGINX

1.10.0-0ubuntu0.16.0

1.10.3

1.10.3

1.10.3

1.10.3

1.10.3

1.10.3

1.10.3

Open vSwitch

2.6

2.6.1

2.8.0-1~u16.04+mcp2

2.8.0-4~u16.04+mcp1

2.8.0-4~u16.04+mcp1

2.8.0-4~u16.04+mcp1

2.8.0-4~u16.04+mcp1

2.9.5-1~u16.04+mcp

QEMU

2.5

2.5

2.11+dfsg-1.1~u16.04+mcp1

2.11+dfsg-1.4~u16.04+mcp2

2.11+dfsg-1.4~u16.04+mcp2

2.11+dfsg-1.4~u16.04+mcp2

2.11+dfsg-1.4~u16.04+mcp2 Q,
2.11+dfsg-1.7.3~u16.04+mcp1 P
2.11+dfsg-1.7.13~u16.04+mcp3 Q,
2.11+dfsg-1.7.13~u16.04+mcp1 P

RabbitMQ

3.6.6-1~u14.04+mcp1

3.6.6-1~u14.04+mcp1

3.6.15-2~u16.04+mcp1

3.6.15-3~u16.04+mcp1

3.6.15-3~u16.04+mcp1

3.6.15-3~u16.04+mcp1

3.6.15-3~u16.04+mcp1

3.8.2-1~u16.04+mcp2

SR-IOV k8s

0.3-9

0.3-9

0.3-9

0.3-9

0.3-9

0.3-9

0.3-9

0.3-9

Ubuntu

16.04,
14.04 OC ntw&nal
16.04,
14.04 OC ntw&nal

16.04

16.04

16.04

16.04

16.04

16.04

Kernel

LTS 4.4.0.93.98,
HWE 4.10.0.33.35
LTS 4.4.0.103.108,
HWE 4.10.0.42.44

LTS 4.4.0.116

LTS 4.4.0.116

LTS 4.4.0.116

LTS 4.4.0.116 OS O
HWE 4.15.0.36
HWE 4.15.0.43.64 default
HWE 4.15.0.50.71 available
HWE 4.15.0.43.64 default
HWE 4.15.0.72.92 available

Notations

* - Available in all included OpenStack releases
O, P, Q - Available only starting from the specified letter release of OpenStack
k8s - Kubernetes reference
OC - OpenContrail reference
OC ntw&nal - OpenContrail network and analytics nodes
OS - OpenStack standard reference
TechPr - Available as technical preview only
SL OC CI/CD - StackLight, OpenContrail, and CI/CD nodes
0(1,2,3)

OpenContrail 3.2.x is not supported for new deployments. OpenContrail 4.0 is deprecated and not supported for new deployments since MCP maintenance update 2019.2.4.

1

Added since the MCP maintenance update 2019.2.7.

Supported upgrade paths

Caution

The upgrade and update procedures described in this section are available as technical preview. Use these procedures for testing and evaluation purposes only.

This section highlights the migration and upgrade paths that are supported for the MCP components with the links to corresponding procedures.

Caution

Before proceeding with any of the upgrade procedures, verify that you have updated DriveTrain including Aptly, Gerrit, Jenkins, Reclass, Salt formulas, and their subcomponents to the MCP release version that supports the version of the component you want to upgrade to. Otherwise, the related MCP product documentation cannot apply to your MCP deployment.

Supported upgrade paths

Component

From

To

Procedure

DriveTrain

Build ID 2018.11.0

Build ID 2019.2.0

MCP Operations Guide: Upgrade MCP to the Build ID 2019.2.0

Build ID below 2018.11.0

Build ID 2018.11.0

MCP Operations Guide: Upgrade MCP to the Build ID 2018.11.0

Note

If your MCP version is not tagged with a Build ID, contact Mirantis support for further details.

OpenStack

Ocata
Pike
Pike
Queens

MCP Operations Guide: Upgrade an MCP OpenStack environment

Kubernetes

1.8 or 1.10

1.12

MCP Operations Guide: Update or upgrade Kubernetes

Calico

2.6

3.3

MCP Operations Guide: Automatically update or upgrade Kubernetes

OpenContrail

3.2

4.x

MCP Operations Guide: Upgrade the OpenContrail nodes from version 3.2 to 4.x

Note

To update OpenContrail from version 4.0 to 4.1, see: MCP Operations Guide: Update the OpenContrail 4.x nodes.

StackLight LMA

Build ID 2018.11.0

Build ID 2019.2.0

MCP Operations Guide: Upgrade StackLight LMA to Build ID 2019.2.0

Build ID below 2018.11.0

Build ID 2018.11.0

MCP Operations Guide: Upgrade StackLight LMA to Build ID 2018.11.0