Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents


Prerequisites

...

Before installing ZBot, ensure you must have JDK 8 for ZBot to run.

  • Java - one of the following:
    • OpenJDK 8 (recommended): Download here / Unzip to any folder
    • Oracle Java JDK 8 (update u101 or later): Download - here / Installation instructions - here


Update the PATH and JAVA_HOME environment variables

...

ZBot needs a couple of environment variable set once you have the JDK installed. You can set the variables this way to allow it to persist through reboot.

Setting up PATH in Windows (steps might vary with Windows version):

  1. Click Start > Control Panel > System
  2. Click Advanced > Environment Variables
  3. Scroll through the fields until you find PATH
  4. Add the location of the bin folder of the install for PATH in System variables (do not delete the existing value, just add to the beginning of it).

A typical path is:

  • for OpenJDK: C:\SomeFolder\java-se-8u41-ri\bin
  • for Oracle JDK: C:\Program Files\Java\JDK_1.8.0_<version>\bin

Setting up JAVA_HOME in Windows (steps might vary with Windows version):

  1. Click Start > Control Panel > System
  2. Click Advanced > Environment Variables
  3. Scroll through the fields until you find JAVA_HOME, if it's not present Add it to the System variables.
  4. Add the location of the JDK root folder to the value of JAVA_HOME in System variables. 

A typical path is:

  • for OpenJDK: C:\SomeFolder\java-se-8u41-ri
  • for Oracle JDK: C:\Program Files\Java\JDK_1.8.0_<version>

Setting up PATH in Linux (steps might vary with Linux version):


  1. Set JAVA_HOME using the syntax export JAVA_HOME=path to JDK. For example, export JAVA_HOME= /usr/java/jdk1.8.0_xx/.
  2. Set PATH using the syntax export PATH=${PATH}:path to the JDK bin. For example, export PATH=${PATH}:/usr/java/jdk1.8.0_xx/bin
  3. Verify the settings using the following commands:
  4. echo $JAVA_HOME
  5. echo $PATH
  6. The output must display the JAVA_HOME and PATH that you set.

Important: make sure you have specified the correct path!

Download ZBot

...

You may download the ZBot directly from Zephyr:

...

Log files are in $ZBOT_EXTRACTION_FOLDER/zbot/logs

Creating Automation Jobs

...

A job is a task with a number of parameters. You use it to automate your test cases. You can create three types of jobs: Script Automation, Suite Automation and Folder Watcher.

  • A Script Automation job triggers a automation script that retrieves data from the specified test automation tool through ZBot and passes it to Zephyr.

  • An Automation job allows you to trigger an execution directly from Zephyr, and once the automation is done, it posts the results to Zephyr.
  • A Folder Watcher job waits for results to appear in the specified results folder, and if any report file is generated, it posts the results to Zephyr.

To learn how to create and execute a Vortex job, see the corresponding topic:

Script Automation

Suite Automation

Folder Watcher

For more information on Vortex, see Zephyr Vortex.

...