close
keyboard_arrow_left
Contrail Networking Installation and Upgrade Guide
Table of Contents Expand all
- play_arrow Installing and Upgrading Contrail
- play_arrow Understanding Contrail
- play_arrow Supported Platforms and Server Requirements
- play_arrow Contrail Command
- How to Install Contrail Command and Provision Your Contrail Cluster
- How to Login to Contrail Command
- Navigating the Contrail Command UI
- Installing a Contrail Cluster using Contrail Command and instances.yml
- Importing Contrail Cluster Data using Contrail Command
- Adding a New Compute Node to Existing Contrail Cluster Using Contrail Command
- How to Deploy Contrail Command and Import a Cluster Using Juju
- Importing a Canonical Openstack Deployment Into Contrail Command
- play_arrow Upgrading Contrail Software
- Upgrading Contrail Networking using Contrail Command
- Upgrading Contrail Command using Backup Restore Procedure
- How to Perform a Zero Impact Contrail Networking Upgrade using the Ansible Deployer
- Updating Contrail Networking using the Zero Impact Upgrade Process in an Environment using Red Hat Openstack 16.1
- Updating Contrail Networking using the Zero Impact Upgrade Process in an Environment using Red Hat Openstack 13
- Updating Contrail Networking using the Zero Impact Upgrade Procedure in a Canonical Openstack Deployment with Juju Charms
- Upgrading Contrail Networking using the Ansible Deployer In-Service Software Upgrade Procedure in OpenStack Environments
- Upgrading Contrail Networking using contrail-ansible Deployer
- Upgrading Contrail Networking using In-Place Upgrade Procedure
- Upgrading Contrail Networking Release 19xx with RHOSP13 to Contrail Networking Release 2011 with RHOSP16.1
- play_arrow Backup and Restore Contrail Software
- play_arrow Using Contrail Networking with VMware vCenter
- play_arrow VMware vCenter with Containerized Contrail Networking
-
- play_arrow Using Contrail Networking with OpenStack
- play_arrow Setting Up Contrail with Red Hat OpenStack 16.1
- play_arrow Setting Up Contrail with Red Hat OpenStack 13
- play_arrow Configuring Virtual Networks
- play_arrow Using Contrail Resources in Heat Templates
- play_arrow QoS Support in Contrail Networking
- play_arrow Load Balancers
- play_arrow Optimizing Contrail Networking
- play_arrow Contrail Networking OpenStack Analytics
- play_arrow Contrail OpenStack APIs
-
- play_arrow Using Contrail with Juju Charms
- Installing Contrail with OpenStack by Using Juju Charms
- Installing Contrail with Kubernetes by Using Juju Charms
- Installing Contrail with Kubernetes in Nested Mode by Using Juju Charms
- Installing OpenStack Octavia LBaaS with Juju Charms in Contrail Networking
- Using Netronome SmartNIC vRouter with Contrail Networking and Juju Charms
- play_arrow Using Contrail and Contrail Insights with Kolla/Ocata OpenStack
- Contrail, Contrail Insights, and OpenStack Kolla/Ocata Deployment Requirements
- Preparing for the Installation
- Run the Playbooks
- Accessing Contrail in Contrail Insights Management Infrastructure in UI
- Notes and Caveats
- Example Instances.yml for Contrail and Contrail Insights OpenStack Deployment
- Contrail Insights Installation and Configuration for OpenStack
- Contrail Insights Installation for OpenStack in HA
- play_arrow Post Installation Tasks
- Configuring Role and Resource-Based Access Control
- Configuring Role-Based Access Control for Analytics
- Configuring the Control Node with BGP
- Configuring MD5 Authentication for BGP Sessions
- Configuring Transport Layer Security-Based XMPP in Contrail
- Configuring Graceful Restart and Long-lived Graceful Restart
- Scaling Up Contrail Networking Configuration API Server Instances
- Scaling Up Contrail Networking Configuration API
-
Loading...
list Table of Contents
file_download PDF
{
"lLangCode": "en",
"lName": "English",
"lCountryCode": "us",
"transcode": "en_US"
}
English
English
Chinese - 中文 (简体)
French - français
German - Deutsch
Japanese - 日本語
Korean - 한국어
Portuguese - Português
Spanish - Español
Setting Up the Undercloud
SUMMARY Follow this topic to setting up the undercloud for Contrail Networking deployment with RHOSP 16.1.
Install the Undercloud
Use this example procedure to install the undercloud.
- Log in to the undercloud VM from the undercloud KVM host.content_copy zoom_out_map
ssh ${undercloud_ip}
- Configure the hostname.content_copy zoom_out_map
undercloud_name=`hostname -s` undercloud_suffix=`hostname -d` hostnamectl set-hostname ${undercloud_name}.${undercloud_suffix} hostnamectl set-hostname --transient ${undercloud_name}.${undercloud_suffix}
- Add the hostname to the /etc/hosts file. The following example assumes the management interface is
eth0.content_copy zoom_out_map
undercloud_ip=`ip addr sh dev eth0 | grep "inet " | awk '{print $2}' | awk -F"/" '{print $1}'` echo ${undercloud_ip} ${undercloud_name}.${undercloud_suffix} ${undercloud_name} >> /etc/hosts
- Set up the repositories.
RHEL
content_copy zoom_out_map#Register with Satellite (can be done with CDN as well) satellite_fqdn=device.example.net act_key=xxx org=example yum localinstall -y http://${satellite_fqdn}/pub/katello-ca-consumer-latest.noarch.rpm subscription-manager register --activationkey=${act_key} --org=${org}
- Install the Tripleo client.content_copy zoom_out_map
yum install -y python-tripleoclient tmux
- Copy the undercloud configuration file sample and modify
the configuration as required. See Red Hat documentation for information on how to modify that
file.content_copy zoom_out_map
su - stack cp /usr/share/python-tripleoclient/undercloud.conf.sample ~/undercloud.conf vi ~/undercloud.conf
- Install the undercloud.content_copy zoom_out_map
openstack undercloud install source stackrc
- If you are using a satellite for deployment, manually
update the hostname and satellite IP addresses in your /etc/hosts/
file.
To perform this procedure using the VI editor:
content_copy zoom_out_map(undercloud) [stack@osp16-5c5s36 ~]$ sudo vi /etc/hosts
and manually enter your hostname and satellite IP address in the file while using the editor.
This step ensures that the overcloud deployment is successful later in the procedure.
You should also perform this step if the overcloud deployment fails later in the procedure and a failed lookup URL message appears on the console as the reason.
A sample failed lookup URL error message when you experience this issue:.
content_copy zoom_out_map======================== TASK [redhat-subscription : SATELLITE | Run Satellite 6 tasks] ***************** Tuesday 30 March 2021 12:11:25 -0400 (0:00:00.490) 0:13:39.737 ********* included: /usr/share/ansible/roles/redhat-subscription/tasks/satellite-6.yml for overcloud-controller-0, overcloud-controller-1, overcloud-controller-2 TASK [redhat-subscription : SATELLITE 6 | Set Satellite server CA as a fact] ***Tuesday 30 March 2021 12:11:26 -0400 (0:00:00.730) 0:13:40.467 ********* fatal: [overcloud-controller-0]: FAILED! =) {"msg": "An unhandled exception occurred while running the lookup plugin 'url'. Error was a <class 'ansible.errors.AnsibleError'>, original message: Failed lookup url for : <urlopen error [Errno -2] Name or service not known>"}fatal: [overcloud-controller-1]: FAILED! =) {"msg": "An unhandled exception occurred while running the lookup plugin 'url'. Error was a <class 'ansible.errors.AnsibleError'>, original message: Failed lookup url for : <urlopen error [Errno -2] Name or service not known>"} fatal: [overcloud-controller-2]: FAILED! =) {"msg": "An unhandled exception occurred while running the lookup plugin 'url'. Error was a <class 'ansible.errors.AnsibleError'>, original message: Failed lookup url for : <urlopen error [Errno -2] Name or service not known>"}
Perform Post-Install Configuration
- Configure a forwarding path between the provisioning network
and the external network:content_copy zoom_out_map
sudo iptables -A FORWARD -i br-ctlplane -o eth0 -j ACCEPT sudo iptables -A FORWARD -i eth0 -o br-ctlplane -m state --state RELATED,ESTABLISHED -j ACCEPT sudo iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
- Add the external API interface:content_copy zoom_out_map
sudo ip link add name vlan720 link br-ctlplane type vlan id 720 sudo ip addr add 10.2.0.254/24 dev vlan720 sudo ip link set dev vlan720 up
- Add the
stack
user to the docker group:content_copy zoom_out_mapnewgrp docker exit su - stack source stackrc
- Manually add the satellite IP address and hostname into the /etc/hosts/ file.