X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=crawler%2Fkiss%2Fdocs%2Fcontent%2Fxdocs%2Findex.xml;h=50397ef2a3dbc51fb0242d5626c669aa8cef9919;hb=098fb64daea94942558b8bcbde992e8ef690b759;hp=d2cc2149b0cb73ada6221d38065bc275f67d21cf;hpb=48417aa9b93a3e74e9f23479106e8356471a959d;p=utils diff --git a/crawler/kiss/docs/content/xdocs/index.xml b/crawler/kiss/docs/content/xdocs/index.xml index d2cc2149..50397ef2 100644 --- a/crawler/kiss/docs/content/xdocs/index.xml +++ b/crawler/kiss/docs/content/xdocs/index.xml @@ -20,7 +20,51 @@
Automatic Recording for KiSS Hard Disk Recorders
- + + + KiSS makes regular updates to their site that sometimes require adaptations + to the crawler. If it stops working, check out the most recent version here. + +
+ Changelog + +
+ 31 August 2006 + +
+
+ 24 August 2006 + +
+ +
+ 13-20 August 2006 +

+ There were several changes to the login procedure, requiring modifications to the crawler. +

+ +
+
Overview @@ -47,9 +91,14 @@ records programs for you or sends notifications about interesting ones.

- In its current version, the crawler can be used a standalone program - only and the preferred way to run it is as a scheduled task. + In its current version, the crawler can be used in two ways:

+
@@ -61,22 +110,42 @@

The easy way to start is the - binary version. + standalone program binary version + or using the web + application.

The latest source can be obtained from subversion with the URL https://wamblee.org/svn/public/utils. The subversion repository allows read-only access to anyone.

+

+ The application was developed and tested on SuSE linux 9.1 with JBoss 4.0.2 application + server (only required for the web application). It requires at least a Java Virtual Machine + 1.5 or greater to run. +

Configuring the crawler

- The crawler comes with two configuration files, namely - crawler.xml and programs.xml. + The crawler comes with three configuration files:

+ +

+ For the standalone program, all configuration files are in the conf directory. + For the web application, the properties files is located in the WEB-INF/classes + directory of the web application, and crawler.xml and programs.xml + are located outside of the web application at a location configured in the properties file. +

+
Crawler configuration <code>crawler.xml</code> @@ -89,33 +158,7 @@ Programme Guide.

- -
- Program configuration: <code>programs.xml</code> - -

- The programs.xml file contains the following - configuration items: -

- -
- Notification configuration -

- Notification is configured in the (surprise, surprise!) - notification element. This notification element - is used to configure respectively sender mail address (= reply - address), recipient address, subject of the email, smtp server - host and port and optional username and password. - In addition it contains the names of the stylesheets to - generate the HTML and Text reports. These stylesheets - should not be changed. -

-
- +
Program configuration

@@ -204,16 +247,24 @@

- - + +
+ Notification configuration +

+ Edit the configuration file org.wamblee.crawler.properties. + The properties file is self-explanatory. +

+ + +
Installing and running the crawler
- Binary distribution + Standalone application

In the binary distribution, execute the run script for your operating system @@ -222,6 +273,21 @@

+
+ Web application +

+ After deploying the web application, navigate to the + application in your browser (e.g. + http://localhost:8080/wamblee-crawler-kissweb). + The screen should show an overview of the last time it ran (if + it ran before) as well as a button to run the crawler immediately. + Also, the result of the last run can be viewed. + The crawler will run automatically every morning at 5 AM local time, + and will retry at 1 hour intervals in case of failure to retrieve + programme information. +

+
+
Source distribution

@@ -235,12 +301,18 @@

General usage

- The crawler, as it is now, is s standalone program which is - intended to be run from a command-line. When it runs, it - retrieves the programs for today. As a result, it is advisable + When the crawler runs, it + retrieves the programs for tomorrow. As a result, it is advisable to run the program at an early point of the day as a scheduled - task (e.g. cron on unix). + task (e.g. cron on unix). For the web application this is + preconfigured at 5AM.

+ + If you deploy the web application today, it will run automatically + on the next (!) day. This even holds if you deploy the application + before the normal scheduled time. + +

Modifying the program to allow it to investigate tomorrow's programs instead is easy as well but not yet implemented. @@ -255,7 +327,7 @@

The best example is in the distribution itself. It is my personal - programs.xml file. + programs.xml file.