You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 79 Next »

DUCC Project Documentation


Quick Start

Instructions on how to fetch, build and install DUCC 1.0 for single host system (my laptop!)
See DUCC Project Documentation for further details.

The following steps were performed on Red Hat Enterprise Linux Workstation release 6.4 (Santiago)

Prerequisites

  • Install svn
  • Install mvn
  • Install jdk (1.6 or better)
    export JAVA_HOME=~/apps/java/java-home
  • Install latex
  • Install ant

Start sshd

[degenaro]$ sudo su root
[root]# chkconfig sshd on
[root]# /sbin/service sshd restart
[root]# exit
[degenaro]$

Create user ducc

[degenaro]$ sudo adduser ducc

Permit universal read+execute access to home directory for users degenaro and ducc

[degenaro]$ sudo su root
[root]# cd /home
[root]# chmod 755 degenaro
[root]# chmod 755 ducc
[root]# exit
[degenaro]$

Enable passwordless ssh for user ducc

 
[degenaro]$ sudo su ducc 
[ducc]$ cd
[ducc]$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/home/ducc/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /home/ducc/.ssh/id_rsa.
Your public key has been saved in /home/ducc/.ssh/id_rsa.pub.
The key fingerprint is:
4f:4a:81:60:c9:a5:d8:88:80:f3:6c:a1:ef:31:8b:8e ducc@hal9000.apache.com
The key's randomart image is:
+--[ RSA 2048]----+
|o  .oo.          |
|+..=oo .         |
|.=o.o . .        |
|. +      .       |
| o      S .      |
|  +    . +       |
| o +    . .      |
|o o              |
|E.               |
+-----------------+
[ducc]$ cd .ssh
[ducc]$ cat id_rsa.pub >> authorized_keys2
[ducc]$ chmod 600 *
[ducc]$ exit
[degenaro]$

Insure JAVA_HOME is set

Sample code to set JAVA_HOME

.bashrc

# .bashrc

# Source global definitions
if [ -f /etc/bashrc ]; then
        . /etc/bashrc
fi

# User specific aliases and functions

export JAVA_HOME=~/apps/java/java-home

Fetch DUCC from svn

[degenaro]$ svn co https://svn.apache.org/repos/asf/uima/sandbox/uima-ducc/trunk ~/svn/ducc/trunk

Build DUCC jars

[degenaro]$ cd ~/svn/ducc/trunk
[degenaro]$ mvn clean install -Pbuild-duccdocs

Install

[degenaro]$ cd target
[degenaro]$ sudo su ducc
[ducc]$ tar -zxf uima-ducc-1.0.0-SNAPSHOT-bin.tar.gz -C ~ducc
[ducc]$ cd ~
[ducc]$ ln -s apache-uima-ducc-1.0.0-SNAPSHOT/ducc_runtime ducc_runtime 
[ducc]$ cd ~ducc/ducc_runtime/admin
[ducc]$ ./ducc_post_install

Check

[ducc]$ cd ~ducc/ducc_runtime/admin
[ducc]$ ./check_ducc -s
[ducc]$ exit
[degenaro]$

Optional: enable ducc_ling and login to Web-server via Linux authentication

[degenaro]$ sudo su root
[root]$ mkdir /local
[root]$ mkdir /local/ducc
[root]$ mkdir /local/ducc/bin
[root]$ chown ducc.ducc /local/ducc
[root]$ chown ducc.ducc /local/ducc/bin
[root]$ chmod 700 /local/ducc
[root]$ chmod 700 /local/ducc/bin
[root]$ cp ~ducc/ducc_runtime/duccling/src/ducc_ling /local/ducc/bin
[root]$ chown root.ducc /local/ducc/bin/ducc_ling
[root]$ chmod 4750 /local/ducc/bin/ducc_ling
[root]$ exit
[degenaro]$
[degenaro]$ sudo su ducc
[ducc]$ cd ~ducc/ducc_runtime/resources
1. edit ducc.properties
2. locate: ducc.ws.login.enabled = false
3. modify: ducc.ws.login.enabled = true
4. locate: ducc.agent.launcher.ducc_spawn_path=${DUCC_HOME}/admin/ducc_ling
5. modify: ducc.agent.launcher.ducc_spawn_path=/local/ducc/bin/ducc_ling
6. save

Start

[ducc]$ cd ~ducc/ducc_runtime/admin
[ducc]$ ./start_ducc -s
[ducc]$ exit
[degenaro]$

ducc-mon System Daemons

Start your favorite browser (firefox, chrome, opera) and visit the ducc-mon system daemons page.

http://localhost:42133/system.daemons.jsp

Submit a test Job

[degenaro]$ cd ~ducc/ducc_runtime/bin
[degenaro]$ export PATH=$PATH:$PWD
[degenaro]$ cd ~ducc/ducc_runtime/examples/simple
[degenaro]$ ducc_submit -f 1.job
Job 1 submitted
[degenaro]$

ducc-mon Jobs

Visit the ducc-mon jobs page.

http://localhost:42133/jobs.jsp

This is a work in progress...more to come soon (Lou 11/06/2013)

  • No labels