blob: af2370c049b37106b2acf13094faf14edf2852b0 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
<!ENTITY imgroot "images/tools/ruta/workbench/" >
<!ENTITY % uimaents SYSTEM "../../target/docbook-shared/entities.ent" >
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
<section id="">
Do the installation of the UIMA Ruta Workbench as follows:
<orderedlist numeration="arabic">
Download, install and start Eclipse. The Eclipse version currently supported by UIMA Ruta is given
on the webpage of the <ulink url="">project</ulink>.
This is normally the latest version of Eclipse, which can be obtained
from the <ulink url=""></ulink> download site.
Add the Apache UIMA update site (
<ulink url="">
</ulink>) to the available
software sites in your Eclipse installation.
Click on <quote>Help &rarr; Install New Software</quote>. This opens the install wizard, which can be
seen in <xref linkend='' />
Select or enter the Apache UIMA update site (<ulink url="">
</ulink>)in field
<quote>Work with:</quote>
and press <quote>Enter</quote>.
Select <quote>Apache UIMA Ruta</quote> and (if not yet installed) <quote>Apache UIMA Eclipse tooling and runtime support</quote>
by clicking into the related checkbox.
Also select
<quote>Contact all update
sites during install to find required software
and click on
On the next page, click <quote>Next</quote>
again. Now, the license
agreement site is displayed. To install UIMA Ruta read the license and
<quote>I accept the ...</quote>
if you agree to it. Then,
click on <quote>Finish</quote>
<figure id="">
<title> Eclipse update site
<imageobject role="html">
<imagedata width="500px" format="PNG" align="center"
fileref="&imgroot;install/update.png" />
<imageobject role="fo">
<imagedata width="5.0in" format="PNG" align="center"
fileref="&imgroot;install/update.png" />
Eclipse update site.
Now, UIMA Ruta is going to be installed.
After the successful
installation, switch to the UIMA Ruta
perspective. To get an overview, see
<xref linkend='' />.
It is sometimes necessary to increase to available PermGenSpace by adding
<quote>-XX:PermSize=64M -XX:MaxPermSize=228M</quote> to the config.ini file of your Eclipse installation.
Several times within this chapter we use a UIMA Ruta example
to illustrate the use of the UIMA Ruta Workbench.
The <quote>ExampleProject</quote> project is part of the source release of UIMA Ruta (example-projects folder).
To import this project into the workbench do
<quote>File &rarr;
. Select
<quote>Existing Projects into Workspace</quote>
. Select the
in your file system as root directory and click on
. The
example project is now available in your workspace.