The CMS-specific VM includes the ROOT framework and CMSSW. Follow the instructions below to setup a CERN Virtual Machine on your computer for 2011-2012 CMS Open Data. Then, go to Getting Started with CMS data
VirtualBox is a free, open source and multiplatform application to run virtual machines: you can download the package for your platform from the Downloads page.
You will need administrative ("root") privileges on every platform to perform the installation of VirtualBox.
Note: the latest tested version of VirtualBox working with this CMS-specific CernVM image is 6.0.22. If you have troubles with the latest version of VirtualBox, pick that one: the full history of VirtualBox versions is available on a different page.
Important: Before you download the CernVM, note that the imported settings may not always work on your host machine. Please see Issues and Limitations or the CMS guide to troubleshooting if you encounter any problems with booting the VM.
Next download the CMS-specific CernVM image as OVA file from: CMS VM Image for 2011 CMS Open Data. It is recommended using the version "CMS-OpenData-1.5.2". This VM Image can be used for data from 2011 and 2012 (for data from 2010 follow the instruction in CMS 2010 Virtual Machines: How to install).
By double clicking the downloaded file, VirtualBox imports the image with ready-to-run settings. In VirtualBox version 6, you need to unselect "import disks as VDI" on the initial import screen. Then, you launch the CMS-specific CernVM, which boots into the graphical user interface and sets up the CMS environment. Be patient, it will take a while.
The validation procedure tests that the CMS environment is installed and operational on your virtual machine, and that you have access to the CMS Open Data files. You may skip this step if you want, and head straight to Getting Started with CMS data. However, these steps give you a quick introduction to the CMS environment.
In the "CMS-OpenData-1.5.2" VM, open a terminal from the "CMS Shell" icon from the desktop (only if using the other VM versions, "CMS-Open-Data-1.2.0" or "CMS-Open-Data-1.3.0", open a terminal with the X terminal emulator from an icon bottom-left of the VM screen, in "CMS-OpenData-1.5.1" this will open a shell with an operating system incompatible with the CMS software release to be used).
Execute the following command; this command builds the local release area (the directory structure) for CMSSW, and only needs to be run once (note that it may take a while):
Note that if you get a warning message about the current OS being SLC7, you are using a wrong terminal ("Outer Shell"). Open a "CMS Shell" terminal as explained above and execute the cmsrel command there.
Change to the
Then, run the following command to create the CMS runtime variables:
Create a working directory for the demo analyzer, change to that directory and create a "skeleton" for the analyzer:
mkdir Demo cd Demo mkedanlzr DemoAnalyzer
Compile the code:
cd DemoAnalyzer scram b
You can ignore the message
****WARNING: No need to export library once you have declared your library as plugin. Please cleanup src/Demo/DemoAnalyzer/BuildFile by removing the <export></export> section.
or take action and remove the indicated section from
Change the file name in the configuration file
demoanalyzer_cfg.py in the DemoAnalyzer directory: i.e. replace
Change the max number of events to 10 (i.e change -1 to 10 in
process.maxEvents = cms.untracked.PSet( input = cms.untracked.int32(-1)).
Move two directories back using:
And then run:
You can consider your VM "validated" — i.e it gets access to and compiles the CMS software, and reads the CMS Open Data files — if you get an output like:
16-Mar-2016 15:45:13 CET Initiating request to open file root://eospublic.cern.ch//eos/opendata/cms/Run2011A/ElectronHad/AOD/12Oct2013-v1/20001/001F9231-F141-E311-8F76-003048F00942.root 16-Mar-2016 15:45:17 CET Successfully opened file root://eospublic.cern.ch//eos/opendata/cms/Run2011A/ElectronHad/AOD/12Oct2013-v1/20001/001F9231-F141-E311-8F76-003048F00942.root Begin processing the 1st record. Run 166782, Event 340184599, LumiSection 309 at 16-Mar-2016 15:45:40.234 CET Begin processing the 2nd record. Run 166782, Event 340185007, LumiSection 309 at 16-Mar-2016 15:45:40.235 CET Begin processing the 3rd record. Run 166782, Event 340187903, LumiSection 309 at 16-Mar-2016 15:45:40.236 CET Begin processing the 4th record. Run 166782, Event 340227487, LumiSection 309 at 16-Mar-2016 15:45:40.237 CET Begin processing the 5th record. Run 166782, Event 340210607, LumiSection 309 at 16-Mar-2016 15:45:40.237 CET Begin processing the 6th record. Run 166782, Event 340256207, LumiSection 309 at 16-Mar-2016 15:45:40.238 CET Begin processing the 7th record. Run 166782, Event 340165759, LumiSection 309 at 16-Mar-2016 15:45:40.239 CET Begin processing the 8th record. Run 166782, Event 340396487, LumiSection 309 at 16-Mar-2016 15:45:40.239 CET Begin processing the 9th record. Run 166782, Event 340390767, LumiSection 309 at 16-Mar-2016 15:45:40.241 CET Begin processing the 10th record. Run 166782, Event 340435263, LumiSection 309 at 16-Mar-2016 15:45:40.241 CET 16-Mar-2016 15:45:40 CET Closed file root://eospublic.cern.ch//eos/opendata/cms/Run2011A/ElectronHad/AOD/12Oct2013-v1/20001/001F9231-F141-E311-8F76-003048F00942.root MessageLogger Summary type category sev module subroutine count total 1 fileAction -s file_close 1 1 2 fileAction -s file_open 2 2 type category Examples: run/evt run/evt run/evt 1 fileAction PostEndRun 2 fileAction pre-events pre-events Severity # Occurrences Total Occurrences System 3 3
Please check the validation report for the VM image for our 2010 data, which may contain information useful to you.
Question: The following error message appears when the Virtual Machine is started: "Could not start the machine CMS Open Data because the following physical network interfaces were not found: vboxnet0 (adapter 2). You can either change the machine's network settings or stop the machine."
Answer: Change the Network settings for adapter 2 from "Host-only Adapter" to "NAT". The VM should then start correctly.
Question: What is the root password for the CMS Open Data VM?
Answer: The root password for the CMS Open Data VM is password.
Question: The CMS Open Data VM does not open correctly
Answer: In some versions of VirtualBox, it has happened that the CMS Open Data VM does not open correctly. This was the case for example for VirtulBox 5.0.32, but more recent versions from the VirtualBox website have been tested and are working properly. Note that it can take a while to launch the CMS Open Data VM for the first time.
Question: In VirtualBox version 6, importing the CMS Open Data VM gives an error message '
Answer: Uncheck the default option "Import hard drives as VDI" in the VirtualBox import menu. It may also happen that the folder in which VirtualBox writes the images ('/users/[username]/VirtualBox VMs') does not get created. In this case you can create it manually.
Question: When/after installing CERN VM, I get a message that my VM uses too much memory
Answer: Reduce the memory allocated to VirtualBox by clicking on System in the VirtualBox graphical user interface and adjust the base memory with the sliding bar.
Question: When I try to compile with 'scram b', I get a warning 'SCRAM warning: You are trying to compile/build for architecture slc6_amd64_gcc530 on SLC7 OS which might not work. If you know this SCRAM_ARCH/OS combination works then please first run 'scram build --ignore-arch'.'
Answer: You are very likely in the wrong shell of the VM machine. When using the "CMS-OpenData-1.5.1" VM, all CMSSW-specific commands (compilation, run) must be given in the "CMS Shell", which can be opened from the desk top icon, not in the "Outer shell".
Question: On Ubuntu running the latest version of VirtualBox, an error appears when opening the CMS-specific virtual machine: the message is about a missing path to a definition file.
Answer: To fix this, open one of the (non-CMS-specific) CernVMs first, after which the CMS-specific one should load without the error message.
Question: On Windows 7 and 8, this error message appears: "VT-X/AMD-V hardware acceleration is not available on your system. Your 64-bit guest will fail to detect a 64-but CPU and will not be able to boot."
Answer: Check whether your processor supports the VT-X feature by going to http://ark.intel.com/: Intel® Virtualisation Technology (VT-x) should be checked as "yes". Then, when the host machine is booting (just after switching it on) press the appropriate function key to get to the setup, go to advanced settings, and enable the virtualisation extensions of the CPU. Note that some recent Acer Inspire laptop models do not give access to the VT-X feature in the BIOS setup even if the processor supports it.
Question: The VM does not inherit the keyboard layout of the host machine.
Answer: The layout can be changed by using setxkbmap from a terminal inside the Virtual Machine. For example a user with a Swiss keyboard with French variant would type
setxkbmap 'ch(fr)'in the terminal and a user with a Finnish keyboard would type
setxkbmap fi. This can also be solved by using the GUI, which can be launched either from the graphical menu in the lower left corner (Preferences → Keyboard) or by typing in the console: xfce4-keyboard-settings. In the Layout tab it is possible to change the keyboard model and the layout. If you wish to keep these settings after reboot, you should delete all the other layouts from the menu.
Question: The default terminal does not accept (not even from the clipboard) nor display certain language-specific characters such as umlauts.
Answer: Using a terminal such as xterm will allow reading and writing special characters.
Question: Users who use high resolutions on small displays and have set their host machines DPI manually, for example through .Xresources on Linux (X11), may find that everything is too small to be read efficiently. (Also helpful to users who have difficulties in reading the fonts and other visual information on the image due to the size of the graphical components.)
Answer: The DPI can easily be adjusted from Xfce menu → Preferences → Appearance → Fonts → DPI. This enhances the readability and general usability significantly.
Question: Resizing the VM window doesn't resize its contents.
Answer: This appears to only occur when a new VM image is launched for the first time. The contents should resize after several minutes (up to half an hour), and the problem should not manifest when the VM image is opened a second time.