Quick demo for DIAL 1.30

D. Adams
March 6, 2005


DIAL release 1.30 is described in the user guide. Those who don't want to be bothered to read it, can quickly submit a job by following the instructions below.

Setting up

Log into one of the acas machines at BNL and enter one the following depending on your shell.
> . /usatlas/ada_sw/dialbase/setup/setup.sh
> source /usatlas/ada_sw/dialbase/setup/setup.csh
These have a minimal effect on your environment (add a couple aliases) and can safely be added to your startup file.

Registration and verification

The first time you use DIAL, you will need to register your grid certificate. Enter the dial shell and check your proxy
> dial
dial-1.30> check_proxy
If you don't have a proxy, you will be prompted for your password in the usual manner. If you don't know what a grid proxy is, then ask a local grid expert.

If this is the first you use DIAL, you will also be asked to provide a username.

Next try the command uidtest:

dial-1.30> uidtest
ID connection is 
  WsClientUniqueIdGenerator:http://dial02.usatlas.bnl.gov:20001:true
Next Test ID is 124-969
If you see something like the above, then your DIAL configuration and proxy are probably OK. If not, please resolve the problem before continuing.

Running the default job

To run a job using the ROOT interface, create and move to an empty directory. Use the command
dial-1.30> dialroot -i
to install the dialroot support files in that directory. Start the DIAL version of ROOT with the command
dial-1.30> dialroot
and then read the job definition with
root> jobdef()
and submit the job with
root> submit()
The job ID will be returned. Open a web browser to
  http://dial02.usatlas.bnl.gov:20010
and click on "Primary job repository" view the jobs submitted to the default analysis service. Your job should be at the top. Follow links to view the job properties including subjobs. Update the browser until your job completes (normally about 15 minutes for this job) and then return to the ROOT session.

Use the command

root> get_result()
to show the job status and fetch the result, if available. If there is a result with histograms (as there should be for the default application), then the histogram file has been copied back (or linked) to your directory. Start a root browser and navigate to the histograms in the usual manner.
root> TBrowser b
For the default job, you should see a Z-peak if you navigate down to the histogram muon_pair_os_mass.

Running the default job

To run a different job, edit jobdef.C and follow the instructions above to resubmit. You can make the job run faster by reducing the maximum number files per subjob (max_file) or can choose a different dataset (dname) from the list at dataset selection catalog.

See the user guide to learn how to modify the analysis task or replace it with your own.

Changing the analysis service

If you want to try a different analysis service, choose one from the list on the service page and then follow its link to obtin the service URL (WS URL) and monitoring URL (HTTP URL). For example, the PANDA service URL is http://dial02.usatlas.bnl.gov:20015 and its monitoring URL is http://dial02.usatlas.bnl.gov:20014.

Copy the service URL into a file named scheduler, restart DIAL and submit as before.


dladams@bnl.gov