From 154ce7b8739632a5c1afafdd910c0a2cd9c18cd9 Mon Sep 17 00:00:00 2001 From: Alex Schultz Date: Fri, 15 Jun 2018 15:58:59 -0600 Subject: [PATCH] Document single nic configuration for standalone The standalone installation can be done on a single nic provided that 3 ip addresses are available. The original docs have been updated to describe the traditional 2 nic setup. Change-Id: I16ef7a14ef2aafaa0d3212fe2af7b9f4f2c54023 Related-Blueprint: all-in-one --- .../containers_deployment/standalone.rst | 155 +++++++++++++----- 1 file changed, 111 insertions(+), 44 deletions(-) diff --git a/doc/source/install/containers_deployment/standalone.rst b/doc/source/install/containers_deployment/standalone.rst index 247b075e..b9096b20 100644 --- a/doc/source/install/containers_deployment/standalone.rst +++ b/doc/source/install/containers_deployment/standalone.rst @@ -30,52 +30,120 @@ Deploying a Standalone Keystone node sudo yum install -y python-tripleoclient -#. Specify required parameters for network configuration:: +#. Configure standalone parameters which include container discovery, network + configuration, and some deployment options. - # TODO(aschultz): This still assumes a bunch of undercloud stuff that may - # not be needed anymore. Will need to clean this up. + The following configuration can be used for a system with 2 network + interfaces. This configuration assumes the first interface is used for + management and we will only configure the second interface. The deployment + assumes the second interface has a "public" /24 network which will be used + for the cloud endpoints and public VM connectivity. - export NETWORK=192.168.24 - export NETMASK=24 - export IP=$NETWORK.2 - export INTERFACE=eth1 + .. code-block:: bash - cat < $HOME/standalone_parameters.yaml - parameter_defaults: - CertmongerCA: local - CloudName: $IP - ContainerImagePrepare: - - set: - ceph_image: daemon - ceph_namespace: docker.io/ceph - ceph_tag: v3.0.3-stable-3.0-luminous-centos-7-x86_64 - name_prefix: centos-binary- - name_suffix: '' - namespace: docker.io/tripleomaster - neutron_driver: null - tag: current-tripleo - tag_from_label: rdo_version - ControlPlaneStaticRoutes: [] - Debug: true - DeploymentUser: $USER - DnsServers: '' - DockerInsecureRegistryAddress: - - $IP:8787 - MasqueradeNetworks: - $NETWORK.0/$NETMASK: - - $NETWORK.0/$NETMASK - NeutronPublicInterface: $INTERFACE - StandaloneCtlplaneLocalSubnet: ctlplane-subnet - StandaloneCtlplaneSubnets: - ctlplane-subnet: - DhcpRangeEnd: $NETWORK.40 - DhcpRangeStart: $NETWORK.20 - NetworkCidr: $NETWORK.0/$NETMASK - NetworkGateway: $IP - StandaloneEnableRoutedNetworks: false - StandaloneHomeDir: $HOME - StandaloneLocalMtu: 1500 - EOF + # EXAMPLE: 2 interfaces + # TODO(aschultz): This still assumes a bunch of undercloud stuff that may + # not be needed anymore. Will need to clean this up. + + export IP=192.168.24.2 + export NETMASK=24 + export INTERFACE=eth1 + + cat < $HOME/standalone_parameters.yaml + parameter_defaults: + CertmongerCA: local + CloudName: $IP + ContainerImagePrepare: + - set: + ceph_image: daemon + ceph_namespace: docker.io/ceph + ceph_tag: v3.0.3-stable-3.0-luminous-centos-7-x86_64 + name_prefix: centos-binary- + name_suffix: '' + namespace: docker.io/tripleomaster + neutron_driver: null + tag: current-tripleo + tag_from_label: rdo_version + ControlPlaneStaticRoutes: [] + Debug: true + DeploymentUser: $USER + DnsServers: '' + DockerInsecureRegistryAddress: + - $IP:8787 + NeutronPublicInterface: $INTERFACE + # re-use ctlplane bridge for public net + NeutronBridgeMappings: datacentre:br-ctlplane + NeutronPhysicalBridge: br-ctlplane + # enable to force metadata for public net + #NeutronEnableForceMetadata: true + StandaloneEnableRoutedNetworks: false + StandaloneHomeDir: $HOME + StandaloneLocalMtu: 1500 + # Needed if running in a VM + StandaloneExtraConfig: + nova::compute::libvirt::services::libvirt_virt_type: qemu + nova::compute::libvirt::libvirt_virt_type: qemu + EOF + + The following configuration can be used for a system with a single network + interface. This configuration assumes that the interface is shared for + management and cloud functions. This configuration requires there be at + least 3 ip addresses available for configuration. 1 ip is used for the + cloud endpoints, 1 is used for an internal router and 1 is used as a + floating IP. + + .. code-block:: bash + + # EXAMPLE: 1 interface + # TODO(aschultz): This still assumes a bunch of undercloud stuff that may + # not be needed anymore. Will need to clean this up. + export IP=192.168.24.2 + export NETMASK=24 + # We need the gateway as we'll be reconfiguring the eth0 interface + export GATEWAY=192.168.24.1 + export INTERFACE=eth0 + + cat < $HOME/standalone_parameters.yaml + parameter_defaults: + CertmongerCA: local + CloudName: $IP + ContainerImagePrepare: + - set: + ceph_image: daemon + ceph_namespace: docker.io/ceph + ceph_tag: v3.0.3-stable-3.0-luminous-centos-7-x86_64 + name_prefix: centos-binary- + name_suffix: '' + namespace: docker.io/tripleomaster + neutron_driver: null + tag: current-tripleo + tag_from_label: rdo_version + # default gateway + ControlPlaneStaticRoutes: + - ip_netmask: 0.0.0.0/0 + next_hop: $GATEWAY + default: true + Debug: true + DeploymentUser: $USER + DnsServers: '' + # needed for vip & pacemaker + KernelIpNonLocalBind: 1 + DockerInsecureRegistryAddress: + - $IP:8787 + NeutronPublicInterface: $INTERFACE + # re-use ctlplane bridge for public net + NeutronBridgeMappings: datacentre:br-ctlplane + NeutronPhysicalBridge: br-ctlplane + # enable to force metadata for public net + #NeutronEnableForceMetadata: true + StandaloneEnableRoutedNetworks: false + StandaloneHomeDir: $HOME + StandaloneLocalMtu: 1500 + # Needed if running in a VM + StandaloneExtraConfig: + nova::compute::libvirt::services::libvirt_virt_type: qemu + nova::compute::libvirt::libvirt_virt_type: qemu + EOF #. Run deploy command:: @@ -135,4 +203,3 @@ Deploying a Standalone Keystone node export OS_CLOUD=standalone openstack endpoint list -