[Tika Wiki] Update of "TikaJAXRS" by NickBurch

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tika Wiki" for change notification.

The "TikaJAXRS" page has been changed by NickBurch:
https://wiki.apache.org/tika/TikaJAXRS?action=diff&rev1=30&rev2=31

Comment:
Encourage users to download the pre-built binary in preference to building from source

  This page is documentation on tika's JSR 311 network server, tika-server. The server package uses the [[http://cxf.apache.org/|Apache CXF]] framework that provides an implementation of JAX-RS for Java. The Tika server component builds to a standalone package in Tika, tika-server.
  
  == Installation ==
- To install:
+ The easiest way to get the Tika JAXRS server is to download the latest stable release binary. This is available from the [[http://tika.apache.org/download.html|Apache Tika downloads page]], via your favourite local mirror. You want the ''tika-server-1.x.jar'' file, eg ''tika-server-1.7.jar''
  
-  1. Download the latest stable source from the [[http://tika.apache.org/download.html|Apache Tika download page]] or retrieve the latest code from [[https://github.com/apache/tika|Github]],
+ == Building from source ==
+ If you need to customise the server in some way, and/or need the very latest version to try out a fix, then to build from source:
+ 
+  1. Checkout the source from SVN as detailed on the [[http://tika.apache.org/contribute.html|Apache Tika contributions page]] or retrieve the latest code from [[https://github.com/apache/tika|Github]],
-  1. Build source using Maven,
+  1. Build source using Maven
-  1. Run the Apache Tika JAXRS server.
+  1. Run the Apache Tika JAXRS server runnable jar.
  
  {{{
+ svn co https://svn.apache.org/repos/asf/tika/trunk/ tika-trunk
+ cd ./tika-trunk/
- wget http://mirror.vorboss.net/apache/tika/tika-x.x-src.zip
- unzip tika-x.x-src
- cd ./tika-x.x/
  mvn install
  cd ./tika-server/target/
  java -jar tika-server-x.x.jar
  }}}
- Remember to replace x.x with the version you have downloaded.
+ Remember to replace x.x with the version you have built.
  
  You will then see a message such as the following:
  
  {{{
+ $ java -jar tika-server-1.8-SNAPSHOT.jar19-Jan-2015 14:23:36 org.apache.tika.server.TikaServerCli main
+ INFO: Starting Apache Tika 1.8-SNAPSHOT server
- $ java -jar target/tika-server-1.2-SNAPSHOT.jar
- Apr 4, 2012 7:48:49 AM org.apache.tika.server.TikaServerCli main
- INFO: Starting Tikaserver ${project.version}
- Apr 4, 2012 7:48:50 AM org.apache.cxf.endpoint.ServerImpl initDestination
+ 19-Jan-2015 14:23:36 org.apache.cxf.endpoint.ServerImpl initDestination
  INFO: Setting the server's publish address to be http://localhost:9998/
- 2012-04-04 07:48:50.316:INFO:oejs.Server:jetty-7.x.y-SNAPSHOT
- 2012-04-04 07:48:50.375:INFO:oejs.AbstractConnector:Started SelectChannelConnector@localhost:9998 STARTING
- 2012-04-04 07:48:50.399:INFO:oejsh.ContextHandler:started o.e.j.s.h.ContextHandler{,null}
- Apr 4, 2012 7:48:50 AM org.apache.tika.server.TikaServerCli main
+ 19-Jan-2015 14:23:36 org.slf4j.impl.JCLLoggerAdapter info
+ INFO: jetty-8.y.z-SNAPSHOT
+ 19-Jan-2015 14:23:36 org.slf4j.impl.JCLLoggerAdapter info
+ INFO: Started SelectChannelConnector@localhost:9998
+ 19-Jan-2015 14:23:36 org.apache.tika.server.TikaServerCli main
  INFO: Started
  }}}
  Which lets you know that it started correctly.