Changes between Version 1 and Version 2 of WikiStart


Ignore:
Timestamp:
2011-09-15 00:37:07 (13 years ago)
Author:
chris
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v1 v2  
    1 = Welcome to Trac 0.12.1 = 
     1= Welcome to the dataMine plugin for Vera = 
    22 
    3 Trac is a '''minimalistic''' approach to '''web-based''' management of 
    4 '''software projects'''. Its goal is to simplify effective tracking and handling of software issues, enhancements and overall progress. 
     3'''Note:''' This page is work in progress!!! 
    54 
    6 All aspects of Trac have been designed with the single goal to  
    7 '''help developers write great software''' while '''staying out of the way''' 
    8 and imposing as little as possible on a team's established process and 
    9 culture. 
    10  
    11 As all Wiki pages, this page is editable, this means that you can 
    12 modify the contents of this page simply by using your 
    13 web-browser. Simply click on the "Edit this page" link at the bottom 
    14 of the page. WikiFormatting will give you a detailed description of 
    15 available Wiki formatting commands. 
    16  
    17 "[wiki:TracAdmin trac-admin] ''yourenvdir'' initenv" created 
    18 a new Trac environment, containing a default set of wiki pages and some sample 
    19 data. This newly created environment also contains  
    20 [wiki:TracGuide documentation] to help you get started with your project. 
    21  
    22 You can use [wiki:TracAdmin trac-admin] to configure 
    23 [http://trac.edgewall.org/ Trac] to better fit your project, especially in 
    24 regard to ''components'', ''versions'' and ''milestones''.  
     5== Overview of dataMine == 
    256 
    267 
    27 TracGuide is a good place to start. 
    288 
    29 Enjoy! [[BR]] 
    30 ''The Trac Team'' 
     9== Installation == 
     10As dataMine makes use of a number of javascript libraries (primarily the flotr graphing package) installation isn't quite as straight forward as a standard plugin. The usual files (XML, JSON, LUA) are loaded in the normal way through the "developers" button in the control panel and all files specific to dataMine are placed into a directory /www/cmh/plugins/dataMine - this includes the js files, and a number of icons for buttons. 
    3111 
    32 == Starting Points == 
     12dataMine can generate a lot of data, so it is recommended to install a USB stick. 
    3313 
    34  * TracGuide --  Built-in Documentation 
    35  * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project 
    36  * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions 
    37  * TracSupport --  Trac Support 
     14Click on MiOS developpers 
     15Go to the "Luup Files" tab and upload the following files -: 
     16 - L_DataMine1.lua 
     17 - D_DataMine1.xml 
     18 - S_DataMine1.xml 
     19 - I_DataMine1.xml 
     20 - D_DataMine1.json 
     21 - J_DataMine1.js 
    3822 
    39 For a complete list of local wiki pages, see TitleIndex. 
     23Go to the "Create Device" tab and set the following values-: 
     24 - '''{{{UpnpDevFilename}}}''' D_DataMine1.xml 
     25 - '''{{{UpnpImplFilename}}}''' I_DataMine1.xml 
     26 - '''{{{DeviceType}}}''' urn:cd-jackson-com:serviceId:DataMine1:1 
     27 - '''{{{Description}}}''' dataMin 
     28 
     29Use WinSCP (or another SSH client) to upload the following files 
     30 
     31Directory: /www/cmh/plugins/dataMine 
     32 - All the GIF/PNG/JS files (other than the files listed above) 
     33 
     34Directory: /www/cmh/skins/default/icons 
     35 - Data_Mine.png 
     36 
     37The plugin needs the json library. To install this, go to -: 
     38 - http://code.mios.com/trac/mios_genericutils/export/20/json.lua  
     39and download this to the following directory on Vera 
     40 - /usr/lib/lua 
     41 
     42Format a USB stick and mount it to the Vera. 
     43(I was unable to get the Vera USB log command to work.) I formatted my drive using FAT32 on my Windows 7 machine and it worked a treat. 
     44 - md /dataMine 
     45 - mount /dev/scsi/host0/bus0/target0/lun0/part1 /dataMine 
     46 
     47Modify the /etc/init.d.custom-user-startup file to add the line -: 
     48 - mount /dev/scsi/host0/bus0/target0/lun0/part1 /dataMine & 
     49This ensures the USB stick is remapped when Vera restarts 
     50 
     51Once the dataMine device is running, click on the tool icon. You will get the graph tab, and config tab. 
     52Click on the config tab, and select the variables you want to log. All changes to the selected variables should now be logged to files in the /dataMine directory. 
     53 
     54 
     55 
     56== Use == 
     57The dataMine plugin installs as a device, and by clicking on the tools button you are presented with two tabs. The first one is the graph tab. This has a listbox to list all the available variables, and a number of buttons. The buttons allow you to select the last day/week/month, or all data, and to scroll and zoom the data. You can also zoom by selecting an area of the graph with the mouse. 
     58 
     59[[Image(dataMine1.png)]] 
     60 
     61The config tab allows you to select the variables to log. This provides a list of all variables for devices that aren't hidden. Variables are listed by service, and if you click on the variable name, logging will be enabled. Clicking again will disable logging, but the variable will still be listed in the graph page dropdown. There's also a little clock button for selected variables. Clicking on this will generate the hourly/daily data for the different zoom levels (currently this is only manual, but it will be made automatic soon). 
     62 
     63[[Image(dataMine2.png)]] 
     64 
     65== Under the hood == 
     66