Cisco Virtual Topology System (VTS) 2.6 Installation Guide

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco Virtual Topology System (VTS) 2.6 Installation Guide

Chapter Title

Running VTC and VTSR within OpenStack as Tenant Virtual Machines

Results

Updated:
November 18, 2017

Chapter: Running VTC and VTSR within OpenStack as Tenant Virtual Machines

Running VTC and VTSR within OpenStack as Tenant Virtual Machines

In certain deployment scenarios, it may be necessary to run VTC and/or VTSR as tenant VMs on OpenStack. This is a deviation from the recommended method of running VTC and VTSR directly on KVM. This appendix provides details on the considerations and steps required in such scenarios.

This appendix has the following section:

Running VTC and VTSR within OpenStack as Tenant VMs


Note

If VTC and/or VTSR are running as tenant VMs, the management and underlay networks which they are attached to must be independent of the tenant networks which they are designed to manage later on.

To run VTC/VTSR as a tenant VM, the following consideration needs to be made:

  • The nova flavor should match VTC/VTSR's requirements.

  • The VTC/VTSR VM should use persistent instead of ephemeral storage. This is achieved by using a cinder volume as the persistent drive.

  • There must be a way to auto-configure VTC parameters using a config drive. This is achieved by using a 2nd cinder volume, mounted as CDROM.


Note

After VTC is launched, its default password needs to be changed from the Web UI before VTSR registers correctly.

Prerequisites:

  • VTC and VTSR software image have been downloaded from cisco.com to OpenStack controller node.

  • Config ISO images for VTC and VTSR have been created.

  • Cinder volume should have at least 130G of space available. For example: VTC requires 48G and VTSR requires 80G based on 2.5.0.

  • Neutron networks for attaching VTC (2x NICs) and VTSR's (6x NICs) have been created.

For VTC

The following section details the steps specific to VTC.

    Step 1   Glance VTC image into OpenStack. For example: 
    glance image-create --file vtc.qcow2 --progress --visibility public --disk-format qcow2 --name vtc250 --container-format bare
[=============================>] 100%
+------------------+--------------------------------------+
| Property         | Value                                |
+------------------+--------------------------------------+
| checksum         | e195df17122ec8bdaa771b3d148546e4     |
| container_format | bare                                 |
| created_at       | 2017-08-03T13:42:39Z                 |
| disk_format      | qcow2                                |
| id               | 52a10029-91ef-44f6-9f78-159cead8da9c |
| min_disk         | 0                                    |
| min_ram          | 0                                    |
| name             | vtc250                               |
| owner            | ea71291e36e94fa1b5745779b1d456cc     |
| protected        | False                                |
| size             | 10529538048                          |
| status           | active                               |
| tags             | []                                   |
| updated_at       | 2017-08-03T13:44:10Z                 |
| virtual_size     | None                                 |
| visibility       | public                               |
+------------------+--------------------------------------+
    Step 2   Create a (persistent) cinder volume for booting up VTC, based on VTC image. For example: 
    openstack volume create --image vtc250 --size 48 vtc_vol
+---------------------+--------------------------------------+
| Field               | Value                                |
+---------------------+--------------------------------------+
| attachments         | []                                   |
| availability_zone   | nova                                 |
| bootable            | false                                |
| consistencygroup_id | None                                 |
| created_at          | 2017-08-03T13:45:05.573850           |
| description         | None                                 |
| encrypted           | False                                |
| id                  | e4fb13fb-a23a-45ce-a2b4-0a3cfe4916af |
| migration_status    | None                                 |
| multiattach         | False                                |
| name                | vtc_vol                              |
| properties          |                                      |
| replication_status  | disabled                             |
| size                | 48                                   |
| snapshot_id         | None                                 |
| source_volid        | None                                 |
| status              | creating                             |
| type                | None                                 |
| user_id             | 3b5684ca7fd2418084090b48904a9237     |
+---------------------+--------------------------------------+
    Step 3   Create VTC config image based on VTC config drive (vtc_config_250.iso). For example: 
    openstack image create vtc_config --file vtc_config_250.iso --disk-format iso --container-format bare
+------------------+------------------------------------------------------+
| Field            | Value                                                |
+------------------+------------------------------------------------------+
| checksum         | c020985f6de566b3b8b6bad02e440f93                     |
| container_format | bare                                                 |
| created_at       | 2017-08-03T13:46:40Z                                 |
| disk_format      | iso                                                  |
| file             | /v2/images/0d74a180-9af4-4dfb-bc81-1f31b11f5a4e/file |
| id               | 0d74a180-9af4-4dfb-bc81-1f31b11f5a4e                 |
| min_disk         | 0                                                    |
| min_ram          | 0                                                    |
| name             | vtc_config                                           |
| owner            | ea71291e36e94fa1b5745779b1d456cc                     |
| protected        | False                                                |
| schema           | /v2/schemas/image                                    |
| size             | 358400                                               |
| status           | active                                               |
| tags             |                                                      |
| updated_at       | 2017-08-03T13:46:41Z                                 |
| virtual_size     | None                                                 |
| visibility       | private                                              |
+------------------+------------------------------------------------------+
    Step 4   Set VTC config image properties. For example: 
    openstack image set --property hw_cdrom_bus=ide --property hw-disk_bus=ide vtc_config
    Step 5   Create VTC config cinder volume, based on VTC config image. For example: 
    openstack volume create vtc_config_vol --image vtc_config --size 1
+---------------------+--------------------------------------+
| Field               | Value                                |
+---------------------+--------------------------------------+
| attachments         | []                                   |
| availability_zone   | nova                                 |
| bootable            | false                                |
| consistencygroup_id | None                                 |
| created_at          | 2017-08-03T13:48:37.932104           |
| description         | None                                 |
| encrypted           | False                                |
| id                  | 32c93acf-0e35-4a67-89b9-44ae190ac76a |
| migration_status    | None                                 |
| multiattach         | False                                |
| name                | vtc_config_vol                       |
| properties          |                                      |
| replication_status  | disabled                             |
| size                | 1                                    |
| snapshot_id         | None                                 |
| source_volid        | None                                 |
| status              | creating                             |
| type                | None                                 |
| user_id             | 3b5684ca7fd2418084090b48904a9237     |
+---------------------+--------------------------------------+
    Step 6   Boot VTC volume with attached config drive (volume). For Example: 
    nova boot --flavor m1.large \
--nic net-id=f12b2a45-aa80-42b3-8007-57730a1325fd \
--nic net-id=ec6e25c2-48e5-4f1a-9f09-774cc4ae0750 \
--block-device id=e4fb13fb-a23a-45ce-a2b4-0a3cfe4916af,source=volume,dest=volume,device=/dev/vda,bootindex=0  \
--block-device id=32c93acf-0e35-4a67-89b9-44ae190ac76a,source=volume,dest=volume,bus=ide,device=/dev/vdb,type=cdrom \
vtc
+--------------------------------------+--------------------------------------------------------------------------------------------------+
| Property                             | Value                                                                                            |
+--------------------------------------+--------------------------------------------------------------------------------------------------+
| OS-DCF:diskConfig                    | MANUAL                                                                                           |
| OS-EXT-AZ:availability_zone          |                                                                                                  |
| OS-EXT-SRV-ATTR:host                 | -                                                                                                |
| OS-EXT-SRV-ATTR:hypervisor_hostname  | -                                                                                                |
| OS-EXT-SRV-ATTR:instance_name        | instance-00000096                                                                                |
| OS-EXT-STS:power_state               | 0                                                                                                |
| OS-EXT-STS:task_state                | scheduling                                                                                       |
| OS-EXT-STS:vm_state                  | building                                                                                         |
| OS-SRV-USG:launched_at               | -                                                                                                |
| OS-SRV-USG:terminated_at             | -                                                                                                |
| accessIPv4                           |                                                                                                  |
| accessIPv6                           |                                                                                                  |
| adminPass                            | KCvjE9aZQ7Td                                                                                     |
| config_drive                         |                                                                                                  |
| created                              | 2017-08-03T13:52:01Z                                                                             |
| flavor                               | m1.large (4)                                                                                     |
| hostId                               |                                                                                                  |
| id                                   | dd38f88b-95a8-40c7-8670-538be76e91ce                                                             |
| image                                | Attempt to boot from volume - no image supplied                                                  |
| key_name                             | -                                                                                                |
| metadata                             | {}                                                                                               |
| name                                 | vtc                                                                                              |
| os-extended-volumes:volumes_attached | [{"id": "e4fb13fb-a23a-45ce-a2b4-0a3cfe4916af"}, {"id": "32c93acf-0e35-4a67-89b9-44ae190ac76a"}] |
| progress                             | 0                                                                                                |
| security_groups                      | default                                                                                          |
| status                               | BUILD                                                                                            |
| tenant_id                            | ea71291e36e94fa1b5745779b1d456cc                                                                 |
| updated                              | 2017-08-03T13:52:02Z                                                                             |
| user_id                              | 3b5684ca7fd2418084090b48904a9237                                                                 |
+--------------------------------------+--------------------------------------------------------------------------------------------------+

    For VTSR

    The following section details the steps specific to VTSR:

      Step 1   Glance VTSR Image into OpenStack. For Example: 
      glance image-create --file vtsr.qcow2 --progress --visibility public --disk-format qcow2 --name vtsr250 --container-format bare
[=============================>] 100%
+------------------+--------------------------------------+
| Property         | Value                                |
+------------------+--------------------------------------+
| checksum         | 0e44a2f2d5266670e1f0664928d6f726     |
| container_format | bare                                 |
| created_at       | 2017-08-03T13:58:47Z                 |
| disk_format      | qcow2                                |
| id               | c6a80651-686f-485c-9336-1176f8338387 |
| min_disk         | 0                                    |
| min_ram          | 0                                    |
| name             | vtsr250                              |
| owner            | ea71291e36e94fa1b5745779b1d456cc     |
| protected        | False                                |
| size             | 2921594880                           |
| status           | active                               |
| tags             | []                                   |
| updated_at       | 2017-08-03T13:59:13Z                 |
| virtual_size     | None                                 |
| visibility       | public                               |
+------------------+--------------------------------------+
      Step 2   Create Cinder Volume based on VTSR Image. For Example: 
      openstack volume create --image vtsr250 --size 80 vtsr_vol
+---------------------+--------------------------------------+
| Field               | Value                                |
+---------------------+--------------------------------------+
| attachments         | []                                   |
| availability_zone   | nova                                 |
| bootable            | false                                |
| consistencygroup_id | None                                 |
| created_at          | 2017-08-03T14:00:14.317952           |
| description         | None                                 |
| encrypted           | False                                |
| id                  | 53b919b7-56a2-4a05-93bd-5f81ba762dc1 |
| migration_status    | None                                 |
| multiattach         | False                                |
| name                | vtsr_vol                             |
| properties          |                                      |
| replication_status  | disabled                             |
| size                | 80                                   |
| snapshot_id         | None                                 |
| source_volid        | None                                 |
| status              | creating                             |
| type                | None                                 |
| user_id             | 3b5684ca7fd2418084090b48904a9237     |
+---------------------+--------------------------------------+
      Step 3   Create VTSR Config Image based on VTSR Config ISO (vtsr_node1_cfg.iso). For Example: 
      openstack image create vtsr_config --file vtsr_node1_cfg.iso --disk-format iso --container-format bare
+------------------+------------------------------------------------------+
| Field            | Value                                                |
+------------------+------------------------------------------------------+
| checksum         | 960a23f61e73cdcf24295e3182f4f663                     |
| container_format | bare                                                 |
| created_at       | 2017-08-03T14:01:26Z                                 |
| disk_format      | iso                                                  |
| file             | /v2/images/7e5cbbb8-e092-4ebc-9249-8a13ab0a7335/file |
| id               | 7e5cbbb8-e092-4ebc-9249-8a13ab0a7335                 |
| min_disk         | 0                                                    |
| min_ram          | 0                                                    |
| name             | vtsr_config                                          |
| owner            | ea71291e36e94fa1b5745779b1d456cc                     |
| protected        | False                                                |
| schema           | /v2/schemas/image                                    |
| size             | 360448                                               |
| status           | active                                               |
| tags             |                                                      |
| updated_at       | 2017-08-03T14:01:26Z                                 |
| virtual_size     | None                                                 |
| visibility       | private                                              |
+------------------+------------------------------------------------------+
      Step 4   Set VTSR Config Image properties. For Example: 
      openstack image set --property hw_cdrom_bus=ide --property hw-disk_bus=ide vtsr_config
      Step 5   Create VTSR Config Image cinder volume, based on VTSR Config Image. For Example: 
      openstack volume create vtsr_config_vol --image vtsr_config --size 1
+---------------------+--------------------------------------+
| Field               | Value                                |
+---------------------+--------------------------------------+
| attachments         | []                                   |
| availability_zone   | nova                                 |
| bootable            | false                                |
| consistencygroup_id | None                                 |
| created_at          | 2017-08-03T14:02:56.332067           |
| description         | None                                 |
| encrypted           | False                                |
| id                  | 3813f48c-10ce-4d03-9587-09d3cb6b1af1 |
| migration_status    | None                                 |
| multiattach         | False                                |
| name                | vtsr_config_vol                      |
| properties          |                                      |
| replication_status  | disabled                             |
| size                | 1                                    |
| snapshot_id         | None                                 |
| source_volid        | None                                 |
| status              | creating                             |
| type                | None                                 |
| user_id             | 3b5684ca7fd2418084090b48904a9237     |
+---------------------+--------------------------------------+
      Step 6   Boot VTSR volume with attached config drive (volume). For Example: 
      nova boot --flavor m1.xlarge  \
--nic net-id=29ddb641-aa7a-4473-a0bd-b6d6bd029240 \
--nic net-id=6c13f4a0-2871-41da-a20a-9063c2535269 \
--nic net-id=51b2c511-0341-4921-abb6-9b9f9f5d345a \
--nic net-id=ec6e25c2-48e5-4f1a-9f09-774cc4ae0750 \
--nic net-id=f12b2a45-aa80-42b3-8007-57730a1325fd \
--nic net-id=b1d841d4-257b-4dd7-bda8-fed5f3c8bef4 \
--block-device id=53b919b7-56a2-4a05-93bd-5f81ba762dc1,source=volume,dest=volume,device=/dev/vda,bootindex=0  \
--block-device id=3813f48c-10ce-4d03-9587-09d3cb6b1af1,source=volume,dest=volume,bus=ide,device=/dev/vdb,type=cdrom \
vtsr
+--------------------------------------+--------------------------------------------------------------------------------------------------+
| Property                             | Value                                                                                            |
+--------------------------------------+--------------------------------------------------------------------------------------------------+
| OS-DCF:diskConfig                    | MANUAL                                                                                           |
| OS-EXT-AZ:availability_zone          |                                                                                                  |
| OS-EXT-SRV-ATTR:host                 | -                                                                                                |
| OS-EXT-SRV-ATTR:hypervisor_hostname  | -                                                                                                |
| OS-EXT-SRV-ATTR:instance_name        | instance-00000097                                                                                |
| OS-EXT-STS:power_state               | 0                                                                                                |
| OS-EXT-STS:task_state                | scheduling                                                                                       |
| OS-EXT-STS:vm_state                  | building                                                                                         |
| OS-SRV-USG:launched_at               | -                                                                                                |
| OS-SRV-USG:terminated_at             | -                                                                                                |
| accessIPv4                           |                                                                                                  |
| accessIPv6                           |                                                                                                  |
| adminPass                            | A52TRbkcQyrn                                                                                     |
| config_drive                         |                                                                                                  |
| created                              | 2017-08-03T14:06:42Z                                                                             |
| flavor                               | m1.xlarge (5)                                                                                    |
| hostId                               |                                                                                                  |
| id                                   | a3bd937a-78ab-47c4-91ca-d0f106b31f2a                                                             |
| image                                | Attempt to boot from volume - no image supplied                                                  |
| key_name                             | -                                                                                                |
| metadata                             | {}                                                                                               |
| name                                 | vtsr                                                                                             |
| os-extended-volumes:volumes_attached | [{"id": "53b919b7-56a2-4a05-93bd-5f81ba762dc1"}, {"id": "3813f48c-10ce-4d03-9587-09d3cb6b1af1"}] |
| progress                             | 0                                                                                                |
| security_groups                      | default                                                                                          |
| status                               | BUILD                                                                                            |
| tenant_id                            | ea71291e36e94fa1b5745779b1d456cc                                                                 |
| updated                              | 2017-08-03T14:06:42Z                                                                             |
| user_id                              | 3b5684ca7fd2418084090b48904a9237                                                                 |
+--------------------------------------+--------------------------------------------------------------------------------------------------+

      Was this Document Helpful?

      FeedbackFeedback

      Contact Cisco