Add DNS Record Blueprint for vRealize Automation · Add DNS Record Blueprint for vRealize...

Add DNS Record Blueprint for vRealize Automation

VMware and Customer Confidential

Copyright 2017 VMware, Inc. All rights reserved. .© Copyright and trademark information

VMware, Inc.

3401 Hillview Ave.

Palo Alto, CA 94304

www.vmware.com

http://pubs.vmware.com/copyright-trademark.html

Contents

1 Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3 Glossary of Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

4 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

5 Customer Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Context Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Components of the Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9vSphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9vRealize Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9vRealize Orchestrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9vRealize CloudClient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

6 Install and Configure the Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Install the Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Verify the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Configure the Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Component configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Blueprint entitlement and service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Uninstall the Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7 Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Add DNS record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18


4 VMware, Inc.

Revision History

Date Rev Author Comments Reviewers

21 Jul 2017 0.1 Ivaylo Stanev Initial Draft Reneta Popova

01 Aug 2017 0.2 Ivaylo Stanev Update


VMware, Inc. 5

About This Document

This document describes the specific named blueprint solution, meaning the details of the customer

environment as a target for implementing the custom developed solution. In addition, the solution

design is outlined as a means to communicate how the new customization, integration, and

automation functionality will be built.

This blueprint solution enables you to add DNS record.

This document is provided in confidence and must not be shared with any third party without explicit

permission by VMware.

Intended Audience

The information in this guide is intended for experienced system administrators who are familiar with

data center operations in VMware vSphere®, VMware vRealize™ Automation™, and VMware

vRealize™ Orchestrator™.


6 VMware, Inc.

Glossary of Terms

This document uses the following terms and acronyms.

Term Description

vRA VMware vRealize® Automation™

vRO VMware vRealize® Orchestrator™

vCM VMware vRealize® Configuration Manager™

VM Virtual Machine

DNS Domain Name System

IPAM IP Address Management system


VMware, Inc. 7

Overview

This blueprint solution enables you to add DNS record.


8 VMware, Inc.

Customer Environment

The solution described in this document is applicable for the following products and versions.

Product Version

vSphere 6.0

VMware vRealize® Automation™ 7.3

VMware vRealize® Orchestrator™ 7.3

The solution might also be compatible with previous vRA and vRO versions, unless stated otherwise.

Context Diagram

The solution usage is outlined in the following diagram.


VMware, Inc. 9

Components of the Environment

vSphere

Attribute Value

Version 6.0

Hot fix N/A

Supported APIs

Description The vSphere virtual infrastructure.

vRealize Automation

Attribute Value

Version 7.3

Hot fix N/A

Supported APIs REST APIs

Description The system where the solution blueprints are hosted and selected from.

vRealize Orchestrator

Attribute Value

Version 7.3

Hot fix N/A

Supported APIs REST APIs

Description The system where the solution workflows are executed.

vRealize CloudClient

Attribute Value

Version 4.4

Hot fix N/A


10 VMware, Inc.

Attribute Value

Description A command-line utility that provides verb-based access with a unified interface across

vRealize Automation APIs.

Assumptions

The environment components must be properly set and working.

The blueprint solution must be installed and verified.

The blueprint solution must be properly configured.

Windows machine with enabled.DNS server tools

Windows machine with the capability to run powershell scripts.


VMware, Inc. 11

1.

2.

3.

4.

Install and Configure the Solution

Blueprint solution's deployment file

cm.blueprints.dns.dnsadd-1.0.0-blueprints.zip

Solution package folder:

The solution package folder has the following structure:

File Details

Install.bat

Install.sh

Installation scripts

cm_02_CreateDNSRecord-xaas-blueprint-1.0.0.zip vRA blueprint (to be automatically

imported)

com.vmware.pscoe.build.cm.dnsadd.vro-1.0.0-10-bundle.

zip

vRO packages

(to be automatically imported)

Install the Solution

Prerequisite

Verify that you have obtained the solution package with all its components.

Procedure:

Unzip the package file on your local machine.

Open a terminal and go to the directory where you have just extracted the solution package.

Start the Installation script (i.e. for Windows or for Linux).Install.bat Install.sh

Add the connectivity information for vRO.

Information to enter Example values

vRO connection:

(ex. vCO endpoint)

vro-l-01a.corp.local:443

Username: administrator@vsphere.

local

Password: ********

y (yes)


12 VMware, Inc.

4.

5.


Overwrite workflows? (y/n)

Import configuration attribute values? (y/n) y (yes)

Add the connectivity information for vRA.


Client cloud local

script - path to

cloudclient.bat:

A) cloud client is located at C:\cloudclient - value is taken

automatically

B) cloud client is located elsewhere - full path to the .bat fie

in the extracted CloudClient folder (e.g. \cloudclient-

)4.4.0-5511232\bin\cloudclient.bat

vRA server: https://vra-l-01a

Tenant: vsphere.local

vRA Username: configurationadmin

vRA Password: ********

Trust the certificate

and continue connecting

(Y/N)? (optional)

y (yes)


VMware, Inc. 13

5.

The installation script produces several messages indicating the successful completion.

Verify the Installation

Installation can be verified by manually inspecting the imported content in vRA and vRO.

Verify that the newly imported blueprint exists in vRA.

Verify that the following packages exist in vRO.

Open the vRO client, select mode, and click the tab.Design Packages

com.vmware.pscoe.build.cm.common.vro-1.0.0.package

com.vmware.pscoe.build.cm.dnsadd.vro-1.0.0.package

http://com.vmware.pscoe.build.cm


14 VMware, Inc.

1.

2.

3.

com.vmware.pscoe.library.class-2.0.0.package

com.vmware.pscoe.library.dns.platform-1.0.1.package

com.vmware.pscoe.library.dns.provider.microsoft-1.0.1.package

com.vmware.pscoe.library.fs-1.0.2.package

com.vmware.pscoe.library.guestops-1.0.5.package

com.vmware.pscoe.library.locking-1.0.0.package

com.vmware.pscoe.library.logging-2.0.1.package

com.vmware.pscoe.library.mail-1.1.2.package

com.vmware.pscoe.library.mail-objects-1.0.0.package

com.vmware.pscoe.library.templates-2.0.0.package

com.vmware.pscoe.library.util-2.2.0.package

com.vmware.pscoe.library.validator-2.0.0.package

com.vmware.pscoe.library.vra.dispatcher.objects-2.0.0.package

com.vmware.pscoe.library.vra.dispatcher-2.1.0.package

com.vmware.pscoe.library.vra.iaas-1.1.1.package

com.vmware.pscoe.library.vra-2.0.0.package

com.vmware.pscoe.pps.msdns-1.0.1.package

Configure the Solution

After the successful installation, the solution must be properly configured for the environment.

The configuration includes the following configuration levels:

Blueprint's component configuration.

Blueprint's entitlement and service assignment.

Component configuration

Procedure:

Start vRO.

Select the view and click the tab.Design Workflows

Execute the workflow Configure MS DNS Provider.

Configuration item

Example Values

powerShellHosts Windows machine(s) with powershell capabilities. Enter valid credentials.


VMware, Inc. 15

1.

2.

Configuration item

Example Values

These VMs should also have 'DNS Server Tools' installed and their primary DNS

server properly configured.

dnsServers Windows machine with DNS role enabled.

Default DNS Suffix

corp.local

vcenter The target vCenter.

Blueprint entitlement and service

The solution blueprint must be entitled and assigned to a service to become available in Service .Catalog

Procedure:

Go to .vRA>Administration>Catalog Management>Entitlements

Click the entitlement you want to add the blueprint to.


16 VMware, Inc.

3.

4.

5.

6.

7.

8.

Under , search for the blueprint you want to add.Entitled Items

Click .Finish

Go to .vRA>Administration>Catalog Management>Catalog Items

Click the blueprint you want to assign to a service.

On the tab, from the drop-down menu next to , select the service you want to General Serviceassign the blueprint to.

Click .OK

The solution blueprint will appear in your .Service Catalog


VMware, Inc. 17

1.

2.

Uninstall the Solution

Currently, there is no automated uninstall process available.

Procedure:

On the vRA page, select the solution's blueprint you want to delete.Design

Click the button and confirm.Delete


18 VMware, Inc.

1.

2.

3.

Usage

After the configuration, a successful blueprint execution is expected.

Add DNS record

Procedure:

Go to vRA and request blueprint.Catalog>All Services Add DNS Record

Enter the following values:

Configuration item Example values

Name DNS_AType_Entry

CName DNS_CType_Entry

IP Address 1.2.3.4

DNS Suffix corp.local (not required if the blueprint is already configured)

Create PTR yes / no

Click .Submit

The DNS records are created.

Add DNS Record Blueprint for vRealize Automation · Add DNS Record Blueprint for vRealize...

Documents

Transcript of Add DNS Record Blueprint for vRealize Automation · Add DNS Record Blueprint for vRealize...