Installation and Usage of ZBots on Linux/MacOS

Installation and Usage of ZBots on Linux/MacOS

  • ZBots can be installed on MacOSX, Solaris or Linux.

  • Below is an example of an installation on Ubuntu Linux. The others are very similar.

  • There are steps below that demonstrate how you can make ZBots autostart.

Pre-requisites


  • You must have JDK 8 or higher for ZBot to run: Download

  • The ZBot can be downloaded from: http://<your_zephyr_server>/zephyr/zbot

1. Click on the Download ZBot link above and download the following file: 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 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