| 1 | = First steps = |
| 2 | |
| 3 | This mini tutorial describes a good way to start (what to install, what to configure). |
| 4 | |
| 5 | == Install user observation == |
| 6 | |
| 7 | Homepage of the user observation plugins for Mozilla Firefox + Thunderbird: |
| 8 | http://dragontalk.opendfki.de/ |
| 9 | - http://dragontalk.opendfki.de/wiki/Firefox_userobs -> XPI to install |
| 10 | - http://dragontalk.opendfki.de/wiki/Thunderbird_userobs -> XPI to install |
| 11 | |
| 12 | Please install the Firefox Plugin first. You can install the one for Thunderbird later on. |
| 13 | For Thunderbird you have to save the XPI, install it in Thunderbird and customize Thunderbird's toolbar. |
| 14 | |
| 15 | |
| 16 | == Download User Observation Hub == |
| 17 | |
| 18 | Homepage where the User Observation Hub is hosted: |
| 19 | http://usercontext.opendfki.de/ |
| 20 | - http://usercontext.opendfki.de/wiki/UserObservationHub |
| 21 | - class de.dfki.km.usercontext.userobservationhub.StartUserObservationHub |
| 22 | |
| 23 | Just start the User Observation Hub by starting the class |
| 24 | de.dfki.km.usercontext.userobservationhub.StartUserObservationHub |
| 25 | as Java application. |
| 26 | |
| 27 | After you succeeded to install the Firefox XPI and start the class above, |
| 28 | you must configure the user observation plugin (in Firefox and Thunderbird) |
| 29 | by clicking the new icon at the very right of the Firefox toolbar: |
| 30 | |
| 31 | |
| 32 | __insert_image_here__ |
| 33 | |
| 34 | |
| 35 | Click at the rightmost icon ("EPOS") and enter the following data for Port and Service |
| 36 | into the following dialog popping up: |
| 37 | |
| 38 | |
| 39 | __insert_image_here__ |
| 40 | |
| 41 | |
| 42 | The information to enter is also printed out in the shell of the Java |
| 43 | application when starting the user observation hub: |
| 44 | |
| 45 | |
| 46 | __insert_image_here__ |
| 47 | |
| 48 | |
| 49 | |
| 50 | After this you should already see some RDF chunks of NOPs (Native Operations), |
| 51 | e.g. when you browse some web pages with Firefox: |
| 52 | |
| 53 | |
| 54 | __insert_image_here__ |
| 55 | |
| 56 | |
| 57 | |
| 58 | Don't worry about the exceptions coming up. These come up due to the fact, |
| 59 | that the UOH currently expects some listeners used by us in the Mymory |
| 60 | project. Most probably, these listeners are not available on your machine (yet). |
| 61 | |
| 62 | Therefore, later on you could create a new starter class or modify the |
| 63 | class de.dfki.km.usercontext.userobservationhub.StartUserObservationHub |
| 64 | to match the user observation listeners you have on your PC. |
| 65 | So, instead of this remote listener: |
| 66 | {{{ |
| 67 | RemoteUserObsListener remoteListener2 = new RemoteUserObsListener( |
| 68 | "localhost", 9998, "MyUserObservationHub_Listener" ); |
| 69 | userobshub.addUserObservationListener( remoteListener2 ); |
| 70 | }}} |
| 71 | you can add your own listener that listens to the NOPs sent by the UOH. |
| 72 | So, if you have an XML-RPC listener running on the same machine on port |
| 73 | 12345 with handler "userobs", then you should add these lines: |
| 74 | {{{ |
| 75 | RemoteUserObsListener mylistener = new RemoteUserObsListener( |
| 76 | "localhost", 12345, "userobs" ); |
| 77 | userobshub.addUserObservationListener( mylistener ); |
| 78 | }}} |
| 79 | |
| 80 | ---- |
| 81 | |
| 82 | If you still have problems with installation or configuration, feel free to send |
| 83 | an email to sven.schwarz@dfki.de |
| 84 | |
| 85 | Have fun! |