From: Jan Pospíšil Date: Thu, 27 Mar 2008 21:04:34 +0000 (+0000) Subject: updated README - some parts moved to org.glite.jp.doc X-Git-Tag: merge_313_4~11 X-Git-Url: http://scientific.zcu.cz/git/?a=commitdiff_plain;h=b916978e86f623694592c7ae1ef45c0247f2908a;p=jra1mw.git updated README - some parts moved to org.glite.jp.doc --- diff --git a/org.glite.jp.index/doc/README b/org.glite.jp.index/doc/README index 2261d3c..9b79e28 100644 --- a/org.glite.jp.index/doc/README +++ b/org.glite.jp.index/doc/README @@ -1,17 +1,9 @@ -Job provenance Index server README +Job Provenance Index Server README ================================== -($Header$) +JPIS is ... -Job provenance and its components ---------------------------------- - -This file contains basic administrator's documentation for Job -provenance (JP) Index server (IS). For Job provenance architecture and -functionality description please see: EGEE architecture document -DJRA1.4 - https://edms.cern.ch/document/594698/ chapter 8.4. -Job provenance interfaces are documented on http://egee.cesnet.cz/en/WSDL/ -page. +For comprehensive documentation about JP see org.glite.jp.doc. Source code, executables, dependences ------------------------------------- @@ -47,70 +39,3 @@ Release notes - No admin tools are implemented yet. - -Installation ------------- - -- database setup - - The JP-IS server daemon assume prior creation of its database. Simple tool - for database creation is org.glite.jp.index/config/dbsetup.sh - -- customize startup script /etc/init.d/glite-jp-indexd (see below) - and set up service startup using this script - - -Configuration -------------- - -Currently, configuration is done by command line options, and -some hard-coded options. - - -The index server takes the following options: - -./glite-jp-indexd [option] - -d, --debug don't run as daemon, additional diagnostics - -q, --query-type hist/cont/both (default history) - -n, --noauth don't check user identity with result owner - -m, --mysql database connect string - -p, --port port to listen - -i, --pidfile file to store master pid - -o, --logfile file to store logs - -x, --config file with server configuration - -The config file parameter is required. There is the example configuration in -$GLITE_LOCATION/etc/glite-jpis-config.xml. - - -Starting the daemon -------------------- - -Preferred way of starting the daemon is using start-up script -(config/startup). It loads glite.conf file (personal version may be stored -in ~/.glite.conf) where many variables may be set to configure the daemon. -The script takes following variables: - -GLITE_JPIS_CONFIG - server config file specification - (default is $GLITE_LOCATION//etc/glite-jpis-config.xml) -GLITE_JPIS_DEBUG - setting to '-d' forces the daemon not to daemonize -GLITE_JPIS_QT - defines query type - 'hist' ... history query - 'cont' ... continuous query - 'both' ... combination of previous types -GLITE_JPIS_AUTH - setting to '-n' forces the daemon not to check - authorisation -GLITE_JPIS_PORT - used port (default 8902) -GLITE_JPIS_DB - database connection string - (default jpis/@localhost:jpis) -GLITE_JPIS_LOGFILE - log file - (default is $GLITE_LOCATION_VAR/log/glite-jp-indexd.log) -GLITE_JPIS_PIDFILE - pid file - (default is $GLITE_LOCATION_VAR/run/glite-jp-indexd.log) - - -Testing -------- - -For testing recipes of JP-IS please see appropriate chapter of JP test plan -document (org.glite.jp/doc/testplan.tex).