updated README - some parts moved to org.glite.jp.doc
authorJan Pospíšil <honik@ntc.zcu.cz>
Thu, 27 Mar 2008 21:04:34 +0000 (21:04 +0000)
committerJan Pospíšil <honik@ntc.zcu.cz>
Thu, 27 Mar 2008 21:04:34 +0000 (21:04 +0000)
org.glite.jp.index/doc/README

index 2261d3c..9b79e28 100644 (file)
@@ -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).