WebChick Installation guide for use on local PC Version 1.0 Agrologic Ltd. Author: Valery M. Published: March 2011 1
Table of Contents Copyright Information... 3 Abstract... 4 Overview:... 4 System Requirements for WebChick... 5 Installation... 5 Creating Database... 11 Running USBServer... 12 Running WebChick... 16 2
Copyright Information This document supports a preliminary release of a software product that may be changed substantially prior to final commercial release, and is the confidential and proprietary information of Agrologic Ltd. It is disclosed pursuant to a non-disclosure agreement between the recipient and Agrologic. This document is provided for informational purposes only and Agrologic makes no warranties, either express or implied, in this document. Information in this document, including URL and other Internet Web site references, is subject to change without notice. The entire risk of the use or the results from the use of this document remains with the user. Unless otherwise noted, the companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in examples herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Agrologic Corporation. Agrologic may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Agrologic, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. 2009 Agrologic Ltd. All rights reserved. 3
Abstract WebChick V1.0 is a set of programs that enables control of Agro Logic controllers from a PC, using an Internet browser. Overview: This installation will create a local web server on your PC. Using your internet browser, you will be able to log in and receive information from your Agrologic control units. Four programs must be installed on your PC. Java Run time Environment (JRE) The WebChick program is written in Java, so Java Run time Environment (JRE) must be installed on the PC. The JRE installation is included on the CD or can be downloaded at; http://www.oracle.com/technetwork/java/javase/downloads/index.html Apache Tomcat 7 Web Server In order to serve a web page, you need a web server. Apache Tomcat 7 web server program is used so it must be installed on the PC. The Apache Tomcat 7 program is included on the CD, or can also be downloaded at; http://tomcat.apache.org/download- 70.cgi MySql A data base is needed to store various information such as data from controllers, house and farm configurations, languages and much more. The data base programmed used is MySql, so it must be installed on the PC. The MySql program is included on the CD or can be downloaded at; http://dev.mysql.com/downloads USBServer The last part is the local communication program (USBServer) which communicates with the controllers via a USBAG box. The drivers for the USBAG box are included on the CD.. Once these programs have been installed, you will need to create the first data base, and then start the USBServer. Please follow the instructions below. 4
System Requirements for WebChick OS Windows XP or above. Java Runtime Environment Apache Tomcat 7 MySql Data Base MySql for 32bit MySql for 64bit MySql gui tool Installation Start the Auto run or run the Setup.bat file and follow instructions. The Java Runtime Environment will be installed. Note: If you already have Java installed on your system, the install program will notify you. If Java is already installed, this can be skipped. Choose "Accept" to install, "Decline" to skip. 5
Next the Apache Tomcat 7 web server will be installed Click on "Next" and follow instructions. Continue to click on "Next" until the installation is complete. Next the MySql Server will be installed. Accept agreement and click "Next". Choose setup type Typical and click "Next". Continue to click on "Next" until the installation is complete. 6
During MySQL installation, the following windows will appear: Click "Next" to continue. After MySql installation is completed, the Instance Configuration Wizard will appear. Click "Next" to continue installation, just click next until the screen below appears: 7
In the "New root password" field, enter agrologic. Enter agrologic again in the "Confirm" field. Click "Next". agrologic agrologic Preparing configuration window will appear. Click on "Execute" to continue. 8
Configuration should pass all tests: Click "Finish". Next "MySql GUI Tool" installation should start. Continue to click on "Next" until the installation is complete. This completes the installation of programs that are needed to run the WebChick application. Next we need to install specific files for a farm, which is included in the disk or the download files. This is the USBServer program, which communicates to the farm controllers, and is specific to each farm. A farm number is assigned by AgroLogic to each configuration, and the farm number is found in the file FarmNumber.txt. Please open this file and 9
Click setup.bat in the directory of the farm installation: The USBServer installation should start. Continue to click "Next" until the installation is complete. 10
Creating Database Run MySql Query Browser Start > All Programs > MySQL > MySQL Query Browser. Fill in all fields using the below data; Server Host : localhost Username : root Password : agrologic Default Schema : agrodb agrologic Click "OK" to create the database. Close MySQL Query Browser. 11
Running USBServer Creating database content Run USBServer: Start > All Programs > Agrologic > USBServer. Before starting program we need to create database contents. Click Make DB in main window of USBServer program. 12
In Open file dialog box choose file with *.sql extension. For example MyCompany.sql, click Open. After creating the database, you should see the following screen. Open the Setting window and click on Setting. 13
* You must connect the USBAG box to your computer and install the supplied drivers. Use the drop down box to choose your comport. Select com and click ok. Check in the Device manger window to see which COM port the USBAG is using. 14
In Farm Number field type the farm number (open the FarmNumber.txt file on the CD to find the number for your setup). Check Start Server with Windows if you want the USBServer to start automatically when Window starts (recommended). Click OK, setting form is closed. Click the Connect button to start communication program. 15
Running WebChick Open your internet browser and in the address bar enter: http://localhost:8080/webchick Add the address to your bookmarks, you can also create a shortcut on your desktop. Your program should come up on the browser. To see more screens click on House 1 title. 16