TouchTest TM Appcelerator Jenkins CI Tutorial
|
|
- Stella Beasley
- 8 years ago
- Views:
Transcription
1 TuchTest TM Appceleratr Jenkins CI Tutrial
2 TuchTest TM Appceleratr Jenkins CI Tutrial 2015, SOASTA, Inc. All rights reserved. The names f actual cmpanies and prducts mentined herein may be the trademarks f their respective cmpanies. This dcument is fr infrmatinal purpses nly. SOASTA makes n warranties, express r implied, as t the infrmatin cntained within this dcument.
3 Table f Cntents Prerequisites... 1 Third Party Prerequisites... 1 ios-only Prerequisites... 1 Abut Shell Steps and the ios Signing/Prvisining Prerequisite... 2 Andrid-Only Prerequisites... 3 CludTest Utilities and Plugins... 3 Test Cmpsitin Prerequisites... 4 CludTest Cntinuus Integratin Supprt... 5 Installing the SOASTA CludTest Jenkins/Hudsn Plugin... 5 Installing the GitHub Plugin... 7 Static vs. Dynamic Instrumentatin... 9 Jenkins Wrkflws fr TuchTest... 9 Dynamic Instrumentatin f an 10 Dynamic Instrumentatin f an 10 Static Instrumentatin f an Xcde Prject Dynamic Instrumentatin f an 10 Static Instrumentatin f an Andrid Prject Creating a Jenkins Jb Using the CludTest Jenkins Plugin, MakeAppTuchTestable Abut the Titanium SDK Path Using MATT n an ios APP Bundle (Dynamic Instrumentatin) Using MATT n an IPA (Dynamic Instrumentatin fr Device) Using MATT n a Prject (Static Instrumentatin fr Simulatrs/Devices) Using MATT n an APK (Dynamic) Using MATT n a Prject (Static) Build the Titanium Prject Preparing the App fr Simulatrs and Devices Build the APP fr a Simulatr Deplying the APP File n a Simulatr Installing the IPA Archive n iphnes and ipads Using SCmmand t Play One r Mre Cmpsitins i
4 Adding the Publish Junit Test Result Reprts Step Building the Prject Inspecting Test Results in Jenkins Appendix: Inspecting the Mbile App in CludTest... 1 Appendix: Cmpleted Execute Shell Script... 1 ii
5 Prerequisites This tutrial guides the user thrugh the prcess f using the Jenkins cntinuus integratin tl cmbined with the CludTest Jenkins/Hudsn Plugin in tandem with an example Titanium prject and precnfigured CludTest test cmpsitins. This tutrial prvides guidance fr tw audiences: Users wh wuld like t add Titanium ios r Andrid Testing t a pre-existing Jenkins setup Users wh are either Titanium ios Develpers r Andrid Develpers starting ut with TuchTest wh wuld als like t add TuchTest t a cntinuus integratin setup TIP: If yur rganizatin is nt already using Jenkins refer t the dcumentatin n the Use Jenkins page t get started. Additinal Jenkins installatin references are included at the end f this guide. A Jenkins jb will be defined that uses git t retrieve the sample prject, makes that prject tuchtestable using the MakeAppTuchTestable utility, and which then deplys the cmpiled app t multiple devices using a deplyment script; after which several preexisting test cmpsitins are called t run silently in CludTest and n the specified devices. Finally, CludTest results are inspected inline in Jenkins, als via the CludTest Jenkins/Hudsn Plugin. Nte: Third Party Prerequisites T get started, yu'll need: The Appceleratr sample mbile app, KitchenSink, which is available frm GitHub, is used as the example prject in this guide. Fr ios, a Macintsh cmputer with sufficient USB prts t run the desired number f devices, pssibly using a USB hub Fr Andrid, a cmputer with sufficient USB prts t run the desired number f devices, pssibly using a USB hub Jenkins cntinuus integratin sftware (this can be n the same Mac that is running Titanium r n a different Mac nde) This tutrial assumes a minimal familiarity with Appceleratr Titanium Studi and the fllwing prerequisites: Titanium Studi is installed with Titanium SDK versin r abve. ios-only Prerequisites The remaining ios prerequisites are cmmn t any Appceleratr prject that utilizes the ios Develper Prgram t install an ios app n a device: The develper is enrlled in the ios Develper Prgram (s that the Appceleratr app can be pushed t the ios Device via itunes). 1
6 The Unique Device Identifier (UDID) f the ios Device that will be used t test must be registered at the Apple Prvisining Prtal. itunes 10.x r greater must be installed n the desktp client that is running Titanium Studi. One f the key steps during an ios autmated build is deplying the app t yur test device, withut requiring any human interactin. Typical slutins (e.g. ver-the-air distributin) require that the user accept a prmpt. SOASTA TuchTest includes a tl (built using AppleScript) that silently deplys an app. It des this by autmating the prcess f pening the prject in Titanium and running it, which causes Xcde t deply. T use the deply script, yu will need the fllwing: 1. A dedicated machine running Mac OS X, with Xcde. If yu are using Jenkins r Hudsn, this can be either the master nde r a slave. 2. One r mre tethered devices. If yu have mre devices than USB inputs, yu can use a USB hub. Nte als that sufficient pwer t prevent the device frm running dwn unexpectedly shuld be available via that USB input. A nte n tethering: SOASTA TuchTest des nt require tethering fr recrding r playback. Hwever, yu d need t tether the device fr silent deplyment f yur app. 3. The device(s) shuld have the ios Aut-Lck setting set t Never. Abut Shell Steps and the ios Signing/Prvisining Prerequisite In general, the best practice fr all shell steps presented in this tutrial is t first execute all f them frm the cmmand line. With respect t ios signing and prvisining, yu must perfrm the fllwing ne-time prcedure frm Terminal t sign each prfile/applicatin cmbinatin that is in its first use. Prvisining will nt be silent until this is dne. TIP: If signing is nt dne, then a "User interactin nt allwed" errr will ccur in the build. This is because the Operating System requires a user t sign an applicatin using a specific Prvisining prfile fr the first time. In that case, the Operating System needs a user t authrize the signing prcess. Use the fllwing steps: 1. In Terminal, run the xcrun cmmand frm yur Jenkins jb manually. Nte: If yu are using the Jenkins $WORKSPACE variable, yu'll need t change it t a Mac OS X path t wrk here. When yu d that, OS will ppup a dialg bx asking permissin fr the signing prcess. 2. Chse "Always allw" and this errr will nt shw up again. 2
7 Andrid-Only Prerequisites This tutrial uses Apache Ant with Andrid SDK. Learn mre abut the Andrid SDK here, and Apache Ant here. The Minimum Andrid Versin supprted fr use with TuchTest is (Gingerbread). The Minimum Apache Ant versin required fr using the SOASTA CludTest Jenkins Plugin is r later. The Jenkins GitHub Plugin is used t retrieve the prject used in this tutrial (instructins fr installing it are presented belw). Refer t the git site here. Each Andrid device must have the TuchTest Agent app installed and Cnnected at runtime (if mbile web testing will ccur then the TuchTest Web app is als required). Each Andrid device shuld have the fllwing Settings: In the device settings, tap Develper Optins and check the USB Debugging bx. In the device settings, tap "Security" and then tap t check the Unknwn surces bx. CludTest Utilities and Plugins Befre prceeding, dwnlad the fllwing CludTest plugin and utility sftware frm the CludTest Welcme page, Dwnlads sectin. CludTest Jenkins/Hudsn Plugin (this Jenkins/Hudsn plugin will be installed using the Jenkins plugin interface). Jenkins CludTest Plugin versin 2.9 r later and TuchTest r later are required fr dynamic instrumentatin. CludTest MakeAppTuchTestable Utility (this utility will be called at the apprpriate time via a Jenkins jb using an Execute Shell build step) 3
8 Nte: The CludTest user specified t run the MakeAppTuchTestable utility must be a user with Mbile Device Administratr rights. CludTest Cmmand Line Client (als knwn as scmmand, this cmmand line interface utility will be called at the apprpriate time via a Jenkins jb using the CludTest Jenkins Plugin's MakeAppTuchTestable, Play Cmpsitin(s) build step). It is nt necessary t dwnlad the cmmand-line utility since the Plugin als handles this task. Fr ios nly, the CludTest ios App Installer Utility is required (this utility cntains tw executables; the is_app_installer, which is used t install IPA files t ios physical devices; and the is_sim_launcher, which is used t install cmpiled APP bundle files). This archive cntains tw executables: Fr deplyment t Simulatrs, use the is_sim_launcher executable fund in the ios App Installer Utility at the apprpriate time(s) via a Jenkins jb using an Execute Shell build step. Fr deplyment t iphne and ipad devices, use the ios App Installer Utility t deply.ipa archives t the physical device(s). This executable can be called at the apprpriate time(s) via a Jenkins jb using an Execute Shell build step. The apprpriate executable will be called at the apprpriate time(s) via a Jenkins jb using an Execute Shell build step. Test Cmpsitin Prerequisites The test cmpsitins yu will use must already exist n the CludTest instance that yu specify and yu must use the crrect SOASTA Repsitry path t invke them. The test cmpsitin specifies the device(s) that it will run n. If yu re a new TuchTest user, refer t the fllwing dcumentatin befre prceeding with this tutrial. 4
9 CludTest Cntinuus Integratin Supprt SOASTA CludTest includes first-class supprt fr including test utput in build reprts fr Jenkins and Hudsn via the SCmmand utility. Additinally, the Jenkins/Hudsn Plugin prvides visual integratin with CludTest dashbards within Jenkins itself. When yu run test cmpsitins via SCmmand, CludTest autmatically utputs JUnitXML-cmpatible test utput. Since Jenkins prvides ut-f-the-bx JUnit supprt these result details frm a given test cmpsitin run in Jenkins using SCmmand will appear n the crrespnding Test Results page in Jenkins. By placing all its XML int a directry that we als prvide t Jenkins as a part f defining a given jb, we can easily display these JUnit-friendly test results inside Jenkins. Using this cnfiguratin, a Jenkins Test Result detail page will display details frm CludTest. While it is nt necessary t install the CludTest Jenkins/Hudsn Plugin t utilize CludTest s JUnitXML-frmatted utput in Jenkins in this manner, plugin installatin adds the capability t als jump t specific test cmpsitin errrs in the CludTest Result Details dashbard frm within Jenkins. In the screensht abve, the errr heading and detail text are an utput f SCmmand fr the test shwn. Clicking the link, and prviding CludTest credentials, will then display the precise failure inline in Jenkins fr the given CludTest result. Installing the SOASTA CludTest Jenkins/Hudsn Plugin Use the fllwing steps t install the CludTest Jenkins Plugin (versin 2.9 r later are required fr dynamic instrumentatin as well as t autmatically update the CludTest Jenkins Plugin's MakeAppTuchTestable) frm within yur Jenkins instance. The MATT mdule is aut-updated, s nce it's installed the mst current versin is assured. 1. In Jenkins, click Manage Jenkins, and then click Manage Plugins. 5
10 2. Click the Plugin Manager, Advanced tab. 3. Lcate the SOASTA CludTest Plugin in the list (using Cmd+F and "Sasta" is a quick way t lcate it). 4. Click the Install withut Restart buttn at the bttm f the page. The Installing Plugins/Upgrades page appears and indicates success nce the install cmpletes. 6
11 Befre using the CludTest Jenkins Plugin, yu will need t prvide the CludTest server URL and user credentials via the Manage Jenkins > Cnfigure System page, CludTest sectin. We recmmend creating a dedicated CludTest accunt fr Jenkins t use. Installing the GitHub Plugin Use the fllwing steps t install the GitHub Plugin frm within yur Jenkins instance. This will allw us t use GitHub as a Surce Cde Repsitry t retrieve the example prject, KitchenSink. TIP: Git is a distributed versin cntrl system used fr sftware develpment. It is nt necessary t signup r lgin t GitHub in rder t checkut the cde using the fllwing cmmand. In the Surce Cde Management sectin, click Git. If yu are using yur wn app, yu can skip this requirement and then substitute the SCM tl and repsitry t use in the place f Git. 1. In Jenkins, click Manage Jenkins, and then click Manage Plugins. 2. Click the Plugin Manager, Advanced tab 3. Lcate the GitHub Plugin and check it as well. Installing the GitHub Plugin will als install the GitHub Plugin. 7
12 Yu can verify plugin installatin n the Manage Plugins, Installed tab: Nte: We will specify a Git repsitry t clne in a later step in the Jenkins jb. 8
13 Static vs. Dynamic Instrumentatin The CludTest Jenkins Plugin's MATT mdule supprts tw instrumentatin methds: static and dynamic. The MATT mdule plays a rle in making either the ios r Andrid prject r its cmpiled APP bundle, IPA, r APK TuchTestable. Dynamic instrumentatin ccurs when MATT instruments a cmpiled file (i.e. an APP bundle flder, an IPA file, r APK file). This methd requires that yu cmpile yur prject first t create an APP, IPA, r APK, after which it can be instrumented using SOASTA r later (TuchTest ). Dynamic instrumentatin is available fr all supprted Andrid versins, while fr ios versin 6 r later is required. Static instrumentatin ccurs when MATT instruments an ios Andrid prject. This methd requires that yu apply MATT t the prject prir t building the APK. Static instrumentatin is available in all TuchTest releases and fr all supprted Andrid versins. 1. Determine whether t instrument the mbile app using the MATT input type prject r t instrument it using the APP, IPA, r APK ptins. The subsequent steps will differ since MATT is applied at a different time in the wrkflw. Jenkins Wrkflws fr TuchTest The CludTest Jenkins Plugin is used t make the mbile app TuchTestable either by applying it t the prject r t the APP bundle, IPA, r APK file itself (as discussed belw). OS-specific tls are used where applicable. In Andrid, Ant is used t build the APK and the cmmand used depends whether MATT has already been applied. After which, adb is used in an Execute Shell step, fllwed by a final pre-build step that uses the CludTest Jenkins Plugin, Play Cmpsitin(s) cmmand. In ios, xcdebuild and xcrun are used, and the iosappinstaller utility cmmandline cmmands are used t build and deply. Because there are different pssible Jenkins jb wrkflws, the pssible steps are presented a la carte. Fr each Jenkins jb there will be (minimally): A First step; used t retrieve the surce prject (all wrkflws) In between the first and last steps, each Jenkins jb will have:! A CludTest Plugin, MakeAppTuchTestable step;! with ne (r mre) Build step using Ant (in Execute Shell)! and ne (r mre) Install steps using adb (in Execute Shell) A Last step; t Play the Cmpsitin 9
14 Nte: Nte the fllwing terminlgy: Signing the app is dne using the CludTest Jenkins Plugin, MATT, Advanced Optins t enter the ptinal MATT parameters (refer t the relevant sectins). Signing can als be dne frm the cmmand line using an Execute Shell step and the tl f yur chice. Static instrumentatin applies MATT t the ios prject file r t te Andrid prject flder Dynamic instrumentatin applies MATT t the ios APP bundle file, IPA file, r t the Andrid APK file Dynamic Instrumentatin f an APP file In this wrkflw, yu'll apply MATT t the cmpiled APP file using the appbundle parameter. If yu're als deplying t physical devices, yu'll need t mix and match steps t d bth, keeping in mind t build the APP first. Build the APP with an Execute Shell step using xcdebuild Apply MATT t that cmpiled APP using ios APP Bundle Run App n ios Simulatr cmmand Dynamic Instrumentatin f an IPA file In this wrkflw, yu'll delay applying MATT until the IPA is created Build the APP with an Execute Shell step using xcdebuild Build the IPA file with an Execute Shell step using xcrun, Apply MATT t that cmpiled IPA using ipa Install App n ios Device cmmand. In the remainder f the Jb Creatin steps, mix and match the tasks that yu need t build yur Jenkins jb. Static Instrumentatin f an Xcde Prject In this wrkflw, yu'll apply MATT t the Xcde prject itself, using the prject parameter. After which, yu'll add the steps necessary t build and install t yur simulatrs and devices. Apply MATT using the prject parameter (static nly) Build the APP with an Execute Shell step using xcdebuild (ptinal) Build the IPA with an Execute Shell step using xcrun Either Run App in ios Simulatr r Install ios App n Device (using IPA) Dynamic Instrumentatin f an APK file In this wrkflw, yu'll apply MATT t the cmpiled APK file using the appbundle parameter. If yu're als deplying t physical devices, yu'll need t mix and match steps t d bth, keeping in mind t build the APK first. 10
15 Get the surce cde (in this scenari, using git) Build the APK with an Execute Shell step using Ant Apply MATT t that cmpiled APK using MATT's APK input type Install the APK Run the cmpsitin(s) Pst results (ptinal) In the fllwing sectins, chse nly thse steps that match yur wrkflw. Static Instrumentatin f an Andrid Prject In this wrkflw, yu'll apply MATT t the Andrid prject itself, using the prject input type. This is dne befre the APK build step. After which, add the step(s) necessary t build and install t yur simulatrs and devices. Get the surce cde (in this scenari, using git) Apply MATT using the prject input type (static nly) Build the APK with an Execute Shell step using Ant Install the APK Run the cmpsitin(s) Pst results (ptinal) 11
16 Creating a Jenkins Jb The Jenkins jb created belw will run n the desktp machine with Titanium and ne r mre prperly prvisined USB-attached devices. The jb will have build steps using Execute Shell that will utilize git t dwnlad a prject frm surce, run the Make AppTuchTestable utility n that prject, build and deply using the deply script, and use the Plugin's Play Cmpsitin(s) cmmand t silently play a list f cmpsitins. Additinally, a Pst-build actin is used t publish the JUnit test result reprt. 1. In tp-level Jenkins dashbard, click New Jb. The Jb name page appears. 1. Enter a jb name withut spaces and select the first ptin, "Build a free-style sftware prject". 12
17 The Jb Details page appears. 2. Enter the fllwing cnfiguratin details fr this jb: A descriptin. Fr example, Fr example, "Checks ut the KitchenSink surce cde, makes the prject r cmpiled file TuchTestable, deplys the app, and runs a suite f CludTest cmpsitins." Click the Add build step drp-dwn and select Execute shell. 13
18 Get KitchenSink using the GitHub Plugin (All Wrkflws) Next, we will add a step that will get the KitchenSink prject that will be used in the remainder f this tutrial. The fllwing instructins use the Jenkins Git Plugin (installed abve). If yu are using yur wn Surce Cde Management system simply select its type and enter its repsitry URL, as yu wuld nrmally d. With the Git Plugin installed in ur Jenkins instance, we will add the Surce Cde Management step as we wuld with any SCM tl. 1. In the Surce Cde Management sectin, check the Git radi buttn. Nte: Yu can specify yur wn SCM tl and Repsitry URL here. 2. Enter the GitHub Repsitry URL in the entry field: 3. Save the Jenkins jb and prceed with the OS-specific instructins belw. 14
19 Using the CludTest Jenkins Plugin, MakeAppTuchTestable As nted in the prerequisites abve, the CludTest Jenkins Plugin's MakeAppTuchTestable mdule is used t autmate prtins f the Jenkins jb. Nte: The CludTest user specified t run the CludTest Jenkins Plugin, MakeAppTuchTestable mdule must be a user with Mbile Device Administratr rights. CludTest Lite users have admin rights fr the given device n their wn instance. In the fllwing sectins, select nly thse steps necessary t cmplete yur Jenkins jb. The wrkflws are rganized first by mbile OS (ios r Andrid) and then by the instrumentatin type. Abut the Titanium SDK Path In sme cases where the Titanium SDK path is nt autmatically detected, yu will need t add yur Titanium SDK path t the examples included belw. In such cases, use the -titaniumsdk parameter. The Titanium SDK argument can be appended t the CludTest Jenkins Plugin's MATT step using the fllwing syntax: -titaniumsdk <Path f the Titanium SDK t use> where the value f the Titanium SDK is either /Library/Applicatin Supprt/ Titanium/ mbilesdk/sx/ r ~/Library/Applicatin Supprt/Titanium/mbilesdk/sx/ with the flavr r SDK appended at the end f the path. Fr example, /Library/Applicatin Supprt/Titanium/mbilesdk/sx/2.0.1.GA2. 15
20 Using MATT n an ios APP Bundle (Dynamic Instrumentatin) Use the fllwing steps t dynamically instrument an APP bundle. This is typically dne befre the APP is run n a simulatr but after the prject APP is built. Fr example, yu can use this step after an Execute Shell step using xcdebuild. 1. Add a MakeAppTuchTestable step t the jb. 2. Apply MATT t the cmpiled APP by selecting the Input Type, ios App Bundle (the MATT cmmand-line equivalent is the appbundle parameter). 1. Enter the APP name as the Input File (frm the wrkspace rt). 2. Optinally, click Advanced t display additinal MATT cnfiguratin fields. 3. Save the Jenkins jb. Using MATT n an IPA (Dynamic Instrumentatin fr Device) Use the fllwing steps t dynamically instrument an IPA file. This is typically dne as the last step befre it is installed n a device. Fr example, yu can use this step after an Execute Shell step using xcrun. 3. Add a MakeAppTuchTestable step t the jb. 16
21 4. Apply MATT t the cmpiled IPA by selecting the Input Type, IPA (e.g. the MATT equivalent is the ipa parameter). 4. Enter the IPA name as the Input File (frm the wrkspace rt). 5. Optinally, click Advanced t display additinal MATT cnfiguratin fields. Launch URL Same as MATT launchurl. Fr example: my-app://launch Back up mdified files Check this t keep backups in the prject). Additinal ptins - Enter any additinal MATT cmmand line parameters. Mst ntably, yu can use MATT t prvisin and cde sign the dynamically instrumented IPA file (cde signing and prvisining can, f curse, be dne using xcrun, which is discussed in the Execute Shell step, Building the IPA fr a Device). Use the fllwing MATT ptinal IPA parameters -prvisiningprfile <prfilepath> - Path f the Prvisining prfile t be used fr building IPA file. The prvisining prfile yu input MUST t be a Distributin prfile. -signingidentity <signingidentityname> - Name f the signing identity t be used fr cdesigning the applicatin. (e.g. "ios Distributin: Develper Name") -entitlementsfile <entitlementsfilepath> - path f the entitlements file t be used fr cdesigning the applicatin Fr mre abut using additinal MATT parameters, use: 17
22 0sh MakeAppTuchTestable/bin/MakeAppTuchTestable -help 6. Save the Jenkins jb. Using MATT n a Prject (Static Instrumentatin fr Simulatrs/ Devices) This utility is autmatically dwnladed by the SOASTA CludTest Jenkins Plugin and can be easily specified in yur Jenkins jb using the fllwing steps. 7. Click Add a Build Step, and select MakeAppTuchTestable frm the drp-dwn list. This MakeAppTuchTestable step will always be the first step in a Static Instrumentatin wrkflw, but will cme after the APP r IPA is built where thse files are in use n a simulatr(s) r device(s). The Make App TuchTestable frm appears. 8. Enter the Xcde prject name as the Input File. 18
23 9. Optinally, click Advanced t display additinal MATT cnfiguratin fields. Launch URL Same as MATT launchurl. Fr example: my-app://launch Target Same as MATT target. Fr example: Stckfish cpy Back up mdified files Check this t keep backups in the prject flder (where.xcdeprj resides). Additinal ptins - Enter any additinal MATT cmmand line parameters. Fr mre abut using additinal MATT parameters, use: 0sh MakeAppTuchTestable/bin/MakeAppTuchTestable -help 10.Save the Jenkins jb. Using MATT n an APK (Dynamic) Use the fllwing steps t dynamically instrument an APK file at the prper pint in yur wrkflw. If yu are using dynamic instrumentatin, yu must first d the APK step prir t this step. But, if yu'd rather fllw alng sequentially, yu can add the MATT step nw s lng as yu place an APK build step prir t it befre building the Jenkins jb. If yu are using static instrumentatin, yu must apply MATT t the prject prir t this step. 1. Add a MakeAppTuchTestable step t the jb. 19
24 2. Select the Input Type, APK (e.g. the MATT equivalent is the APK parameter). 3. Enter the APK name as the Input File (frm the wrkspace rt). 20
25 4. Optinally, click Advanced t display additinal MATT cnfiguratin fields. 5. Specify MATT flags as required. Fr example, andridsdk when installing a debug APK t a physical device and either verwriteapp r dntcreateapp t prevent Jenkins frm marking the MATT step as FAILURE (even thugh the TuchTestable app is created as expected). Launch URL Same as MATT launchurl. Fr example: my-app://launch Backup mdified files Check this t keep backups in the prject. Additinal ptins - Enter any additinal MATT cmmand line parameters. Mst ntably, yu can use MATT t add keystre, keypass, and strepass arguments t sign the dynamically instrumented APK file. Use the fllwing MATT ptinal APK parameters -keystre <keystrepath> - Path f the keystre t be used t sign the APK file.. -strepass <keystrepasswrd> - Passwrd f the keystre t be used t sign the APK file. -keypass <privatekeypasswrd> - Passwrd f the private key (if different than the keystre passwrd) t be used t sign the APK file. Fr mre abut using additinal MATT parameters, use: 0sh MakeAppTuchTestable/bin/MakeAppTuchTestable - help 21
26 6. Save the Jenkins jb. Using MATT n a Prject (Static) Use the fllwing steps if yu'll be instrumenting the prject using the static methd via the Input Type, prject. This step will always prceed the build APK step while using static instrumentatin. 1. Click Add a Build Step, and select Make App TuchTestable frm the drp-dwn list. The Make App TuchTestable frm appears. TIP: Click the Help icns fr any rw t get tip text. 2. Select the CludTest Server frm amng thse cnfigured. Nte: Indicating the CludTest server was dne as part f the CludTest Jenkins Plugin, Cnfigure System step. If nt entries appear here return t Manage Jenkins > Cnfigure System, and fill in the infrmatin in the CludTest Servers sectin. Be sure t save these changes. 3. Specify the current prject flder t use. "dridfishchess_andrid" t indicate the prject flder in the Jenkins wrkspace. 22
27 4. Optinally, specify additinal parameters by first clicking the Advanced buttn (page right). 5. Select the CludTest Server frm amng thse cnfigured. TIP: Indicating the CludTest server was dne as part f the CludTest Jenkins Plugin, Cnfigure System step. If nt entries appear here return t Manage Jenkins > Cnfigure System, and fill in the infrmatin in the CludTest Servers sectin. Be sure t save these changes. 6. Optinally, click Advanced t display additinal MATT cnfiguratin fields. Launch URL Same as MATT launchurl. Fr example: my-app://launch Back up mdified files Check this t keep backups in the prject flder (where build.xml resides). Additinal ptins - Enter any additinal MATT cmmand line parameters. Mst ntably, yu can use MATT t add keystre, keypass, and strepass arguments t sign the dynamically instrumented APK file. Use the fllwing MATT ptinal APK parameters -keystre <keystrepath> - Path f the keystre t be used t sign the APK file.. -strepass <keystrepasswrd> - Passwrd f the keystre t be used t sign the APK file. -keypass <privatekeypasswrd> - Passwrd f the private key (if different than the keystre passwrd) t be used t sign the APK file. Fr mre abut using additinal MATT parameters, use: 23
28 0sh MakeAppTuchTestable/bin/MakeAppTuchTestable - help 7. Click Apply and then Save. Build the Titanium Prject Nw that we ve revised ur script t make the directry, clne the KitchenSink app surce, and t make the app surce tuchtestable, the next sectin will be used t build the Titanium prject using the Pythn builder.py script that cmes with the Titanium SDK in use. Nte: The builder.py file is available as part f all Titanium SDKs. Hwever, yu must use the ne that crrespnds t the Titanium SDK yur prject uses. As nted in Prerequisites, TuchTest supprts nly Titanium SDK and later. This sectin f ur Execute Shell script will generate bth an Xcde prject and stre it in the "build/iphne" sub-directry f yur Titanium prject (e.g. "~/dev/jenkins/ wrkspace/jenkinsfucntinaltests/kitchensink/build/iphne/kitchensink.xcdeprj"). Belw is a sample sectin that uses all the parameters abve (as cmmented fields) fllwed by the cmmand itself. # Build the Titanium prject. # # Parameters: # mde # Minimum ios versin ("5.1" in this example) # Path t the Titanium prject directry # Titanium app ID # Titanium app name # ios prvisining prfile identifier (see cmments belw) # ios prvisining prfile wner (see cmments belw) $ "/Library/Applicatin Supprt/Titanium/mbilesdk/sx/2.1.3.GA/iphne/ builder.py" install 5.1 "~/dev/jenkins/wrkspace/jenkinsfucntinaltests/ KitchenSink" cm.appceleratr.kitchensink KitchenSink b92b4cc0-fc88-11e1- a21f c9a66 "Jhn De" universal 1. Determine all f the fllwing values and then paste the revised cmmand int the Execute Shell script using the sample at the end f this sectin. Yu will need the fllwing infrmatin t prceed: Mde Users have 3 ptins as a mde. Chse the mde based n yur Apple Prfile (use Xcde's Organizer t review yur prfile ptins). install (requires Apple Develper Prfile) adhc (requires Apple Distributin Prfile) 24
29 distribute (requires Apple Distributin Prfile). Minimum ios versin Fr example, 5.1. Path t the Titanium prject directry n the Jenkins nde (will be the same as the ne used fr MakeAppTuchTestable abve). Titanium app ID - the app ID can be fund in tiapp.xml (in the <id/> element). Fr this example, the ID cm.appceleratr.titanium Titanium app Name the app Name can be fund in tiapp.xml (in the name/> element. Fr this example, KitchenSink ios prvisining prfile identifier - The prvisining prfile identifier is typically lcated in the "~/Library/MbileDevice/Prvisining Prfiles" directry. Yu'll find ne r mre files with the extensin ".mbileprvisin". The prfile ID is the name f the file, minus the extensin. ios prvisining prfile wner Team Name- the prfile "wner" is the name f the ios develpment team t which the prfile is registered. 25
30 Preparing the App fr Simulatrs and Devices The ios App Installer Utility cntains tw executable files is_sim_launcher and is_app_installer. Deplyment is achieved fr bth Simulatrs and ipad/iphne devices using these executables and the steps described belw. Unzip the utility at this time if yu have yet t d s and nte the cntents f the resulting iosappinstaller flder. Fr a Simulatr, the./bin/is_sim_launcher -app cmmand is used In rder t deply t a simulatr, we must first build an APP file and then use that APP file with the is_sim_launcher Fr an iphne r ipad, the./bin/is_app_installer -ipa In rder t deply t a physical device, we must first build an APP file, fllwed by building an IPA file, after which we can use the is_app_installer. Build the APP fr a Simulatr The app file is a requirement fr deplyment t all ios simulatrs and devices. In rder t build the app, the cmmand line xcdebuild cmmand is used. 1. Enter the fllwing lines in the end f the Execute Shell field (revise the paths t match that f yur wn envirnment): #Build the KitchenSink app fr Simulatr /usr/bin/xcdebuild -sdk iphnesimulatr -target "KitchenSink-universal" -prject ~/dev/jenkins/wrkspace/jenkinsfunctinaltests/kitchensink/ build/iphne/kitchensink.xcdeprj -cnfiguratin Release clean build where (as in the MakeAppTuchTestable cmmand abve): <sdk> in this case is iphnesimulatr <target> is the name f the target in the ".xcdeprj" file representing yur prject. Nte that yu need t either specify the sdk as an argument (recmmended) r create a Target specifically fr Simulatrs <prject> is the path f the ".xcdeprj" file t build <cnfiguratin> is the type f build. Refer t /usr/bin/xcdebuild help fr mre infrmatin. 26
31 After the APP has been successfully created, it can be deplyed t a simulatr using the steps in the next sectin. If yu are deplying t an iphne r ipad, yu must first create an IPA archive befre deplyment. Deplying the APP File n a Simulatr Once the APP file has been created, use the fllwing step t run the is_sim_launcher t deply the cmpiled APP file. Befre starting, nte the path t the unarchived ios App Installer Utility flder where is_sim_launcher resides. 1. In the Execute Shell field, enter the fllwing (be sure t use yur wn paths as well as t specify the ios SDK and family f the simulatr t use): #Deply the APP t a simulatr cd ~/Dcuments/Dem/iOSAppInstaller/./bin/is_sim_launcher --app ~/dev/jenkins/wrkspace/ JenkinsFunctinalTests/KitchenSink/build/iphne/build/Releaseiphnesimulatr/KitchenSink.app --sdk family ipad --agenturl " URL>/cncert/tuchtest" The is_sim_launcher requires the app path: --app <app path> - The path t the cmpiled APP. Nte: The highlighted CludTest URL placehlder in the abve sht, which riginates in the appendix script at the end f this tutrial, must be replaced with yur wn CludTest URL. The is_sim_launcher takes the fllwing additinal parameters. These are used in the example abve t specify the SDK and family: --sdk <versin> - The ios SDK versin t use. Fr example, family <list> - The simulated device family, values are iphne (default), ipad, iphne_retina, and ipad_retina. --agenturl The agenturl parameter specifies the TuchTest Agent URL t use t launch the device agent, which is a requirement fr cntinuus integratin. The value is the CludTest URL with the /cncert/tuchtest URL string appended. 27
32 Installing the IPA Archive n iphnes and ipads In this sectin, we ll run the is_app_installer t deply the IPA archive created in the prir sectin. Befre starting, nte the path t the dwnladed ios App Installer Utility. In the example belw, the IPA archive is in the Jenkins wrkspace we already defined as part f this Jenkins jb. 1. In the Execute Shell field, enter the fllwing (be sure t revise this example t use yur wn paths): #Deply the IPA t all devices cd ~/Dcuments/Dem/iOSAppInstaller/./bin/is_app_installer --ipa ~/dev/jenkins/wrkspace/ JenkinsFunctinalTests/KitchenSink/build/iphne/build/Debug-iphnes/ KitchenSink.ipa The script requires the fllwing parameters: --ipa <ipapath> - The path t the IPA archive. Nte: Yur user-cnfigurable IPA archive lcatin will vary. In the abve example, the file is in the Jenkins wrkspace that we specified as ~/ dev/jenkins/wrkspace/jenkinsfunctinaltests/kitchensink/build/ iphne/build/debug-iphnes/. The ios App Installer Utility will deply t all the tethered prvisined devices by default. If yu d like t limit the deplyment t specific devices use the fllwing ptinal parameters: --udid <list> - One r mre device UDID in a cmma-separated list, if unspecified it install n all the cnnected ios devices --device <list> : device name list cmma-separated, if unspecified it install n all the cnnected ios devices 28
33 Using SCmmand t Play One r Mre Cmpsitins Next, we will add SCmmand lines that will silently play the specified test cmpsitins n the specific CludTest instance. Additinally, we will add arguments that will utput junitxml-cmpatible XML cde that will appear in Jenkins fr each test result. 1. In the Execute Shell field, enter the fllwing (be sure t substitute the full path fr the cmpsitin yu d like t use): # Run the first cmpsitin. # The result will be stred in the "testresults/kitchensink1.xml" file. # Jenkins will use this file t render the test reprt. ~/Dcuments/Dem/scmmand/bin/scmmand \ cmd=play \ name="/soastatutrial/titanium/cmpsitin fr KitchenSink1" \ wait \ frmat=junitxml \ url= \ username=soasta_doc passwrd=secret >testresults/kitchensink1.xml 2. Enter any additinal cmpsitins fr the jb: # Run the secnd cmpsitin. # The result will be stred in the "testresults/kitchensink2.xml" file. # Jenkins will use this file t render the test reprt. ~/Dcuments/Dem/scmmand/bin/scmmand \ cmd=play \ name="/soastatutrial/titanium/cmpsitin fr KitchenSink2" \ 29
34 wait \ frmat=junitxml \ url= \ username=soasta_doc \ passwrd=secret >testresults/kitchensink2.xml 30
35 Adding the Publish Junit Test Result Reprts Step Next, we will add a Pst-build actin that will display SCmmand utput in Jenkins and pt in t plugin display as well. 1. In the Pst-build actin sectin, check Publish JUnit test result reprt. 2. In the Test reprt XMLs field, enter a path where the JUnit XML will be created. This shuld be in the Jenkins wrkspace. The flder need nt exist prir t the first build. Fr example, the flder testresults/**/*.xml. Nte: The errr shwn belw will display the n match errr until after the first build. 3. Under the Additinal test reprt features sectin, check the 'Include links t SOASTA CludTest dashbards' bx. 4. Check the Include links t SOASTA CludTest dashbards bx t pt int the plugin fr this jb. 5. Click Save t exit the jb. Building the Prject After yu click the Save buttn, yu will be taken t the prject page fr the jb yu just created. 1. T build the prject, click the "Build Nw" link. 31
36 The build will start. After a shrt delay, yu shuld see a prgress bar appear n the left side f the page. Click this prgress bar t watch the build prcess "live" in the Cnsle view. Yu shuld see the fllwing happen: a. Jenkins checks ut the surce cde frm Git, and runs the MakeAppTuchTestable utility. b. Jenkins runs the DeplyPrjectTDevice script. On the build nde, yu shuld see Xcde immediately launch and deply the KitchenSink app t the tethered device. D nt interact with Xcde while this is happening. Once the app has been deplyed, Xcde will autmatically exit. c. On the tethered device, yu shuld see the KitchenSink app briefly appear. It will immediately switch ver t the SOASTA TuchTest Agent web page (in Safari), with the Status shwing "Cnnected" <insert screen sht>. d. Jenkins plays the CludTest cmpsitins using SCmmand. On the tethered device, yu shuld see the KitchenSink app launch and run thrugh the test steps. When the test finishes, KitchenSink will exit, and the SOASTA TuchTest Agent page will re-pen. 32
37 Inspecting Test Results in Jenkins On the build summary page, the Test Result link (added by the steps in the previus sectin) appears. 1. Click Test Result. Fr a successful test with n failures, the Test Result page merely lists the All Tests sectin with the given package (i.e. in this case the package equates t a CludTest repsitry flder). 2. Click the Package link until yu reach the cmpsitin flders. Each click pens the subsequent CludTest flder. The cmpsitin was a success in this case. 33
38 3. Use the Click here dashbard link t view CludTest inline. Lgin using yur credentials if yu get the Lgin page. After ding s, the dashbard fr the given cmpsitin is shwn. 34
39 Things get mre interesting when an errr in the test ccurs. The subsequent SCmmand utput is displayed (in text) n the Jenkins Test Result page (as discussed abve). In this case, the All Failed Tests sectin is added with the name f the test listed with a link t mre f the SCmmand details. Clicking the link under the Test Name sectin where the cmpsitin is named displays an Errr detail page (fr the given errr). In the errr abve a validatin in the Cmpsitin fr KitchenSink1 has failed. 4. T view this errr in the CludTest, Result Details dashbard, click the plugin link prvided (i.e. Click here t see the SOASTA CludTest dashbard fr this test). 35
40 After the plugin link is clicked, enter CludTest credentials whenever required. After credentials are entered, the dashbard tab pens, displays the test result, and jumps t the relevant errr. 36
41 Frm here, the Result Details dashbard can be navigated as within any CludTest dashbard. Refer t Result Details Dashbard fr a quick review f Result Details features. 37
42 Appendix: Inspecting the Mbile App in CludTest In the steps abve at the end f each run f the MakeAppTuchTestable.jar we were ntified that the Mbile App Object had been created in the CludTest Repsitry. TIP: This mbile app will appear in the Chse Device Agent and Mbile App bx whenever end-users start a mbile app recrding. Selecting which mbile app t launch n which test devices is a crucial enduser step. 1. Optinally, verify that the Mbile App has been added by lgging int CludTest and lking fr its entry in the Central > Mbile Apps list. Fr example, in the screensht belw the KitchenSink cpy app appears as expected. 2. Duble-click the KitchenSink Mbile App t inspect its details. The Mbile App detail frm appears. All f the fields shwn were ppulated frm the Xcde prject, with the exceptin f Supprted Device Type and Minimum OS Versin. a
43 The default Supprted Device Type is Universal (e.g. bth iphne and ipad). Leave this as is, since we will be specifying multiple devices later. The default Minimum OS Versin supprted in TuchTest beta is ios 5.0 b
44 Appendix: Cmpleted Execute Shell Script The cmpleted Execute Shell script described abve is presented in its entirety belw. Yu can use this as a template t insert yur wn paths as well as yur wn CludTest URL wherever it is required. #Cntinue playing subsequent cmpsitins if a prir cmpsitin fails set +e #Create the test result reprts flder if it desn't already exist mkdir -p testresults #Remve the versin we dwnladed as part f last build (if any) rm -rf "KitchenSink" #Dwnlad KitchenSink frm Github /usr/lcal/git/bin/git clne #Run MakeAppTuchTestable (be sure t enter yur CludTest URL here) sh MakeAppTuchTestable/bin/MakeAppTuchTestable -prject $WORKSPACE/ KitchenSink -target "KitchenSink" -url URL>/cncert - username SOASTA_DOC -passwrd secret # Build the Titanium prject. # # Parameters: # mde (shuld be "adhc" fr CI) # Minimum ios versin ("5.1" in this example) # Path t the Titanium prject directry # Titanium app ID # Titanium app name # ios prvisining prfile identifier # ios prvisining prfile team name "/Library/Applicatin Supprt/Titanium/mbilesdk/sx/2.1.3.GA/iphne/ builder.py" install 5.1 ~/dev/jenkins/wrkspace/jenkinsfunctinaltests/ KitchenSink cm.appceleratr.kitchensink KitchenSink 20433FAB-7A9C-4996-BDD3- E660DB "James GARDNER" universal I
45 #Build the KitchenSink app fr Simulatr /usr/bin/xcdebuild -sdk iphnesimulatr -target "KitchenSink-universal" - prject ~/dev/jenkins/wrkspace/jenkinsfunctinaltests/kitchensink/build/ iphne/kitchensink.xcdeprj -cnfiguratin Release clean build #Deply the APP t a simulatr (be sure t enter yur CludTest URL here) cd ~/Dcuments/Dem/iOSAppInstaller/./bin/is_sim_launcher --app ~/dev/jenkins/wrkspace/jenkinsfunctinaltests/ KitchenSink/build/iphne/build/Release-iphnesimulatr/KitchenSink.app --sdk family ipad --agenturl " URL>/cncert/tuchtest" #Deply the IPA t all devices cd ~/Dcuments/Dem/iOSAppInstaller/./bin/is_app_installer --ipa ~/dev/jenkins/wrkspace/jenkinsfunctinaltests/ KitchenSink/build/iphne/build/Debug-iphnes/KitchenSink.ipa # Run the first cmpsitin. # The result will be stred in the "testresults/kitchensink1.xml" file. # Jenkins will use this file t render the test reprt. ~/Dcuments/Dem/scmmand/bin/scmmand \ cmd=play \ name="/soastatutrial/titanium/cmpsitin fr KitchenSink1" \ wait \ frmat=junitxml \ url= \ username=soasta_doc \ passwrd=secret >testresults/kitchensink1.xml # Run the secnd cmpsitin. # The result will be stred in the "testresults/kitchensink2.xml" file. # Jenkins will use this file t render the test reprt. ~/Dcuments/Dem/scmmand/bin/scmmand \ cmd=play \ name="/soastatutrial/titanium/cmpsitin fr KitchenSink2" \ wait \ frmat=junitxml \ url= \ II
46 username=soasta_doc \ passwrd=secret >testresults/kitchensink2.xml III
47 SOASTA, Inc. 444 Castr St. Muntain View, CA
TouchTest TM Developer Guide
TuchTest TM Develper Guide SOASTA TuchTest Develper Guide 2015, SOASTA, Inc. All rights reserved. The names f actual cmpanies and prducts mentined herein may be the trademarks f their respective cmpanies.
More informationSTIOffice Integration Installation, FAQ and Troubleshooting
STIOffice Integratin Installatin, FAQ and Trubleshting Installatin Steps G t the wrkstatin/server n which yu have the STIDistrict Net applicatin installed. On the STI Supprt page at http://supprt.sti-k12.cm/,
More informationGetting started with Android
Getting started with Andrid Befre we begin, there is a prerequisite, which is t plug the Andrid device int yur cmputer, and lad the drivers fr the OS. In writing this article, I was using Windws XP, 7
More informationMaaS360 Cloud Extender
MaaS360 Clud Extender Installatin Guide Cpyright 2012 Fiberlink Cmmunicatins Crpratin. All rights reserved. Infrmatin in this dcument is subject t change withut ntice. The sftware described in this dcument
More informationConfiguring an Email Client for your Hosting Support POP/IMAP mailbox
Cnfiguring an Email Client fr yur Hsting Supprt POP/IMAP mailbx This article lists the email settings and prt numbers fr pp and imap cnfiguratins, as well as fr SSL. It cntains instructins fr setting up
More informationCenterPoint Accounting for Agriculture Network (Domain) Installation Instructions
CenterPint Accunting fr Agriculture Netwrk (Dmain) Installatin Instructins Dcument # Prduct Mdule Categry 2257 CenterPint CenterPint Installatin This dcument describes the dmain netwrk installatin prcess
More informationISAM TO SQL MIGRATION IN SYSPRO
118 ISAM TO SQL MIGRATION IN SYSPRO This dcument is aimed at assisting yu in the migratin frm an ISAM data structure t an SQL database. This is nt a detailed technical dcument and assumes the reader has
More informationDurango Merchant Services QuickBooks SyncPay
Durang Merchant Services QuickBks SyncPay Gateway Plug-In Dcumentatin April 2011 Durang-Direct.cm 866-415-2636-1 - QuickBks Gateway Plug-In Dcumentatin... - 3 - Installatin... - 3 - Initial Setup... -
More informationCreating automated reports using VBS AN 44
Creating autmated reprts using VBS AN 44 Applicatin Nte t the KLIPPEL R&D and QC SYSTEM Publishing measured results is imprtant t custmers and clients. While the KLIPPEL database cntains all infrmatin
More informationTips & Tricks. Table of Contents. Browser Update - WebEx Plugin. Updated Global Access Numbers
Tips & Tricks Table f Cntents Brwser Update - WebEx Plugin... 1 Updated Glbal Access Numbers... 1 WebEx Prfile Settings (Time zne, Email )... 2 Hsting a successful WebEx call with Vide... 2 Using the WebEx
More informationConnecting to Email: Live@edu
Cnnecting t Email: Live@edu Minimum Requirements fr Yur Cmputer We strngly recmmend yu upgrade t Office 2010 (Service Pack 1) befre the upgrade. This versin is knwn t prvide a better service and t eliminate
More informationTen Steps for an Easy Install of the eg Enterprise Suite
Ten Steps fr an Easy Install f the eg Enterprise Suite (Acquire, Evaluate, and be mre Efficient!) Step 1: Dwnlad the eg Sftware; verify hardware and perating system pre-requisites Step 2: Obtain a valid
More informationPreparing to Deploy Reflection : A Guide for System Administrators. Version 14.1
Preparing t Deply Reflectin : A Guide fr System Administratrs Versin 14.1 Table f Cntents Table f Cntents... 2 Preparing t Deply Reflectin 14.1:... 3 A Guide fr System Administratrs... 3 Overview f the
More informationHow To Install Fcus Service Management Software On A Pc Or Macbook
FOCUS Service Management Sftware Versin 8.4 fr Passprt Business Slutins Installatin Instructins Thank yu fr purchasing Fcus Service Management Sftware frm RTM Cmputer Slutins. This bklet f installatin
More informationFOCUS Service Management Software Version 8.5 for CounterPoint Installation Instructions
FOCUS Service Management Sftware Versin 8.5 fr CunterPint Installatin Instructins Thank yu fr purchasing Fcus Service Management Sftware frm RTM Cmputer Slutins. This bklet f installatin instructins will
More informationService Desk Self Service Overview
Tday s Date: 08/28/2008 Effective Date: 09/01/2008 Systems Invlved: Audience: Tpics in this Jb Aid: Backgrund: Service Desk Service Desk Self Service Overview All Service Desk Self Service Overview Service
More informationReadme File. Purpose. What is Translation Manager 9.3.1? Hyperion Translation Manager Release 9.3.1 Readme
Hyperin Translatin Manager Release 9.3.1 Readme Readme File This file cntains the fllwing sectins: Purpse... 1 What is Translatin Manager 9.3.1?... 1 Cmpatible Sftware... 2 Supprted Internatinal Operating
More informationAccess EEC s Web Applications... 2 View Messages from EEC... 3 Sign In as a Returning User... 3
EEC Single Sign In (SSI) Applicatin The EEC Single Sign In (SSI) Single Sign In (SSI) is the secure, nline applicatin that cntrls access t all f the Department f Early Educatin and Care (EEC) web applicatins.
More informationFOCUS Service Management Software Version 8.5 for Passport Business Solutions Installation Instructions
FOCUS Service Management Sftware fr Passprt Business Slutins Installatin Instructins Thank yu fr purchasing Fcus Service Management Sftware frm RTM Cmputer Slutins. This bklet f installatin instructins
More informationTipsheet: Sending Out Mass Emails in ApplyYourself
GEORGETOWN GRADUATE SCHOOL Tipsheet: Sending Out Mass Emails in ApplyYurself In ApplyYurself (AY), it is very simple and easy t send a mass email t all f yur prspects, applicants, r students with applicatins
More informationUsing PayPal Website Payments Pro UK with ProductCart
Using PayPal Website Payments Pr UK with PrductCart Overview... 2 Abut PayPal Website Payments Pr & Express Checkut... 2 What is Website Payments Pr?... 2 Website Payments Pr and Website Payments Standard...
More informationKronoDesk Migration and Integration Guide Inflectra Corporation
/ KrnDesk Migratin and Integratin Guide Inflectra Crpratin Date: September 24th, 2015 0B Intrductin... 1 1B1. Imprting frm Micrsft Excel... 2 6B1.1. Installing the Micrsft Excel Add-In... 2 7B1.1. Cnnecting
More informationSoftware Distribution
Sftware Distributin Quantrax has autmated many f the prcesses invlved in distributing new cde t clients. This will greatly reduce the time taken t get fixes laded nt clients systems. The new prcedures
More informationOptimal Payments Extension. Supporting Documentation for the Extension Package. 20140225 v1.1
Optimal Payments Extensin Supprting Dcumentatin fr the Extensin Package 20140225 v1.1 Revisin Histry v1.1 Updated Demac Media branding v1.0 Initial Dcument fr Distributin supprt@ptimalpayments.cm Page
More informationUser Manual Brainloop Outlook Add-In. Version 3.4
User Manual Brainlp Outlk Add-In Versin 3.4 Cntent 1. Summary... 3 2. Release Ntes... 3 2.1 Prerequisites... 3 2.2 Knwn Restrictins... 4 3. Installatin and Cnfiguratin... 4 3.1 The installatin prgram...
More informationUser Guide. Excel Data Management Pack (EDM-Pack) OnCommand Workflow Automation (WFA) Abstract PROFESSIONAL SERVICES. Date: December 2015
PROFESSIONAL SERVICES User Guide OnCmmand Wrkflw Autmatin (WFA) Excel Data Management Pack (EDM-Pack) Date: December 2015 Dcument Versin: 1.0.0 Abstract The EDM-Pack includes a general-purpse Data Surce
More informationFINRA Regulation Filing Application Batch Submissions
FINRA Regulatin Filing Applicatin Batch Submissins Cntents Descriptin... 2 Steps fr firms new t batch submissin... 2 Acquiring necessary FINRA accunts... 2 FTP Access t FINRA... 2 FTP Accunt n FINRA s
More informationTelelink 6. Installation Manual
Telelink 6 Installatin Manual Table f cntents 1. SYSTEM REQUIREMENTS... 3 1.1. Hardware Requirements... 3 1.2. Sftware Requirements... 3 1.2.1. Platfrm... 3 1.2.1.1. Supprted Operating Systems... 3 1.2.1.2.
More informationExchanging Files Securely with Gerstco Using gpg4win Public Key Encryption
Exchanging Files Securely with Gerstc Using gpg4win Public Key Encryptin Overview Visit the fllwing page n Gerstc s website t watch a vide verview f Public Key Encryptin: www.gerstc.cm/???? Initial Setup
More informationWatchDox Server. Administrator's Guide. Version 3.8.5
WatchDx Server Administratr's Guide Versin 3.8.5 Cnfidentiality This dcument cntains cnfidential material that is prprietary WatchDx. The infrmatin and ideas herein may nt be disclsed t any unauthrized
More information1) Update the AccuBuild Program to the latest version Version 9.3.0.3 or later.
Certified Payrll XML Exprt As f June 4 th, 2015, The Califrnia Department f Industrial Relatins (DIR) is requiring that all certified payrll reprts be submitted nline using the ecpr system. The ecpr System
More informationIntroduction LIVE MAPS UNITY PORTAL / INSTALLATION GUIDE. 2015 Savision B.V. savision.com All rights reserved.
Rev 7.5.0 Intrductin 2 LIVE MAPS UNITY PORTAL / INSTALLATION GUIDE 2015 Savisin B.V. savisin.cm All rights reserved. This manual, as well as the sftware described in it, is furnished under license and
More informationApplication Advisories for Data Integrator for Non- EDI location
Applicatin Advisries fr Data Integratr fr Nn- EDI lcatin It is a standalne Windws based applicatin that will be installed at every Cmmissinerate. Applicatin will be used fr filling Bill f Entry and Shipping
More informationHelpdesk Support Tickets & Knowledgebase
Helpdesk Supprt Tickets & Knwledgebase User Guide Versin 1.0 Website: http://www.mag-extensin.cm Supprt: http://www.mag-extensin.cm/supprt Please read this user guide carefully, it will help yu eliminate
More informationCreate a Non-Catalog Requisition
Create a Nn-Catalg Requisitin Jb Aid This jb aid describes hw t create a standard nn-catalg (i.e., nn-ibuynu) purchase request. REFER TO ADDITIONAL TRAINING GUIDES If yu need t create a special requisitin
More informationCopyright 2013, SafeNet, Inc. All rights reserved. http://www.safenet-inc.com/ We have attempted to make these documents complete, accurate, and
ii Cpyright 2013, SafeNet, Inc. All rights reserved. http://www.safenet-inc.cm/ We have attempted t make these dcuments cmplete, accurate, and useful, but we cannt guarantee them t be perfect. When we
More informationBest Practice - Pentaho BA for High Availability
Best Practice - Pentah BA fr High Availability This page intentinally left blank. Cntents Overview... 1 Pentah Server High Availability Intrductin... 2 Prerequisites... 3 Pint Each Server t Same Database
More informationJunos Pulse Instructions for Windows and Mac OS X
Juns Pulse Instructins fr Windws and Mac OS X When yu pen the Juns client fr the first time yu get the fllwing screen. This screen shws yu have n cnnectins. Create a new cnnectin by clicking n the + icn.
More informationDeploy Your First Cloud Foundry App to Any Cloud Foundry Service Provider
Deply Yur First Clud Fundry App t Any Clud Fundry Service Prvider cludwrkshp.rg/cludfundry Presenter: Develper Advcate, Redis Labs @davenielsen Oct 2015 dnielsen@gmail.cm twitter.cm/davenielsen linkedin.cm/in/dnielsen
More informationGrants Online. Quick Reference Guide - Grantees
Abut Grants Online: Grants Online perates in a web envirnment. Internet Explrer is the preferred brwser fr PC users; FireFx is the preferred brwser fr MAC users. N sftware is required fr installatin. Lgins
More informationDeployment Overview (Installation):
Cntents Deplyment Overview (Installatin):... 2 Installing Minr Updates:... 2 Dwnlading the installatin and latest update files:... 2 Installing the sftware:... 3 Uninstalling the sftware:... 3 Lgging int
More informationExercise 5 Server Configuration, Web and FTP Instructions and preparatory questions Administration of Computer Systems, Fall 2008
Exercise 5 Server Cnfiguratin, Web and FTP Instructins and preparatry questins Administratin f Cmputer Systems, Fall 2008 This dcument is available nline at: http://www.hh.se/te2003 Exercise 5 Server Cnfiguratin,
More informationINUVIKA OPEN VIRTUAL DESKTOP ENTERPRISE
INUVIKA OPEN VIRTUAL DESKTOP ENTERPRISE MIGRATION GUIDE Mathieu Schires Versin 1.0 Published 06/03/2015 This dcument describes the preparatin and steps t fllw t upgrade an OVD farm frm Inuvika OVD 0.9.x
More informationExercise 5 Server Configuration, Web and FTP Instructions and preparatory questions Administration of Computer Systems, Fall 2008
Exercise 5 Server Cnfiguratin, Web and FTP Instructins and preparatry questins Administratin f Cmputer Systems, Fall 2008 This dcument is available nline at: http://www.hh.se/te2003 Exercise 5 Server Cnfiguratin,
More informationAccess to the Ashworth College Online Library service is free and provided upon enrollment. To access ProQuest:
PrQuest Accessing PrQuest Access t the Ashwrth Cllege Online Library service is free and prvided upn enrllment. T access PrQuest: 1. G t http://www.ashwrthcllege.edu/student/resurces/enterlibrary.html
More informationUser Guide. Sysgem SysMan Remote Control. By Sysgem AG
Sysgem SysMan Remte Cntrl User Guide By Sysgem AG Sysgem is a registered trademark f Sysgem AG. Other brands and prducts are registered trademarks f their respective hlders. 2012 Sysgem AG, Lavaterstrasse
More informationStage 2 Meaningful Use - Core Measure 12 Patient Reminders Configuration Guide
Enterprise EHR Stage 2 Meaningful Use - Cre Measure 12 Patient Reminders Cnfiguratin Guide Last Updated: Nvember 8, 2013 Cpyright 2013 Allscripts Healthcare, LLC. www.allscripts.cm MU Cre 12 Send Patient
More informationMobile Device Manager Admin Guide. Reports and Alerts
Mbile Device Manager Admin Guide Reprts and Alerts September, 2013 MDM Admin Guide Reprts and Alerts i Cntents Reprts and Alerts... 1 Reprts... 1 Alerts... 3 Viewing Alerts... 5 Keep in Mind...... 5 Overview
More information990 e-postcard FAQ. Is there a charge to file form 990-N (e-postcard)? No, the e-postcard system is completely free.
990 e-pstcard FAQ Fr frequently asked questins abut filing the e-pstcard that are nt listed belw, brwse the FAQ at http://epstcard.frm990.rg/frmtsfaq.asp# (cpy and paste this link t yur brwser). General
More informationSetup O365 mailbox access on MACs
Setup O365 mailbx access n MACs Yu can use a web brwser r an email prgram n yur cmputer t cnnect t yur email accunt. Web brwser access Yu cnnect yur Apple cmputer t yur email accunt by using a web brwser
More informationWebalo Pro Appliance Setup
Webal Pr Appliance Setup 1. Dwnlad the Webal virtual appliance apprpriate fr yur virtualizatin infrastructure, using the link yu were emailed. The virtual appliance is delivered as a.zip file that is n
More informationUsing PayPal Website Payments Pro with ProductCart
Using PayPal Website Payments Pr with PrductCart Overview... 2 Abut PayPal Website Payments Pr & Express Checkut... 3 What is Website Payments Pr?... 3 Website Payments Pr and Website Payments Standard...
More informationAdobe Sign. Enabling Single Sign-On with SAML Reference Guide
Enabling Single Sign-On with SAML Reference Guide 2016 Adbe Systems Incrprated. All Rights Reserved. Prducts mentined in this dcument, such as the services f identity prviders Micrsft Active Directry Federatin,
More informationDocAve 6 Supplementary Tools
DcAve 6 Supplementary Tls User Guide Service Pack 6 Cumulative Update 1 Issued December 2015 1 Table f Cntents What s New in this Guide... 6 Befre Yu Begin... 6 Cnfiguratin... 7 Submitting Dcumentatin
More informationATL: Atlas Transformation Language. ATL Installation Guide
ATL: Atlas Transfrmatin Language ATL Installatin Guide - versin 0.1 - Nvember 2005 by ATLAS grup LINA & INRIA Nantes Cntent 1 Intrductin... 3 2 Installing ADT frm binaries... 3 2.1 Installing Eclipse and
More informationefusion Table of Contents
efusin Cst Centers, Partner Funding, VAT/GST and ERP Link Table f Cntents Cst Centers... 2 Admin Setup... 2 Cst Center Step in Create Prgram... 2 Allcatin Types... 3 Assciate Payments with Cst Centers...
More informationSTIClassroom Win Rosters, Attendance, Lesson Plans and Textbooks
STIClassrm Win Rsters, Attendance, Lessn Plans and Textbks Student Class Rster T access the student class rster, click the icn in the Classrm desktp. Frm the Rster screen, teachers may access the items
More informationesupport Quick Start Guide
esupprt Quick Start Guide Last Updated: 5/11/10 Adirndack Slutins, Inc. Helping Yu Reach Yur Peak 908.725.8869 www.adirndackslutins.cm 1 Table f Cntents PURPOSE & INTRODUCTION... 3 HOW TO LOGIN... 3 SUBMITTING
More informationGrants Online. Quick Reference Guide Grant Recipients
Abut Grants Online: Grants Online perates in a web envirnment. Internet Explrer is the preferred brwser fr PC users, but Ggle Chrme als wrks well; FireFx is the preferred brwser fr MAC users. N sftware
More informationSBClient and Microsoft Windows Terminal Server (Including Citrix Server)
SBClient and Micrsft Windws Terminal Server (Including Citrix Server) Cntents 1. Intrductin 2. SBClient Cmpatibility Infrmatin 3. SBClient Terminal Server Installatin Instructins 4. Reslving Perfrmance
More informationAvePoint Privacy Impact Assessment 1
AvePint Privacy Impact Assessment 1 User Guide Cumulative Update 2 Revisin E Issued February 2015 Table f Cntents Table f Cntents... 2 Abut AvePint Privacy Impact Assessment... 5 Submitting Dcumentatin
More informationE-Biz Web Hosting Control Panel
1 f 38 E-Biz Web Hsting Cntrl Panel This dcument has been created t give yu a useful insight in t the Hsting Cntrl Panel available with E-Biz hsting services. Please nte: Optins available are dependent
More informationGetting Started Guide
fr SQL Server www.lgbinder.cm Getting Started Guide Dcument versin 1 Cntents Installing LOGbinder fr SQL Server... 3 Step 1 Select Server and Check Requirements... 3 Select Server... 3 Sftware Requirements...
More informationTaskCentre v4.5 MS SQL Server Trigger Tool White Paper
TaskCentre v4.5 MS SQL Server Trigger Tl White Paper Dcument Number: PD500-03-02-1_0-WP Orbis Sftware Limited 2010 Table f Cntents COPYRIGHT... 1 TRADEMARKS... 1 INTRODUCTION... 2 Overview... 2 Features...
More informationDocAve for Salesforce 3.1
DcAve fr Salesfrce 3.1 User Guide Revisin F Issued January 2014 DcAve fr Salesfrce User Guide 1 Table f Cntents Abut DcAve fr Salesfrce... 5 Befre Yu Begin... 6 System Hardware and Operating System Requirements...
More informationRegions File Transmission
Regins File Transmissin Getting Started with FTPS Regins Bank Member FDIC Revised 022113 It s time t expect mre. Table f Cntents Getting Started with FTPS Setting Up FTPS Cnnectin in FTP Client 3 4 9 Regins
More informationBRILL s Editorial Manager (EM) Manual for Authors Table of Contents
BRILL s Editrial Manager (EM) Manual fr Authrs Table f Cntents Intrductin... 2 1. Getting Started: Creating an Accunt... 2 2. Lgging int EM... 3 3. Changing Yur Access Cdes and Cntact Infrmatin... 3 3.1
More informationRemote Setup and Configuration of the Outlook Email Program Information Technology Group
Remte Setup and Cnfiguratin f the Outlk Email Prgram Infrmatin Technlgy Grup The fllwing instructins will help guide yu in the prper set up f yur Outlk Email Accunt. Please nte that these instructins are
More informationMacintosh Operating System Online Proctoring Guide
Macintsh Operating System Online Prctring Guide ONLINE PROCTORING GUIDE 0 Macintsh Operating System Online Prctring Guide Cntents CONTENTS... 1 ABOUT ONLINE PROCTORING... 2 PREPARING FOR YOUR ONLINE PROCTORED
More informationSoftware Update Notification
Sftware Update Ntificatin PSS0223-02 Mastersizer 3000 v1.01 sftware Abstract This dcument details the release f sftware PSS0223-02 v1.01 f the sftware fr the Mastersizer 3000 laser diffractin system. It
More informationSoftLayer Development Lab
SftLayer Develpment Lab Phil Jacksn, Chief Evangelist, SftLayer pjacksn@sftlayer.cm @underscrephil Brad DesAulniers, Sftware Engineer, Advanced Clud Slutins IBM GTS bradd@us.ibm.cm @cb_brad Angel Tmala-Reyes,
More informationCloud Services MDM. Windows 8 User Guide
Clud Services MDM Windws 8 User Guide 10/24/2014 CONTENTS Overview... 2 Supprted Devices... 2 System Capabilities... 2 Enrllment and Activatin... 3 Prcess Overview... 3 Verify Prerequisites... 3 Dwnlad
More informationValley Transcription Service I-Phone/I-Pod App User s Guide
541-926-4194 Valley Transcriptin Service I-Phne/I-Pd App User s Guide (Fr use with iphne/ipad/i-pd Tuch) Page 0 Table f Cntents Table f Cntents... i Intrductin... 1 Requirements... 1 1. 2. 3. Installing
More informationAP Capstone Digital Portfolio - Teacher User Guide
AP Capstne Digital Prtfli - Teacher User Guide Digital Prtfli Access and Classrm Setup... 2 Initial Lgin New AP Capstne Teachers...2 Initial Lgin Prir Year AP Capstne Teachers...2 Set up Yur AP Capstne
More informationNETWRIX CHANGE NOTIFIER
NETWRIX CHANGE NOTIFIER FOR ACTIVE DIRECTORY, EXCHANGE AND GROUP POLICY QUICK-START GUIDE Prduct versin: 7.5.873 February 2014 February 2014. Legal Ntice The infrmatin in this publicatin is furnished fr
More informationBackupAssist SQL Add-on
WHITEPAPER BackupAssist Versin 6 www.backupassist.cm 2 Cntents 1. Requirements... 3 1.1 Remte SQL backup requirements:... 3 2. Intrductin... 4 3. SQL backups within BackupAssist... 5 3.1 Backing up system
More informationFirewall/Proxy Server Settings to Access Hosted Environment. For Access Control Method (also known as access lists and usually used on routers)
Firewall/Prxy Server Settings t Access Hsted Envirnment Client firewall settings in mst cases depend n whether the firewall slutin uses a Stateful Inspectin prcess r ne that is cmmnly referred t as an
More informationImplementing ifolder Server in the DMZ with ifolder Data inside the Firewall
Implementing iflder Server in the DMZ with iflder Data inside the Firewall Nvell Cl Slutins AppNte www.nvell.cm/clslutins JULY 2004 OBJECTIVES The bjectives f this dcumentatin are as fllws: T cnfigure
More informationExcel Contact Reports
Excel Cntact Reprts v.1.0 Anther efficient and affrdable ACT! Add-On by http://www.expnenciel.cm Excel Cntact Reprts User s Manual 2 Table f cntents Purpse f the add-n... 3 Installatin prcedure... 3 The
More informationDreamweaver MX 2004. Templates
Dreamweaver MX 2004 Templates Table f Cntents Dreamweaver Templates... 3 Creating a Dreamweaver template... 3 Types f template regins... 4 Inserting an editable regin... 4 Selecting editable regins...
More informationSteps to fix the product is not properly fixed issue for international clients.
Axxya Systems supprt cntact details 1-800-709-2977 ext 9 within US 1-425-999-4350 ext 9 utside f US Email supprt@axxya.cm Technical FAQ -- www.nutritinistpr.cm/help-center/ Steps t fix the prduct is nt
More informationStarterPak: Dynamics CRM On-Premise to Dynamics Online Migration - Option 2. Version 1.0
StarterPak: Dynamics CRM On-Premise t Dynamics Online Migratin - Optin 2 Versin 1.0 1/7/2016 Imprtant Ntice N part f this publicatin may be reprduced, stred in a retrieval system, r transmitted in any
More informationMerchant Management System. New User Guide CARDSAVE
Merchant Management System New User Guide CARDSAVE Table f Cntents Lgging-In... 2 Saving the MMS website link... 2 Lgging-in and changing yur passwrd... 3 Prcessing Transactins... 4 Security Settings...
More informationKaltura Video Plugin for Jive User Guide. Version: 1.0
Kaltura Vide Plugin fr Jive User Guide Versin: 1.0 Kaltura Business Headquarters 5 Unin Square West, Suite 602, New Yrk, NY, 10003, USA Tel.: +1 800 871 5224 Cpyright 2014 Kaltura Inc. All Rights Reserved.
More informationo 1.1 - How AD Query Works o 1.2 - Installation Requirements o 2.1 - Inserting your License Key o 2.2 - Selecting and Changing your Search Domain
SysOp Tls Active Directry Management sftware Active Directry Query v1.x Sftware Installatin and User Guide Updated September 29, 2008 In This Dcument: 1.0 Intrductin 1.1 - Hw AD Query Wrks 1.2 - Installatin
More informationCSAT Account Management
CSAT Accunt Management User Guide March 2011 Versin 2.1 U.S. Department f Hmeland Security 1 CSAT Accunt Management User Guide Table f Cntents 1. Overview... 1 1.1 CSAT User Rles... 1 1.2 When t Update
More informationIntel Hybrid Cloud Management Portal Update FAQ. Audience: Public
Intel Hybrid Clud Management Prtal Update FAQ Audience: Public Purpse: Prepare fr the launch f the Intel Hybrid Clud Platfrm multi-user/multi-tier update Versin: Final FAQs What s new in the Intel Hybrid
More informationTECHNICAL BULLETIN. Title: Remote Access Via Internet Date: 12/21/2011 Version: 1.1 Product: Hikvision DVR Action Required: Information Only
Title: Remte Access Via Internet Date: 12/21/2011 Versin: 1.1 Prduct: Hikvisin DVR Actin Required: Infrmatin Only The fllwing steps will guide yu thrugh the steps necessary t access yur Hikvisin DVR remtely
More informationInstallation Guide Marshal Reporting Console
INSTALLATION GUIDE Marshal Reprting Cnsle Installatin Guide Marshal Reprting Cnsle March, 2009 Cntents Intrductin 2 Supprted Installatin Types 2 Hardware Prerequisites 3 Sftware Prerequisites 3 Installatin
More informationReadme File. Purpose. Introduction to Data Integration Management. Oracle s Hyperion Data Integration Management Release 9.2.
Oracle s Hyperin Data Integratin Management Release 9.2.1 Readme Readme File This file cntains the fllwing sectins: Purpse... 1 Intrductin t Data Integratin Management... 1 Data Integratin Management Adapters...
More informationPerl for OpenVMS Alpha
Perl fr OpenVMS Alpha Installatin Guide and Release Ntes January 25, 2002 Perl fr OpenVMS Versin 5.6.1 CPQ-AXPVMS-PERL-V0506-1-1.PCSI-DCX-AXPEXE On this page yu'll find infrmatin abut: Sftware prerequisites
More informationDynamic Login 4.1. User Guide. Copyright 2011 Data Springs Inc. All rights reserved.
Dynamic Lgin 4.1 User Guide Cpyright 2011 Data Springs Inc. All rights reserved. Table f cntents: 1 INTRODUCTION 1.1 What s new in 4.1 2 INSTALLATION PROCEDURE 3 ADDING DYNAMIC LOGIN MODULE TO A PAGE 4
More informationGetting Started Guide
AnswerDash Resurces http://answerdash.cm Cntextual help fr sales and supprt Getting Started Guide AnswerDash is cmmitted t helping yu achieve yur larger business gals. The utlined pre-launch cnsideratins
More informationNEC CLOUD STORAGE. User Guide. Version: R03.1
NEC CLOUD STORAGE User Guide Versin: R03.1 2013 1 INTRODUCTION... 5 1.1 GOALS OF THIS DOCUMENT... 5 1.2 TERMS, ACRONYMS AND ABBREVIATIONS... 5 2 INTRODUCTION TO NEC CLOUD STORAGE... 6 2.1 WHAT IS NEEDED
More informationSimmons GMAIL Client Setup
Simmns GMAIL Client Setup Supprted IMAP client list: Belw is a list f mail clients and mbile devices yu can synchrnize with yur Gmail. Mail Clients Outlk Express (Windws) Outlk 2003 (Windws) Outlk 2007/2010
More informationViPNet VPN in Cisco Environment. Supplement to ViPNet Documentation
ViPNet VPN in Cisc Envirnment Supplement t ViPNet Dcumentatin 1991 2015 Inftecs Americas. All rights reserved. Versin: 00121-04 90 02 ENU This dcument is included in the sftware distributin kit and is
More informationStarterPak: Dynamics CRM Opportunity To NetSuite Sales Order
StarterPak: Dynamics CRM Opprtunity T NetSuite Sales Order Versin 1.0 7/20/2015 Imprtant Ntice N part f this publicatin may be reprduced, stred in a retrieval system, r transmitted in any frm r by any
More informationImplementing SQL Manage Quick Guide
Implementing SQL Manage Quick Guide The purpse f this dcument is t guide yu thrugh the quick prcess f implementing SQL Manage n SQL Server databases. SQL Manage is a ttal management slutin fr Micrsft SQL
More informationArchiving IVTVision Video (Linux)
Archiving IVTVisin Vide (Linux) 1 Intrductin Because IVTVisin Server recrds vide using a straightfrward perating system file structure, archiving vide shuld be simple fr any IT prfessinal. This dcument
More informationAvePoint Perimeter Pro 1.6. Secured Share User Guide
AvePint Perimeter Pr 1.6 Secured Share User Guide Issued May 2016 Table f Cntents What s New in this Guide... 4 Overview... 5 Internal Users... 6 Site Cllectin Administratrs... 7 External Prtal Users...
More information