management suites business unit | cloud solutions engineering · management suites business unit |...

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

VMware and Customer Confidential

Management Suites Business Unit | Cloud Solutions Engineering

VMware vRealize Code Stream Management Pack for IT DevOps – Installation Guide Enabling IT DevOps on VMware vRealize Automation


2 VMware, Inc.

© 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. This product is covered by one or more patents listed at http://www.vmware.com/download/patents.html.

VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Copyright and trademark information

VMware, Inc 3401 Hillview Ave Palo Alto, CA 94304 www.vmware.com

http://www.vmware.com/download/patents.html

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

http://www.vmware.com/

http://www.vmware.com/


VMware, Inc. 3

Contents

vRealize Code Stream Management Pack for IT DevOps....................... 4

Installation Overview ............................................................................... 4

Pre-Installation Tasks ............................................................................. 5

Manually Copy CloudClient to the CTS Host ......................................................................... 7

Install the Management Pack .................................................................. 7

(Optional) Configure Approval Groups .................................................. 11

(Optional) Configure Email Notifications ............................................... 12

Installation Validation ............................................................................ 13

Content Test Package Installation ........................................................ 14

Import the Content Test Package to a vRealize Orchestrator Host ..................................... 14


4 VMware, Inc.

vRealize Code Stream Management Pack for IT DevOps

VMware vRealize™ Code Stream Management Pack for IT DevOps is an extensible framework that

automates the management of software-defined content such as workflows, blueprints, or templates.

This management pack makes it possible to dispense with the time-consuming and error-prone manual

processes currently required to manage software-defined content.

This solution is based on VMware’s concept of the Software-Defined Data Center (SDDC). The SDDC

abstracts every service in the data center from its underlying hardware and redefines services as

software. By treating software-defined content as code, you can apply current software development

methodologies such as agile or DevOps to the configurations and content within the SDDC.

The management pack uses vRealize Code Stream to facilitate "DevOps for Infrastructure." The

management pack is intended for organizations that have an enterprise deployment of vRealize

Automation, which includes multiple environments such as development, testing, staging, and

production. The management pack provides a welcome alternative to the time-intensive manual

processes currently used to move content and configurations from one environment to another. For

more information, see the Operations Guide.

This installation guide is intended for users who are familiar with administering vRealize Automation and

vRealize Orchestrator.

Installation Overview

vRealize Code Stream Management Pack for IT DevOps is supplied as a vRealize Orchestrator package.

The release must be installed on a vRealize Automation standalone deployment, with all the following

components on a single host machine:

vRealize Automation

vRealize Orchestrator

vRealize Code Stream

JFrog Artifactory

All of these components come pre-installed on the VMware vRealize Automation 6.2.3 appliance that is

available at https://www.vmware.com/go/download-vcac.

The management pack requires an additional component, the Content Transfer Server (CTS). For this

release, the CTS is hosted on a separate, modified vRealize appliance that has all non-essential services

disabled. The CTS exports and imports software-defined content in the form of binary files between

external systems and the JFrog Artifactory artifact repository.

https://www.vmware.com/go/download-vcac


VMware, Inc. 5

Pre-Installation Tasks

Complete each of the following tasks before installing the management pack.

Task Reference

Deploy two vRealize Automation 6.2.3 appliances from https://www.vmware.com/go/download-vcac.

The first appliance serves as the vRealize Automation host.

The second appliance serves as the CTS host.

Specify 10 GB RAM and 2 vCPUs for the vRealize Automation host machine, and power on the appliance. Important: Not configuring the recommended hardware settings can cause undesirable results.

Specify 8 GB RAM and 4 vCPUs for the CTS host machine, and power on the appliances.

Important: Not configuring the recommended hardware settings can cause undesirable results.

Configure NTP on the vRealize Automation host, CTS host, and SSO host.

Register the vRealize Automation Appliance with any supported version of SSO.

https://www.vmware.com/go/download-vcac


6 VMware, Inc.

On the vRealize Automation Appliance host, use the following procedure to apply the necessary licenses.

1. Open a browser and enter the following address: https://<vRealize Automation server FQDN or IP>:5480

2. Apply the vRealize Code Stream license and the vRealize Automation license within the VAMI interface.

On the CTS host, use the following procedure to stop unused component services.

1. Log in using SSH.

2. Open a new command prompt, and run the following commands:

> chkconfig vcac-server stop

> chkconfig vco-server stop

> chkconfig vpostgres stop

> chkconfig rabbitmq-server stop

> service vcac-server stop

> service vco-server stop

> service vpostgres stop

> service rabbitmq-server stop

On the appliance where you are installing the management pack, set up a tenant administrator user on the default vsphere.local tenant with all privileges.

Important: The tenant administrator account must include release management roles, so you must perform this task after you apply the vRealize Code Stream license.

Ensure that this tenant administrator user can log in and view the Code Stream tab in the vRealize Automation console. This tab appears only after a valid vRealize Code Stream license is applied. The license is a prerequisite for using this feature.


VMware, Inc. 7

(Optional) If the CTS host does not have an internet connection, download CloudClient 3.3.1 directly to the CTS host, and use the following procedure, Manually Copy CloudClient to the CTS Host.

Manually Copy CloudClient to the CTS Host

If the CTS host does not have an internet connection, use the following procedure to download

CloudClient 3.3.1 to the CTS host.

1. On a computer with internet access, download CloudClient 3.3.1 and copy cloudclient-3.3.1-

2966416-dist.zip to the /tmp/ directory on the CTS host, either by accessing an internal web server

first and downloading the file from there, or by using a file transfer utility such as SCP.

2. Open a command prompt, and use the following command to create

the /storage/artifactory/clm/install/ directory.

> mkdir -p /storage/artifactory/clm/install

3. Use the following command to create a symlink to the CLM folder.

> ln -s /storage/artifactory/clm /storage/clm

4. Use the following command to move the CloudClient Zip file to

the /storage/clm/install/ directory, and change the cloudclient-3.3.1-2966416-

dist.zip file name to cc.zip.

> mv /tmp/cloudclient-3.3.1-2966416-dist.zip /storage/clm/install/cc.zip

Note: Do not extract the contents of the CloudClient Zip file. The installer extracts the Zip file during the installation process.

Install the Management Pack

Use the following procedure to install the management pack.

Step Reference 1. 1. Copy the vRealize Code Stream Management Pack

for IT DevOps solution, com.vmware.cse.clm.all.package to the machine where you plan to start the vRealize Orchestrator client.

2. Open a web browser and connect to https://<vRealize Orchestrator FQDN or

IP>:8281/vco

https://vdc-download.vmware.com/vmwb-repository/dcr-public/e8b140e7-cf16-4ff6-af88-a22ad7e9f5d1/10d2f6af-39b8-4d64-a682-7dc13fb0d6aa/cloudclient-3.3.1-2966416-dist.zip

https://vdc-download.vmware.com/vmwb-repository/dcr-public/e8b140e7-cf16-4ff6-af88-a22ad7e9f5d1/10d2f6af-39b8-4d64-a682-7dc13fb0d6aa/cloudclient-3.3.1-2966416-dist.zip


8 VMware, Inc.

3. Click Start Orchestrator Client, and click any warning dialog boxes to open the vRealize Orchestrator client.

4. Log in using [email protected] for the user name and the password specified during the vRealize Automation appliance deployment.

5. Select Design ( ) >

Packages ( ) > Import Package ( ).

6. In the Open dialog box, navigate to the location of com.vmware.cse.clm.all.package, and click Open.

7. In the vRealize Orchestrator client, click Workflows, and select Library > Content Management > Configuration.

Right click Install Content Management, and select Start Workflow.

mailto:[email protected]


VMware, Inc. 9

8. Select Yes to accept the EULA, and click Next.

9. Enter the vRealize Automation server details and the tenant administrator user name and password created in the pre-installation tasks. Click Next.

10. Enter the vRealize Orchestrator administrator account user name and password, or accept the default. Click Next.

11. Enter the vRealize Code Stream user name and password, or accept the default. Click Next.


10 VMware, Inc.

12. Enter the Artifactory user name and password, or accept the default. Click Next.

13. Enter the CTS host details, and click Submit to start the installation process.


VMware, Inc. 11

(Optional) Configure Approval Groups

Use the following procedure to configure approval groups on the vRealize Orchestrator host where you installed the management pack. Users in each AD group whose name you provide see an approval request after selecting Inbox > Manual User Actions in the vRealize Automation console after someone flags an environment as requiring approval for test or release.

Step Reference

1. On the vRealize Orchestrator client, click Workflows, and select Administrator > Library > Content Management > Configuration. Right click Configure Approval Groups, and select Start workflow.

2. In the Enter Approval Groups dialog box, enter one valid Active Directory (AD) group in the Test Approval Group Name text box and in the Release Approval Group Name text box. Click Submit.

Note: Multiple groups are not supported.


12 VMware, Inc.

(Optional) Configure Email Notifications

Use the following procedure to configure email notifications on the vRealize Orchestrator host where you installed the management pack. Users whose name you provide receive an email approval request after someone flags an environment as requiring approval for test or release.

Step Reference

1. On the vRealize Orchestrator client, select Design. Click Workflows. Select Library > Content Management > Configuration. Right-click Configure Email Notifications and select Start workflow.

2. On the Configure Email Notifications dialog box, enter the following requested information for the email server settings, and click Next.

SMTP Server Address

SMTP Server Port

From Name

From Address

User name (if necessary)

Password (if necessary)

3. Under Email Addresses for Pipeline Completion Notifications, click Not Set.


VMware, Inc. 13

4. On the Array of string dialog box, enter each email address for a member of the approval group one at a time in the New value text box, and click Insert Value. When you are finished, click Accept.

5. Under Copy approval email addresses from Pipeline Notifications setting, select Yes, and click Submit.

Installation Validation

To validate a successful installation, do the following:

1. Open the vRealize Automation console as the tenant administrator, and click the Catalog tab. You should see the management pack’s Service Catalog items as shown in the following figure.

Figure 1. Service Catalog - All Services


14 VMware, Inc.

2. Click the Code Stream tab, and click the Pipelines tab where the management pack’s pipelines are installed and activated. The following figure shows an example of the pipelines page.

Figure 2. Pipelines

Content Test Package Installation

To run vRealize Orchestrator tests successfully on a remote vRealize Orchestrator instance, you must first import the com.vmware.cse.clm.tests.package file to each vRealize Orchestrator host machine that runs tests.

Import the Content Test Package to a vRealize Orchestrator Host

Import the content test package to a vRealize Orchestrator host that runs tests.

Step Reference 2. 1. Copy com.vmware.cse.clm.tests.package to

the machine where you plan to run tests.

2. Open a web browser and connect to https://<vRealize Orchestrator FQDN or

IP>:8281/vco


VMware, Inc. 15

3. Click Start Orchestrator Client, and click any warning dialog boxes to open the vRealize Orchestrator client.

4. Log in using [email protected] for the user name and the password specified during the vRealize Automation appliance deployment.

5. On the home page, click Import package in the right pane.

6. In the Open dialog box, navigate to the location of com.vmware.cse.clm.tests.package, and click Open.

mailto:[email protected]

management suites business unit | cloud solutions engineering · management suites business unit |...

Documents