Skip to content

Latest commit

 

History

History
65 lines (42 loc) · 6.8 KB

setup.md

File metadata and controls

65 lines (42 loc) · 6.8 KB
title questions
Setup
What accounts do I need to perform my work on CMS?
How do I obtain and install a grid certificate?
Who can I contact if I need help with the pre-exercises?

These instructions are for attendees of the {{ site.year }} CMS Data Analysis School at the Fermilab LHC Physcis Center. Others can follow the instructions specific to Fermilab site and computing access, but the chats and support sections will not be active outside the school.

Mattermost (chat)

There is a dedicated Mattermost team, called [CMSDAS@LPC {{ site.year }}]({{ site.mattermost_invitelink }}), created to facilitate communication and discussions via live chat (which is also archived). Please join the team now! This is how most of the real-time communication will take place during the school.

If you have never used Mattermost at CERN, start by clicking on the links above, and login with CERN SSO (single sign-on). The link above should auto-join you to the CMSDAS "Team"; you can also find it by searching (click "+" in your list of teams; not channels, mind!).

If you already have used Mattermost at CERN, please know that when you click direct links to channels (as you will find below) that are within the CMSDAS@LPC {{ site.year }} team, you may be redirected to the last Mattermost team you used. If this happens, remember to click the [signup link to join the CMSDAS@LPC {{ site.year }} team]({{ site.mattermost_invitelink }})) to switch to the correct team from which you should be able to see the individual channels. If that still doesn't work, remove all cookies associated with cern.ch and restart your browser.

The [PreExercisesChannel](https://mattermost.web.cern.ch/cmsdaslpc{{ site.year }}/channels/preexercises) will be available once you join or switch to the CMSDAS@LPC {{ site.year }} team!

Note that you can access Mattermost via browser or you can download the corresponding application running standalone on your laptop or smartphone. The laptop application does not work with CERN certificate login.

Support email

For CMSDAS@LPC {{ site.year }}, you may e-mail [email protected] with a detailed description of your problem. The instructors will be happy to help you.

Obtain a Computer Account

To get a CERN account, please have a look at Get Account at CERN. Obtaining a CERN account can be time-consuming and requires response from people at CERN during CERN business hours. CERN is closed for the winter holiday (Dec. 21, 2024 - Jan. 5, 2025). CERN account application starts with the institutional team leader filling out a pre-registration form, so your institutional team leader also needs to be available for this task.

Site specific instructions

Here are some additional links in case you are using Windows:

Warning

If you are attending CMSDAS at the LPC, you should do the pre-exercises on the cmslpc-el8.fnal.gov cluster using the computer you intend to use at CMSDAS. {: .caution}

Obtain a Grid Certificate and CMS VO Registration

A Grid Certificate and CMS VO registration will be needed for the next set of exercises. The registration process can be time-consuming (actions by several people are required), so it is important to start it as soon as possible. There are two main requirements which can be simply summarized: A certificate ensures that you are who you claim to be. A registration in the VO recognizes you (identified by your certificate) as a member of CMS. Use the following link for this: Fermilab guide to getting CMS CERN grid certificate and CMS VO. Both are needed to submit jobs to the grid and access files remotely using XRootD. Make sure you follow any additional instructions for US-CMS users.

Obtain a GitHub Account

Most CMS software is hosted on [GitHub]. [GitHub] is a Git repository web-based hosting service, while git is a distributed version control system. In your future analysis work, version control of your analysis code will become a very important task and git will be very useful.

In order to checkout and develop CMS software, you will need a github account, which is free.

  • In case you don’t have one already, simply go to https://github.com/join and follow the instructions to create a new account. Choose your username wisely, ideally based on your actual name, as it will be used to sign all of your contributions to CMS code!
  • In case you already have an account you can simply use the "Sign in" dialog and put your username and password.
  • Make sure you register an SSH key in [GitHub], following these instruction. Remember, when you generate an SSH key, two files are generated; the public key (ending in .pub) is uploaded to github.com, while the private key (not ending in .pub) is put on cmslpc at ~/.ssh/. Make sure the permissions of your private key are set using chmod 600 ~/.ssh/id_rsa. You can register more than one SSH key and it's usually a good idea to do so for every computer/cluster on which you regularly work (i.e. your laptop, cmslpc, your university cluster, etc.). You don't need to use an ssh-agent, but you can try if you want to. For more about ssh-agents, see CMSGitTutorial#SSH_agent_in_logon_file.
  • You may also find it useful to launch ssh-agent at login time. Instructions are at CMSGitTutorialPublic#bash .

Windows specific setup

If you would like to use cygwin, you will need to install winpty and prefix your docker command like winpty docker. Windows Subsystem for Linux can also be used; once installed (whichever flavor of Linux you prefer), you can largely follow the Unix instructions.

{% include links.md %}