readme

dml-2.2.5.b8.tar.gz(xml, html document)

File Transfer Monitor
=====================
Currenty, supports gsiftp, ftp, http for get and put file transfers.
For all transfer types requestid is required.

*  concurrency is supported for all transfer types.
*  parallelism is only supported for gsiftp transfers..

https (lahfs) is a special purpose https transfer
which requires esg username and password. 
    * when an lahfs type transfer is initiated esg username and password
      will be prompted.
    * setting buffer size is not supported for lahfs transfers.
    * release file is supported for lahfs transfers.
        * How to enable release file 
          * In the gui mode, please go to Tools->config and then check the
            relase file CheckBox "ON".  To disable please toggle the checkbox.
          * In the nogui mode, use -releasefile option. 
            and -noreleasefile option to turn off release file option.

setting buffersize is not supported for lahfs type transfers.

How to run 
==========
1) Runs in both gui and nogui mode.

To Run in GUI mode:

   Example dml-gui -conf conf/config.xml -targetdir /tmp/test -logdir ./logs
   
   Usage : 
       ++++++++++++++++++++++++++++++++++++++++++++++++++++
       java gov.lbl.srm.client.SRMClientGUI <options>
                 -conf location to config.xml file
                         default ./config.xml
                 -logdir location to create status file
                         default in the same directory
                 -targetdir location 
                         not required for put requests
       ++++++++++++++++++++++++++++++++++++++++++++++++++++

1) If config.xml does not exist, there is an option to create the config
   file from the menu->Tools->Config.
   From the menu->Tools->Config option, one can change the path to
   userkey, usercert, proxyfile , lahfs-properties-location,release-file etc.
   By default user proxy is used for gsiftp transfers.

2) Proxy can initialized from the menu->Tools->InitProxy

3) Following Options can be set using the menu->Options 
   Buffer size
   Concurrency
   Parallelism 
   Overwrite/NoOverwrite (Default overwrite)

To Run in NOGUI mode:

   Example dml -config conf/config.xml -f <inputfile> 
  	            -targetdir /tmp/test -logdir ./logs
                -lahfspropsloc <path to lahfs properties file>
    or dml -config conf/config.xml -s <sourceurl> -size <filesize> 
  	            -targetdir /tmp/test -logdir ./logs
                -lahfspropsloc <path to lahfs properties file>

    ++++++++++++++++++++++++++++++++++++++++++++++++++++
       java gov.lbl.srm.client.SRMClientNGUI <options>
		    -conf location to config.xml file
			      default ./config.xml
		    -f input file
		    -s sourceUrl 
		    -rid <requestid> (requried)
		    -size expected fileSize (optional)
		    -lahfs (true|false) (default:false) 
		    -lahfspropsloc location to 
		  	   lahfsproperties file(default: ./lahfs.properties)
		    -releasefile (true|false) (default:false) 
			   release file in the server with rid, fid
		    -noreleasefile (true|false) (default:false) 
		  	   no release file in the server with rid, fid
		    -userkey location to userkey file
		  	   default from ./config.xml
		    -logdir location to create status log file.
			   default the same directory.
		    -targetdir target dir location for get requests
			   not required for put requests.
		    -usercert location to usercert file
			   default from ./config.xml
		    -proxyfile location to proxyfile file
			   default from ./config.xml
		    -nooverwrite to overwrite or not overwrite file
			   default overwrites file
            -genproxy (generated proxy)
               default false
            -old (creates GT2 type of proxy
               default creates GT3 type of proxy
               prompts for password later on
		    -renew renews proxy automatically
			   default false
			   prompts for password later on
		    -concurrency <integer>number of concurrent transfers
			   default 1
		    -parallelism <integer>number of parallelism
			   default 1, applies only for gsiftp transfer
		    -buffersize <integer> buffersize for transfers
			   default 1024, maximum 1048576, min 128 
		    -loadcerts <alias1#certlocation1;alias2#certlocation2> 
			   loading additional certs into keystore
               to load more than one alias#certlocation pair 
			   please seperate them with semilcolons
    ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

DMLStatus
=========

DMLStatus is a command line program which shows the status of the 
current transfer made by the file transfer monitor tool.

DMLStatus reads the log file generated by File Monitor Transfer tool
and generates a simple text based status.



Example :
   dml-status -requestid request.xml -logdir ./logs

  requestid is the name of the input file used for transfering files.
  logdir is the log directory used to store the status log files for
  transferring files.

Usage :
   ++++++++++++++++++++++++++++++++++++++++++
   java DMLStatus -requestid <inputfile>
                         example: request.xml           
                   -logdir <location of log file>
                         example: /home/users/vijayaln/log
   ++++++++++++++++++++++++++++++++++++++++++