close

keyboard_arrow_left

Table of Contents Expand all

play_arrow Overview
- play_arrow Understanding Contrail Controller
  - Contrail Overview
  - Contrail Description
play_arrow Installing and Upgrading Contrail
- play_arrow Supported Platforms and Server Requirements
  - Server Requirements and Supported Platforms
- play_arrow Installing Contrail and Provisioning Roles
- play_arrow Installation and Configuration Scenarios
- play_arrow Upgrading Contrail Software
  - Contrail In-Service Software Upgrade from Releases 3.2 and 4.1 to 5.0.x using Ansible Deployer
  - Contrail In-Service Software Upgrade from Releases 3.2 and 4.1 to 5.0.x using Helm Deployer
- play_arrow Backup and Restore Contrail Software
  - Backing up Contrail Databases in JSON Format
- play_arrow Multicloud Contrail
- play_arrow Using Contrail with Kubernetes
- play_arrow Using VMware vCenter with Containerized Contrail
- play_arrow Using Contrail with Red Hat
  - Deploying Contrail with Red Hat OpenStack Platform Director 13
  - Provisioning Red Hat OpenShift Container Platform Clusters Using Ansible Deployer
- play_arrow Contrail and AppFormix Kolla/Ocata OpenStack Deployment
- play_arrow Using Contrail with Juju Charms
  - Deploying Contrail by Using Juju Charms
- play_arrow Contrail Command
- play_arrow Extending Contrail to Physical Routers, Bare Metal Servers, Switches, and Interfaces
- play_arrow Contrail for Data Center Automation and Fabric Management
play_arrow Configuring Contrail
- play_arrow Configuring Virtual Networks
- play_arrow Example of Deploying a Multi-Tier Web Application Using Contrail
  - Example: Deploying a Multi-Tier Web Application
  - Sample Network Configuration for Devices for Simple Tiered Web Application
- play_arrow Configuring Services
- play_arrow Configuring Service Chaining
- play_arrow Examples: Configuring Service Chaining
- play_arrow Adding Physical Network Functions in Service Chains
  - Using Physical Network Functions in Contrail Service Chains
  - Example: Adding a Physical Network Function Device to a Service Chain
- play_arrow QoS Support in Contrail
  - Quality of Service in Contrail
  - Configuring Network QoS Parameters
- play_arrow BGP as a Service
  - BGP as a Service
  - BGP as a Service in Contrail Release 3.1
- play_arrow Load Balancers
- play_arrow Optimizing Contrail
play_arrow Contrail Security
- play_arrow Contrail Security
  - Security Policy Enhancements
play_arrow Monitoring and Troubleshooting Contrail
- play_arrow Configuring Traffic Mirroring to Monitor Network Traffic
- play_arrow Understanding Contrail Analytics
- play_arrow Configuring Contrail Analytics
- play_arrow Using Contrail Analytics to Monitor and Troubleshoot the Network
- play_arrow Common Support Answers
play_arrow Contrail Commands and APIs
- play_arrow Contrail Commands
- play_arrow Contrail Application Programming Interfaces (APIs)

list Table of Contents

English

vCenter Integration for Contrail Release 5.0.2

date_range 16-Oct-23

arrow_backward

arrow_forward

These topics provide instructions for integrating Contrail Release 5.0.2 and microservices with VMware vCenter.

Prerequisites

Before you start the integration, ensure that the contrail controller meets the prerequisites given in Server Requirements and Supported Platforms.

Follow these steps to prepare Contrail controller(s):

content_copy zoom_out_map
yum update -y

yum install -y yum-plugin-priorities https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

yum install -y python-pip git gcc python-devel sshpass

yum install -y git

pip install “ansible==2.5.0” pyvmomi

ESX Agent Manager

VMware provides a standard vCenter solution called vSphere ESX Agent Manager (EAM), that allows you to deploy, monitor, and manage ContrailVMs on ESXi hosts.

Starting in Contrail Release 5.0.2, the ContrailVM is deployed as an Agent VM that is monitored by EAM. With this integration, ContrailVMs are marked as more critical and privileged than other tenant VMs on the host.

The following are the benefits of running ContrailVM as an AgentVM from EAM:

Auto-deploy ContrailVMs on ESXi hosts in scope (clusters).
Manage and Monitor ContrailVMs through EAM in the vSphere web client.
Integrate with other vCenter features like AddHos, Maintenance Mode, vSphere DRS, vSphere DPM, and VMWare HA.

These topics provide instructions for integrating Contrail Release 5.0.2 and microservices with VMware vCenter.

Set Up vCenter Server

Follow these steps to set up the vCenter server.

Download the Contrail Ansible Deployer (contrail-ansible-deployer-< >.tgz) onto your provisioning host. You can download the deployer from https://www.juniper.net/support/downloads/?p=contrail#sw.

Untar the tgz.

content_copy zoom_out_map
- tar xvf contrail-ansible-deployer-< >.tgz 

Prepare a vcenter_vars.yml file populated with vCenter server and ESXI hosts parameters. You can download the CentOS 7.5 and ESXi VM Host from https://www.juniper.net/support/downloads/?p=contrail#sw.

Note:

You can see a sample of the vcenter_vars.yml file in the contrail-ansible-deployer/playbooks /roles/vcenter/vars/vcenter_vars.yml after you extract the image files.

Note:

The ContrailVM’s Open Virtualization Format (OVF) image must be hosted on an http or https server which runs on and is reachable from the vCenter server. The location of the OVF is provided as a URL path for vmdk: as shown in the example given below.

Example: Enabling HA and DRS in the cluster

content_copy zoom_out_map
vcenter_servers:
  - SRV1:
      hostname: 
      username:
      password:
      # Optional: defaults to False
      #validate_certs: False
      datacentername: 
      clusternames:
      #path to the ovf, is needed for ESX Agent Manager to deploy ContrailVMs
      vmdk: http://<ip-address>/centos-7.5/LATEST/ContrailVM.ovf
      # Optional: If not specified HA and DRS are turned off on the clusters.
      enable_ha: yes
      enable_drs: yes

For definition examples, refer contrail-ansible-deployer/playbooks/roles/vcenter/vars/vcenter_vars.yml.sample.

To enable HA and DRS in the cluster, set enable_ha and enable_drs to yes in the vcenter_vars.yml file. If these flags are not enabled, HA and DRS is turned off by default for newly created and existing clusters.

Example instances.yaml File

content_copy zoom_out_map
provider_config:
  bms:
    ssh_pwd: password
    ssh_user: root
    ntpserver: 8.8.8.8
    domainsuffix: blah.net

instances:
  bms1:
    provider: bms
    ip: <ip-address>
    roles:
      config_database:
      config:
      control:
      analytics_database:
      analytics:
      webui:
      vcenter_plugin:
  bms2:
    provider: bms
    esxi_host: <ip-address>
    ip: <ip-address>
    roles:
      vrouter:
      vcenter_manager:
        ESXI_USERNAME: root
        ESXI_PASSWORD: password
  bms3:
    provider: bms
    esxi_host: <ip-address>
    ip: <ip-address>
    roles:
      vrouter:
      vcenter_manager:
        ESXI_USERNAME: root
        ESXI_PASSWORD: password
  bms4:
    provider: bms
    esxi_host: <ip-address>
    ip: <ip-address>
    roles:
      vrouter:
      vcenter_manager:
        ESXI_USERNAME: root
        ESXI_PASSWORD: password


global_configuration:
  CONTAINER_REGISTRY: hub.juniper.net/contrail
  CONTAINER_REGISTRY_USERNAME: username
  CONTAINER_REGISTRY_PASSWORD: password
  REGISTRY_PRIVATE_INSECURE: False

contrail_configuration:
  CLOUD_ORCHESTRATOR: vcenter
  CONTROLLER_NODES: <ip-address>
  CONTRAIL_VERSION: 5.0.2-0.360
  RABBITMQ_NODE_PORT: 5673
  VCENTER_SERVER: <ip-address>
  VCENTER_USERNAME: administrator@vsphere.net
  VCENTER_PASSWORD: password
  VCENTER_DATACENTER: <DC name here>
  VCENTER_DVSWITCH: overlay
  VCENTER_WSDL_PATH: /usr/src/contrail/contrail-web-core/webroot/js/vim.wsdl
  VCENTER_AUTH_PROTOCOL: https

Note:

The default login credentials for Contrail OVF is

Username: root

Password: c0ntrail123

Example vcenter_vars.yml File

content_copy zoom_out_map
---
vcenter_servers:
  - SRV1:
      hostname: <host-ip-address>
      username: administrator@vsphere.net
      password: password
      # Optional: defaults to False
      #validate_certs: False
      datacentername: "<your DC name here>"
      clusternames:
        - "<your cluster name here>"
      vmdk: http://<ip-address>/contrail/images/ContrailVM.ovf
      dv_switch:
        dv_switch_name: overlay
      dv_port_group:
        dv_portgroup_name: VM_pg
        number_of_ports: 1800

esxihosts:
  - name: <ip-address>
    username: root
    password: password
    datastore: <your local datastore here>
    datacenter: "<your DC name here>"
    cluster: "<your cluster name here>"
    contrail_vm:
      networks:
        - mac: 00:77:56:aa:bb:01
    vcenter_server: SRV1 #leave this
  - name: <ip-address>
    username: root
    password: password
    datastore: <your local datastore here>
    datacenter: "<your DC name here>"
    cluster: "<your cluster name here>"
    contrail_vm:
      networks:
        - mac: 00:77:56:aa:bb:02
    vcenter_server: SRV1 #leave this
  - name: <ip-address>
    username: root
    password: password
    datastore: <your local datastore here>
    datacenter: "<your DC name here>"
    cluster: "<your cluster name here>"
    contrail_vm:
      networks:
        - mac: 00:77:56:aa:bb:77
    vcenter_server: SRV1 #leave this

Run the Contrail vCenter playbook.
```
ansible-playbook playbooks/vcenter.yml
```

Note:

Verify that the hostnames for the contrail controller(s) and the ContrailVMs (vRouters) are unique in /etc/hostname file.

You can verify hostname from either the DHCP options (if the management network uses DHCP) or manually (if the management network uses static IP allocation).

Configure Contrail Parameters

Populate the file config/instances.yaml with Contrail roles.

For an example file, see contrail-ansible-deployer/confing/instances.yaml.vcenter_example.

Install Contrail

Install Contrail by running the following Contrail playbooks:

content_copy zoom_out_map
ansible-playbook -i inventory/ -e orchestrator=vcenter playbooks/configure_instances.yml
ansible-playbook -i inventory/ -e orchestrator=vcenter playbooks/install_contrail.yml

Monitor and Manage ContrailVM from ESX Agent Manager

ContrailVMs can be monitored from EAM by using ContrailVM-Agency.

Follow these steps to monitor and manage Contrail VM from EAM:

Resolve issues from the ContrailVM-Agency.
The ContrailVM-Agency is in an alert state when the ContrailVM in any host is powered off or is deleted.

Click Resolve All Issues from the ContrailVM-Agency to correct the issue. The ContrailVM-Agency will attempt to correct the issue by bringing the ContrailVM back online or by spawning a ContrailVM from the OVF on the ESXi host.

Figure 1: vCenter Server Extensions

Figure 2: ESX Agencies
Add host.
1. Add ESXi host to the cluster.
2. Configure Agent VM Settings for the ESXI host.
  Figure 3: Configure Agent VM Settings
  
  For more information on configuring Agent VM, network, and datastore settings, see Configure Agent VM Settings.
  
  EAM deploys a ContrailVM (from the base OVF) on the ESXi host.
3. Add ESXi host details to vcenter_vars.yml and repeat step 4 to add appropriate interfaces to the ContrailVM and to configure necessary settings in the vCenter server.
4. Add ContrailVM details to instances.yaml and provision Contrail on the newly added ContrailVm (router). For more information on provisioning Contrail, see Install Contrail.
Clean up the ContrailVM-Agency.
Delete ContrailVM-Agency from the EAM user interface to delete ContrailVM and the agency.

arrow_backward PREVIOUS vCenter Integration for Contrail Release 5.0.1

NEXT arrow_forward Underlay Network Configuration for ContrailVM

Contrail Feature Guide

ON THIS PAGE

vCenter Integration for Contrail Release 5.0.2

Prerequisites

ESX Agent Manager

Set Up vCenter Server

Configure Contrail Parameters

Install Contrail

Monitor and Manage ContrailVM from ESX Agent Manager

Stay in touch

Helped me install or use the product
Accelerated my deployment

Discuss the product with a co-worker
Make a purchase inquiry

Contrail Feature Guide

ON THIS PAGE

vCenter Integration for Contrail Release 5.0.2

Prerequisites

ESX Agent Manager

Set Up vCenter Server

Configure Contrail Parameters

Install Contrail

Monitor and Manage ContrailVM from ESX Agent Manager

Related Documentation

Stay in touch