Download

Installation of ROME

• Requirements

  • ROOT
    • Compatible versions are written later in this page.

    ROOT is available on the ROOT Download site.

  • UNIX like system requirements.

    g++

    required

    version 3.2 or later.

    
    
  • UNIX like system optional libraries.

    MySQL	optional	necessary if you use rome together with MySQL or MariaDB database.
    PostgreSQL	optional	necessary if you use rome together with PostgreSQL database.
    SQLite	optional	necessary if you use rome together with SQLite database.
    SQLite3	optional	necessary if you use rome together with SQLite version 3 database.
    MIDAS	optional	necessary if you use rome online together with midas experiment.
    graphviz	optional	necessary if you want to make a picture which shows task connections.
    xz library	optional	necessary if you want to read midas files compressed by xz.
    bzip2 library	optional	necessary if you want to read midas files compressed by bzip2.

---

• Download ROME

  There are 3 different ways to download ROME; tar-file, Git or SVN.
  
  Until 2013, ROME (version-2) was version-controlled by subversion(SVN) and can be downloaded from a SVN repository. In 2013 ROME version-3 is moved to Git. No new features will be added to ROME version-2, but bug-fixes can be done when it is requested by users. Since version-3, windows is not supported because we don't get any requests for windows version.
  
  Downloading from Git is recommended.

  • Download a ROME Release tar file

    Following release are available :

    Version	link to release notes	Supported ROOT version
    3.1 (latest)	(release notes)	v4.02.xx - v6.00.xx
    3.0	(release notes)	v4.02.xx - v5.34.xx
    2.15	(release notes)	v4.02.xx - v5.34.xx
    2.14	(release notes)	v4.02.xx - v5.32.xx
    2.13	(release notes)	v4.02.xx - v5.28.xx
    2.12	(release notes)	v4.02.xx - v5.26.xx
    2.11	(release notes)	v4.02.xx - v5.22.xx
    2.10	(release notes)	v4.02.xx - v5.18.xx
    2.9	(release notes)	v4.02.xx - v5.16.xx
    2.8	(release notes)	v4.00.08 - v5.14.xx
    2.7	(release notes)	v4.00.08 - v5.12.xx
    2.6	(release notes)
    2.5	(release notes)
    2.4	(release notes)
    2.3	(release notes)

  • ROME3 from a Git repository

    ROME version-3 is available at Bitbucket. The latest version can be checked out using Git. If Git is not installed on your system, you can download from the Git web page.
    The url to checkout will be shown when you click on the 'Clone' button indicated in the red circle in the following screen-shot.
    The command must be like,

    $ git clone https://bitbucket.org/muegamma/rome3.git rome
    

    After you checkout, you can choose the branch to use,

    $ git checkout master
    

    or

    $ git checkout develop
    

    The 'master' version is the stable version, and the 'develop' branch is for the development of ROME. You can also search for tagged versions and check it out. For example to checkout v3.0.3,

    $ git tag
    $ git checkout v3.0.3
    

    Alternatively, you can download tarballs from the links indicated in the blue circle in the following screen-shot.
    
    (This picture is just a screen-shot, you need to open the actual Bitbucket page, instead of clicking on this picture itself.)

  • ROME2 from a subversion repository

    ROME is available at a subversion repository at PSI.

    Subversion is available at tigris.org.
    Windows user may also download a windows shell (Explorer) integration named TortoiseSVN.
    

    You can check out ROME on 3 different ways :

    • If you don't have an afs account at PSI use the anonymous checkout :

    	> svn co svn+ssh://svn@savannah.psi.ch/repos/meg/rome/trunk/rome rome
    	password is 'svn'. The 'svn' password has to be given up to three times.

    • If you have an afs account at PSI you can checkout via direct access :

    > svn co file:///afs/psi.ch/project/meg/svn/rome/trunk/rome rome

    • Alternatively you can use the gateway :

    > svn co svn+ssh://your-afs-username@savannah.psi.ch/repos/meg/rome/trunk/rome rome

    These commands check out the development version (trunk version) of ROME.
    To check out a release version replace
    

    rome/trunk/rome

    with

    rome/tags/rome_v?.? (e.g. rome/tags/rome_v2.7)

    It is possible that you are forced to type the password several times!
    There's a workaround for this problem.
    

    You can check the development notes under SVN log

  ---

• Define Environment Variables

  Define the environment variable ROMESYS and update the path variable by typing :

  	export ROMESYS=/directory/where/you/have/rome	on a bourne shell
  	export PATH=$ROMESYS/bin:$PATH	on a bourne shell
  	setenv ROMESYS /directory/where/you/have/rome	on a c-shell
  	setenv PATH $ROMESYS/bin:$PATH	on a c-shell

  You can write the commands in your .bashrc or something equivalent for you shell so that the setting is used next time you login your computer.

---

• Make the ROMEBuilder

  Go to the rome directory and link the ROMEBuilder by typing :

  	cd $ROMESYS
  	make

---

• Developing your software

  You can try step-by-step to learn the concept of ROME.
  If you are going to use ROME to analyze or monitor MIDAS data, please refer ROME MIDAS instruction.

	Matthias Schneebeli, Ryu Sawada
	e-mail: ryu.sawada@cern.ch