Install Guide - OpenStack

Install Guide

OpenStack contributors

Jan 04, 2024

CONTENTS

1 Conventions

1

1.1 Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1.2 Command prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2 Preface

3

2.1 Abstract . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2.2 Operating systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3 Get started with OpenStack

5

3.1 The OpenStack services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2 The OpenStack architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3.2.1 Conceptual architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.2.2 Logical architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

4 Overview

9

4.1 Example architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.1.1 Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.1.2 Compute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.1.3 Block Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.1.4 Object Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.2 Networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.2.1 Networking Option 1: Provider networks . . . . . . . . . . . . . . . . . . . . 12

4.2.2 Networking Option 2: Self-service networks . . . . . . . . . . . . . . . . . . . 13

5 Environment

15

5.1 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

5.2 Host networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

5.2.1 Controller node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

5.2.2 Compute node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

5.2.3 Block storage node (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . . 22

5.2.4 Verify connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.3 Network Time Protocol (NTP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

5.3.1 Controller node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

5.3.2 Other nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

5.3.3 Verify operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

5.4 OpenStack packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

5.4.1 OpenStack packages for SUSE . . . . . . . . . . . . . . . . . . . . . . . . . . 28

5.4.2 OpenStack packages for RHEL and CentOS . . . . . . . . . . . . . . . . . . . 30

5.4.3 OpenStack packages for Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . 33

i

5.5 SQL database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 5.5.1 SQL database for SUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 5.5.2 SQL database for RHEL and CentOS . . . . . . . . . . . . . . . . . . . . . . 35 5.5.3 SQL database for Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5.6 Message queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.6.1 Message queue for SUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 5.6.2 Message queue for RHEL and CentOS . . . . . . . . . . . . . . . . . . . . . . 38 5.6.3 Message queue for Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

5.7 Memcached . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 5.7.1 Memcached for SUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 5.7.2 Memcached for RHEL and CentOS . . . . . . . . . . . . . . . . . . . . . . . 41 5.7.3 Memcached for Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

5.8 Etcd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 5.8.1 Etcd for SUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 5.8.2 Etcd for RHEL and CentOS . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 5.8.3 Etcd for Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6 Install OpenStack services

47

6.1 Minimal deployment for 2023.2 (Bobcat) . . . . . . . . . . . . . . . . . . . . . . . . . 47

6.2 Minimal deployment for 2023.1 (Antelope) . . . . . . . . . . . . . . . . . . . . . . . . 48

6.3 Minimal deployment for Zed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

6.4 Minimal deployment for Yoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

6.5 Minimal deployment for Xena . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6.6 Minimal deployment for Wallaby . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6.7 Minimal deployment for Victoria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

6.8 Minimal deployment for Ussuri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

6.9 Minimal deployment for Train . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

6.10 Minimal deployment for Stein . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

7 Launch an instance

53

7.1 Create virtual networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

7.1.1 Provider network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

7.1.2 Self-service network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

7.2 Create m1.nano flavor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

7.3 Generate a key pair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

7.4 Add security group rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

7.5 Launch an instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

7.5.1 Launch an instance on the provider network . . . . . . . . . . . . . . . . . . . 66

7.5.2 Launch an instance on the self-service network . . . . . . . . . . . . . . . . . 71

7.6 Block Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

7.6.1 Block Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

7.7 Orchestration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

7.8 Shared File Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

8 Firewalls and default ports

81

9 Appendix

83

9.1 Community support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

9.1.1 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

9.1.2 The OpenStack wiki . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

9.1.3 The Launchpad bugs area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

9.1.4 Documentation feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

ii

9.1.5 The OpenStack IRC channel . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 9.1.6 OpenStack mailing lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 9.1.7 OpenStack distribution packages . . . . . . . . . . . . . . . . . . . . . . . . . 86 9.2 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 9.2.1 0-9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 9.2.2 A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 9.2.3 B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 9.2.4 C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 9.2.5 D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 9.2.6 E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 9.2.7 F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 9.2.8 G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 9.2.9 H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 9.2.10 I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 9.2.11 J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 9.2.12 K . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 9.2.13 L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 9.2.14 M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 9.2.15 N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 9.2.16 O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 9.2.17 P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 9.2.18 Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 9.2.19 R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 9.2.20 S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 9.2.21 T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 9.2.22 U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 9.2.23 V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 9.2.24 W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 9.2.25 X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 9.2.26 Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 9.2.27 Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Index

137

iii

iv

CHAPTER

ONE

CONVENTIONS

The OpenStack documentation uses several typesetting conventions.

1.1 Notices

Notices take these forms: Note: A comment with additional information that explains a part of the text. Important: Something you must be aware of before proceeding. Tip: An extra but helpful piece of practical advice.

Caution: Helpful information that prevents the user from making mistakes.

Warning: Critical information about the risk of data loss or security issues.

1.2 Command prompts

$ command Any user, including the root user, can run commands that are prefixed with the $ prompt. # command The root user must run commands that are prefixed with the # prompt. You can also prefix these commands with the sudo command, if available, to run them.

1

Install Guide

2

Chapter 1. Conventions

................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download