Jenkins on Windows with StreamBase
Contents
1. Build History trend Execute concurrent builds if necessary 3 Sct 11 2015 12 14 P Advanced Project Options Q 2 Oct 11 2015 11 58 A Advanced 1 Oct 11 2015 11 56 Source Code Management RSS for all N RSS for failures None CVS CVS Projectset Subversion Modules V Repository URL https svn code sf net p streambase ant example code double Local module directory optional Repository depth infinity v Ignore externals 0000 8 Add more locations Check out Strategy Use svn update as much as possible v Use svn update whenever possible making the buid faster But this causes the artifacts from the previous buid to remain when a new build starts Repository browser Auto ar Click on Build Now Jenkins StreamBaseExample 4 Back to Dashboard O Status i Changes F Workspace amp Build Now a moir m o Verify success a blue circle amp Build History 3 Det 11 2015 12 14 F2. not just a JRE It s possible to use the JDK that installs with StreamBase itself which is in S TREAMBASE_HOME jdk64 You may wish to install and use a separate JDK for Jenkins to use If you do that recall that TIBCO recommends that you compile StreamBase applicaitons and Java plug ins with the same JDK version as the one bundled with your StreamBase installation The version installed with StreamBase is documented on the StreamBase Supported Configurations documentation page under JDK Requirements Some StreamBase users use a locally installed version of the JDK with StreamBase as well so consult with local StreamBase users for local JDK practice For the examples in this document we use the installed StreamBase JDK Edit System Variable Variable name JAVA_HOME Variable value YSTREAMBASE HOME jdk64 x _ _ cae Ant While StreamBase Studio comes with a version of Ant that s used for running Ant inside Studio and it s probably possible to leverage that especially if your local corporate policies make it hard to go directly get open source packages it s probably best to use a separate ant installation for Jenkins since it is like that you ll use Jenkins to do Cl with more things than just StreamBase It s like you already have ant installed In case you don t here s a brief guide to installing and configuring ant for use with Jenkins Determine the Ant version StreamBase uses While it isn t usual
3. Installed Advanced Install Name Coverage Complexity Scatter Plot Plugin This plugin shows the coverage complexity scatter plot from Clover or Cobertura plugin results ViewVC Plugin This plugin integrates ViewVC browser interface for CVS and Subversion with Hudson Team Foundation Server Plug in This plugin integrates Microsoft Team Foundation Server source control also known as TFVC to Jenkins PVCS SCM plugin for Hudson This plugin provides integration with Serena s PVCS Version Manager SCM Bazaar plugin This plugin integrates Bazaar version control system to Jenkins The plugin requires the Bazaar binary bz CMVC Plug in This plugin integrates CMVC to Hudson install without restart Download now and install after restart Install without restart Update information obtained 29 min lt z Then wait until you see this screen Installing Plugins Upgrades Preparation e Checking internet connectivity e Checking update center connectivity e Success ViewVC Plugin Success Configure StreamBase on the CI machine Consider setting STREAMBASE_HOME as a system environment variable At least to get started As the sample StreamBase ant scripts require it These samples don t consider having multiple StreamBase versions on the Cl server Make sure STREAMBASE_HOME bin is on system PATH Java Make sure the JDK you want for Ant is available on the system JAVA_HOME streamBase requires the full JDK
4. Jenkins on Windows with StreamBase Using a Continuous Integration Cl process and server to perform frequent application building packaging and automated testing is such a good idea that it s now a mainstream practice StreamBase users often ask TIBCO for guidance in integrating StreamBase with a Cl server infrastructure This document steps through one way to do that TIBCO doesn t sell a Cl server product there are plenty of fine Cl servers out there By far the most commonly used Cl server for Java based applications is Jenkins Development Tool Chain Setting up a Cl environment inevitably depends on other Software Development Lifecycle SDLC and DevOps tool choices We ll pick a tool chain for this document that represents the choices we most frequently see StreamBase customers make and which also represent our de facto recommendations for streamBase users who are setting up a Cl environment for the first time That we made these choices for this document doesn t mean other choices won t also work perfectly well and if you are already happy with other tools and know them well then it is probably better not to switch just because of what we did here In particular the average StreamBase application team today e Develops applications using a local Windows workstation usually in a corporate IT department and both the workstations and the development environments are managed and specified according to local corporate stand
5. ards e Is very familiar with Java application development for server side applications and uses the Eclipse IDE for its Java work Uses JUnit4 for Java functional unit testing and SBUnit for StreamBase functional unit testing Uses subversion for a source control repository Uses ant to build its applications and to run automated functional unit tests Uses Maven for software dependency management though in a variety of ways e Uses Jenkins as a Cl server The tool chain we picked e StreamBase Studio IDE for StreamBase and Java application development e m2e e JUnit4 e subversion e ant e maven e Jenkins Note These notes are based on Jenkins 1 632 StreamBase 7 5 4 and Windows 7 Professional There may be variations for different versions of any these These notes assume there is a Cl server machine that will have both Jenkins and StreamBase installed on it Other configurations are certainly possible but not explored here This note also assumes that StreamBase has already been installed on the CI server Instructions for installing StreamBase on Windows are here We re going to use Subversion as our source control repository in this document Others work fine too Git and Github are rapidly becoming commonplace among StreamBase users and the next version of this document will mostly like provide explicit steps for using Git instead of or in addition to Subversion The Windows Environment Microsoft Windows has some cha
6. f StreamBase with Jenkins There are many different things such as authentication you may want to set up on your Jenkins server Since this paper isn t really trying to teach you how to use Jenkins please consult the Jenkins documentation for such things Jenkins Location That said many people will need to change the Jenkins server port just on the very simplest installation to test out the integration Jenkins default port is 8080 This is a pretty commonly used port for many web server based things You can change the port by using the Jenkins console in a web browser Jenkins gt Configure System gt Manage Jenkins gt Jenkins Location or by editing the httpPort value in the services arguments element of JENKINS HOME jenkins xml If you change the Jenkins Location you have to restart the Jenkins server service to put the change into effect Source Repository Viewer Plugin It s going to be very handy to be able to view the source code related to test reports so while not absolutely necessary consider installing a source repository viewer plugin into your Jenkins server This is optional Since we re using Subversion for the examples in this document we pick ViewVC which is one of the viewers the StreamBase product engineering team uses in its own work Manage Jenkins gt Manage Plugins gt Available gt ViewVC Plugin and check the Install check box The press the Install without restart button Updates Available
7. ination that more recent versions of Ant will or won t work with StreamBase If you want to actually use the Ant from StreamBase Studio instead of installing your own see How to run the Studio provided version of Apache Ant from the command line The downside of using the provided Ant is that if you are customizing your Ant installation for Jenkins you have to do that in the context of the Studio Ant install and that s not always so easy to manage We could be very conservative and match the Ant version we use with Jenkins exactly with the StreamBase version and never have to worry about any Ant version incompatibilities at all It s probably fine to use the latest available ant release especially if it s still 1 9 x Download Ant 1 Browse to hittp ant apache org 2 Select Download gt Binary Distributions J N Apache Ant Welcome x gt C f D antapache oi Apps amp Bookmarks StreamBase Apache gt Ant apache THE APACHE ANT PROJECT I Projects Apache Ant o o License o News o Security Reports Documentation Manual Related Projects External Tools and Tasks Resources Frequently Asked Questions Wiki Having Problems Download o Binary Distributions o Source Distributions o Ant Manual Contributing o Mailing Lists Pick the version of ant you want and download For example to get Ant 1 9 2 go to http archive apache org dist ant binaries and download http a
8. ins 1 632 Brow 3 Press the Extract button After the extraction is finished Windows Extract All pops up an Explorer window gt Local Disk C temp gt jenkins 1 632 Burn New folder Name 5 jenkins msi TS setup exe 4 Run setup exe by double clicking on it in Explorer 5 Press Next gt Next assuming you accept the default install directory gt Install it wants Administrator privileges Press Yes if the Account Control dialog appears 6 Press Finish 7 The installation automatically installs Jenkins as a Windows Service starts it and then pops up your default browser and points it to http localhost 8080 Q Dashboard Jenkins x C fi D localhost 8080 Apps x Bookmarks J StreamBase J TIBCO 3 SBInterest CJ StreamBase Useful L New York New York spark moc Jenkins amp New Item amp People Welcome to Jenkins gt Build History yx Manage Jenkins Please Create new jobs to get started A Credentials Build Queue No builds in the queue Build Executor Status 1 Idle 2 Idle Tip The Jenkins installer probably set up permissions on the Jenkins install dir JENKINS HOME probably C Program Files x86 Jenkins for the Administrator You might want to change permissions there if others users will need access to this directory hierarchy Configure Jenkins for Use with StreamBase We re only going to touch on the things to configure that directly impact the integration o
9. llenges when it comes to configuring multiple Java based packages In particular system environment variables such as PATH JAVA_HOME and CLASSPATH tend to get set by different tools and the paths tend to get so cluttered it becomes hard to determine what version of what you re actually going to get when you run things The StreamBase product itself works hard to keep that clutter and guesswork to a minimum by simply not relying on those environment variables at all However in a Jenkins based environment such isolation is more difficult to maintain This document presents a very simplified installation process to get you up and running on a machine that is assumed to be pretty clean However if the machine you are using as a Cl server already has a lot of things on it your Jenkins jobs might start failing in hard to diagnose ways So if you see problems following the steps below it s not a bad idea to consider what s set in the environment of the Jenkins server and think about how it ought to be set for running StreamBase related jobs We ll try to do a better job in setting up isolated environments for Jenkins and the other toolchain tools in future versions of this document but for now consider setting up your CI server using a fresh Windows image as a way to minimize configuration headaches later Downloading and Installing Jenkins There are many ways to do this install Jenkins In this document we re just going to get Jenkins ins
10. ly necessary to use exactly the version of Ant that s built into StreamBase Studio it s probably best that they are at least pretty close since you will probably want to develop and test ant scripts inside StreamBase Studio and then have Jenkins run them later To find out what version of Ant StreamBase Studio has start up Studio and then look at the Ant plug in version From the Studio main menu Help gt Installation Details gt Plug ins gt Type filter text ant and have a look sr 1 T TIBCO StreamBase Studio 7 5 Installation Details S xZ Installed Software Installation History Features Plug ins Configuration type filter text Sign Provider Plug in Name s _ Version Plug in Id z E Eclipse org Ant Build Tool Core 3 3 1 v20150123 org eclipse ant core E Eclipse org Ant Launching Support 1 0 400 v201405 org eclipse ant launck E3 Eclipse org Ant UI 3 5 500 v201405 org eclipse ant ui E Eclipse Orbit Apache Ant 1 9 2 v20140417 org apache ant k Eclipse org Apache Batik CSS 1 7 0 v20101104 org apache batik css E Eclipse org Apache Batik GUI Utilities 1 7 0 v20090309 org apache batik util REl Felince arn Anache Ratik Itilitiec 179 w2N1N11NA arn anache hatik itil You can see here that StreamBase Studio in this case version 7 5 4 has Ant 1 9 2 The Ant version is determined from the Eclipse release that underlies this Studio release We haven t made any determ
11. nt variable e Make sure ANT_HOME is a system environment variable as well Maven Plug in for Jenkins Jenkins comes pre installed with the Maven Project Plugin Just use that as Is Jenkins Admin Note We ve been changing a lot of things here We should restart Jenkins so it picks up the changes j uul Q Jenkins x 4 sb Revision 2267 oe C ft 5 localhost 8080 restart Start a Cmd line in JENKINS HOME then jenkins exe stop jenkins exe start if you change anything after install Creating a Jenkins project for a StreamBase application Goto http localhost 8080 and create a new job Welcome to Jenkins Please create new jobs to get started Create a Freestyle project Item Name streamBaseExample Freestyle project This is the central feature of Jenkins Jenkins will Press OK On the resulting project configuration page Under Source Code Management e select the Subversion radio button e Modules Repository URL https svn code sf net p streambase ant example code double Under Build Add build step Invoke Ant Targets sbunit Press Save Jenkins Jenkins StreamBaseExample configuration 4 Back to Dashboard Project name StreamBaseExample C DN Status Description gt Changes Workspace Build Now Plain text Preview Delete Project Discard Old Builds z Configure This build is parameterized Disable Build No new builds will be executed until the project is re enabled
12. rchive apache org dist ant binaries apache ant 1 9 2 bin zip Install Ant Follow the installation instructions for Ant in the Apache Ant User Manual gt Installing Apache Ant section with the caveat that the link above is to the latest version of Ant and might differ from the one you just downloaded If you want to be sure you have the right version of the manual use the one in the manual sub folder of the ant version you just downloaded Very important for Windows based installed ANT HOME JAVA_HOME and CLASSPATH must be set appropriately in order for Ant to be happy This is covered in Ant installation instructions but double checking never hurts For the examples in this document we ve installed Ant into and set the system ANT _HOME to C java apache ant 1 9 2 oN Phere j lel j eT Oe j C java apache ant 1 9 2 Destination file ma acernmamii f Aah anise 1f A416 lado namm nnm coe Verify that Ant is Working We re sure you wouldnt have skipped this step on purpose but in case it slipped your mind make sure that Ant runs on its own just fine from a command line on your CI machine by completely following the instructions under Apache Ant User Manual gt Installing Apache Ant gt Check Installation Configure Ant for Use with Jenkins There s probably some more advanced way to use Ant with Jenkins but for this simple installation example e Make sure ANT_HOME bin is available on the system PATH environme
13. talled and up and running as quickly as possible The Jenkins wiki installation page for Windows site actually recommends a somewhat different procedure that involves more steps This document presents the steps we actually took on a Windows 7 Pro machine If you are already well versed in Jenkins installation please feel free to use the method that works for you and of course you may use a pre existing Jenkins installation of your choice At the moment we have no recommendations about the range of Jenkins versions to use with StreamBase and will revise these notes as we have them The main Jenkins web site is at https jenkins ci org We ll refer to the directory that Jenkins was installed into as JENKINS HOME in this document 1 Download latest from hittp mirrors jenkins ci org windows latest These instructions use 1 632 If you are using the latest that s beyond that things might be a little different C f D mirrors jenkins ci org windows Apps ye Bookmarks StreamBase TIBCO SB Interest WW jenkins 1 631 zip 27 Sep 2015 21 22 99M iW ienkins 1 632 zip 05 Oct 2015 11 18 99M latest 23 Mar 2011 18 17 0 2 Goto where you downloaded your zip file right click on the zip file and select Extract All from the context menu Name Date r _4 jenkins 1 632 zip 10 10 P i r _4 Extract Compressed Zipped Folders Select a Destination and Extract Files Files will be extracted to this folder C temp jenk
Download Pdf Manuals
Related Search