cloudhotspot.csr1000v

Ansible CSR1000V Role

This is an Ansible role that helps automate the setup of the Cisco Cloud Services Router (CSR) 1000V on VMWare Fusion.

The role sets up an OVF runtime environment for the CSR 1000V, which allows it to automatically configure itself when it is deployed.

Requirements

Mac OS X
VMWare Fusion version 7.x or newer
VMWare OVF Tools version 4.1 or newer (You might need a VMWare account)
Cisco CSR 1000v OVA Image (Requires a CCO login)

Role Variables

You need to define the following variables in your playbook:

# Path where the Cisco CSR 1000V OVA file is located
csr_ova_source: "/path/to/ova/source"

# Main folder where the CSR 1000V virtual machine will be created
csr_vm_root: "/path/to/root"

The CSR 1000V virtual machine will be set up in this location:

{{ csr_vm_root }}/{{ csr_vm_name }}.vmwarevm/

For example, if csr_vm_root is /Users/alice/guests and csr_vm_name is csr01, the virtual machine will be created at /Users/alice/guests/csr01.vmwarevm.

If the virtual machine already exists, the role will fail by default. To replace the existing machine, set this variable (to any value):

csr_vm_overwrite: yes

Default Role Variables

# Name of the Cisco CSR 1000V virtual machine that will be created
csr_vm_name: "csr01"

# Last part of the IP address for the CSR 1000V management interface, between 3 and 127
csr_vm_mgmt_ip_octet: "120"

# Management Interface - 0 = Ethernet0/GigabitEthernet1, 1 = Ethernet1/GigabitEthernet2, 2 = Ethernet2/GigabitEthernet2
csr_vm_mgmt_interface: 2

# Keep the DHCP reservation used for setting up the machine
csr_vm_persist_dhcp_reservation: yes

# CSR 1000V configuration settings
csr_name: csr01
csr_admin_username: admin
csr_admin_password: Pass1234
csr_domain_name: cloudhotspot.co

# Set to 'True' or 'False'
csr_enable_scp: False

# Set to 'ax' or 'appx' for license type
csr_license_level: appx

Dependencies

This role depends on the Ansible Galaxy yaegashi.blockinfile module. Installing this role will also install that module for you.

Example Playbook

Use this playbook on your local OS X host. Make sure to set hosts: localhost and connection: local:

- hosts: localhost
  connection: local
  roles:
     - { role: mixja.csr1000v, csr_vm_overwrite: true, csr_ova_source: /path/to/ova/source, csr_ova_root: /path/to/vm/root }