Installing ZBot on UNIX

Owned by Daniel (Deactivated)
Last updated: Jan 22, 2018 by Kevin Pham (Deactivated)

This section applies specifically to the ZBot. The information below is generally used to ensure that system administrators can understand how to install the ZBot on a Unix system.


This section provides step-by-step instructions for installing the ZBot on Unix.

Prerequisites

  • You must have JDK 1.6 update > 24 or higher for ZBot to run. You can get that from here.

Installing ZBot

ZBots can be installed on MacOSX, Solaris or Linux. Below is an example of an installation on Ubuntu Linux. The others are very similar. We will also be showing you how you can make ZBots autostart.
The ZBot can be downloaded from http://<your_zephyr_server>/zephyr/zbot
 
1. Clicking on the appropriate OS version for download, the following file is downloaded: zbot.unix.tar.gz
2. Open the archive with unzipping software (in this case Archive Manager on Ubuntu Linux)
 

 
3. Extract this folder to a convenient location where the ZBot will be installed. ZBot will be running from this folder.

 

 
4. In this case, /usr/local/zephyr has been chosen as seen below.
 

 
5. Open your favorite editor (gedit in this case), and open $ZBOT_EXTRACTION_FOLDER/zbot/conf/zbot.properties
 

 
6. Modify zephyrServerURL to point to your zephyr server (as highlighted), and enter a Zephyr username/password and save the property file.
 

 
7. Open a terminal window and navigate to $ZBOT_EXTRACTION_FOLDER/zbot and use the following to administer:
./bin/zbot.sh start - To Start the zbot in background
./bin/zbot.sh status - To Check the status of ZBot
./bin/zbot.sh stop - To Stop the zbot
./bin/zbot.sh console - To run zbot in interactive mode
 

 
8. Log files are in  $ZBOT_EXTRACTION_FOLDER/zbot/logs

Autostarting ZBots on UNIX

INSTALLATION
As root,
1. Create a symlink
        ln -s /usr/local/zephyr/zbot/bin/zbot.sh /etc/init.d/zbot
2. make sure symlink works
        cd /etc/init.d/
        ./zbot console
3. run following command
        cd /etc/init.d
        update-rc.d zbot start 20 2 3 4 5 . stop 20 0 1 6 .
        
        OUTPUT
        Adding system startup for /etc/init.d/zbot ...  
        /etc/rc0.d/K20myapp -> ../init.d/myapp  
        /etc/rc1.d/K20myapp -> ../init.d/myapp  
        /etc/rc6.d/K20myapp -> ../init.d/myapp  
        /etc/rc2.d/S20myapp -> ../init.d/myapp  
        /etc/rc3.d/S20myapp -> ../init.d/myapp  
        /etc/rc4.d/S20myapp -> ../init.d/myapp  
        /etc/rc5.d/S20myapp -> ../init.d/myapp
4. reboot your machine to check if it works
        shutdown -r now 


UNINSTALLATION
1. Remove the run levels
        update-rc.d -f zbot remove


Back to Top ^