Difference between revisions of "New Project Participants"

From Embedded Xinu
Jump to navigation Jump to search
(Linked to wikipedia article on Subversion)
(Mark page as obsolete)
 
(6 intermediate revisions by one other user not shown)
Line 1: Line 1:
This page contains details for newcomers to the XINU project who want to get started working in the lab and coding with XINU.
+
{{Historical}}
 +
 
 +
This page is obsolete; see [[Git|here]] for information about using git.
  
 
= Subversion =
 
= Subversion =
 
The code for XINU is stored in a [[wikipedia:Subversion_(software) | Subversion]] code repository.
 
The code for XINU is stored in a [[wikipedia:Subversion_(software) | Subversion]] code repository.
  
In order to access the code you need to have your ssh public key registered
+
You have two ways of accessing the code:
with the 'svn' user.  Please email or link to your public key to
+
* over HTTPS
be added.  If you do not yet have an ssh keypair, here is a document
+
* over SSH
that explains the why and the how pretty well:
+
 
 +
For detailed usage information, head over to our [[Subversion Primer]].
 +
 
 +
== Over HTTPS ==
 +
To access the repository over HTTPS you'll need to contact the MULUG system administrator and he/she will generate a password for you (it can be changed later, do not fear).  Once you have an account, you can access the repositories at:
 +
 
 +
https://xinu.mscs.mu.edu/svn/mips/trunk
 +
 
 +
Or some sort of URL.
 +
 
 +
== Over SSH ==
 +
If you want to access the code via SSH, you will need to create and register your public key with the 'svn' user on MULUGThere is good document that details generating an SSH keypair at:
  
 
http://kb.iu.edu/data/aews.html
 
http://kb.iu.edu/data/aews.html
 +
 +
After the key is generated please email (or link) your public SSH key to the current repository administrator to be added.
  
 
Once your key has been registered, you can do a test checkout with the
 
Once your key has been registered, you can do a test checkout with the
 
following command:
 
following command:
  
svn co svn+ssh://svn@mulug.mscs.mu.edu/xinu-mips/trunk xinu
+
svn co svn+ssh://svn@xinu.mscs.mu.edu/mips/trunk xinu
  
 
You can also switch an existing working copy with the following from
 
You can also switch an existing working copy with the following from
Line 21: Line 36:
 
<pre>
 
<pre>
 
FROM=`svn info | grep ^URL | awk '{ print $2 }'`
 
FROM=`svn info | grep ^URL | awk '{ print $2 }'`
svn switch --relocate $FROM svn+ssh://svn@mulug.mscs.mu.edu/xinu-mips/trunk
+
svn switch --relocate $FROM svn+ssh://svn@xinu.mscs.mu.edu/mips/trunk
 
unset FROM
 
unset FROM
 
</pre>
 
</pre>
Line 36: Line 51:
 
Trac has several nice ways of visualizing activity in the Subversion
 
Trac has several nice ways of visualizing activity in the Subversion
 
repository, including a source code browser and a timeline.  It also
 
repository, including a source code browser and a timeline.  It also
has a wiki, which I assume we'll mostly skip, and at it's center
+
has a wiki, which we try to use for internal documentation, and at it's center
 
is an issue tracking system, which I suggest we consider as a way to
 
is an issue tracking system, which I suggest we consider as a way to
 
consolidate our various and sundry todo lists.
 
consolidate our various and sundry todo lists.
  
http://xinu.mscs.mu.edu/trac/
+
https://xinu.mscs.mu.edu/trac/
  
As for user accounts on this guy, I have it set up to do mod_auth_digest
+
As for user accounts, if you have a password to access the repository via HTTPS it is the same for logging into trac.  If you do not have on, please email the MULUG system administrator to set one up or generate your own with the following command:
right now, which means if you run the following command and email me the
 
password file I can add you to the list of users:
 
  
<pre>
+
htdigest -c <mypassfile> "XINU Project Repositories" <username>
htdigest -c <mypassfile> "Embedded XINU Trac Login" <username>
 
</pre>
 
  
Then you go to [http://xinu.mscs.mu.edu/trac/login/ /trac/login] which will authenticate you, after which the
+
After your account has been setup you can simply visit the trac URI, log in, and start editing!
site will recognize you as a logged-in user.  Then you can edit wiki
 
pages and create tickets and such.
 

Latest revision as of 22:17, 11 September 2013

✘ This page is currently inactive and is retained primarily for historical interest.
A historical page is usually one that is no longer maintained or no longer relevant.

This page is obsolete; see here for information about using git.

Subversion

The code for XINU is stored in a Subversion code repository.

You have two ways of accessing the code:

  • over HTTPS
  • over SSH

For detailed usage information, head over to our Subversion Primer.

Over HTTPS

To access the repository over HTTPS you'll need to contact the MULUG system administrator and he/she will generate a password for you (it can be changed later, do not fear). Once you have an account, you can access the repositories at:

https://xinu.mscs.mu.edu/svn/mips/trunk

Or some sort of URL.

Over SSH

If you want to access the code via SSH, you will need to create and register your public key with the 'svn' user on MULUG. There is good document that details generating an SSH keypair at:

http://kb.iu.edu/data/aews.html

After the key is generated please email (or link) your public SSH key to the current repository administrator to be added.

Once your key has been registered, you can do a test checkout with the following command:

svn co svn+ssh://svn@xinu.mscs.mu.edu/mips/trunk xinu

You can also switch an existing working copy with the following from your working copy's directory:

FROM=`svn info | grep ^URL | awk '{ print $2 }'`
svn switch --relocate $FROM svn+ssh://svn@xinu.mscs.mu.edu/mips/trunk
unset FROM

You will be asked for the passphrase that you specified for your private key every time you perform a svn command that needs the server. This is because svn is not locally caching your password in plaintext as it was before (no plaintext cache = better). I highly recommend using a memory-caching tool like ssh-agent to prevent having to repeatedly enter your passphrase.

Trac

Trac has several nice ways of visualizing activity in the Subversion repository, including a source code browser and a timeline. It also has a wiki, which we try to use for internal documentation, and at it's center is an issue tracking system, which I suggest we consider as a way to consolidate our various and sundry todo lists.

https://xinu.mscs.mu.edu/trac/

As for user accounts, if you have a password to access the repository via HTTPS it is the same for logging into trac. If you do not have on, please email the MULUG system administrator to set one up or generate your own with the following command:

htdigest -c <mypassfile> "XINU Project Repositories" <username>

After your account has been setup you can simply visit the trac URI, log in, and start editing!