1. © 2013 IBM Corporation IBM UrbanCode Deploy v6.0 Support Enablement Training Jenkins plug-in 1 November 2013

2. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational 2 Agenda  Overview  Install uDeploy Plug-in in Jenkins  Configure uDeploy Plug-in in Jenkins  Set Up a Jenkins Job  Set Up a uDeploy Component  Build the Jenkins Job  Verify in uDeploy  Additional Links Source:If applicable, describe source origin (date, author, publication)

3. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational 3 UC Deploy v6.0 Jenkins CI – Overview Source:If applicable, describe source origin (date, author, publication)  Jenkins Continuous Integration is an open source continuous integration tool written in Java.  Jenkins CI was forked from Hudson after a dispute with Oracle.  The Jenkins CI plug-in adds capabilities to the IBM Urban Code Deploy (UCD) product that allow for integration with a Jenkins Continuous Integration instance.

4. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Install uDeploy Plug-in in Jenkins Prerequisite: Both Jenkins CI and uDeploy must be installed and running before continuing. 1) Log into the Jenkins CI server, which by default is http://hostname:8080 2) Click Manage Jenkins -> Manage Plugins. 4

5. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Install uDeploy Plug-in in Jenkins 3) Click the Advanced tab. 4) Under the “Upload Plugin” section, press the Browse button and search for the Jenkins hpi file. 5) Click the Upload button. 5

6. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Install uDeploy Plug-in in Jenkins 6) You can see the uDeploy plugin under the Installed tab. 6

7. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Configure uDeploy Plug-in in Jenkins 1) Back on the welcome page, click Manage Jenkins -> Configure System. 7

8. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Configure uDeploy Plug-in in Jenkins 2) Scroll to the “uDeploy Server” section. 3) Enter any name for the Profile Name. 4) Enter the correct URL to your uDeploy server. 5) Enter the correct log-in credentials, which by default are admin / admin. 6) Press the Test Connection button, and the “Success” message should appear on screen. 7) Press the Save bottom at the bottom. 8

9. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Set Up a Jenkins Job 1) Click New Job. 2) Enter a job name and select your project type. 3) Press the OK button. 9

10. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Set Up a Jenkins Job 4) Scroll to the “Post-build Actions” section. 5) Click the Add post-build action drop down menu. 6) Select Publish artifacts to uDeploy. 10

11. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Set Up a Jenkins Job 7) On the screen that loads, scroll to the “Publish artifacts to uDeploy” section. 8) Select the uDeploy Server, which is the Profile Name from slide 8. 9) Enter any name for Component. 10) Enter the Jenkins workspace path specific for this job for Base Artifact Directory. 11) Enter something like “1.${BUILD_NUMBER}” for Version to have a unique ID for each build. 12) Press the Save button. 11

12. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Set Up a uDeploy Component 1) Log into the uDeploy server, which by default is http://hostname:8080 2) The default log-in credentials are admin / admin. 3) Click the Component tab then press the Create New Component button. 4) For Name, enter the same value as Component from slide 11. 5) Leave Source Config Type as NONE, and press the Save button. 12

13. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Build the Jenkins Job 1) Now make sure the Jenkins workspace directory has your project files or copy the files over. 2) On the Jenkins welcome page, select your job. 3) Click Build Now, and you will see an entry added under “Build History”. 13

14. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational UC Deploy v6.0 Jenkins CI – Verify in uDeploy 1) On the uDeploy welcome page, click the Component tab. 2) Select your component then click the Versions tab. 3) You will see and be able to click on the version that Jenkins pushed to uDeploy. 14

15. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational 15 UC Deploy v6.0 Jenkins CI – Additional Links  Get the plug-in hpi file here: https://ausgsa.ibm.com/projects/d/devops/plug-ins/October/https://ausgsa.ibm.com/projects/d/devops/plug-ins/October/  This two minute video quickly shows Jenkins ineracting with uDeploy: http://blogs.urbancode.com/urbandeploy/quick-look-at-udeploy-jenkins/  This hour long video shows in detail Jenkins interacting with uDeploy: http://www.urbancode.com/html/resources/webinars/Using_UrbanCode_Deploy_with_Jenkins.html  Here is the UrbanCode wiki about Jenkins: http://wiki.urbancode.com/uDeploy/Repositories#Jenkins

16. © 2013 IBM Corporation Accelerating Product and Service Innovation | Rational 16 © Copyright IBM Corporation 2013. All rights reserved. The information contained in these materials is provided for informational purposes only, and is provided AS IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials. Nothing contained in these materials is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in these materials to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in these materials may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. IBM, the IBM logo, Rational, the Rational logo, and other IBM products and services are trademarks of the International Business Machines Corporation, in the United States, other countries or both. Other company, product, or service names may be trademarks or service marks of others. www.ibm.com/software/rational