martin-grunewald / hlt-confdb Goto Github PK

----------------
startGUI script:
----------------

You shouldn't have to start the GUI by checkking out the package and
invoking the startGUI script! You can start the GUI by pointing your
browser to the following address:

http://www.cern.ch/confdb/gui/start.jnlp


To invoke the startGUI script you need 'java' and 'classic-ant' in
your path. Then:

cvs co [-r VXX-YY-ZZ] -d . EventFilter/ConfigDB
cd ConfigDB
./startGUI


---------
 parser:
---------

assuming:
eval `scramv1 runtime -[c]sh`

with MySQL:
***********
python ConfdbSourceToDB.py -r CMSSW_X_Y_Z [-p /path/to/CMSSW_X_Y_Z] -d hltdb -u <username> -s <pwd> -o machine.cern.ch -t MySQL

with Oracle [dev@IT]:
*********************
python ConfdbSourceToDB.py -r CMSSW_X_Y_Z [-p /path/to/CMSSW_X_Y_Z] -u cms_hlt -s <pwd> -o cms_orcoff_int2r -t Oracle


with Oracle XE [LOCAL]:
***********************
- setup your local XE installation:
source /usr/lib/oracle/xe/app/oracle/product/10.2.0/server/bin/oracle_env.[c]sh

- setenv TNS_ADMIN $ORACLE_HOME/network/admin

python ConfdbSourceToDB.py -r CMSSW_X_Y_Z [-p /path/to/CMSSW_X_Y_Z] -u <username> -s <pwd> -o XE -t Oracle


------------------------
Deployment to Web Server
------------------------

(1) http://webservices.cern.ch/

    -> Manage my web sites

(2) login using your user name / passwd

    -> http://cern.ch/cms-project-confdb-hltdev

    -> Deploy application

    -> browse : select war to upload
    -> Upload file


----------------------
Producing problems.txt
----------------------

-> edmConfigToPython < RelVal_HLTFromRaw.cfg >  RelVal_HLTFromRaw.py

-> java -cp ext/ojdbc6.jar:lib/cmssw-evf-confdb-gui.jar confdb.parser.PythonParser -t oracle -h int2r1-v.cern.ch -p 10121 -n int2r_lb.cern.ch -u cms_hlt -s ************** -r CMSSW_2_0_0_pre2 -c RelVal_HLTFromRaw.py

----------------------
Note for developers:
----------------------
- JNLP (Java launching mechanism): To download automatically .jar libraries from the server it is needed set the rules in start.jnlp script.
- Tag V01-06-21: Includes a set of .jar libraries needed for the Python parser feature.
- Tag V01-06-23: Modifies the launching script to include them in the library download.
	<jar href="jython-2.5.2.jar" download="eager"/>
	<jar href="antlr-runtime-3.1.3.jar" download="eager"/>
	<jar href="asm-3.1.jar" download="eager"/>
	<jar href="asm-commons-3.1.jar" download="eager"/>
	<jar href="asm-util-3.1.jar" download="eager"/>
	<jar href="constantine-0.4.jar" download="eager"/>
	<jar href="jna.jar" download="eager"/>
	<jar href="jna-posix.jar" download="eager"/>
- See /browser/WebContent/gui/start.jnlp

- startGUI: You will also need to specify them in the classpath if you run the Confdb-gui locally.

EXTRA FOLDERS:
- The /Python/FWCore folder has been added in the version (Tag V01-06-21) to satisfy dependences for the python interpreter while parsing python configurations.
- In order to have this folder available in the classpath when the app. is downloaded from the server, it needs to be included in cmssw-evf-confdb-gui.jar 
- To do that the build.xml file must specify the inclusion of this folder in the relevant compilation.
- See build.xml