IPAM

To learn more about this OneFuse module, refer to IPAM.

Prerequisites

1. Configure OneFuse Property Set(s) and OneFuse Module Policies.
2. Run OneFuse Configuration per vRA Tenant.
3. Review the OneFuse Modules overview for vRealize Automation 7.6.
4. Create a new vRA Blueprint (if none exist) or determine which existing Blueprint(s) will utilize this OneFuse Module.
   • Resource: Designing Machine Blueprints

Configure the Blueprint

1. Know the name of the OneFuse Endpoint created via OneFuse Configuration.
2. Determine which OneFuse IPAM Policies to run for this Blueprint.
3. Update the Blueprint to add in the necessary vRA Properties to invoke a OneFuse IPAM Policy.
4. Deploy the Blueprint to provision a vRA Deployment and reserve IP Address(es).
5. Destroy the vRA Deployment to remove the IP Address(es) for the destroyed resource(s).

Update the Blueprint

1. Log in to the vRA Tenant
2. Select the Design tab from the top menu bar
3. Select the Blueprints tab from the left menu
4. Edit the Blueprint and perform the below:

Add in necessary vRA property

The following vRA Property needs to be added to the Blueprint’s Properties > Custom Properties section under the Resource(s) of interest.

Call an IPAM Policy for a specific NIC:

• Replace <#> with a number from 0 to 9, one for each NIC. Default is 0.

Example vRA Custom Properties (in key: value pair format):

# Execute OneFuse IPAM Policy

# -- Property Value
# <OneFuse Endpoint Name>  is onefuse
# <IPAM Policy Name> is prod

OneFuse_IpamPolicy_Nic0: onefuse:prod

Optional. IPAM Multi-IP support:

Support for multiple IP Addresses on a single interface. The IP Addresses are reserved and stored in both OneFuse and vRA Machine Properties for future reference in vRA lifecycles.

• OneFuse_IpamPolicy_AdditionalTrigger is the required trigger property to enable IPAM for additional NICs.
• Replace <niclabel> with a value that is appended to the hostname.

Name behavior:

• Without additional Naming Property: Default behavior appends <niclabel> to the hostname after a hyphen (-). To override, modify the Hostname Override field on the OneFuse IPAM Policy.
• With additional Naming Property: If an Additional Naming Policy is defined that matches this value, the name generated from the Naming Policy will be used.

Example vRA Custom Properties (in key: value pair format):

# -- Property Name
# <niclabel> is xyz

# -- Property Value
# <OneFuse Endpoint Name>  is onefuse
# <OneFuse IPAM Policy Name> is prod

# Example
OneFuse_IpamPolicy_AdditionalTrigger: true
OneFuse_IpamPolicy_Additional_xyz: onefuse:prod

Additional helpful vRA properties

Purpose: Relate OneFuse Policy executions from different OneFuse Modules together with a Tracking ID.

Purpose: Reference a specific NIC’s values to get hostname, IP address, etc.

Replace <#> with a number from 0 to 9, one for each NIC.

Replace <value> with an appropriate key: dnsSuffix, fqdn, gateway, hostname, ipAddress, macAddress, netmask, network, subnet, target

Examples:

• OneFuse_VmNic0.dnsSuffix
• OneFuse_VmNic0.fqdn
• OneFuse_VmNic0.hostname
• OneFuse_VmNic0.ipAddress
• OneFuse_VmNic0.target: when DNS Suffix is provided, will be the FQDN; otherwise, will be the hostname (without domain).

Custom property placement methods

Influence Custom Properties for Resources using different methods:

Learn more: Understanding Custom Properties Precedence

Compiled example vRA custom properties

Review example below of vRA Custom Properties (in key: value pair format) for this OneFuse Module.

# Execute OneFuse IPAM Policy

# -- Property Value
# <OneFuse Endpoint Name>  is onefuse
# <IPAM Policy Name> is prod

OneFuse_IpamPolicy_Nic0: onefuse:prod

Provision

Deploy a Blueprint with OneFuse IPAM Policies configured. IP Address(es) will get reserved in the desired IPAM Provider.

Outputs

The following vRA Properties will exist on the Deployment.

• <#> is a number 0-9.
• <niclabel> is the user-specified value (if configured to register additional IPs).

Deprovision

Destroy an existing deployment with OneFuse IPAM Policies configured. The IP Address(es) will be removed from the desired IPAM Provider.

vRA EBS

Troubleshooting

Troubleshoot in vRealize Orchestrator.

1. Log in to vRealize Orchestrator.
2. Turn on Verbose Logging and try again to see additional log messages in vRO Workflows:
   • Select Library > Workflows from the left menu
   • Go to: OneFuse > IPAM > vRA7 to find corresponding workflow runs and view logs
   • Optionally, run the workflows in the Manual folder to manually test
3. Optionally, configure timeouts for EBS and/or Configure timeouts for OneFuse modules.

Additional resources:

• Review Troubleshooting in OneFuse
• Review VMware troubleshooting resources