Installation Guide


[PDF]Installation Guide - Rackcdn.comhttps://c368768.ssl.cf1.rackcdn.com/...

53 downloads 125 Views 2MB Size

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

Management Suites Business Unit | Cloud Solutions Engineering

VMware vRealize Code Stream Management Pack for IT DevOps 2.1 Installation Guide Enabling “DevOps for Infrastructure” on VMware vRealize Suite

VMware and Customer Confidential

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

© 2016 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

2

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

Contents vRealize Code Stream Management Pack for IT DevOps....................... 4 Supported Product Versions ................................................................... 4 Installation Overview ............................................................................... 4 Pre-Installation Tasks ............................................................................. 5 Install the Management Pack .................................................................. 8 Installation Validation ............................................................................ 11 Content Test Package Installation ........................................................ 12 Import the Content Test Package to a vRealize Orchestrator Host ..................................... 12

Appendices ........................................................................................... 14 Appendix I: Manually Downloading CloudClient 4.0.0 ......................................................... 14 Appendix II: Manually Downloading CloudClient 3.3.1 ........................................................ 14 Appendix III: Installing Java 7 .............................................................................................. 15 Appendix IV: Installing VMware OVF Tool ........................................................................... 15

VMware, Inc.

3

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

vRealize Code Stream Management Pack for IT DevOps The VMware vRealize Code Stream Management Pack for IT DevOps is an extensible, customizable framework that provides a set of release management processes for softwaredefined content with the ability to capture, version control, test, release and rollback. This management pack makes it possible to dispense with the time-consuming and error-prone manual processes currently required to manage software-defined content. Supported content includes entities from vRealize Automation, Orchestration, Operations and vSphere.

Supported Product Versions The VMware vRealize Code Stream Management Pack for IT DevOps 2.0 can be installed on the following VMware products: 

vRealize Automation 7.0.1 (vRA)



vRealize Code Stream 2.0 (vRCS)



vRealize Orchestrator 7.0.1 (vRO) (embedded only)

Please note that it is not possible to install this version of the management pack on version 6.x of vRealize Automation.

Installation Overview The following resources are required to deploy vRealize Code Stream Management Pack for IT DevOps 2.1: 

A vRealize Automation 7.0.1 appliance with 4 CPU and 20 GB RAM, this ships with vRealize Code Stream 2.0 on the same appliance.



Primary Content Server. For production systems this is hosted on a secondary vRealize Automation appliance that has all unnecessary vRA and vRO services disabled. The Content Server exports and imports software-defined content in the form of binary files between external systems and the JFrog Artifactory artifact repository. For non-production systems the Content Server can be installed on the same appliance as vRealize Automation, however, the memory must be increased to account for extra load, and performance will be impacted. For best results, install the Primary Content Server on a separate, external vRealize Automation appliance.



Remote Content Server. Remote Content Servers provide the ability to test and release from locations near to the endpoint, to minimize the amount of data traversing the WAN. Content is cached on the Remote Content Servers during test and release stages, and subsequent deployments of the same content is from the local cached copy. Remote Content Servers are hosted on additional vRealize Automation appliances that have unnecessary vRA and vRO services disabled. Note: Capture always runs from the Primary Content Server.

4

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide 

vRealize Automation Advanced (or equivalent) license



vRealize Code Stream license



SMTP server (optional)

IMPORTANT: Please note that the RAM on the vRealize Automation appliance needs to be increased from 18Gb to at least 26Gb if the Content Server is not external to the vRealize Automation appliance. Running in single appliance mode is NOT supported in production, please deploy an external Content Server for production workloads.

Pre-Installation Tasks Complete each of the following tasks before installing the management pack.

Task 

Reference

Deploy two vRealize Automation 7.0.1 appliances from https://www.vmware.com/go/download-vcac. The first appliance serves as the vRealize Automation host. The second appliance serves as the Primary Content Server. Important: ensure the option to Enable SSH service in the appliance is ticked when deploying Content Servers If this deployment is not intended for production use and you wish to run the Primary Content Server on the vRealize Automation appliance, then you must increase the RAM from 18Gb to at least 26Gb. Otherwise requests will take longer and fail when the appliance experiences too much load.

VMware, Inc.

5

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide 

Open a browser and enter the following address: https://:5480

Follow the Installation Wizard, unticking the Install Infrastructure as a Service option on the Deployment Type screen. Note that you do not need to run the Installation Wizard on the Content Servers. 

On the Licensing screen, ensure to assign both a vRealize Code Stream license and a vRealize Automation Advanced (or equivalent) license.



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 may require the a logout and login, or refresh of the browser. This tab appears only after a valid vRealize Code Stream license is applied. The license is a prerequisite for using this feature.



Open a browser and enter the following address: https:///artifactory

Click Login and login with the default credentials: o

Username: vmadmin

o

Password: vmware

Enter a new Artifactory password and make a note of this as you will need it when installing the management pack.

6

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide The following update is required on the vRA host 

Open a terminal/SSH session to the vRA host as root user and run the following command: # echo “vco.socket.timeout.millis=120000” >> /etc/vcac/vcac.properties



Restart vRA services: # service vcac-server restart



This step is required so that the provisioned item is seen in the vRA “My Items” tab once the vRO workflow has completed when under load.

The following prerequisites are only necessary if the Content Server is NOT connected to the Internet: 

Download CloudClient 4.0.0 directly to the Content Server use the below procedure Appendix I: Manually Downloading CloudClient 4.0.0. This is required for all installations but is automatically installed if an Internet connection is available. Note: CloudClient 4.1.0 is not supported at this time.



In order for the management pack to communicate with vRealize Automation 6.2.x servers, download CloudClient 3.3.1 directly to the Content Server using the following procedure Appendix I: Manually Downloading CloudClient 3.3.1. This is automatically installed if an Internet connection is available. Note: CloudClient 3.4.0 is not supported at this time.

The following prerequisites are optional depending on the content that needs to be managed: 

This step is only necessary if you wish to use the management pack to manage vRA 6.x content. Download Java 7 directly to the Content Server using the following procedure Appendix III: Installing Java 7.



This step is only necessary if you wish to use the management pack to manage vSphere content. Install OVF tool on the Content Server using the following procedure Appendix IV: Installing VMware OVF Tool.

VMware, Inc.

7

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

Install the Management Pack Use the following procedure to install the management pack:

Step 1.

Reference

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:///vco

3. Click Start Orchestrator Client, and click any warning dialog boxes to open the vRealize Orchestrator client. Tip: You can save the JNLP file for future use. 4. Log in using [email protected] for the administrator username and the password specified during the vRealize Automation installation wizard.

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. Click the Select/Deselect all checkbox in the bottom left of the screen. Click Import selected elements.

8

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide 7. In the vRealize Orchestrator client, click Workflows, and select Library > Content Management > Configuration. Right click Install Content Management, and select Start Workflow.

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.

VMware, Inc.

9

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide 11. Enter the vRealize Code Stream user name and password. Click Next.

12. Enter the Artifactory user name and password that was set in the prerequisites section. Click Next.

13. Enter the Primary Content Server details, and click Submit to start the installation process.

10

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

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

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

VMware, Inc.

11

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

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 2.

Reference

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:///vco

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

4. Log in to the vRealize Orchestrator client.

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

12

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide 6. In the Open dialog box, navigate to the location of com.vmware.cse.clm.tests.package, and click Open. Click the Select/Deselect all checkbox in the bottom left of the screen. Click Import selected elements.

VMware, Inc.

13

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

Appendices Appendix I: Manually Downloading CloudClient 4.0.0 If the Content Server does not have an internet connection, use the following procedure to download CloudClient 4.0.0 to the Content Server – this is required for ALL installations: 1. On a computer with Internet access, download CloudClient 4.0.0 from the following location, and copy the cloudclient-4.0.0-3343843-dist.zip to the /tmp/ directory on the Content Server, either by accessing an internal web server first and downloading the file from there, or by using a file transfer utility such as SCP: https://vdc-download.vmware.com/vmwb-repository/dcr-public/13069b77-0c6a-4a07b96d-83ea0cd65c85/ecf79ffa-af94-4e99-8781-b8625e0807a4/cloudclient-4.0.0-3343843dist.zip

2. SSH to the Content Server and use the following command to create the /storage/artifactory/clm/install/ directory for CloudClient 4.0.0: mkdir -p /storage/artifactory/clm/install/4.0.0/

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/4.0.0/ directory, and change the cloudclient-4.0.0-3343843dist.zip zip file name to cc.zip. mv

/tmp/cloudclient-4.0.0-3343843-dist.zip /storage/clm/install/4.0.0/cc.zip

Note: Do not extract the contents of the CloudClient (cc.zip) zip files. The installer extracts the zip files during the installation process.

Appendix II: Manually Downloading CloudClient 3.3.1 If the Content Server does not have an internet connection, use the following procedure to download CloudClient 3.3.1 (if required) to the Content Server. If you do not intend to manage vRA 6.2 content, then you can skip this section. 1. On a computer with Internet access, download CloudClient 3.3.1 from the following location, and copy the cloudclient-3.3.1-2966416-dist.zip to the /tmp/ directory on the Content Server, either by accessing an internal web server first and downloading the file from there, or by using a file transfer utility such as SCP: https://vdc-download.vmware.com/vmwb-repository/dcr-public/e8b140e7-cf16-4ff6af88-a22ad7e9f5d1/10d2f6af-39b8-4d64-a682-7dc13fb0d6aa/cloudclient-3.3.1-2966416dist.zip

2. SSH to the Content Server and use the following command to create the /storage/artifactory/clm/install/ directory for CloudClient 3.3.1: mkdir -p /storage/artifactory/clm/install/3.3.1/ 14

VMware, Inc.

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

3. Use the following command to move the CloudClient zip file to the /storage/clm/install/ directory, and change the cloudclient-3.3.1-2966416dist.zip file name to cc.zip. mv

/tmp/cloudclient-3.3.1-2966416-dist.zip

/storage/clm/install/3.3.1/cc.zip

Note: Do not extract the contents of the CloudClient (cc.zip) zip files. The installer extracts the zip files during the installation process.

Appendix III: Installing Java 7 If you plan to manage vRealize Automation 6.2.x content using the management pack, use the following procedure to download Java 7 to the Content Server. 1. SSH to the Content Server and use the following command to create the download folder for Java 7: mkdir -p /storage/clm/install/jre-1-7/

2. Run the following command to download Java 7 – please note by downloading this software you are agreeing to the software license agreement: curl -kL -H "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F; oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otnpub/java/jdk/7u79-b15/jre-7u79-linux-x64.tar.gz -o /storage/clm/install/jre-17/jre-7.tar.gz

Note: Alternatively the tar.gz file can be downloaded from the website and transferred to the server via SCP. 3. Run the following command to extract the tar.gz file to the correct location: tar -xf /storage/clm/install/jre-1-7/jre-7.tar.gz -C /storage/clm/framework/jre-1-7/

4. Run the following command to rename the extracted folder: mv /storage/clm/framework/jre-1-7/jre1.7* /storage/clm/framework/jre-1-7/jre-17/

Appendix IV: Installing VMware OVF Tool In order to capture and release the vSphere Template package type VMware OVF Tool is required to be installed on the Content Server. This is not shipped as part of the release, but is free to download from the VMware download site. 1. Go to the web link below and follow then download link to OVF Tool 4.1: https://www.vmware.com/support/developer/ovf/

2. SCP the file to the /tmp directory on the Content Server. 3. SSH to the Content Server and cd to the /tmp directory ssh root@ cd /tmp VMware, Inc.

15

VMware vRealize Code Stream Management Pack for IT DevOps Installation Guide

4. Run the following command to make the uploaded file executable: chmod +x VMware-ovftool-4.1.0-2459827-lin.x86_64.bundle

5. Install OVF Tool with the following command: ./VMware-ovftool-4.1.0-2459827-lin.x86_64.bundle

6. Follow the prompts to accept the license agreement and install OVF Tool.

16

VMware, Inc.