Author: challngr
Date: Fri Jun 21 13:37:00 2013
New Revision: 1495431
URL: http://svn.apache.org/r1495431
Log:
UIMA-2682 Misc doc and message updates.
Modified:
uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_post_install
uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_util.py
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/job-details.tex
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/jobs.tex
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/reservations.tex
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/admin/ducc-properties.tex
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
Modified: uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_post_install
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_post_install?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
--- uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_post_install (original)
+++ uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_post_install Fri Jun 21
13:37:00 2013
@@ -75,7 +75,7 @@ class PostInstall(DuccUtil):
def warn(self, *msg):
print ''
print 'WARNING'
- print 'WARNing', ' '.join(msg)
+ print 'WARNING', ' '.join(msg)
print 'WARNING'
print ''
@@ -96,11 +96,11 @@ class PostInstall(DuccUtil):
pw = self.ducc_properties.get('ducc.ws.port.ssl.pw')
if ( pw == 'quackquack' ):
- print self.warn('The default ssl pw of ', pw, ' is configured. For
security, change the property \n\tducc.ws.port.ssl.pw to a secure password in
ducc.properties.')
+ print self.warn('The default ssl pw of ', pw, ' is configured. For
security, change the property \n\tducc.ws.port.ssl.pw to a secure password in
ducc.properties and rerun ducc_post_install.')
#/usr/bin/keytool
- cmd = self.keytool
+ cmd = keytool
cmd += ' '
cmd += '-genkey'
cmd += ' '
Modified: uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_util.py
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_util.py?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
--- uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_util.py (original)
+++ uima/sandbox/uima-ducc/trunk/src/main/admin/ducc_util.py Fri Jun 21
13:37:00 2013
@@ -545,7 +545,7 @@ class DuccUtil:
duccgid = grpinfo.gr_gid
#print 'UID', sstat.st_uid, 'GID', duccgid
if ( (sstat.st_uid != 0) or (sstat.st_gid != duccgid) ):
- print 'ducc_ling module', dl, ': Invalid ownership. Should be
ducc.ducc'
+ print 'ducc_ling module', dl, ': Invalid ownership. Should be
root.ducc'
return False
else:
if ( not os.path.exists(self.duccling) ):
Modified:
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/job-details.tex
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/job-details.tex?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
---
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/job-details.tex
(original)
+++
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/job-details.tex
Fri Jun 21 13:37:00 2013
@@ -83,11 +83,10 @@
\item[Killed] - The agent terminated the process for some
reason. The ``Reason Agent'' field
should have more details in this case.
- \item[Stopped] - The process terminated normally. HELP HELP
how is this different from Voluntary?
+ \item[Stopped] - The process was terminated by the Agent for
some reason. The hover should
+ contain more information.
\item[Voluntary] - The job is winding down, there's no more
work for this node, so it stops.
- HELP HELP How is this different from Stopped. Also State
Agent has Stopped - does this
- RELATE TO THAT? HELP HELP
\item[Unknown] - None of the above. This is an exceptional
condition, sometimes an
internal DUCC error. Check the JP and JD logs for possible
causes..
@@ -120,7 +119,9 @@
\item The Job Process timed out during initialization,
\item The process Exocet's its allowed swap.
\end{enumerate}
- \item[Abandoned] WHAT IS THIS?
+ \item[Abandoned] It is possible to cancel a specific process of
a job. Usually
+ this is because it became ``stuck'' because of hardware
failure. It a process
+ is killed in \hyperref[sec:cli.ducc-cancel]{this way}, the
state is recoreded as {\em Abandonded}.
\end{description}
\item[Reason Agent] \hfill \\
Modified:
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/jobs.tex
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/jobs.tex?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
---
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/jobs.tex
(original)
+++
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/jobs.tex
Fri Jun 21 13:37:00 2013
@@ -72,6 +72,8 @@
termination is seen by hovering over the text with your
mouse.
\item[CanceledBySystem] - The job was canceled because DUCC
was shutdown.
\item[CanceledBySser] - The job owner or DUCC administrator
canceled the job.
+ \item[Cancel Pending] - The job has been canceleled and is
not yet fully evicted
+ from the system.
\item[DriverInitializationFailure] - The Job Deiver (JD)
process is unable to initialize. Hover over
the field with your mouse for details (if any are
available), and check your JD log.
\item[DriverProcessFailed] - The Job Driver (JD) process
failed for some reason. Hover over the
Modified:
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/reservations.tex
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/reservations.tex?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
---
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/reservations.tex
(original)
+++
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part2/webserver/reservations.tex
Fri Jun 21 13:37:00 2013
@@ -64,7 +64,13 @@ The Reservations page contains the follo
For {\em managed reservations}, DUCC does terminate the associated process.
\begin{description}
- \item[CanceledBySystem] - The job was canceled because DUCC was shutdown.
+ \item[CanceledBySystem] - In the case of the special JobDriver reservation,
this is
+ canceled by DUCC and reestablished on reboot; hence the state is a result
of DUCC
+ having been restarted.
+
+ In all other cases, it is a result of DUCC being restarted {\em COLD}.
When
+ DUCC is started {\em COLD}, all previous reservations are canceled. (When
DUCC
+ is started {\em WARM}, the default, previous reservations are preserved.)
\item[CanceledByAdmin] - The DUCC administrator released the reservation.
\item[CanceledByUser] - The reservation owner released the reservation.
\item[ResourcesUnavailable] - The Resource Manager was unable to find free
or freeable resources
Modified:
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/admin/ducc-properties.tex
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/admin/ducc-properties.tex?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
---
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/admin/ducc-properties.tex
(original)
+++
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/admin/ducc-properties.tex
Fri Jun 21 13:37:00 2013
@@ -395,7 +395,8 @@
\end{description}
\item[ducc.ws.port.ssl.pw] \hfill \\
- This is the SSL password used for SSL requests.
+ This is the password used to generate the Web Server's keystore used
for HTTPS requests. Usually
+ this keystore is created at initial installation time using
\hyperref[subsec:install.single-user]{ducc\_post\_install.}
\begin{description}
\item[Default Value] quackquack
\item[Type] Local
Modified:
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
URL:
http://svn.apache.org/viewvc/uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex?rev=1495431&r1=1495430&r2=1495431&view=diff
==============================================================================
---
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
(original)
+++
uima/sandbox/uima-ducc/trunk/uima-ducc-duccdocs/src/site/tex/duccbook/part4/install.tex
Fri Jun 21 13:37:00 2013
@@ -133,7 +133,11 @@ cd $HOME/ducc_runtime/admin
\begin{verbatim}
./ducc_post_install
\end{verbatim}
- This should be run only once. Its tasks are described below.
+ If this script fails, correct any problems it identifies and run it
again.
+
+ Note that {\em ducc\_post\_install} initializes various default
parameters which
+ may be changed later by the system administrator. Therefore it
usually should be
+ run only during this first installation step.
\item If you wish to install jconsole support from the webserver, make
sure Apache Ant
is installed, and run
