# SOME DESCRIPTIVE TITLE. # Copyright (C) 2015-2020, OpenStack contributors # This file is distributed under the same license as the Installation Guide package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Installation Guide \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-05-17 07:16+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../environment-etcd-obs.rst:3 msgid "Etcd for SUSE" msgstr "" #: ../environment-etcd-obs.rst:5 msgid "" "Right now, there is no distro package available for etcd3. This guide uses " "the tarball installation as a workaround until proper distro packages are " "available." msgstr "" #: ../environment-etcd-obs.rst:9 ../environment-etcd-rdo.rst:9 #: ../environment-etcd-ubuntu.rst:9 msgid "The etcd service runs on the controller node." msgstr "" #: ../environment-etcd-obs.rst:12 ../environment-etcd-rdo.rst:12 #: ../environment-etcd-ubuntu.rst:12 ../environment-memcached-obs.rst:10 #: ../environment-memcached-rdo.rst:10 ../environment-memcached-ubuntu.rst:10 #: ../environment-messaging-obs.rst:18 ../environment-messaging-rdo.rst:18 #: ../environment-messaging-ubuntu.rst:18 ../environment-ntp-controller.rst:10 #: ../environment-ntp-other.rst:11 ../environment-sql-database-obs.rst:11 #: ../environment-sql-database-rdo.rst:11 #: ../environment-sql-database-ubuntu.rst:26 msgid "Install and configure components" msgstr "" #: ../environment-etcd-obs.rst:14 msgid "Install etcd:" msgstr "" #: ../environment-etcd-obs.rst:16 msgid "Create etcd user:" msgstr "" #: ../environment-etcd-obs.rst:27 msgid "Create the necessary directories:" msgstr "" #: ../environment-etcd-obs.rst:36 msgid "Determine your system architecture:" msgstr "" #: ../environment-etcd-obs.rst:42 msgid "Download and install the etcd tarball for x86_64/amd64:" msgstr "" #: ../environment-etcd-obs.rst:56 msgid "Or download and install the etcd tarball for arm64:" msgstr "" #: ../environment-etcd-obs.rst:70 msgid "" "Create and edit the ``/etc/etcd/etcd.conf.yml`` file and set the ``initial-" "cluster``, ``initial-advertise-peer-urls``, ``advertise-client-urls``, " "``listen-client-urls`` to the management IP address of the controller node " "to enable access by other nodes via the management network:" msgstr "" #: ../environment-etcd-obs.rst:88 msgid "Create and edit the ``/usr/lib/systemd/system/etcd.service`` file:" msgstr "" #: ../environment-etcd-obs.rst:108 msgid "Reload systemd service files with:" msgstr "" #: ../environment-etcd-obs.rst:116 ../environment-etcd-rdo.rst:41 #: ../environment-etcd-ubuntu.rst:45 ../environment-memcached-obs.rst:34 #: ../environment-memcached-rdo.rst:42 ../environment-memcached-ubuntu.rst:39 #: ../environment-sql-database-obs.rst:40 #: ../environment-sql-database-rdo.rst:42 #: ../environment-sql-database-ubuntu.rst:63 msgid "Finalize installation" msgstr "" #: ../environment-etcd-obs.rst:118 ../environment-etcd-rdo.rst:43 msgid "Enable and start the etcd service:" msgstr "" #: ../environment-etcd-rdo.rst:3 msgid "Etcd for RHEL and CentOS" msgstr "" #: ../environment-etcd-rdo.rst:5 ../environment-etcd-ubuntu.rst:5 #: ../environment-etcd.rst:5 msgid "" "OpenStack services may use Etcd, a distributed reliable key-value store for " "distributed key locking, storing configuration, keeping track of service " "live-ness and other scenarios." msgstr "" #: ../environment-etcd-rdo.rst:14 ../environment-messaging-obs.rst:20 #: ../environment-messaging-rdo.rst:20 ../environment-messaging-ubuntu.rst:20 msgid "Install the package:" msgstr "" #: ../environment-etcd-rdo.rst:20 msgid "" "Edit the ``/etc/etcd/etcd.conf`` file and set the ``ETCD_INITIAL_CLUSTER``, " "``ETCD_INITIAL_ADVERTISE_PEER_URLS``, ``ETCD_ADVERTISE_CLIENT_URLS``, " "``ETCD_LISTEN_CLIENT_URLS`` to the management IP address of the controller " "node to enable access by other nodes via the management network:" msgstr "" #: ../environment-etcd-ubuntu.rst:3 msgid "Etcd for Ubuntu" msgstr "" #: ../environment-etcd-ubuntu.rst:14 msgid "Install the ``etcd`` package:" msgstr "" #: ../environment-etcd-ubuntu.rst:22 msgid "" "As of Ubuntu 18.04, the ``etcd`` package is no longer available from the " "default repository. To install successfully, enable the ``Universe`` " "repository on Ubuntu." msgstr "" #: ../environment-etcd-ubuntu.rst:26 msgid "" "Edit the ``/etc/default/etcd`` file and set the ``ETCD_INITIAL_CLUSTER``, " "``ETCD_INITIAL_ADVERTISE_PEER_URLS``, ``ETCD_ADVERTISE_CLIENT_URLS``, " "``ETCD_LISTEN_CLIENT_URLS`` to the management IP address of the controller " "node to enable access by other nodes via the management network:" msgstr "" #: ../environment-etcd-ubuntu.rst:47 msgid "Enable and restart the etcd service:" msgstr "" #: ../environment-etcd.rst:3 msgid "Etcd" msgstr "" #: ../environment-memcached-obs.rst:2 msgid "Memcached for SUSE" msgstr "" #: ../environment-memcached-obs.rst:4 ../environment-memcached-rdo.rst:4 #: ../environment-memcached-ubuntu.rst:4 ../environment-memcached.rst:4 msgid "" "The Identity service authentication mechanism for services uses Memcached to " "cache tokens. The memcached service typically runs on the controller node. " "For production deployments, we recommend enabling a combination of " "firewalling, authentication, and encryption to secure it." msgstr "" #: ../environment-memcached-obs.rst:12 ../environment-memcached-rdo.rst:12 #: ../environment-memcached-ubuntu.rst:12 ../environment-ntp-controller.rst:12 #: ../environment-sql-database-obs.rst:13 #: ../environment-sql-database-rdo.rst:13 #: ../environment-sql-database-ubuntu.rst:28 msgid "Install the packages:" msgstr "" #: ../environment-memcached-obs.rst:18 ../environment-memcached-rdo.rst:26 msgid "" "Edit the ``/etc/sysconfig/memcached`` file and complete the following " "actions:" msgstr "" #: ../environment-memcached-obs.rst:21 ../environment-memcached-rdo.rst:29 msgid "" "Configure the service to use the management IP address of the controller " "node. This is to enable access by other nodes via the management network:" msgstr "" #: ../environment-memcached-obs.rst:31 msgid "Change the existing line ``MEMCACHED_PARAMS=\"-l 127.0.0.1\"``." msgstr "" #: ../environment-memcached-obs.rst:36 ../environment-memcached-rdo.rst:44 msgid "" "Start the Memcached service and configure it to start when the system boots:" msgstr "" #: ../environment-memcached-rdo.rst:2 msgid "Memcached for RHEL and CentOS" msgstr "" #: ../environment-memcached-rdo.rst:14 msgid "**For CentOS 7 and RHEL 7**" msgstr "" #: ../environment-memcached-rdo.rst:20 msgid "**For CentOS 8 and RHEL 8**" msgstr "" #: ../environment-memcached-rdo.rst:39 msgid "Change the existing line ``OPTIONS=\"-l 127.0.0.1,::1\"``." msgstr "" #: ../environment-memcached-ubuntu.rst:2 msgid "Memcached for Ubuntu" msgstr "" #: ../environment-memcached-ubuntu.rst:14 msgid "For Ubuntu versions prior to 18.04 use:" msgstr "" #: ../environment-memcached-ubuntu.rst:20 msgid "For Ubuntu 18.04 and newer versions use:" msgstr "" #: ../environment-memcached-ubuntu.rst:26 msgid "" "Edit the ``/etc/memcached.conf`` file and configure the service to use the " "management IP address of the controller node. This is to enable access by " "other nodes via the management network:" msgstr "" #: ../environment-memcached-ubuntu.rst:36 msgid "Change the existing line that had ``-l 127.0.0.1``." msgstr "" #: ../environment-memcached-ubuntu.rst:41 msgid "Restart the Memcached service:" msgstr "" #: ../environment-memcached.rst:2 msgid "Memcached" msgstr "" #: ../environment-messaging-obs.rst:2 msgid "Message queue for SUSE" msgstr "" #: ../environment-messaging-obs.rst:4 ../environment-messaging-rdo.rst:4 #: ../environment-messaging-ubuntu.rst:4 ../environment-messaging.rst:4 msgid "" "OpenStack uses a :term:`message queue` to coordinate operations and status " "information among services. The message queue service typically runs on the " "controller node. OpenStack supports several message queue services including " "`RabbitMQ `__, `Qpid `__, " "and `ZeroMQ `__. However, most distributions that package " "OpenStack support a particular message queue service. This guide implements " "the RabbitMQ message queue service because most distributions support it. If " "you prefer to implement a different message queue service, consult the " "documentation associated with it." msgstr "" #: ../environment-messaging-obs.rst:15 ../environment-messaging-rdo.rst:15 #: ../environment-messaging-ubuntu.rst:15 ../environment-messaging.rst:15 msgid "The message queue runs on the controller node." msgstr "" #: ../environment-messaging-obs.rst:26 ../environment-messaging-rdo.rst:26 msgid "" "Start the message queue service and configure it to start when the system " "boots:" msgstr "" #: ../environment-messaging-obs.rst:34 ../environment-messaging-rdo.rst:34 #: ../environment-messaging-ubuntu.rst:26 msgid "Add the ``openstack`` user:" msgstr "" #: ../environment-messaging-obs.rst:42 ../environment-messaging-rdo.rst:42 #: ../environment-messaging-ubuntu.rst:34 msgid "Replace ``RABBIT_PASS`` with a suitable password." msgstr "" #: ../environment-messaging-obs.rst:44 ../environment-messaging-rdo.rst:44 #: ../environment-messaging-ubuntu.rst:36 msgid "" "Permit configuration, write, and read access for the ``openstack`` user:" msgstr "" #: ../environment-messaging-rdo.rst:2 msgid "Message queue for RHEL and CentOS" msgstr "" #: ../environment-messaging-ubuntu.rst:2 msgid "Message queue for Ubuntu" msgstr "" #: ../environment-messaging.rst:2 msgid "Message queue" msgstr "" #: ../environment-networking-compute.rst:2 msgid "Compute node" msgstr "" #: ../environment-networking-compute.rst:5 #: ../environment-networking-controller.rst:5 #: ../environment-networking-storage-cinder.rst:8 msgid "Configure network interfaces" msgstr "" #: ../environment-networking-compute.rst:7 #: ../environment-networking-controller.rst:7 msgid "Configure the first interface as the management interface:" msgstr "" #: ../environment-networking-compute.rst:9 msgid "IP address: 10.0.0.31" msgstr "" #: ../environment-networking-compute.rst:11 #: ../environment-networking-controller.rst:11 msgid "Network mask: 255.255.255.0 (or /24)" msgstr "" #: ../environment-networking-compute.rst:13 #: ../environment-networking-controller.rst:13 msgid "Default gateway: 10.0.0.1" msgstr "" #: ../environment-networking-compute.rst:17 msgid "Additional compute nodes should use 10.0.0.32, 10.0.0.33, and so on." msgstr "" #: ../environment-networking-compute.rst:19 #: ../environment-networking-controller.rst:15 msgid "" "The provider interface uses a special configuration without an IP address " "assigned to it. Configure the second interface as the provider interface:" msgstr "" #: ../environment-networking-compute.rst:23 #: ../environment-networking-controller.rst:19 msgid "" "Replace ``INTERFACE_NAME`` with the actual interface name. For example, " "*eth1* or *ens224*." msgstr "" #: ../environment-networking-compute.rst:26 #: ../environment-networking-controller.rst:22 #: ../environment-ntp-controller.rst:14 ../environment-ntp-controller.rst:70 #: ../environment-ntp-other.rst:15 ../environment-ntp-other.rst:52 msgid "For Ubuntu:" msgstr "" #: ../environment-networking-compute.rst:28 #: ../environment-networking-controller.rst:24 msgid "Edit the ``/etc/network/interfaces`` file to contain the following:" msgstr "" #: ../environment-networking-compute.rst:38 #: ../environment-networking-controller.rst:34 #: ../environment-ntp-controller.rst:20 ../environment-ntp-other.rst:21 msgid "For RHEL or CentOS:" msgstr "" #: ../environment-networking-compute.rst:40 #: ../environment-networking-controller.rst:36 msgid "" "Edit the ``/etc/sysconfig/network-scripts/ifcfg-INTERFACE_NAME`` file to " "contain the following:" msgstr "" #: ../environment-networking-compute.rst:43 #: ../environment-networking-controller.rst:39 msgid "Do not change the ``HWADDR`` and ``UUID`` keys." msgstr "" #: ../environment-networking-compute.rst:52 #: ../environment-networking-controller.rst:48 #: ../environment-ntp-controller.rst:26 ../environment-ntp-other.rst:27 msgid "For SUSE:" msgstr "" #: ../environment-networking-compute.rst:54 #: ../environment-networking-controller.rst:50 msgid "" "Edit the ``/etc/sysconfig/network/ifcfg-INTERFACE_NAME`` file to contain the " "following:" msgstr "" #: ../environment-networking-compute.rst:62 #: ../environment-networking-controller.rst:58 #: ../environment-networking-storage-cinder.rst:25 msgid "Reboot the system to activate the changes." msgstr "" #: ../environment-networking-compute.rst:65 #: ../environment-networking-controller.rst:61 #: ../environment-networking-storage-cinder.rst:19 msgid "Configure name resolution" msgstr "" #: ../environment-networking-compute.rst:67 msgid "Set the hostname of the node to ``compute1``." msgstr "" #: ../environment-networking-controller.rst:2 #: ../environment-ntp-controller.rst:5 msgid "Controller node" msgstr "" #: ../environment-networking-controller.rst:9 msgid "IP address: 10.0.0.11" msgstr "" #: ../environment-networking-controller.rst:63 msgid "Set the hostname of the node to ``controller``." msgstr "" #: ../environment-networking-storage-cinder.rst:2 msgid "Block storage node (Optional)" msgstr "" #: ../environment-networking-storage-cinder.rst:4 msgid "" "If you want to deploy the Block Storage service, configure one additional " "storage node." msgstr "" #: ../environment-networking-storage-cinder.rst:10 msgid "Configure the management interface:" msgstr "" #: ../environment-networking-storage-cinder.rst:12 msgid "IP address: ``10.0.0.41``" msgstr "" #: ../environment-networking-storage-cinder.rst:14 msgid "Network mask: ``255.255.255.0`` (or ``/24``)" msgstr "" #: ../environment-networking-storage-cinder.rst:16 msgid "Default gateway: ``10.0.0.1``" msgstr "" #: ../environment-networking-storage-cinder.rst:21 msgid "Set the hostname of the node to ``block1``." msgstr "" #: ../environment-networking-verify.rst:2 msgid "Verify connectivity" msgstr "" #: ../environment-networking-verify.rst:4 msgid "" "We recommend that you verify network connectivity to the Internet and among " "the nodes before proceeding further." msgstr "" #: ../environment-networking-verify.rst:7 msgid "From the *controller* node, test access to the Internet:" msgstr "" #: ../environment-networking-verify.rst:23 msgid "" "From the *controller* node, test access to the management interface on the " "*compute* node:" msgstr "" #: ../environment-networking-verify.rst:40 msgid "From the *compute* node, test access to the Internet:" msgstr "" #: ../environment-networking-verify.rst:56 msgid "" "From the *compute* node, test access to the management interface on the " "*controller* node:" msgstr "" #: ../environment-networking-verify.rst:75 msgid "" "RHEL, CentOS and SUSE distributions enable a restrictive :term:`firewall` by " "default. During the installation process, certain steps will fail unless you " "alter or disable the firewall. For more information about securing your " "environment, refer to the `OpenStack Security Guide `_." msgstr "" #: ../environment-networking-verify.rst:81 msgid "" "Ubuntu does not enable a restrictive :term:`firewall` by default. For more " "information about securing your environment, refer to the `OpenStack " "Security Guide `_." msgstr "" #: ../environment-networking.rst:4 msgid "Host networking" msgstr "" #: ../environment-networking.rst:6 msgid "" "After installing the operating system on each node for the architecture that " "you choose to deploy, you must configure the network interfaces. We " "recommend that you disable any automated network management tools and " "manually edit the appropriate configuration files for your distribution. For " "more information on how to configure networking on your distribution, see " "the documentation." msgstr "" #: ../environment-networking.rst:15 msgid "" "`Ubuntu Network Configuration `__" msgstr "" #: ../environment-networking.rst:17 msgid "" "`RHEL 7 `__ or `RHEL 8 " "`__ Network Configuration" msgstr "" #: ../environment-networking.rst:21 msgid "" "`SLES 12 `__ or `SLES 15 `__ or " "`openSUSE `__ Network Configuration" msgstr "" #: ../environment-networking.rst:28 msgid "" "All nodes require Internet access for administrative purposes such as " "package installation, security updates, :term:`DNS `, and :term:`NTP `. In most cases, nodes " "should obtain Internet access through the management network interface. To " "highlight the importance of network separation, the example architectures " "use `private address space `__ for the " "management network and assume that the physical network infrastructure " "provides Internet access via :term:`NAT ` " "or other methods. The example architectures use routable IP address space " "for the provider (external) network and assume that the physical network " "infrastructure provides direct Internet access." msgstr "" #: ../environment-networking.rst:40 msgid "" "In the provider networks architecture, all instances attach directly to the " "provider network. In the self-service (private) networks architecture, " "instances can attach to a self-service or provider network. Self-service " "networks can reside entirely within OpenStack or provide some level of " "external network access using :term:`NAT ` through the provider network." msgstr "" #: ../environment-networking.rst:52 msgid "The example architectures assume use of the following networks:" msgstr "" #: ../environment-networking.rst:54 msgid "Management on 10.0.0.0/24 with gateway 10.0.0.1" msgstr "" #: ../environment-networking.rst:56 msgid "" "This network requires a gateway to provide Internet access to all nodes for " "administrative purposes such as package installation, security updates, :" "term:`DNS `, and :term:`NTP `." msgstr "" #: ../environment-networking.rst:61 msgid "Provider on 203.0.113.0/24 with gateway 203.0.113.1" msgstr "" #: ../environment-networking.rst:63 msgid "" "This network requires a gateway to provide Internet access to instances in " "your OpenStack environment." msgstr "" #: ../environment-networking.rst:66 msgid "" "You can modify these ranges and gateways to work with your particular " "network infrastructure." msgstr "" #: ../environment-networking.rst:69 msgid "" "Network interface names vary by distribution. Traditionally, interfaces use " "``eth`` followed by a sequential number. To cover all variations, this guide " "refers to the first interface as the interface with the lowest number and " "the second interface as the interface with the highest number." msgstr "" #: ../environment-networking.rst:77 msgid "" "Ubuntu has changed the network interface naming concept. Refer `Changing " "Network Interfaces name Ubuntu 16.04 `_." msgstr "" #: ../environment-networking.rst:80 msgid "" "Unless you intend to use the exact configuration provided in this example " "architecture, you must modify the networks in this procedure to match your " "environment. Each node must resolve the other nodes by name in addition to " "IP address. For example, the ``controller`` name must resolve to " "``10.0.0.11``, the IP address of the management interface on the controller " "node." msgstr "" #: ../environment-networking.rst:89 msgid "" "Reconfiguring network interfaces will interrupt network connectivity. We " "recommend using a local terminal session for these procedures." msgstr "" #: ../environment-networking.rst:95 msgid "" "RHEL, CentOS and SUSE distributions enable a restrictive :term:`firewall` by " "default. Ubuntu does not. For more information about securing your " "environment, refer to the `OpenStack Security Guide `_." msgstr "" #: ../environment-networking.rst:-1 msgid "Network layout" msgstr "" #: ../environment-ntp-controller.rst:7 msgid "Perform these steps on the controller node." msgstr "" #: ../environment-ntp-controller.rst:32 msgid "" "Edit the ``chrony.conf`` file and add, change, or remove the following keys " "as necessary for your environment." msgstr "" #: ../environment-ntp-controller.rst:35 ../environment-ntp-other.rst:36 msgid "For RHEL, CentOS, or SUSE, edit the ``/etc/chrony.conf`` file:" msgstr "" #: ../environment-ntp-controller.rst:41 ../environment-ntp-other.rst:42 msgid "For Ubuntu, edit the ``/etc/chrony/chrony.conf`` file:" msgstr "" #: ../environment-ntp-controller.rst:47 msgid "" "Replace ``NTP_SERVER`` with the hostname or IP address of a suitable more " "accurate (lower stratum) NTP server. The configuration supports multiple " "``server`` keys." msgstr "" #: ../environment-ntp-controller.rst:53 msgid "" "By default, the controller node synchronizes the time via a pool of public " "servers. However, you can optionally configure alternative servers such as " "those provided by your organization." msgstr "" #: ../environment-ntp-controller.rst:57 msgid "" "To enable other nodes to connect to the chrony daemon on the controller " "node, add this key to the same ``chrony.conf`` file mentioned above:" msgstr "" #: ../environment-ntp-controller.rst:65 msgid "" "If necessary, replace ``10.0.0.0/24`` with a description of your subnet." msgstr "" #: ../environment-ntp-controller.rst:68 msgid "Restart the NTP service:" msgstr "" #: ../environment-ntp-controller.rst:76 ../environment-ntp-other.rst:58 msgid "For RHEL, CentOS, or SUSE:" msgstr "" #: ../environment-ntp-other.rst:5 msgid "Other nodes" msgstr "" #: ../environment-ntp-other.rst:7 msgid "" "Other nodes reference the controller node for clock synchronization. Perform " "these steps on all other nodes." msgstr "" #: ../environment-ntp-other.rst:13 msgid "Install the packages." msgstr "" #: ../environment-ntp-other.rst:33 msgid "" "Configure the ``chrony.conf`` file and comment out or remove all but one " "``server`` key. Change it to reference the controller node." msgstr "" #: ../environment-ntp-other.rst:48 msgid "Comment out the ``pool 2.debian.pool.ntp.org offline iburst`` line." msgstr "" #: ../environment-ntp-other.rst:50 msgid "Restart the NTP service." msgstr "" #: ../environment-ntp-verify.rst:4 #: ../launch-instance-networks-selfservice.rst:213 msgid "Verify operation" msgstr "" #: ../environment-ntp-verify.rst:6 msgid "" "We recommend that you verify NTP synchronization before proceeding further. " "Some nodes, particularly those that reference the controller node, can take " "several minutes to synchronize." msgstr "" #: ../environment-ntp-verify.rst:10 msgid "Run this command on the *controller* node:" msgstr "" #: ../environment-ntp-verify.rst:22 msgid "" "Contents in the *Name/IP address* column should indicate the hostname or IP " "address of one or more NTP servers. Contents in the *MS* column should " "indicate *\\** for the server to which the NTP service is currently " "synchronized." msgstr "" #: ../environment-ntp-verify.rst:26 msgid "Run the same command on *all other* nodes:" msgstr "" #: ../environment-ntp-verify.rst:37 msgid "" "Contents in the *Name/IP address* column should indicate the hostname of the " "controller node." msgstr "" #: ../environment-ntp.rst:4 msgid "Network Time Protocol (NTP)" msgstr "" #: ../environment-ntp.rst:6 msgid "" "To properly synchronize services among nodes, you can install Chrony, an " "implementation of :term:`NTP `. We recommend " "that you configure the controller node to reference more accurate (lower " "stratum) servers and other nodes to reference the controller node." msgstr "" #: ../environment-packages-obs.rst:2 msgid "OpenStack packages for SUSE" msgstr "" #: ../environment-packages-obs.rst:4 ../environment-packages.rst:4 msgid "" "Distributions release OpenStack packages as part of the distribution or " "using other methods because of differing release schedules. Perform these " "procedures on all nodes." msgstr "" #: ../environment-packages-obs.rst:10 ../environment-packages.rst:10 msgid "" "The set up of OpenStack packages described here needs to be done on all " "nodes: controller, compute, and Block Storage nodes." msgstr "" #: ../environment-packages-obs.rst:15 ../environment-packages-rdo.rst:14 #: ../environment-packages.rst:15 msgid "" "Your hosts must contain the latest versions of base installation packages " "available for your distribution before proceeding further." msgstr "" #: ../environment-packages-obs.rst:20 ../environment-packages-rdo.rst:29 #: ../environment-packages.rst:20 msgid "" "Disable or remove any automatic update services because they can impact your " "OpenStack environment." msgstr "" #: ../environment-packages-obs.rst:25 ../environment-packages-rdo.rst:100 #: ../environment-packages-rdo.rst:213 msgid "Enable the OpenStack repository" msgstr "" #: ../environment-packages-obs.rst:27 msgid "" "Enable the Open Build Service repositories based on your openSUSE or SLES " "version, and on the version of OpenStack you want to install:" msgstr "" #: ../environment-packages-obs.rst:30 msgid "**On openSUSE for OpenStack Ussuri:**" msgstr "" #: ../environment-packages-obs.rst:36 msgid "**On openSUSE for OpenStack Train:**" msgstr "" #: ../environment-packages-obs.rst:42 msgid "**On openSUSE for OpenStack Stein:**" msgstr "" #: ../environment-packages-obs.rst:48 msgid "**On openSUSE for OpenStack Rocky:**" msgstr "" #: ../environment-packages-obs.rst:54 msgid "**On openSUSE for OpenStack Queens:**" msgstr "" #: ../environment-packages-obs.rst:60 msgid "**On openSUSE for OpenStack Pike:**" msgstr "" #: ../environment-packages-obs.rst:68 msgid "" "The openSUSE distribution uses the concept of patterns to represent " "collections of packages. If you selected 'Minimal Server Selection (Text " "Mode)' during the initial installation, you may be presented with a " "dependency conflict when you attempt to install the OpenStack packages. To " "avoid this, remove the minimal\\_base-conflicts package:" msgstr "" #: ../environment-packages-obs.rst:79 msgid "**On SLES for OpenStack Ussuri:**" msgstr "" #: ../environment-packages-obs.rst:85 msgid "**On SLES for OpenStack Train:**" msgstr "" #: ../environment-packages-obs.rst:91 msgid "**On SLES for OpenStack Stein:**" msgstr "" #: ../environment-packages-obs.rst:97 msgid "**On SLES for OpenStack Rocky:**" msgstr "" #: ../environment-packages-obs.rst:103 msgid "**On SLES for OpenStack Queens:**" msgstr "" #: ../environment-packages-obs.rst:109 msgid "**On SLES for OpenStack Pike:**" msgstr "" #: ../environment-packages-obs.rst:117 msgid "" "The packages are signed by GPG key ``D85F9316``. You should verify the " "fingerprint of the imported GPG key before using it." msgstr "" #: ../environment-packages-obs.rst:128 ../environment-packages-rdo.rst:140 msgid "Finalize the installation" msgstr "" #: ../environment-packages-obs.rst:130 ../environment-packages-rdo.rst:142 msgid "Upgrade the packages on all nodes:" msgstr "" #: ../environment-packages-obs.rst:138 ../environment-packages-rdo.rst:150 msgid "" "If the upgrade process includes a new kernel, reboot your host to activate " "it." msgstr "" #: ../environment-packages-obs.rst:141 msgid "Install the OpenStack client:" msgstr "" #: ../environment-packages-rdo.rst:3 msgid "OpenStack packages for RHEL and CentOS" msgstr "" #: ../environment-packages-rdo.rst:5 msgid "Contents" msgstr "" #: ../environment-packages-rdo.rst:7 msgid "" "Distributions release OpenStack packages as part of the distribution or " "using other methods because of differing release schedules. **Perform these " "procedures on all nodes (controller, compute, network, dashboard, storage " "etc. nodes).**" msgstr "" #: ../environment-packages-rdo.rst:19 msgid "" "The following instructions refer to RDO: a free, community supported " "distribution of OpenStack for RHEL and CentOS. For the Red Hat-supported " "*Red Hat OpenStack Platform*, `see here `_." msgstr "" #: ../environment-packages-rdo.rst:24 msgid "" "According to RDO Packstack documentation, RDO should work on RHEL but is " "currently only tested on CentOS Stream." msgstr "" #: ../environment-packages-rdo.rst:33 msgid "Operating System" msgstr "" #: ../environment-packages-rdo.rst:35 msgid "**Operating System**" msgstr "" #: ../environment-packages-rdo.rst:38 msgid "OS" msgstr "" #: ../environment-packages-rdo.rst:39 msgid "Compatible Releases" msgstr "" #: ../environment-packages-rdo.rst:40 msgid "Maintained Releases" msgstr "" #: ../environment-packages-rdo.rst:41 msgid "CentOS 7 / RHEL 7" msgstr "" #: ../environment-packages-rdo.rst:42 msgid "? to Train" msgstr "" #: ../environment-packages-rdo.rst:43 ../environment-packages-rdo.rst:46 msgid "*None*" msgstr "" #: ../environment-packages-rdo.rst:44 msgid "CentOS Stream 8 / RHEL 8" msgstr "" #: ../environment-packages-rdo.rst:45 msgid "Ussuri to Yoga" msgstr "" #: ../environment-packages-rdo.rst:47 msgid "CentOS Stream 9 / RHEL 9" msgstr "" #: ../environment-packages-rdo.rst:48 msgid "Xena and following releases" msgstr "" #: ../environment-packages-rdo.rst:49 msgid "Zed, 2023.1 Antelope (SLURP), 2023.2 Bobcat, 2024.1 Caracal (SLURP)" msgstr "" #: ../environment-packages-rdo.rst:52 ../environment-packages-rdo.rst:179 msgid "Prerequisites" msgstr "" #: ../environment-packages-rdo.rst:56 msgid "" "We recommend disabling EPEL when using RDO packages due to updates in EPEL " "breaking backwards compatibility. Or, preferably pin package versions using " "the ``yum-versionlock`` plugin." msgstr "" #: ../environment-packages-rdo.rst:60 msgid "" "If EPEL is needed, also consider `lowering its priority in DNF `_." msgstr "" #: ../environment-packages-rdo.rst:64 ../environment-packages-rdo.rst:106 msgid "CentOS Stream" msgstr "" #: ../environment-packages-rdo.rst:66 msgid "Enable PowerTools/CRB repository:" msgstr "" #: ../environment-packages-rdo.rst:75 ../environment-packages-rdo.rst:127 msgid "RHEL" msgstr "" #: ../environment-packages-rdo.rst:77 msgid "" "When using RHEL, it is assumed that you have registered your system using " "Red Hat Subscription Management. For more information on registering a " "RHEL 9 system, see the `Red Hat Enterprise Linux 9 Installation Guide " "`_." msgstr "" #: ../environment-packages-rdo.rst:82 ../environment-packages-rdo.rst:190 msgid "Enable the required repositories:" msgstr "" #: ../environment-packages-rdo.rst:91 msgid "Enable CodeReady Linux Builder (CRB) repository:" msgstr "" #: ../environment-packages-rdo.rst:102 msgid "" "To choose which OpenStack release to install, `check the release page " "`_." msgstr "" #: ../environment-packages-rdo.rst:108 msgid "" "On CentOS Stream, the ``extras`` repository provides the RPM that enables " "the OpenStack repository. CentOS includes the ``extras`` repository by " "default, so you can simply install the package to enable the OpenStack " "repository:" msgstr "" #: ../environment-packages-rdo.rst:129 msgid "" "On RHEL, download and install the RDO repository RPM to enable the OpenStack " "repository." msgstr "" #: ../environment-packages-rdo.rst:137 msgid "" "**The RDO repository RPM installs the latest available OpenStack release.**" msgstr "" #: ../environment-packages-rdo.rst:153 msgid "Install the appropriate OpenStack client for your version." msgstr "" #: ../environment-packages-rdo.rst:160 msgid "" "RHEL and CentOS enable :term:`SELinux` by default. Install the ``openstack-" "selinux`` package to automatically manage security policies for OpenStack " "services:" msgstr "" #: ../environment-packages-rdo.rst:170 msgid "Older versions" msgstr "" #: ../environment-packages-rdo.rst:174 msgid "" "Information here is kept for historical/archival purposes. Includes " "unmaintained/end of life operating systems and OpenStack releases. **Do not " "follow these instructions**." msgstr "" #: ../environment-packages-rdo.rst:181 msgid "**RHEL**" msgstr "" #: ../environment-packages-rdo.rst:183 msgid "" "When using RHEL, it is assumed that you have registered your system using " "Red Hat Subscription Management. For more information on registering a RHEL " "7 system, see the `Red Hat Enterprise Linux 7 System Administrator's Guide " "`_ For " "more information on registering a RHEL 8 system, see the `Red Hat Enterprise " "Linux 8 Installation Guide `_." msgstr "" #: ../environment-packages-rdo.rst:205 msgid "Enable Powertools CodeReady Linux Builder (CRB) repository:" msgstr "" #: ../environment-packages-rdo.rst:215 msgid "" "On CentOS, the ``extras`` repository provides the RPM that enables the " "OpenStack repository. CentOS includes the ``extras`` repository by default, " "so you can simply install the package to enable the OpenStack repository. " "For CentOS8, you will also need to enable the PowerTools repository." msgstr "" #: ../environment-packages-rdo.rst:221 msgid "**When installing the Victoria release, run:**" msgstr "" #: ../environment-packages-rdo.rst:228 msgid "**When installing the Ussuri release, run:**" msgstr "" #: ../environment-packages-rdo.rst:235 msgid "**When installing the Train release, run:**" msgstr "" #: ../environment-packages-rdo.rst:241 msgid "**When installing the Stein release, run:**" msgstr "" #: ../environment-packages-rdo.rst:247 msgid "**When installing the Rocky release, run:**" msgstr "" #: ../environment-packages-rdo.rst:253 msgid "**When installing the Queens release, run:**" msgstr "" #: ../environment-packages-rdo.rst:259 msgid "**When installing the Pike release, run:**" msgstr "" #: ../environment-packages-rdo.rst:266 msgid "Further references" msgstr "" #: ../environment-packages-rdo.rst:268 msgid "" "`Red Hat - Introduction to Red Hat OpenStack Platform / Understanding Red " "Hat OpenStack Platform `_" msgstr "" #: ../environment-packages-rdo.rst:270 msgid "" "`RDO - Overview of available RDO repos `_" msgstr "" #: ../environment-packages-rdo.rst:271 msgid "`RDO - Packstack `_" msgstr "" #: ../environment-packages-ubuntu.rst:2 msgid "OpenStack packages for Ubuntu" msgstr "" #: ../environment-packages-ubuntu.rst:4 msgid "" "Ubuntu releases OpenStack with each Ubuntu release. Ubuntu LTS releases are " "provided every two years. OpenStack packages from interim releases of Ubuntu " "are made available to the prior Ubuntu LTS via the Ubuntu Cloud Archive." msgstr "" #: ../environment-packages-ubuntu.rst:11 msgid "" "The archive enablement described here needs to be done on all nodes that run " "OpenStack services." msgstr "" #: ../environment-packages-ubuntu.rst:16 msgid "Archive Enablement" msgstr "" #: ../environment-packages-ubuntu.rst:17 msgid "**OpenStack 2023.2 Bobcat for Ubuntu 22.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:23 msgid "**OpenStack 2023.1 Antelope for Ubuntu 22.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:29 msgid "**OpenStack Zed for Ubuntu 22.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:35 msgid "**OpenStack Yoga for Ubuntu 22.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:41 msgid "**OpenStack Yoga for Ubuntu 20.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:47 msgid "**OpenStack Xena for Ubuntu 20.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:53 msgid "**OpenStack Wallaby for Ubuntu 20.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:59 msgid "**OpenStack Victoria for Ubuntu 20.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:65 msgid "**OpenStack Ussuri for Ubuntu 20.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:71 msgid "**OpenStack Ussuri for Ubuntu 18.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:77 msgid "**OpenStack Train for Ubuntu 18.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:83 msgid "**OpenStack Stein for Ubuntu 18.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:89 msgid "**OpenStack Rocky for Ubuntu 18.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:95 msgid "**OpenStack Queens for Ubuntu 18.04 LTS:**" msgstr "" #: ../environment-packages-ubuntu.rst:103 msgid "" "For a full list of supported Ubuntu OpenStack releases, see \"Ubuntu " "OpenStack release cycle\" at https://www.ubuntu.com/about/release-cycle." msgstr "" #: ../environment-packages-ubuntu.rst:109 msgid "Sample Installation" msgstr "" #: ../environment-packages-ubuntu.rst:117 msgid "Client Installation" msgstr "" #: ../environment-packages.rst:2 msgid "OpenStack packages" msgstr "" #: ../environment-security.rst:2 msgid "Security" msgstr "" #: ../environment-security.rst:4 msgid "" "OpenStack services support various security methods including password, " "policy, and encryption. Additionally, supporting services including the " "database server and message broker support password security." msgstr "" #: ../environment-security.rst:8 msgid "" "To ease the installation process, this guide only covers password security " "where applicable. You can create secure passwords manually, but the database " "connection string in services configuration file cannot accept special " "characters like \"@\". We recommend you generate them using a tool such as " "`pwgen `_, or by running the " "following command:" msgstr "" #: ../environment-security.rst:20 msgid "" "For OpenStack services, this guide uses ``SERVICE_PASS`` to reference " "service account passwords and ``SERVICE_DBPASS`` to reference database " "passwords." msgstr "" #: ../environment-security.rst:24 msgid "" "The following table provides a list of services that require passwords and " "their associated references in the guide." msgstr "" #: ../environment-security.rst:27 msgid "**Passwords**" msgstr "" #: ../environment-security.rst:31 msgid "Password name" msgstr "" #: ../environment-security.rst:32 msgid "Description" msgstr "" #: ../environment-security.rst:33 msgid "Database password (no variable used)" msgstr "" #: ../environment-security.rst:34 msgid "Root password for the database" msgstr "" #: ../environment-security.rst:35 msgid "``ADMIN_PASS``" msgstr "" #: ../environment-security.rst:36 msgid "Password of user ``admin``" msgstr "" #: ../environment-security.rst:37 msgid "``CINDER_DBPASS``" msgstr "" #: ../environment-security.rst:38 msgid "Database password for the Block Storage service" msgstr "" #: ../environment-security.rst:39 msgid "``CINDER_PASS``" msgstr "" #: ../environment-security.rst:40 msgid "Password of Block Storage service user ``cinder``" msgstr "" #: ../environment-security.rst:41 msgid "``DASH_DBPASS``" msgstr "" #: ../environment-security.rst:42 msgid "Database password for the Dashboard" msgstr "" #: ../environment-security.rst:43 msgid "``DEMO_PASS``" msgstr "" #: ../environment-security.rst:44 msgid "Password of user ``demo``" msgstr "" #: ../environment-security.rst:45 msgid "``GLANCE_DBPASS``" msgstr "" #: ../environment-security.rst:46 msgid "Database password for Image service" msgstr "" #: ../environment-security.rst:47 msgid "``GLANCE_PASS``" msgstr "" #: ../environment-security.rst:48 msgid "Password of Image service user ``glance``" msgstr "" #: ../environment-security.rst:49 msgid "``KEYSTONE_DBPASS``" msgstr "" #: ../environment-security.rst:50 msgid "Database password of Identity service" msgstr "" #: ../environment-security.rst:51 msgid "``METADATA_SECRET``" msgstr "" #: ../environment-security.rst:52 msgid "Secret for the metadata proxy" msgstr "" #: ../environment-security.rst:53 msgid "``NEUTRON_DBPASS``" msgstr "" #: ../environment-security.rst:54 msgid "Database password for the Networking service" msgstr "" #: ../environment-security.rst:55 msgid "``NEUTRON_PASS``" msgstr "" #: ../environment-security.rst:56 msgid "Password of Networking service user ``neutron``" msgstr "" #: ../environment-security.rst:57 msgid "``NOVA_DBPASS``" msgstr "" #: ../environment-security.rst:58 msgid "Database password for Compute service" msgstr "" #: ../environment-security.rst:59 msgid "``NOVA_PASS``" msgstr "" #: ../environment-security.rst:60 msgid "Password of Compute service user ``nova``" msgstr "" #: ../environment-security.rst:61 msgid "``PLACEMENT_PASS``" msgstr "" #: ../environment-security.rst:62 msgid "Password of the Placement service user ``placement``" msgstr "" #: ../environment-security.rst:63 msgid "``RABBIT_PASS``" msgstr "" #: ../environment-security.rst:64 msgid "Password of RabbitMQ user ``openstack``" msgstr "" #: ../environment-security.rst:66 msgid "" "OpenStack and supporting services require administrative privileges during " "installation and operation. In some cases, services perform modifications to " "the host that can interfere with deployment automation tools such as " "Ansible, Chef, and Puppet. For example, some OpenStack services add a root " "wrapper to ``sudo`` that can interfere with security policies. See the " "`Compute service documentation for Pike `_, the `Compute service documentation " "for Queens `_, or the `Compute service documentation for Rocky `_ for more " "information." msgstr "" #: ../environment-security.rst:79 msgid "" "The Networking service assumes default values for kernel network parameters " "and modifies firewall rules. To avoid most issues during your initial " "installation, we recommend using a stock deployment of a supported " "distribution on your hosts. However, if you choose to automate deployment of " "your hosts, review the configuration and policies applied to them before " "proceeding further." msgstr "" #: ../environment-sql-database-obs.rst:2 msgid "SQL database for SUSE" msgstr "" #: ../environment-sql-database-obs.rst:4 ../environment-sql-database-rdo.rst:4 #: ../environment-sql-database-ubuntu.rst:4 ../environment-sql-database.rst:4 msgid "" "Most OpenStack services use an SQL database to store information. The " "database typically runs on the controller node. The procedures in this guide " "use MariaDB or MySQL depending on the distribution. OpenStack services also " "support other SQL databases including `PostgreSQL `__." msgstr "" #: ../environment-sql-database-obs.rst:19 msgid "" "Create and edit the ``/etc/my.cnf.d/openstack.cnf`` file and complete the " "following actions:" msgstr "" #: ../environment-sql-database-obs.rst:22 #: ../environment-sql-database-rdo.rst:23 #: ../environment-sql-database-ubuntu.rst:45 msgid "" "Create a ``[mysqld]`` section, and set the ``bind-address`` key to the " "management IP address of the controller node to enable access by other nodes " "via the management network. Set additional keys to enable useful options and " "the UTF-8 character set:" msgstr "" #: ../environment-sql-database-obs.rst:42 #: ../environment-sql-database-rdo.rst:44 msgid "" "Start the database service and configure it to start when the system boots:" msgstr "" #: ../environment-sql-database-obs.rst:50 #: ../environment-sql-database-rdo.rst:52 #: ../environment-sql-database-ubuntu.rst:71 msgid "" "Secure the database service by running the ``mysql_secure_installation`` " "script. In particular, choose a suitable password for the database ``root`` " "account:" msgstr "" #: ../environment-sql-database-rdo.rst:2 msgid "SQL database for RHEL and CentOS" msgstr "" #: ../environment-sql-database-rdo.rst:19 msgid "" "Create and edit the ``/etc/my.cnf.d/openstack.cnf`` file (backup existing " "configuration files in ``/etc/my.cnf.d/`` if needed) and complete the " "following actions:" msgstr "" #: ../environment-sql-database-ubuntu.rst:2 msgid "SQL database for Ubuntu" msgstr "" #: ../environment-sql-database-ubuntu.rst:12 msgid "" "As of Ubuntu 16.04, MariaDB was changed to use the \"unix_socket " "Authentication Plugin\". Local authentication is now performed using the " "user credentials (UID), and password authentication is no longer used by " "default. This means that the root user no longer uses a password for local " "access to the server." msgstr "" #: ../environment-sql-database-ubuntu.rst:21 msgid "" "As of Ubuntu 18.04, the ``mariadb-server`` package is no longer available " "from the default repository. To install successfully, enable the " "``Universe`` repository on Ubuntu." msgstr "" #: ../environment-sql-database-ubuntu.rst:30 msgid "As of Ubuntu 20.04, install the packages:" msgstr "" #: ../environment-sql-database-ubuntu.rst:36 msgid "As of Ubuntu 18.04 or 16.04, install the packages:" msgstr "" #: ../environment-sql-database-ubuntu.rst:42 msgid "" "Create and edit the ``/etc/mysql/mariadb.conf.d/99-openstack.cnf`` file and " "complete the following actions:" msgstr "" #: ../environment-sql-database-ubuntu.rst:65 msgid "Restart the database service:" msgstr "" #: ../environment-sql-database.rst:2 msgid "SQL database" msgstr "" #: ../environment-sql-database.rst:12 msgid "" "If you see ``Too many connections`` or ``Too many open files`` error log " "messages on OpenStack services, verify that maximum number of connection " "settings are well applied to your environment. In MariaDB, you may also need " "to change `open_files_limit `__ configuration." msgstr "" #: ../environment.rst:3 msgid "Environment" msgstr "" #: ../environment.rst:5 msgid "" "This section explains how to configure the controller node and one compute " "node using the example architecture." msgstr "" #: ../environment.rst:8 msgid "" "Although most environments include Identity, Image service, Compute, at " "least one networking service, and the Dashboard, the Object Storage service " "can operate independently. If your use case only involves Object Storage, " "you can skip to" msgstr "" #: ../environment.rst:13 msgid "" "`Object Storage Installation Guide for 2023.2 (Bobcat) `_" msgstr "" #: ../environment.rst:15 msgid "" "`Object Storage Installation Guide for 2023.1 (Antelope) `_" msgstr "" #: ../environment.rst:17 msgid "" "`Object Storage Installation Guide for Zed `_" msgstr "" #: ../environment.rst:19 msgid "" "`Object Storage Installation Guide for Yoga `_" msgstr "" #: ../environment.rst:21 msgid "" "`Object Storage Installation Guide for Stein `_" msgstr "" #: ../environment.rst:23 msgid "after configuring the appropriate nodes for it." msgstr "" #: ../environment.rst:25 msgid "" "You must use an account with administrative privileges to configure each " "node. Either run the commands as the ``root`` user or configure the ``sudo`` " "utility." msgstr "" #: ../environment.rst:31 msgid "" "The :command:`systemctl enable` call on openSUSE outputs a warning message " "when the service uses SysV Init scripts instead of native systemd files. " "This warning can be ignored." msgstr "" #: ../environment.rst:36 msgid "" "For best performance, we recommend that your environment meets or exceeds " "the hardware requirements in :ref:`figure-hwreqs`." msgstr "" #: ../environment.rst:39 msgid "" "The following minimum requirements should support a proof-of-concept " "environment with core services and several :term:`CirrOS` instances:" msgstr "" #: ../environment.rst:42 msgid "Controller Node: 1 processor, 4 GB memory, and 5 GB storage" msgstr "" #: ../environment.rst:44 msgid "Compute Node: 1 processor, 2 GB memory, and 10 GB storage" msgstr "" #: ../environment.rst:46 msgid "" "As the number of OpenStack services and virtual machines increase, so do the " "hardware requirements for the best performance. If performance degrades " "after enabling additional services or virtual machines, consider adding " "hardware resources to your environment." msgstr "" #: ../environment.rst:51 msgid "" "To minimize clutter and provide more resources for OpenStack, we recommend a " "minimal installation of your Linux distribution. Also, you must install a 64-" "bit version of your distribution on each node." msgstr "" #: ../environment.rst:55 msgid "" "A single disk partition on each node works for most basic installations. " "However, you should consider :term:`Logical Volume Manager (LVM)` for " "installations with optional services such as Block Storage." msgstr "" #: ../environment.rst:59 msgid "" "For first-time installation and testing purposes, many users select to build " "each host as a :term:`virtual machine (VM)`. The primary benefits of VMs " "include the following:" msgstr "" #: ../environment.rst:63 msgid "" "One physical server can support multiple nodes, each with almost any number " "of network interfaces." msgstr "" #: ../environment.rst:66 msgid "" "Ability to take periodic \"snap shots\" throughout the installation process " "and \"roll back\" to a working configuration in the event of a problem." msgstr "" #: ../environment.rst:70 msgid "" "However, VMs will reduce performance of your instances, particularly if your " "hypervisor and/or processor lacks support for hardware acceleration of " "nested VMs." msgstr "" #: ../environment.rst:76 msgid "" "If you choose to install on VMs, make sure your hypervisor provides a way to " "disable MAC address filtering on the provider network interface." msgstr "" #: ../environment.rst:80 msgid "" "For more information about system requirements, see the `OpenStack 2023.2 " "(Bobcat) Administrator Guides `_, " "the `OpenStack 2023.1 (Antelope) Administrator Guides `_, the `OpenStack Zed Administrator Guides " "`_, the `OpenStack Yoga Administrator " "Guides `_, or the `OpenStack Stein " "Administrator Guides `_." msgstr "" #: ../firewalls-default-ports.rst:3 msgid "Firewalls and default ports" msgstr "" #: ../firewalls-default-ports.rst:5 msgid "" "On some deployments, such as ones where restrictive firewalls are in place, " "you might need to manually configure a firewall to permit OpenStack service " "traffic." msgstr "" #: ../firewalls-default-ports.rst:9 msgid "" "To manually configure a firewall, you must permit traffic through the ports " "that each OpenStack service uses. This table lists the default ports that " "each OpenStack service uses:" msgstr "" #: ../firewalls-default-ports.rst:13 msgid "Default ports that OpenStack components use" msgstr "" #: ../firewalls-default-ports.rst:16 msgid "OpenStack service" msgstr "" #: ../firewalls-default-ports.rst:17 msgid "Default ports" msgstr "" #: ../firewalls-default-ports.rst:18 msgid "Application Catalog (``murano``)" msgstr "" #: ../firewalls-default-ports.rst:19 msgid "8082" msgstr "" #: ../firewalls-default-ports.rst:20 msgid "Backup Service (``Freezer``)" msgstr "" #: ../firewalls-default-ports.rst:21 msgid "9090" msgstr "" #: ../firewalls-default-ports.rst:22 msgid "Big Data Processing Framework (``sahara``)" msgstr "" #: ../firewalls-default-ports.rst:23 ../firewalls-default-ports.rst:41 msgid "8386" msgstr "" #: ../firewalls-default-ports.rst:24 msgid "Block Storage (``cinder``)" msgstr "" #: ../firewalls-default-ports.rst:25 msgid "8776" msgstr "" #: ../firewalls-default-ports.rst:26 msgid "Clustering (``senlin``)" msgstr "" #: ../firewalls-default-ports.rst:27 msgid "8777" msgstr "" #: ../firewalls-default-ports.rst:28 msgid "Compute (``nova``) endpoints" msgstr "" #: ../firewalls-default-ports.rst:29 msgid "8774" msgstr "" #: ../firewalls-default-ports.rst:30 msgid "Compute ports for access to virtual machine consoles" msgstr "" #: ../firewalls-default-ports.rst:31 msgid "5900-5999" msgstr "" #: ../firewalls-default-ports.rst:32 msgid "Compute VNC proxy for browsers (openstack-nova-novncproxy)" msgstr "" #: ../firewalls-default-ports.rst:33 msgid "6080" msgstr "" #: ../firewalls-default-ports.rst:34 msgid "" "Compute VNC proxy for traditional VNC clients (openstack-nova-xvpvncproxy)" msgstr "" #: ../firewalls-default-ports.rst:35 msgid "6081" msgstr "" #: ../firewalls-default-ports.rst:36 msgid "Container Infrastructure Management (``Magnum``)" msgstr "" #: ../firewalls-default-ports.rst:37 msgid "9511" msgstr "" #: ../firewalls-default-ports.rst:38 msgid "Container Service (``Zun``)" msgstr "" #: ../firewalls-default-ports.rst:39 msgid "9517" msgstr "" #: ../firewalls-default-ports.rst:40 msgid "Data processing service (``sahara``) endpoint" msgstr "" #: ../firewalls-default-ports.rst:42 msgid "Database service (``Trove``)" msgstr "" #: ../firewalls-default-ports.rst:43 msgid "8779" msgstr "" #: ../firewalls-default-ports.rst:44 msgid "DNS service (``Designate``)" msgstr "" #: ../firewalls-default-ports.rst:45 msgid "9001" msgstr "" #: ../firewalls-default-ports.rst:46 msgid "High Availability Service (``Masakari``)" msgstr "" #: ../firewalls-default-ports.rst:47 msgid "15868" msgstr "" #: ../firewalls-default-ports.rst:48 msgid "Identity service (``keystone``) endpoint" msgstr "" #: ../firewalls-default-ports.rst:49 msgid "5000" msgstr "" #: ../firewalls-default-ports.rst:50 msgid "Image service (``glance``) API" msgstr "" #: ../firewalls-default-ports.rst:51 msgid "9292" msgstr "" #: ../firewalls-default-ports.rst:52 msgid "Key Manager service (``Barbican``)" msgstr "" #: ../firewalls-default-ports.rst:53 msgid "9311" msgstr "" #: ../firewalls-default-ports.rst:54 msgid "Loadbalancer service (``Octavia``)" msgstr "" #: ../firewalls-default-ports.rst:55 msgid "9876" msgstr "" #: ../firewalls-default-ports.rst:56 msgid "Networking (``neutron``)" msgstr "" #: ../firewalls-default-ports.rst:57 msgid "9696" msgstr "" #: ../firewalls-default-ports.rst:58 msgid "NFV Orchestration service (``tacker``)" msgstr "" #: ../firewalls-default-ports.rst:59 msgid "9890" msgstr "" #: ../firewalls-default-ports.rst:60 msgid "Object Storage (``swift``)" msgstr "" #: ../firewalls-default-ports.rst:61 msgid "6000, 6001, 6002" msgstr "" #: ../firewalls-default-ports.rst:62 msgid "Orchestration (``heat``) endpoint" msgstr "" #: ../firewalls-default-ports.rst:63 msgid "8004" msgstr "" #: ../firewalls-default-ports.rst:64 msgid "" "Orchestration AWS CloudFormation-compatible API (``openstack-heat-api-cfn``)" msgstr "" #: ../firewalls-default-ports.rst:65 msgid "8000" msgstr "" #: ../firewalls-default-ports.rst:66 msgid "" "Orchestration AWS CloudWatch-compatible API (``openstack-heat-api-" "cloudwatch``)" msgstr "" #: ../firewalls-default-ports.rst:67 msgid "8778" msgstr "" #: ../firewalls-default-ports.rst:68 msgid "Placement API (``placement``)" msgstr "" #: ../firewalls-default-ports.rst:69 msgid "8003" msgstr "" #: ../firewalls-default-ports.rst:70 msgid "Proxy port for HTML5 console used by Compute service" msgstr "" #: ../firewalls-default-ports.rst:71 msgid "6082" msgstr "" #: ../firewalls-default-ports.rst:72 msgid "Rating service (``Cloudkitty``)" msgstr "" #: ../firewalls-default-ports.rst:73 msgid "8889" msgstr "" #: ../firewalls-default-ports.rst:74 msgid "Registration service (``Adjutant``)" msgstr "" #: ../firewalls-default-ports.rst:75 msgid "5050" msgstr "" #: ../firewalls-default-ports.rst:76 msgid "Resource Reservation service (``Blazar``)" msgstr "" #: ../firewalls-default-ports.rst:77 msgid "1234" msgstr "" #: ../firewalls-default-ports.rst:78 msgid "Root Cause Analysis service (``Vitrage``)" msgstr "" #: ../firewalls-default-ports.rst:79 msgid "8999" msgstr "" #: ../firewalls-default-ports.rst:80 msgid "Shared File Systems service (``Manila``)" msgstr "" #: ../firewalls-default-ports.rst:81 msgid "8786" msgstr "" #: ../firewalls-default-ports.rst:82 msgid "Telemetry alarming service (``Aodh``)" msgstr "" #: ../firewalls-default-ports.rst:83 msgid "8042" msgstr "" #: ../firewalls-default-ports.rst:84 msgid "Telemetry event service (``Panko``)" msgstr "" #: ../firewalls-default-ports.rst:85 msgid "8977" msgstr "" #: ../firewalls-default-ports.rst:86 msgid "Workflow service (``Mistral``)" msgstr "" #: ../firewalls-default-ports.rst:87 msgid "8989" msgstr "" #: ../firewalls-default-ports.rst:89 msgid "" "To function properly, some OpenStack components depend on other, non-" "OpenStack services. For example, the OpenStack dashboard uses HTTP for non-" "secure communication. In this case, you must configure the firewall to allow " "traffic to and from HTTP." msgstr "" #: ../firewalls-default-ports.rst:94 msgid "This table lists the ports that other OpenStack components use:" msgstr "" #: ../firewalls-default-ports.rst:96 msgid "" "Default ports that secondary services related to OpenStack components use" msgstr "" #: ../firewalls-default-ports.rst:99 msgid "Service" msgstr "" #: ../firewalls-default-ports.rst:100 msgid "Default port" msgstr "" #: ../firewalls-default-ports.rst:101 msgid "Used by" msgstr "" #: ../firewalls-default-ports.rst:102 msgid "HTTP" msgstr "" #: ../firewalls-default-ports.rst:103 msgid "80" msgstr "" #: ../firewalls-default-ports.rst:104 msgid "" "OpenStack dashboard (``Horizon``) when it is not configured to use secure " "access." msgstr "" #: ../firewalls-default-ports.rst:105 msgid "HTTP alternate" msgstr "" #: ../firewalls-default-ports.rst:106 msgid "8080" msgstr "" #: ../firewalls-default-ports.rst:107 msgid "OpenStack Object Storage (``swift``) service." msgstr "" #: ../firewalls-default-ports.rst:108 msgid "HTTPS" msgstr "" #: ../firewalls-default-ports.rst:109 msgid "443" msgstr "" #: ../firewalls-default-ports.rst:110 msgid "" "Any OpenStack service that is enabled for SSL, especially secure-access " "dashboard." msgstr "" #: ../firewalls-default-ports.rst:111 msgid "rsync" msgstr "" #: ../firewalls-default-ports.rst:112 msgid "873" msgstr "" #: ../firewalls-default-ports.rst:113 msgid "OpenStack Object Storage. Required." msgstr "" #: ../firewalls-default-ports.rst:114 msgid "iSCSI target" msgstr "" #: ../firewalls-default-ports.rst:115 msgid "3260" msgstr "" #: ../firewalls-default-ports.rst:116 msgid "" "OpenStack Block Storage. Required when using LVM with iSCSI target (tgt, " "LIO, iSER)" msgstr "" #: ../firewalls-default-ports.rst:117 msgid "NVMe-oF target" msgstr "" #: ../firewalls-default-ports.rst:118 msgid "4420" msgstr "" #: ../firewalls-default-ports.rst:119 msgid "" "OpenStack Block Storage. Required when using LVM with NVMe-oF target (nvmet)." msgstr "" #: ../firewalls-default-ports.rst:120 msgid "MySQL database service" msgstr "" #: ../firewalls-default-ports.rst:121 msgid "3306" msgstr "" #: ../firewalls-default-ports.rst:122 msgid "Most OpenStack components." msgstr "" #: ../firewalls-default-ports.rst:123 msgid "Message Broker (AMQP traffic)" msgstr "" #: ../firewalls-default-ports.rst:124 msgid "5672" msgstr "" #: ../firewalls-default-ports.rst:125 msgid "OpenStack Block Storage, Networking, Orchestration, and Compute." msgstr "" #: ../firewalls-default-ports.rst:127 msgid "" "On some deployments, the default port used by a service may fall within the " "defined local port range of a host. To check a host's local port range:" msgstr "" #: ../firewalls-default-ports.rst:135 msgid "" "If a service's default port falls within this range, run the following " "program to check if the port has already been assigned to another " "application:" msgstr "" #: ../firewalls-default-ports.rst:143 msgid "" "Configure the service to use a different port if the default port is already " "being used by another application." msgstr "" #: ../get-started-conceptual-architecture.rst:7 msgid "Conceptual architecture" msgstr "" #: ../get-started-conceptual-architecture.rst:9 msgid "" "The following diagram shows the relationships among the OpenStack services:" msgstr "" #: ../get-started-conceptual-architecture.rst:-1 msgid "OpenStack conceptual architecture" msgstr "" #: ../get-started-logical-architecture.rst:3 #: ../get-started-logical-architecture.rst:-1 msgid "Logical architecture" msgstr "" #: ../get-started-logical-architecture.rst:5 msgid "" "To design, deploy, and configure OpenStack, administrators must understand " "the logical architecture." msgstr "" #: ../get-started-logical-architecture.rst:8 msgid "" "As shown in :ref:`get_started_conceptual_architecture`, OpenStack consists " "of several independent parts, named the OpenStack services. All services " "authenticate through a common Identity service. Individual services interact " "with each other through public APIs, except where privileged administrator " "commands are necessary." msgstr "" #: ../get-started-logical-architecture.rst:14 msgid "" "Internally, OpenStack services are composed of several processes. All " "services have at least one API process, which listens for API requests, " "preprocesses them and passes them on to other parts of the service. With the " "exception of the Identity service, the actual work is done by distinct " "processes." msgstr "" #: ../get-started-logical-architecture.rst:20 msgid "" "For communication between the processes of one service, an AMQP message " "broker is used. The service's state is stored in a database. When deploying " "and configuring your OpenStack cloud, you can choose among several message " "broker and database solutions, such as RabbitMQ, MySQL, MariaDB, and SQLite." msgstr "" #: ../get-started-logical-architecture.rst:26 msgid "" "Users can access OpenStack via the web-based user interface implemented by " "the Horizon Dashboard, via `command-line clients `__ and by issuing API requests through tools like browser " "plug-ins or :command:`curl`. For applications, `several SDKs `__ are available. Ultimately, all these access " "methods issue REST API calls to the various OpenStack services." msgstr "" #: ../get-started-logical-architecture.rst:34 msgid "" "The following diagram shows the most common, but not the only possible, " "architecture for an OpenStack cloud:" msgstr "" #: ../get-started-with-openstack.rst:3 msgid "Get started with OpenStack" msgstr "" #: ../get-started-with-openstack.rst:5 msgid "" "The OpenStack project is an open source cloud computing platform for all " "types of clouds, which aims to be simple to implement, massively scalable, " "and feature rich. Developers and cloud computing technologists from around " "the world create the OpenStack project." msgstr "" #: ../get-started-with-openstack.rst:10 msgid "" "OpenStack provides an :term:`Infrastructure-as-a-Service (IaaS)` solution " "through a set of interrelated services. Each service offers an :term:" "`Application Programming Interface (API)` that facilitates this integration. " "Depending on your needs, you can install some or all services." msgstr "" #: ../get-started-with-openstack.rst:17 msgid "The OpenStack services" msgstr "" #: ../get-started-with-openstack.rst:19 msgid "" "The `OpenStack project navigator `_ lets you browse the OpenStack services " "that make up the OpenStack architecture. The services are categorized per " "the service type and release series." msgstr "" #: ../get-started-with-openstack.rst:25 msgid "The OpenStack architecture" msgstr "" #: ../get-started-with-openstack.rst:27 msgid "" "The following sections describe the OpenStack architecture in more detail:" msgstr "" #: ../index.rst:3 msgid "OpenStack Installation Guide" msgstr "" #: ../launch-instance-cinder.rst:4 ../launch-instance.rst:202 #: ../overview.rst:126 msgid "Block Storage" msgstr "" #: ../launch-instance-cinder.rst:7 msgid "Create a volume" msgstr "" #: ../launch-instance-cinder.rst:9 msgid "" "Source the ``demo`` credentials to perform the following steps as a non-" "administrative project:" msgstr "" #: ../launch-instance-cinder.rst:16 msgid "Create a 1 GB volume:" msgstr "" #: ../launch-instance-cinder.rst:46 msgid "" "After a short time, the volume status should change from ``creating`` to " "``available``:" msgstr "" #: ../launch-instance-cinder.rst:60 msgid "Attach the volume to an instance" msgstr "" #: ../launch-instance-cinder.rst:62 msgid "Attach a volume to an instance:" msgstr "" #: ../launch-instance-cinder.rst:68 msgid "" "Replace ``INSTANCE_NAME`` with the name of the instance and ``VOLUME_NAME`` " "with the name of the volume you want to attach to it." msgstr "" #: ../launch-instance-cinder.rst:71 #: ../launch-instance-networks-provider.rst:130 #: ../launch-instance-networks-selfservice.rst:112 msgid "**Example**" msgstr "" #: ../launch-instance-cinder.rst:73 msgid "Attach the ``volume1`` volume to the ``provider-instance`` instance:" msgstr "" #: ../launch-instance-cinder.rst:81 ../launch-instance-selfservice.rst:236 msgid "This command provides no output." msgstr "" #: ../launch-instance-cinder.rst:83 msgid "List volumes:" msgstr "" #: ../launch-instance-cinder.rst:95 msgid "" "Access your instance using SSH and use the ``fdisk`` command to verify " "presence of the volume as the ``/dev/vdb`` block storage device:" msgstr "" #: ../launch-instance-cinder.rst:123 msgid "" "You must create a file system on the device and mount it to use the volume." msgstr "" #: ../launch-instance-cinder.rst:126 msgid "" "For more information about how to manage volumes, see the `python-" "openstackclient documentation for Pike `_, the `python-" "openstackclient documentation for Queens `_, or the `python-" "openstackclient documentation for Rocky `_." msgstr "" #: ../launch-instance-cinder.rst:133 msgid "Return to :ref:`launch-instance`." msgstr "" #: ../launch-instance-networks-provider.rst:4 msgid "Provider network" msgstr "" #: ../launch-instance-networks-provider.rst:6 msgid "" "Before launching an instance, you must create the necessary virtual network " "infrastructure. For networking option 1, an instance uses a provider " "(external) network that connects to the physical network infrastructure via " "layer-2 (bridging/switching). This network includes a DHCP server that " "provides IP addresses to instances." msgstr "" #: ../launch-instance-networks-provider.rst:12 msgid "" "The ``admin`` or other privileged user must create this network because it " "connects directly to the physical network infrastructure." msgstr "" #: ../launch-instance-networks-provider.rst:17 #: ../launch-instance-networks-selfservice.rst:23 msgid "" "The following instructions and diagrams use example IP address ranges. You " "must adjust them for your particular environment." msgstr "" #: ../launch-instance-networks-provider.rst:23 msgid "**Networking Option 1: Provider networks - Overview**" msgstr "" #: ../launch-instance-networks-provider.rst:23 msgid "Networking Option 1: Provider networks - Overview" msgstr "" #: ../launch-instance-networks-provider.rst:28 msgid "**Networking Option 1: Provider networks - Connectivity**" msgstr "" #: ../launch-instance-networks-provider.rst:28 msgid "Networking Option 1: Provider networks - Connectivity" msgstr "" #: ../launch-instance-networks-provider.rst:31 msgid "Create the provider network" msgstr "" #: ../launch-instance-networks-provider.rst:33 #: ../launch-instance-networks-selfservice.rst:219 msgid "" "On the controller node, source the ``admin`` credentials to gain access to " "admin-only CLI commands:" msgstr "" #: ../launch-instance-networks-provider.rst:40 #: ../launch-instance-networks-selfservice.rst:46 msgid "Create the network:" msgstr "" #: ../launch-instance-networks-provider.rst:80 msgid "The ``--share`` option allows all projects to use the virtual network." msgstr "" #: ../launch-instance-networks-provider.rst:82 msgid "" "The ``--external`` option defines the virtual network to be external. If you " "wish to create an internal network, you can use ``--internal`` instead. " "Default value is ``internal``." msgstr "" #: ../launch-instance-networks-provider.rst:86 msgid "" "The ``--provider-physical-network provider`` and ``--provider-network-type " "flat`` options connect the flat virtual network to the flat (native/" "untagged) physical network on the ``br0`` bridge, which can have a port " "which is connected to ``eth0`` on the host using information from the " "following files:" msgstr "" #: ../launch-instance-networks-provider.rst:92 #: ../launch-instance-networks-provider.rst:99 #: ../launch-instance-networks-selfservice.rst:83 msgid "``ml2_conf.ini``:" msgstr "" #: ../launch-instance-networks-provider.rst:106 #: ../launch-instance-networks-selfservice.rst:93 msgid "Create a subnet on the network:" msgstr "" #: ../launch-instance-networks-provider.rst:115 msgid "" "Replace ``PROVIDER_NETWORK_CIDR`` with the subnet on the provider physical " "network in CIDR notation." msgstr "" #: ../launch-instance-networks-provider.rst:118 msgid "" "Replace ``START_IP_ADDRESS`` and ``END_IP_ADDRESS`` with the first and last " "IP address of the range within the subnet that you want to allocate for " "instances. This range must not include any existing active IP addresses." msgstr "" #: ../launch-instance-networks-provider.rst:123 #: ../launch-instance-networks-selfservice.rst:101 msgid "" "Replace ``DNS_RESOLVER`` with the IP address of a DNS resolver. In most " "cases, you can use one from the ``/etc/resolv.conf`` file on the host." msgstr "" #: ../launch-instance-networks-provider.rst:127 msgid "" "Replace ``PROVIDER_NETWORK_GATEWAY`` with the gateway IP address on the " "provider network, typically the \".1\" IP address." msgstr "" #: ../launch-instance-networks-provider.rst:132 msgid "" "The provider network uses 203.0.113.0/24 with a gateway on 203.0.113.1. A " "DHCP server assigns each instance an IP address from 203.0.113.101 to " "203.0.113.250. All instances use 8.8.4.4 as a DNS resolver." msgstr "" #: ../launch-instance-networks-provider.rst:169 #: ../launch-instance-networks-selfservice.rst:267 msgid "" "Return to :ref:`Launch an instance - Create virtual networks `." msgstr "" #: ../launch-instance-networks-selfservice.rst:4 msgid "Self-service network" msgstr "" #: ../launch-instance-networks-selfservice.rst:6 msgid "" "If you chose networking option 2, you can also create a self-service " "(private) network that connects to the physical network infrastructure via " "NAT. This network includes a DHCP server that provides IP addresses to " "instances. An instance on this network can automatically access external " "networks such as the Internet. However, access to an instance on this " "network from external networks such as the Internet requires a :term:" "`floating IP address`." msgstr "" #: ../launch-instance-networks-selfservice.rst:13 msgid "" "The ``demo`` or other unprivileged user can create this network because it " "provides connectivity to instances within the ``demo`` project only." msgstr "" #: ../launch-instance-networks-selfservice.rst:18 msgid "" "You must :ref:`create the provider network ` before the self-service network." msgstr "" #: ../launch-instance-networks-selfservice.rst:29 msgid "**Networking Option 2: Self-service networks - Overview**" msgstr "" #: ../launch-instance-networks-selfservice.rst:29 msgid "Networking Option 2: Self-service networks - Overview" msgstr "" #: ../launch-instance-networks-selfservice.rst:34 msgid "**Networking Option 2: Self-service networks - Connectivity**" msgstr "" #: ../launch-instance-networks-selfservice.rst:34 msgid "Networking Option 2: Self-service networks - Connectivity" msgstr "" #: ../launch-instance-networks-selfservice.rst:37 msgid "Create the self-service network" msgstr "" #: ../launch-instance-networks-selfservice.rst:39 #: ../launch-instance-networks-selfservice.rst:165 #: ../launch-instance-provider.rst:12 ../launch-instance-selfservice.rst:12 msgid "" "On the controller node, source the ``demo`` credentials to gain access to " "user-only CLI commands:" msgstr "" #: ../launch-instance-networks-selfservice.rst:79 msgid "" "Non-privileged users typically cannot supply additional parameters to this " "command. The service automatically chooses parameters using information from " "the following files:" msgstr "" #: ../launch-instance-networks-selfservice.rst:105 msgid "" "Replace ``SELFSERVICE_NETWORK_GATEWAY`` with the gateway you want to use on " "the self-service network, typically the \".1\" IP address." msgstr "" #: ../launch-instance-networks-selfservice.rst:108 msgid "" "Replace ``SELFSERVICE_NETWORK_CIDR`` with the subnet you want to use on the " "self-service network. You can use any arbitrary value, although we recommend " "a network from `RFC 1918 `_." msgstr "" #: ../launch-instance-networks-selfservice.rst:114 msgid "" "The self-service network uses 172.16.1.0/24 with a gateway on 172.16.1.1. A " "DHCP server assigns each instance an IP address from 172.16.1.2 to " "172.16.1.254. All instances use 8.8.4.4 as a DNS resolver." msgstr "" #: ../launch-instance-networks-selfservice.rst:152 msgid "Create a router" msgstr "" #: ../launch-instance-networks-selfservice.rst:154 msgid "" "Self-service networks connect to provider networks using a virtual router " "that typically performs bidirectional NAT. Each router contains an interface " "on at least one self-service network and a gateway on a provider network." msgstr "" #: ../launch-instance-networks-selfservice.rst:158 msgid "" "The provider network must include the ``router:external`` option to enable " "self-service routers to use it for connectivity to external networks such as " "the Internet. The ``admin`` or other privileged user must include this " "option during network creation or add it later. In this case, the ``router:" "external`` option was set by using the ``--external`` parameter when " "creating the ``provider`` network." msgstr "" #: ../launch-instance-networks-selfservice.rst:172 msgid "Create the router:" msgstr "" #: ../launch-instance-networks-selfservice.rst:200 msgid "Add the self-service network subnet as an interface on the router:" msgstr "" #: ../launch-instance-networks-selfservice.rst:206 msgid "Set a gateway on the provider network on the router:" msgstr "" #: ../launch-instance-networks-selfservice.rst:215 msgid "" "We recommend that you verify operation and fix any issues before proceeding. " "The following steps use the IP address ranges from the network and subnet " "creation examples." msgstr "" #: ../launch-instance-networks-selfservice.rst:226 msgid "" "List network namespaces. You should see one ``qrouter`` namespace and two " "``qdhcp`` namespaces." msgstr "" #: ../launch-instance-networks-selfservice.rst:237 msgid "" "List ports on the router to determine the gateway IP address on the provider " "network:" msgstr "" #: ../launch-instance-networks-selfservice.rst:251 msgid "" "Ping this IP address from the controller node or any host on the physical " "provider network:" msgstr "" #: ../launch-instance-provider.rst:4 msgid "Launch an instance on the provider network" msgstr "" #: ../launch-instance-provider.rst:7 ../launch-instance-selfservice.rst:7 msgid "Determine instance options" msgstr "" #: ../launch-instance-provider.rst:9 ../launch-instance-selfservice.rst:9 msgid "" "To launch an instance, you must at least specify the flavor, image name, " "network, security group, key, and instance name." msgstr "" #: ../launch-instance-provider.rst:19 ../launch-instance-selfservice.rst:19 msgid "" "A flavor specifies a virtual resource allocation profile which includes " "processor, memory, and storage." msgstr "" #: ../launch-instance-provider.rst:22 ../launch-instance-selfservice.rst:22 msgid "List available flavors:" msgstr "" #: ../launch-instance-provider.rst:36 ../launch-instance-selfservice.rst:36 msgid "You can also reference a flavor by ID." msgstr "" #: ../launch-instance-provider.rst:38 ../launch-instance-selfservice.rst:38 msgid "List available images:" msgstr "" #: ../launch-instance-provider.rst:50 ../launch-instance-selfservice.rst:50 msgid "This instance uses the ``cirros`` image." msgstr "" #: ../launch-instance-provider.rst:52 ../launch-instance-selfservice.rst:52 msgid "List available networks:" msgstr "" #: ../launch-instance-provider.rst:65 msgid "" "This instance uses the ``provider`` provider network. However, you must " "reference this network using the ID instead of the name." msgstr "" #: ../launch-instance-provider.rst:70 msgid "" "If you chose option 2, the output should also contain the ``selfservice`` " "self-service network." msgstr "" #: ../launch-instance-provider.rst:73 ../launch-instance-selfservice.rst:68 msgid "List available security groups:" msgstr "" #: ../launch-instance-provider.rst:85 ../launch-instance-selfservice.rst:80 msgid "This instance uses the ``default`` security group." msgstr "" #: ../launch-instance-provider.rst:88 msgid "Launch the instance" msgstr "" #: ../launch-instance-provider.rst:90 ../launch-instance-selfservice.rst:82 msgid "Launch the instance:" msgstr "" #: ../launch-instance-provider.rst:92 msgid "" "Replace ``PROVIDER_NET_ID`` with the ID of the ``provider`` provider network." msgstr "" #: ../launch-instance-provider.rst:97 msgid "" "If you chose option 1 and your environment contains only one network, you " "can omit the ``--nic`` option because OpenStack automatically chooses the " "only network available." msgstr "" #: ../launch-instance-provider.rst:139 ../launch-instance-selfservice.rst:125 msgid "Check the status of your instance:" msgstr "" #: ../launch-instance-provider.rst:151 ../launch-instance-selfservice.rst:138 msgid "" "The status changes from ``BUILD`` to ``ACTIVE`` when the build process " "successfully completes." msgstr "" #: ../launch-instance-provider.rst:155 msgid "Access the instance using the virtual console" msgstr "" #: ../launch-instance-provider.rst:157 ../launch-instance-selfservice.rst:144 msgid "" "Obtain a :term:`Virtual Network Computing (VNC)` session URL for your " "instance and access it from a web browser:" msgstr "" #: ../launch-instance-provider.rst:173 ../launch-instance-selfservice.rst:160 msgid "" "If your web browser runs on a host that cannot resolve the ``controller`` " "host name, you can replace ``controller`` with the IP address of the " "management interface on your controller node." msgstr "" #: ../launch-instance-provider.rst:177 ../launch-instance-selfservice.rst:164 msgid "" "The CirrOS image includes conventional user name/password authentication and " "provides these credentials at the login prompt. After logging into CirrOS, " "we recommend that you verify network connectivity using ``ping``." msgstr "" #: ../launch-instance-provider.rst:182 msgid "Verify access to the provider physical network gateway:" msgstr "" #: ../launch-instance-provider.rst:198 ../launch-instance-selfservice.rst:185 msgid "Verify access to the internet:" msgstr "" #: ../launch-instance-provider.rst:215 ../launch-instance-selfservice.rst:202 msgid "Access the instance remotely" msgstr "" #: ../launch-instance-provider.rst:217 msgid "" "Verify connectivity to the instance from the controller node or any host on " "the provider physical network:" msgstr "" #: ../launch-instance-provider.rst:234 ../launch-instance-selfservice.rst:268 msgid "" "Access your instance using SSH from the controller node or any host on the " "provider physical network:" msgstr "" #: ../launch-instance-provider.rst:246 ../launch-instance-selfservice.rst:280 msgid "" "If your instance does not launch or seem to work as you expect, see the " "`Troubleshoot Compute documentation for Pike `_, the `Troubleshoot Compute " "documentation for Queens `_, or the `Troubleshoot Compute documentation for " "Rocky `_ " "for more information or use one of the :doc:`many other options ` to seek assistance. We want your first installation to work!" msgstr "" #: ../launch-instance-provider.rst:256 ../launch-instance-selfservice.rst:290 msgid "Return to :ref:`Launch an instance `." msgstr "" #: ../launch-instance-selfservice.rst:4 msgid "Launch an instance on the self-service network" msgstr "" #: ../launch-instance-selfservice.rst:65 msgid "" "This instance uses the ``selfservice`` self-service network. However, you " "must reference this network using the ID instead of the name." msgstr "" #: ../launch-instance-selfservice.rst:84 msgid "" "Replace ``SELFSERVICE_NET_ID`` with the ID of the ``selfservice`` network." msgstr "" #: ../launch-instance-selfservice.rst:142 msgid "Access the instance using a virtual console" msgstr "" #: ../launch-instance-selfservice.rst:169 msgid "Verify access to the self-service network gateway:" msgstr "" #: ../launch-instance-selfservice.rst:204 msgid "Create a :term:`floating IP address` on the provider virtual network:" msgstr "" #: ../launch-instance-selfservice.rst:228 msgid "Associate the floating IP address with the instance:" msgstr "" #: ../launch-instance-selfservice.rst:238 msgid "Check the status of your floating IP address:" msgstr "" #: ../launch-instance-selfservice.rst:251 msgid "" "Verify connectivity to the instance via floating IP address from the " "controller node or any host on the provider physical network:" msgstr "" #: ../launch-instance.rst:5 ../launch-instance.rst:187 msgid "Launch an instance" msgstr "" #: ../launch-instance.rst:7 msgid "" "This section creates the necessary virtual networks to support launching " "instances. Networking option 1 includes one provider (external) network with " "one instance that uses it. Networking option 2 includes one provider network " "with one instance that uses it and one self-service (private) network with " "one instance that uses it." msgstr "" #: ../launch-instance.rst:13 msgid "" "The instructions in this section use command-line interface (CLI) tools on " "the controller node. However, you can follow the instructions on any host " "that the tools are installed." msgstr "" #: ../launch-instance.rst:17 msgid "" "For more information on the CLI tools, see the `OpenStackClient " "documentation for Pike `_, the `OpenStackClient " "documentation for Queens `_, or the " "`OpenStackClient documentation for Rocky `_." msgstr "" #: ../launch-instance.rst:24 msgid "" "To use the dashboard, see the `Dashboard User Documentation for Pike " "`_, the `Dashboard User " "Documentation for Queens `_, or the `Dashboard User Documentation for Rocky `_." msgstr "" #: ../launch-instance.rst:34 msgid "Create virtual networks" msgstr "" #: ../launch-instance.rst:36 msgid "" "Create virtual networks for the networking option that you chose when " "configuring Neutron. If you chose option 1, create only the provider " "network. If you chose option 2, create the provider and self-service " "networks." msgstr "" #: ../launch-instance.rst:47 msgid "" "After creating the appropriate networks for your environment, you can " "continue preparing the environment to launch an instance." msgstr "" #: ../launch-instance.rst:51 msgid "Create m1.nano flavor" msgstr "" #: ../launch-instance.rst:53 msgid "" "The smallest default flavor consumes 512 MB memory per instance. For " "environments with compute nodes containing less than 4 GB memory, we " "recommend creating the ``m1.nano`` flavor that only requires 64 MB per " "instance. Only use this flavor with the CirrOS image for testing purposes." msgstr "" #: ../launch-instance.rst:80 msgid "Generate a key pair" msgstr "" #: ../launch-instance.rst:82 msgid "" "Most cloud images support :term:`public key authentication` rather than " "conventional password authentication. Before launching an instance, you must " "add a public key to the Compute service." msgstr "" #: ../launch-instance.rst:86 msgid "Source the ``demo`` project credentials:" msgstr "" #: ../launch-instance.rst:92 msgid "Generate a key pair and add a public key:" msgstr "" #: ../launch-instance.rst:109 msgid "" "Alternatively, you can skip the ``ssh-keygen`` command and use an existing " "public key." msgstr "" #: ../launch-instance.rst:112 msgid "Verify addition of the key pair:" msgstr "" #: ../launch-instance.rst:125 msgid "Add security group rules" msgstr "" #: ../launch-instance.rst:127 msgid "" "By default, the ``default`` security group applies to all instances and " "includes firewall rules that deny remote access to instances. For Linux " "images such as CirrOS, we recommend allowing at least ICMP (ping) and secure " "shell (SSH)." msgstr "" #: ../launch-instance.rst:132 msgid "Add rules to the ``default`` security group:" msgstr "" #: ../launch-instance.rst:134 msgid "Permit :term:`ICMP ` (ping):" msgstr "" #: ../launch-instance.rst:160 msgid "Permit secure shell (SSH) access:" msgstr "" #: ../launch-instance.rst:189 msgid "" "If you chose networking option 1, you can only launch an instance on the " "provider network. If you chose networking option 2, you can launch an " "instance on the provider network and the self-service network." msgstr "" #: ../launch-instance.rst:204 msgid "" "If your environment includes the Block Storage service, you can create a " "volume and attach it to an instance." msgstr "" #: ../launch-instance.rst:213 msgid "Orchestration" msgstr "" #: ../launch-instance.rst:215 msgid "" "If your environment includes the Orchestration service, you can create a " "stack that launches an instance." msgstr "" #: ../launch-instance.rst:218 msgid "" "For more information, see the `Orchestration installation guide for Pike " "`_, the `Orchestration " "installation guide for Queens `_, or the `Orchestration installation guide for Rocky `_." msgstr "" #: ../launch-instance.rst:226 msgid "Shared File Systems" msgstr "" #: ../launch-instance.rst:228 msgid "" "If your environment includes the Shared File Systems service, you can create " "a share and mount it in an instance." msgstr "" #: ../launch-instance.rst:231 msgid "" "For more information, see the `Shared File Systems installation guide for " "Pike `_, the `Shared File " "Systems installation guide for Queens `_, or the `Shared File Systems installation guide for Rocky " "`_." msgstr "" #: ../openstack-services.rst:3 msgid "Install OpenStack services" msgstr "" #: ../openstack-services.rst:5 msgid "" "The installation of individual OpenStack services is covered in the Project " "Installation Guides that are available at the following locations:" msgstr "" #: ../openstack-services.rst:9 msgid "" "`OpenStack Installation Guides for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:11 msgid "" "`OpenStack Installation Guides for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:13 msgid "" "`OpenStack Installation Guides for Zed `_" msgstr "" #: ../openstack-services.rst:15 msgid "" "`OpenStack Installation Guides for Yoga `_" msgstr "" #: ../openstack-services.rst:17 msgid "" "`OpenStack Installation Guides for Xena `_" msgstr "" #: ../openstack-services.rst:19 msgid "" "`OpenStack Installation Guides for Wallaby `_" msgstr "" #: ../openstack-services.rst:21 msgid "" "`OpenStack Installation Guides for Victoria `_" msgstr "" #: ../openstack-services.rst:23 msgid "" "`OpenStack Installation Guides for Ussuri `_" msgstr "" #: ../openstack-services.rst:25 msgid "" "`OpenStack Installation Guides for Train `_" msgstr "" #: ../openstack-services.rst:27 msgid "" "`OpenStack Installation Guides for Stein `_" msgstr "" #: ../openstack-services.rst:31 msgid "Minimal deployment for 2023.2 (Bobcat)" msgstr "" #: ../openstack-services.rst:33 ../openstack-services.rst:56 #: ../openstack-services.rst:79 ../openstack-services.rst:102 #: ../openstack-services.rst:125 ../openstack-services.rst:148 #: ../openstack-services.rst:171 ../openstack-services.rst:194 #: ../openstack-services.rst:217 ../openstack-services.rst:240 msgid "" "At a minimum, you need to install the following services. Install the " "services in the order specified below:" msgstr "" #: ../openstack-services.rst:36 msgid "" "Identity service – `keystone installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:38 msgid "" "Image service – `glance installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:40 msgid "" "Placement service – `placement installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:42 msgid "" "Compute service – `nova installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:44 msgid "" "Networking service – `neutron installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:47 ../openstack-services.rst:70 #: ../openstack-services.rst:93 ../openstack-services.rst:116 #: ../openstack-services.rst:139 ../openstack-services.rst:162 #: ../openstack-services.rst:185 ../openstack-services.rst:208 #: ../openstack-services.rst:231 ../openstack-services.rst:254 msgid "" "We advise to also install the following components after you have installed " "the minimal deployment services:" msgstr "" #: ../openstack-services.rst:50 msgid "" "Dashboard – `horizon installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:51 msgid "" "Block Storage service – `cinder installation for 2023.2 (Bobcat) `_" msgstr "" #: ../openstack-services.rst:54 msgid "Minimal deployment for 2023.1 (Antelope)" msgstr "" #: ../openstack-services.rst:59 msgid "" "Identity service – `keystone installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:61 msgid "" "Image service – `glance installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:63 msgid "" "Placement service – `placement installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:65 msgid "" "Compute service – `nova installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:67 msgid "" "Networking service – `neutron installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:73 msgid "" "Dashboard – `horizon installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:74 msgid "" "Block Storage service – `cinder installation for 2023.1 (Antelope) `_" msgstr "" #: ../openstack-services.rst:77 msgid "Minimal deployment for Zed" msgstr "" #: ../openstack-services.rst:82 msgid "" "Identity service – `keystone installation for Zed `_" msgstr "" #: ../openstack-services.rst:84 msgid "" "Image service – `glance installation for Zed `_" msgstr "" #: ../openstack-services.rst:86 msgid "" "Placement service – `placement installation for Zed `_" msgstr "" #: ../openstack-services.rst:88 msgid "" "Compute service – `nova installation for Zed `_" msgstr "" #: ../openstack-services.rst:90 msgid "" "Networking service – `neutron installation for Zed `_" msgstr "" #: ../openstack-services.rst:96 msgid "" "Dashboard – `horizon installation for Zed `_" msgstr "" #: ../openstack-services.rst:97 msgid "" "Block Storage service – `cinder installation for Zed `_" msgstr "" #: ../openstack-services.rst:100 msgid "Minimal deployment for Yoga" msgstr "" #: ../openstack-services.rst:105 msgid "" "Identity service – `keystone installation for Yoga `_" msgstr "" #: ../openstack-services.rst:107 msgid "" "Image service – `glance installation for Yoga `_" msgstr "" #: ../openstack-services.rst:109 msgid "" "Placement service – `placement installation for Yoga `_" msgstr "" #: ../openstack-services.rst:111 msgid "" "Compute service – `nova installation for Yoga `_" msgstr "" #: ../openstack-services.rst:113 msgid "" "Networking service – `neutron installation for Yoga `_" msgstr "" #: ../openstack-services.rst:119 msgid "" "Dashboard – `horizon installation for Yoga `_" msgstr "" #: ../openstack-services.rst:120 msgid "" "Block Storage service – `cinder installation for Yoga `_" msgstr "" #: ../openstack-services.rst:123 msgid "Minimal deployment for Xena" msgstr "" #: ../openstack-services.rst:128 msgid "" "Identity service – `keystone installation for Xena `_" msgstr "" #: ../openstack-services.rst:130 msgid "" "Image service – `glance installation for Xena `_" msgstr "" #: ../openstack-services.rst:132 msgid "" "Placement service – `placement installation for Xena `_" msgstr "" #: ../openstack-services.rst:134 msgid "" "Compute service – `nova installation for Xena `_" msgstr "" #: ../openstack-services.rst:136 msgid "" "Networking service – `neutron installation for Xena `_" msgstr "" #: ../openstack-services.rst:142 msgid "" "Dashboard – `horizon installation for Xena `_" msgstr "" #: ../openstack-services.rst:143 msgid "" "Block Storage service – `cinder installation for Xena `_" msgstr "" #: ../openstack-services.rst:146 msgid "Minimal deployment for Wallaby" msgstr "" #: ../openstack-services.rst:151 msgid "" "Identity service – `keystone installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:153 msgid "" "Image service – `glance installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:155 msgid "" "Placement service – `placement installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:157 msgid "" "Compute service – `nova installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:159 msgid "" "Networking service – `neutron installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:165 msgid "" "Dashboard – `horizon installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:166 msgid "" "Block Storage service – `cinder installation for Wallaby `_" msgstr "" #: ../openstack-services.rst:169 msgid "Minimal deployment for Victoria" msgstr "" #: ../openstack-services.rst:174 msgid "" "Identity service – `keystone installation for Victoria `_" msgstr "" #: ../openstack-services.rst:176 msgid "" "Image service – `glance installation for Victoria `_" msgstr "" #: ../openstack-services.rst:178 msgid "" "Placement service – `placement installation for Victoria `_" msgstr "" #: ../openstack-services.rst:180 msgid "" "Compute service – `nova installation for Victoria `_" msgstr "" #: ../openstack-services.rst:182 msgid "" "Networking service – `neutron installation for Victoria `_" msgstr "" #: ../openstack-services.rst:188 msgid "" "Dashboard – `horizon installation for Victoria `_" msgstr "" #: ../openstack-services.rst:189 msgid "" "Block Storage service – `cinder installation for Victoria `_" msgstr "" #: ../openstack-services.rst:192 msgid "Minimal deployment for Ussuri" msgstr "" #: ../openstack-services.rst:197 msgid "" "Identity service – `keystone installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:199 msgid "" "Image service – `glance installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:201 msgid "" "Placement service – `placement installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:203 msgid "" "Compute service – `nova installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:205 msgid "" "Networking service – `neutron installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:211 msgid "" "Dashboard – `horizon installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:212 msgid "" "Block Storage service – `cinder installation for Ussuri `_" msgstr "" #: ../openstack-services.rst:215 msgid "Minimal deployment for Train" msgstr "" #: ../openstack-services.rst:220 msgid "" "Identity service – `keystone installation for Train `_" msgstr "" #: ../openstack-services.rst:222 msgid "" "Image service – `glance installation for Train `_" msgstr "" #: ../openstack-services.rst:224 msgid "" "Placement service – `placement installation for Train `_" msgstr "" #: ../openstack-services.rst:226 msgid "" "Compute service – `nova installation for Train `_" msgstr "" #: ../openstack-services.rst:228 msgid "" "Networking service – `neutron installation for Train `_" msgstr "" #: ../openstack-services.rst:234 msgid "" "Dashboard – `horizon installation for Train `_" msgstr "" #: ../openstack-services.rst:235 msgid "" "Block Storage service – `cinder installation for Train `_" msgstr "" #: ../openstack-services.rst:238 msgid "Minimal deployment for Stein" msgstr "" #: ../openstack-services.rst:243 msgid "" "Identity service – `keystone installation for Stein `_" msgstr "" #: ../openstack-services.rst:245 msgid "" "Image service – `glance installation for Stein `_" msgstr "" #: ../openstack-services.rst:247 msgid "" "Placement service – `placement installation for Stein `_" msgstr "" #: ../openstack-services.rst:249 msgid "" "Compute service – `nova installation for Stein `_" msgstr "" #: ../openstack-services.rst:251 msgid "" "Networking service – `neutron installation for Stein `_" msgstr "" #: ../openstack-services.rst:257 msgid "" "Dashboard – `horizon installation for Stein `_" msgstr "" #: ../openstack-services.rst:258 msgid "" "Block Storage service – `cinder installation for Stein `_" msgstr "" #: ../overview.rst:3 msgid "Overview" msgstr "" #: ../overview.rst:5 msgid "" "The :term:`OpenStack` project is an open source cloud computing platform " "that supports all types of cloud environments. The project aims for simple " "implementation, massive scalability, and a rich set of features. Cloud " "computing experts from around the world contribute to the project." msgstr "" #: ../overview.rst:10 msgid "" "OpenStack provides an :term:`Infrastructure-as-a-Service (IaaS)` solution " "through a variety of complementary services. Each service offers an :term:" "`Application Programming Interface (API)` that facilitates this integration." msgstr "" #: ../overview.rst:15 msgid "" "This guide covers step-by-step deployment of the major OpenStack services " "using a functional example architecture suitable for new users of OpenStack " "with sufficient Linux experience. This guide is not intended to be used for " "production system installations, but to create a minimum proof-of-concept " "for the purpose of learning about OpenStack." msgstr "" #: ../overview.rst:21 msgid "" "After becoming familiar with basic installation, configuration, operation, " "and troubleshooting of these OpenStack services, you should consider the " "following steps toward deployment using a production architecture:" msgstr "" #: ../overview.rst:25 msgid "" "Determine and implement the necessary core and optional services to meet " "performance and redundancy requirements." msgstr "" #: ../overview.rst:28 msgid "" "Increase security using methods such as firewalls, encryption, and service " "policies." msgstr "" #: ../overview.rst:31 msgid "" "Use a deployment tool such as Ansible, Chef, Puppet, or Salt to automate " "deployment and management of the production environment. The OpenStack " "project has a couple of deployment projects with specific guides per " "version: - `2023.2 (Bobcat) release `_ - `2023.1 (Antelope) release `_ - `Zed release `_ - `Yoga " "release `_ - `Xena release `_ - `Wallaby release `_ - `Victoria release `_ - `Ussuri release `_ - `Train release `_ - " "`Stein release `_" msgstr "" #: ../overview.rst:49 msgid "Example architecture" msgstr "" #: ../overview.rst:51 msgid "" "The example architecture requires at least two nodes (hosts) to launch a " "basic :term:`virtual machine ` or instance. Optional " "services such as Block Storage and Object Storage require additional nodes." msgstr "" #: ../overview.rst:57 msgid "" "The example architecture used in this guide is a minimum configuration, and " "is not intended for production system installations. It is designed to " "provide a minimum proof-of-concept for the purpose of learning about " "OpenStack. For information on creating architectures for specific use cases, " "or how to determine which architecture is required, see the `Architecture " "Design Guide `_." msgstr "" #: ../overview.rst:64 msgid "" "This example architecture differs from a minimal production architecture as " "follows:" msgstr "" #: ../overview.rst:67 msgid "" "Networking agents reside on the controller node instead of one or more " "dedicated network nodes." msgstr "" #: ../overview.rst:70 msgid "" "Overlay (tunnel) traffic for self-service networks traverses the management " "network instead of a dedicated network." msgstr "" #: ../overview.rst:73 msgid "" "For more information on production architectures for Pike, see the " "`Architecture Design Guide `_, " "`OpenStack Networking Guide for Pike `_, and `OpenStack Administrator Guides for Pike `_." msgstr "" #: ../overview.rst:79 msgid "" "For more information on production architectures for Queens, see the " "`Architecture Design Guide `_, " "`OpenStack Networking Guide for Queens `_, and `OpenStack Administrator Guides for Queens `_." msgstr "" #: ../overview.rst:85 msgid "" "For more information on production architectures for Rocky, see the " "`Architecture Design Guide `_, " "`OpenStack Networking Guide for Rocky `_, and `OpenStack Administrator Guides for Rocky `_." msgstr "" #: ../overview.rst:96 msgid "**Hardware requirements**" msgstr "" #: ../overview.rst:96 msgid "Hardware requirements" msgstr "" #: ../overview.rst:99 msgid "Controller" msgstr "" #: ../overview.rst:101 msgid "" "The controller node runs the Identity service, Image service, Placement " "service, management portions of Compute, management portion of Networking, " "various Networking agents, and the Dashboard. It also includes supporting " "services such as an SQL database, :term:`message queue`, and :term:`NTP " "`." msgstr "" #: ../overview.rst:107 msgid "" "Optionally, the controller node runs portions of the Block Storage, Object " "Storage, Orchestration, and Telemetry services." msgstr "" #: ../overview.rst:110 msgid "The controller node requires a minimum of two network interfaces." msgstr "" #: ../overview.rst:113 msgid "Compute" msgstr "" #: ../overview.rst:115 msgid "" "The compute node runs the :term:`hypervisor` portion of Compute that " "operates instances. By default, Compute uses the :term:`KVM ` hypervisor. The compute node also runs a Networking service agent " "that connects instances to virtual networks and provides firewalling " "services to instances via :term:`security groups `." msgstr "" #: ../overview.rst:122 msgid "" "You can deploy more than one compute node. Each node requires a minimum of " "two network interfaces." msgstr "" #: ../overview.rst:128 msgid "" "The optional Block Storage node contains the disks that the Block Storage " "and Shared File System services provision for instances." msgstr "" #: ../overview.rst:131 ../overview.rst:145 msgid "" "For simplicity, service traffic between compute nodes and this node uses the " "management network. Production environments should implement a separate " "storage network to increase performance and security." msgstr "" #: ../overview.rst:135 msgid "" "You can deploy more than one block storage node. Each node requires a " "minimum of one network interface." msgstr "" #: ../overview.rst:139 msgid "Object Storage" msgstr "" #: ../overview.rst:141 msgid "" "The optional Object Storage node contain the disks that the Object Storage " "service uses for storing accounts, containers, and objects." msgstr "" #: ../overview.rst:149 msgid "" "This service requires two nodes. Each node requires a minimum of one network " "interface. You can deploy more than two object storage nodes." msgstr "" #: ../overview.rst:153 msgid "Networking" msgstr "" #: ../overview.rst:155 msgid "Choose one of the following virtual networking options." msgstr "" #: ../overview.rst:160 msgid "Networking Option 1: Provider networks" msgstr "" #: ../overview.rst:162 msgid "" "The provider networks option deploys the OpenStack Networking service in the " "simplest way possible with primarily layer-2 (bridging/switching) services " "and VLAN segmentation of networks. Essentially, it bridges virtual networks " "to physical networks and relies on physical network infrastructure for " "layer-3 (routing) services. Additionally, a :term:`DHCP` service provides IP address information to " "instances." msgstr "" #: ../overview.rst:170 msgid "" "The OpenStack user requires more information about the underlying network " "infrastructure to create a virtual network to exactly match the " "infrastructure." msgstr "" #: ../overview.rst:176 msgid "" "This option lacks support for self-service (private) networks, layer-3 " "(routing) services, and advanced services such as :term:`LBaaS ` and :term:`FWaaS`. Consider the self-service networks option below if you desire " "these features." msgstr "" #: ../overview.rst:190 msgid "Networking Option 2: Self-service networks" msgstr "" #: ../overview.rst:192 msgid "" "The self-service networks option augments the provider networks option with " "layer-3 (routing) services that enable :term:`self-service` networks using " "overlay segmentation methods such as :term:`VXLAN `. Essentially, it routes virtual networks to physical networks " "using :term:`NAT`. Additionally, this " "option provides the foundation for advanced services such as LBaaS and FWaaS." msgstr "" #: ../overview.rst:200 msgid "" "The OpenStack user can create virtual networks without the knowledge of " "underlying infrastructure on the data network. This can also include VLAN " "networks if the layer-2 plug-in is configured accordingly." msgstr "" #: ../overview.rst:-1 msgid "Networking Option 1: Provider networks - Service layout" msgstr "" #: ../overview.rst:-1 msgid "Networking Option 2: Self-service networks - Service layout" msgstr "" #: ../preface.rst:3 msgid "Preface" msgstr "" #: ../preface.rst:6 msgid "Abstract" msgstr "" #: ../preface.rst:8 msgid "" "The OpenStack system consists of several key services that are separately " "installed. These services work together depending on your cloud needs and " "include the Compute, Identity, Networking, Image, Block Storage, Object " "Storage, Telemetry, Orchestration, and Database services. You can install " "any of these projects separately and configure them stand-alone or as " "connected entities." msgstr "" #: ../preface.rst:15 msgid "" "Explanations of configuration options and sample configuration files are " "included." msgstr "" #: ../preface.rst:18 msgid "" "This guide documents the installation of OpenStack starting with the Pike " "release. It covers multiple releases." msgstr "" #: ../preface.rst:23 msgid "" "This guide is a work-in-progress and is subject to updates frequently. Pre-" "release packages have been used for testing, and some instructions may not " "work with final versions. Please help us make this guide better by reporting " "any errors you encounter." msgstr "" #: ../preface.rst:29 msgid "Operating systems" msgstr "" #: ../preface.rst:31 msgid "" "Currently, this guide describes OpenStack installation for the following " "Linux distributions:" msgstr "" #: ../preface.rst:35 msgid "" "You can install OpenStack by using packages on openSUSE Leap 42.3, openSUSE " "Leap 15, SUSE Linux Enterprise Server 12 SP4, SUSE Linux Enterprise Server " "15 through the Open Build Service Cloud repository." msgstr "" #: ../preface.rst:38 msgid "openSUSE and SUSE Linux Enterprise Server" msgstr "" #: ../preface.rst:41 msgid "" "You can install OpenStack by using packages available on both Red Hat " "Enterprise Linux 7 and 8 and their derivatives through the RDO repository." msgstr "" #: ../preface.rst:47 msgid "" "OpenStack Wallaby is available for CentOS Stream 8. OpenStack Ussuri and " "Victoria are available for both CentOS 8 and RHEL 8. OpenStack Train and " "earlier are available on both CentOS 7 and RHEL 7." msgstr "" #: ../preface.rst:49 msgid "Red Hat Enterprise Linux and CentOS" msgstr "" #: ../preface.rst:52 msgid "" "You can walk through an installation by using packages available through " "Canonical's Ubuntu Cloud archive repository for Ubuntu 16.04+ (LTS)." msgstr "" #: ../preface.rst:57 msgid "" "The Ubuntu Cloud Archive pockets for Pike and Queens provide OpenStack " "packages for Ubuntu 16.04 LTS; OpenStack Queens is installable direct using " "Ubuntu 18.04 LTS; the Ubuntu Cloud Archive pockets for Rocky and Stein " "provide OpenStack packages for Ubuntu 18.04 LTS; the Ubuntu Cloud Archive " "pocket for Victoria provides OpenStack packages for Ubuntu 20.04 LTS." msgstr "" #: ../preface.rst:61 msgid "Ubuntu" msgstr "" #: ../shared/edit_hosts_file.txt:1 msgid "Edit the ``/etc/hosts`` file to contain the following:" msgstr "" #: ../shared/edit_hosts_file.txt:22 msgid "" "Some distributions add an extraneous entry in the ``/etc/hosts`` file that " "resolves the actual hostname to another loopback IP address such as " "``127.0.1.1``. You must comment out or remove this entry to prevent name " "resolution problems. **Do not remove the 127.0.0.1 entry.**" msgstr "" #: ../shared/edit_hosts_file.txt:30 msgid "" "This guide includes host entries for optional services in order to reduce " "complexity should you choose to deploy them." msgstr ""