****************************************************************** * This file is part of the Entrak system. * * Copyright Energy Systems Research Unit, University of * * Strathclyde, Glasgow Scotland, 2001 2002 2003. * * * * Entrak is free software. You can redistribute it and/or * * modify it under the terms of the GNU General Public * * License as published by the Free Software Foundation * * (version 2 or later). * * * * Entrak is distributed in the hope that it will be useful * * but WITHOUT ANY WARRANTY; without even the implied * * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * * PURPOSE. See the GNU General Public License for more * * details. * * * * You should have received a copy of the GNU General Public * * License along with Entrak. If not, write to the Free * * Software Foundation, Inc., 59 Temple Place, Suite 330, * * Boston, MA 02111-1307 USA. * ****************************************************************** Copyright (c) 2001 2002 2003 2004 2005 2006 Energy Systems Research Unit, University of Strathclyde, All Rights Reserved. ------------------------------------- Installation and running instructions ------------------------------------- This package is a program of EnTrak (Java based application of an Energy Environment Information system). This document describes how to install and run the package. this package includes some sample data with which users establish mySQL databases. EnTrak is a Java application so that it can run on any platform, 1. Pre-requisite 1-1 JAVA Virtual Machine installation You must log-in as an administrator. It is necessary to install Java Virtual Machine(JVM) version 1.3.1 or higher before installing Entrak. For example, you can download JRE 1.5.0 for Windows from http://java.sun.com/j2se/1.5.0/download.jsp and install it in your PC (Windows). You must set the path to include the JVM. To set the path, open 'start_entrak.bat'. edit the first line of the script start with "set JAVA_PATH". The default PATH is 'C:\"Program Files"\Java\jre1.5.0_04'. 1-2. My SQL server installation - Download the mySQL (essential) server 4.1 from the official mySQL web site (http://www.mysql.com/downloads). - Install mySQL server by clicking 'mysql-essential-4.1.13-win32.msi'. Then to run the server, use the MySQL Server Instance Configuration Wizard. Accept all defaults follow the instructions to create an instance. In the "Install as Windows Service", enter MySQL41 as the service name. NOTE: any older version of mySQL must be uninstalled before installing mySQL 4.1. Make sure to delete the folder (mannualy) where the older mySQL server is installed. 1-3 (Option) Arcview GIS installation to run the GIS analsys facility in EnTrak, you need to install 'Arcview' GIS package in your PC. download Arcview GIS package from http://www.esri.com/software/arcgis/arcview/index.html 2. Installation of EnTrak package 2.1 Unzip the entrak package in C:\ the structure of the folders looks like the following. c:\ESRU\Entrak\bin \graph \lib \docs \Tutorial \sql_tutorial \maps \uk\ .... \sample_data \training \strathclyde \springburn \3d_data \drivers 2.2 double-click 'start_entrak.bat' in 'c:\ESRU\Entrak\bin'. make sure that the mySQL server is running on. 3. Running 3.1 You MUST run mySQL server before running EnTrak. 3.2 You can install 'sample databases' by activating data importing script file in 'c:\ESRU\Entrak\sample_data\' folder where there are threee databases:'strathclyde', 'springburn' and 'training'. - click 'install_***_db.bat'. - you will have dos command terminal on the screen. - you need to type the password of the mySQL server administrator. 3.3. To run EnTrak : double-click 'start_entrak.bat' in 'C:\ESRU\entrak\bin' in Windows Explorer. 4. Configuration for ODBC 4.1 Register to ODBC data required for EnTrak analsys to make it sharable between applications (e.g. for 3D pattern view as an exploratory anaysis, data in 'c:\ESRU\entrak\sample_data\3d_data' directory should be registered as an ODBC data source named '3d_sample') - go to 'start/settings/control panel' in Windows NT, or 'start/settings/control panel/administrative tools' in Windows2000 or XP - open 'ODBC data sources administrator' by clicking 'ODBC data sources' icon. - open 'create new data source' panel by clicking 'add' button in 'user DSN' tab. - select 'Microsoft Text Driver[*.txt;*.csv]' ( double click the option). - type '3d_sample' in 'data source name'. - unclick 'user current directory' to set up your directory. - click 'select directory'. - select 'c:\ESRU\entrak\sample_data\3d_data\'. and click 'OK' button. - close 'ODBC data sources administrator' by clicking 'OK' button. 4.2 (Option) To connect Arcview GIS to a database (e.g. spriburn database avaiable in 'sample data') in EnTrak, - install mySQL ODBC driver by double-clicking "MyODBC-3.51.10-2-win.exe" in "c:\ESRU\Entrak\drivers\". - open 'ODBC data sources administrator' by clicking 'ODBC data sources' icon. - open 'create new data source' panel by clicking 'add' button in 'user DSN' tab. - select 'MySQL ODBC 3.51 driver' ( double click the option). - type 'entrak_springburn' in 'data source name' field. - type 'localhost' in 'Server' field. - type 'manager' in 'user' field. - type 'manager' in 'password' field. - type 'springburn' in 'database' field. - click 'ok' button'. 5. Tutorial To explore the EnTrak, follow the tutorial file in: C:\ESRU\Entrak\docs\Tutorial\content.htm NOTE: open the tutorial file using web browser. Alternatively, you can browse the latest version of the tutorial file from the following URL. http://www.esru.strath.ac.uk/Courseware/EnTrak/content.htm 6. Contact For any enquiry or comments on the package, contact esru@strath.ac.uk