Difference between revisions of "Code repositories"

From MCEWiki
Line 1: Line 1:
 
[[MAS]] and [[MCE script]] are housed in separate Subversion (SVN) repositories on <tt>e-mode.phas.ubc.ca</tt>, accessible from anywhere on the internet.  The core MAS repository is called '''mas'''.  The MCE script repository is called '''mce_script'''.
 
[[MAS]] and [[MCE script]] are housed in separate Subversion (SVN) repositories on <tt>e-mode.phas.ubc.ca</tt>, accessible from anywhere on the internet.  The core MAS repository is called '''mas'''.  The MCE script repository is called '''mce_script'''.
  
<!--  
+
To check out the code you will need a SVN user id (and password).  For read-only access, accounts are often given out on a per-experiment basis.  Committing to the repository requires a personal account.  For account information, contact UBC.
== SSH Tunneling for SVN ==
 
  
Sometimes, you may want to tunnel the SVN port.  This isn't necessary now that the server is on e-mode, but in any case it's done like this:
+
== MAS ==
  
ssh mhasse@phas.ubc.ca -N -L 3690:e-mode.phas.ubc.ca:3690
+
Everyone should be using <tt>mas/trunk</tt> these days.  (In the past we suggested branching the MAS repository on a per-experiment basis but MAS is now stable enough that this is no longer necessary.)  Only <tt>mas/trunk</tt> is currently maintained for Ubuntu 10.04 and 12.04.
 
 
You can replace "mhasse@phas.ubc.ca" with your username@any machine behind the physics firewall that you have access to.  This command will ask for your password, and then remain open.  As long as this command is running, you can do svn operations using the address "svn://localhost/..." and they will be redirected to e-mode.
 
 
 
-->
 
== Checkout ==
 
 
 
=== MAS ===
 
 
 
Everyone should be using <tt>mas/trunk</tt> these days.  (In the past we suggested branching the MAS repository on a per-experiment basis, as is done for MCE script, but MAS is now stable enough that this is no longer necessary.)  Only <tt>mas/trunk</tt> is currently maintained for Ubuntu 10.04 and 12.04.
 
  
 
MAS uses the GNU autotools for a bit of configuration work. You should checkout MAS into a user source folder somewhere:
 
MAS uses the GNU autotools for a bit of configuration work. You should checkout MAS into a user source folder somewhere:
  
 
  cd src/
 
  cd src/
  svn checkout --username=''<my_svn_id or my_experiment_name>'' svn://e-mode.phas.ubc.ca/mas/trunk mas
+
  svn checkout --username=''<svn_id>'' svn://e-mode.phas.ubc.ca/mas/trunk mas
  
=== MCE Script ===
+
== MCE Script ==
  
The top-level structure of the mce_script repositories is, roughly:
+
Everyone should be using <tt>mce_script/trunk</tt> these days.  (In the past we suggested branching mce_script on a per-experiment basis but MCE Script is now stable enough that this is no longer mecessary.)
  
  --+--trunk
+
We also now suggest people check mce_script in a user source folder somewhere, and install it into <tt>/usr/mce/mce_script</tt> (or wherever they want the public copy to go) using the supplied Makefile. (In the past checking out mce_script directly into /usr/mce was suggested).
    +--branch--+--experiment1
 
                +--experiment2
 
                +-- ...
 
  
Depending on whether you want the trunk (UBC users or read-only for other users), or your experiment's branch, you should use either
+
To check out MCE script:
  MY_BRANCH=trunk
 
  MY_USER=my_svn_id
 
or
 
  MY_BRANCH=branch/my_experiment_name
 
  MY_USER=my_experiment_name
 
  
If you have a personal svn id, you should use it.  Sometimes.
+
  cd src/
 
+
  svn checkout --username=''<svn_id>'' svn://e-mode.phas.ubc.ca/mce_script/trunk mce_script
Since things in mce_scripts tend to get edited more often than MAS, it should be checked-out directly into /usr/mce.  The /usr/mce directory should be created automatically when you "sudo make install" the mas source.  If you can't wait that long, create it manually:
 
 
 
sudo mkdir /usr/mce
 
sudo chgrp mce /usr/mce
 
sudo chmod g+wxs /usr/mce
 
 
 
Then checkout mce_script:
 
 
 
  cd /usr/mce
 
  svn checkout --username=$MY_USER svn://e-mode.phas.ubc.ca/mce_script/$MY_BRANCH  mce_script
 
 
 
(You need to be in the <tt>mce</tt> group to get away with the checkout... 'usermod -a -G mce <username>' )
 

Revision as of 16:48, 9 July 2012

MAS and MCE script are housed in separate Subversion (SVN) repositories on e-mode.phas.ubc.ca, accessible from anywhere on the internet. The core MAS repository is called mas. The MCE script repository is called mce_script.

To check out the code you will need a SVN user id (and password). For read-only access, accounts are often given out on a per-experiment basis. Committing to the repository requires a personal account. For account information, contact UBC.

MAS

Everyone should be using mas/trunk these days. (In the past we suggested branching the MAS repository on a per-experiment basis but MAS is now stable enough that this is no longer necessary.) Only mas/trunk is currently maintained for Ubuntu 10.04 and 12.04.

MAS uses the GNU autotools for a bit of configuration work. You should checkout MAS into a user source folder somewhere:

cd src/
svn checkout --username=<svn_id> svn://e-mode.phas.ubc.ca/mas/trunk mas

MCE Script

Everyone should be using mce_script/trunk these days. (In the past we suggested branching mce_script on a per-experiment basis but MCE Script is now stable enough that this is no longer mecessary.)

We also now suggest people check mce_script in a user source folder somewhere, and install it into /usr/mce/mce_script (or wherever they want the public copy to go) using the supplied Makefile. (In the past checking out mce_script directly into /usr/mce was suggested).

To check out MCE script:

cd src/
svn checkout --username=<svn_id> svn://e-mode.phas.ubc.ca/mce_script/trunk mce_script