Overview

In this how to, we will cover how to setup and template your IPAM profiles so they can be made highly dynamic whilst reducing the amount of profiles you are creating. We will work through how to create your IPAM Profile, how to setup the dynamic nature using Property Definitions and Property Groups and how these can be used to build your IPAM Profile through your selections in your blueprint.

 

Considerations

  • Have licensed your IPAM/DNS
  • Have licensed Property Tool Kit
  • Have a good understanding of template engine
  • This ONLY applies from SovLabs version 2019.10.0 and onwards

 

Scenario

You require a Blueprint that based on several different criteria will dynamically set your network and domain

  • Select Production or Non Production to determine IP segment
  • Select Domain to set DNS Suffix

 

Procedure

Setting up your IPAM Profile
  1. From your Catalog (1) search for IPAM Profile (2) and click on Request (3) in the Add IPAM Profile – SovLabs Module

  2. Provide a meaningful Configuration label (1) and Description (2)
  3. From the Type, select your IPAM endpoint type you will be using
  4. Select your IPAM providers endpoint that you have already configured
  5. Select the NIC number this will apply to (NOTE: The first network card on a VM is 0)
  6. In the Subnets, Gateways, Network name and network mask. This is where you will utilise the template engine.  Enter the values (1) you have setup in the previous steps to reflect the Dynamic nature of the network and press the green cross (2)
    NOTE:  These are the values you will use to populate from your Property Groups
  7. Excluded IPs, if you have any enter them here, else leave this blank
  8. IN DNS Configuration, enter the Primary and secondary DNS IP Addresses you will use (1), and you can Template the DNS Suffix and DNS Search Suffix (2) as these will match the domain you will choose.
  9. You can configure WINS if you require, else this can be left blank
  10. Click on Submit

 

Create SVL_ property Groups
  1. In vRA fo to Administration (1) → Property Dictionary (2) → Property Groups (3) → and click on New (4)
  2. Type in a Name starting with SVL_ for your first property group.  In this example it is for Production
  3. Enter a description as required (optional)
  4. In properties click on New
  5. You will now create the values that match your production environment and the IPAM Profile information you need
    Subnet, Gateway and Network Name. Example below creates the Gateway then click OK. Repeat for the other properties

    NOTE:  These values MUST MATCH your IPAM properties template inputs you created

  6. Click on OK
  7. Repeat this for Non Production environment
  8. You will end up with two property groups that contain different information for Subnet, Gateway and Network Name

 

 

Create your SVL_ Property Definition
  1. Click on Administration (1) → Property Dictionary (2) → Property Definitions (3) and click on New (4)
  2. In the Name, enter SVL_ followed by a name for his Definition (1) and a Label that will be displayed in your blueprint (2)
  3. Set a description (Optional)
  4. Set the data type to String (1) and the required to Yes (2)
  5. Set the Display As to Dropdown (1) and the Values to Static List (2)
  6. In the static list, click on New
  7. In name enter a value (1), in this example it is Production and the value (2) references your Property group for production (SVL_<PropertyGroupName>) then click OK.  
    Repeat for the Non Production value

  8. You will now have 2 options ready for your blueprint
  9. Click on OK
  10. Repeat the above steps for your Domain Selection property definition with the following exceptions:
    1. You do not need to put SVL_ in front of the Property Definition Name as this is a standard property definition BUT the Name must match the template name in your IPAM Profile for DNS Suffix and/or Search Domain
    2. Your domain selection will be simplified where Name for each drop down can reflect an environment ie; production, nonproduction, or, simply select put the name as your domain and the value to match this.  See example below:
Adding to your Blueprint
  1. Open your blueprint and go to Properties (1) → Property Groups (2) → and click on Add (3)
  2. Search for your IPAM Profile which will begin with SovLabs-IPAMProfile-<tenant>_<IPAMTemplateName> and place a check next to it (1) then click on OK (2)

  3. Now go to Properties (1) → Custom Properties (2) → and click on New (3)

  4. In the Name property, search for the SVL_ property definition we created and select this from the drop down
  5. In the Show in Request column, place a check on the box

  6. Click on OK
  7. Repeat steps 3 and 4 to add in the DNS Suffix selection you created earlier so you will have 2 additional Custom properties

  8. Click on Finish

  9. Now when you deploy your blueprint, you will have 2 additional options, Network selection for IPAM and the DNS Suffix list.  
  10. When you build the VM, in vRO you will be able to validate that the VM has obtained the IP Address from the correct network segment. If you copy the text from the payload you will see the following
    (This is an example, yours will have your own values)

    “Doco_DNS_Suffix”: “DocoDomain.net“,
    “Doco_Gateway”: “10.11.12.1”,
    “Doco_NetworkName”: “dvs_DocoDomain_112_10.11.12.0_24”,
    “Doco_Subnet”: “10.11.12.0/24”,

    “SVL_Doco_IPAM_Select”: “SVL_Doco_Production_IPAM”,

 

Additional information

Property Toolkit: https://docs.sovlabs.com/latest/vRA/7.6/modules/vra-toolkits/property-toolkit/
IPAM Integration information: https://docs.sovlabs.com/latest/vRA/7.6/modules/#endpoint-integrations
Template Engine: https://docs.sovlabs.com/latest/vRA/7.6/framework/sovlabs-template-engine/basics/intro/

Recommended Reading