View source

== Server Backend ==
The backend needs some basic configuration to configure data sources that should be crawled.

=== Configure data sources ===
* For configuration, make sure that the backend's WAR-archive is installed and unpacked in your application server (see [[Integrated Search/Installation]])
* You should then be able to find a directory called <code>\teamweaverIS-backend\WEB-INF\conf</code>
* In here, you find (among other) two configuration files, which you need to edit:
** <code>repo_config.xml</code> contains access data for the repositories you want to crawl (see [[repo_config.xml]] for details)
** <code>crawl_config.xml</code> helps you to group the repositories into "crawls" (see [[crawl_config.xml]] for details)

=== Crawl data sources ===
* Now that you configured everything, you might want to start your first crawl to fill the index with real that.
* Navigate in the new <code>teamweaverIS-backend</code> folder and execute <code>cc.bat</code>  resp. <code>cc.sh</code>. This will generate some scripts required for crawling.
* Execute the crawl shell script (<code>crawl.bat</code> resp. <code>crawl.sh</code> with the Id of the crawl you want to execute (as defined in [[crawl_config.xml]]) - e.g. "<code>crawl 0</code>"
** Note 1: Crawling is incremental. So when you start the same crawl later again, it will only update new/changed/deleted files.
** Note 2: TeamWeaver does not provide means for automatically launching crawls. You need to schedule a task on your server machine which executes the crawl regularly (e.g. once a night) to keep the index up-to-date.

=== Configuring "push" indexing ===
Besides having the backend crawling the data sources as described above, the backend also allows data sources to proactively "push" new or changed data to the index. This makes the index more "fresh", but would typically require modifications on the side of the crawled data source. Therefore, "push" indexing is currently only supported for [[Polarion Enterprise|Polarion]] and for [[Woogle|MediaWiki]].

Push-indexing needs to be configured in the backend as well as in the data source system. In the backend, you need to enabled pushIndexing, define an Id and provide a <code>pushIndexAuthKey</code> (see [[repo_config.xml]]).

For configuring the data source system, you need the following information:
* the backend URL (e.g. <code>http://localhost:8080/teamweaverIS-backend/services/</code>)
* the repositoryId and
* the <code>pushIndexAuthKey</code> as defined in the backend

The actual way of configuration should be described in the documentation. See e.g. [[Woogle4MediaWiki/Configuration]].