This lab will introduce version control with a tool called Subversion. Before you can use Subversion, you need to complete the following setup steps.
Before you start
If you will be using a PC provided in a Lab environment for today's Lab exercise, then you can skip and move on to Creating a Subversion Repository. Otherwise, you will be using your own computer: these are steps that you should have already completed as part of today's homework. If you haven't, you will have to start here. Otherwise, you can move on to the next section.
- Install and configure the Pulse VPN client on your computer following these instructions.
- If you have a MS Windows computer, you also need to install an SSH client like Putty.
Also note that you need to have installed the Subclipse plugin as described in Environment Setup on Your Own Computer—Downloading and Installing Plugins (steps 13-15). Without this plugin you will not be able to work on today's lab or share your work with your teammate(s).
Connect to the COE Network with PulseVPN
From now on, whenever you want to share your work on a lab or project with your teammate(s), or you want to access your Subversion repository (see below), while using your own computer, you must run the PulseVPN client and make a connection to the College of Engineering network. This is not necessary when using a lab Windows PC or a connection through Citrix Workspace.
Creating a Subversion Repository (only one member per team)
To share your projects and keep track of the history of the changes to the projects, you will need to set up a Subversion repository. This is a simple task that only one team member must handle.
The repository for your team will reside on coelinux. [coelinux stands for "College of Engineering Linux" and it is a Linux server accessible to all students taking CSE classes.] A group directory for your team has been created on coelinux. One team member must first open an ssh connection to coelinux.coeit.osu.edu. Instructions are available at Connecting to coelinux with ssh. Once connected, to find your group and group directory:
- In the terminal window enter the command:
groups - You should see (among other things) something like "cse-c2231axnn" where x is your section letter (e.g., 'a', 'b', 'c', ...) and nn is your team number (a two digit number). That's your group for the semester, and your group's project directory (where you will create your Subversion repository) is /share/CSE/project/c2231axnn. If you do not see such a group listed, call an instructor to learn your group name and use this name as the group argument to the create-repo command (see below). In the instructions below, make sure to replace c2231axnn with your team group.
Once you have identified your project directory, enter the following commands to create the repository and check the results. Again, these steps should only be comppleted by one team member and only once (today) for the whole semester. Make sure you do not skip or mistype any of these commands:
cd /share/CSE/project/c2231axnn(where c2231axnn is your team group)/share/CSE/class/software/bin/create-repo
(if you get the error "Command not found" double check the command you typed and try again; if instead you get the following message:Not in a 2231 group; checking for group argument No group argument: try to run this script with your group (c2231axnn) as the only argument
try the command:/share/CSE/class/software/bin/create-repo c2231axnn(where c2231axnn is your team group)).ls -l(note that the second character in -l in this command is the letter 'l' ("el"))
This last command should list the contents of your project directory and should display something similar to this (but with different user name, group, and date/time):
total 4 drwxrws---. 6 jesse cse-c2231af24 4096 May 12 15:27 repos
It is essential that the permissions for the repos directory look like this: drwxrws---. If they don't, call an instructor who will help you fix them.
That's it! Your team repository has been created.
Introduction to Version Control With Subversion
Now you can move on to the actual lab at Introduction to Version Control With Subversion. Here is a reminder of the step you will have to repeat throughout the semester while using your own computer when you want to use Eclipse to access your repository: establish a VPN connection to the COE network with the PulseVPN client (instructions to set up PulseVPN).
Remember that you need to have installed the Subclipse plugin as described in Downloading and Installing Plugins (steps 13-15) . Without this plugin on your computer you will not be able to complete the lab and share your work with your teammate(s) in the future. And, only when using your own computer (this is not needed if you are using a lab computer), and if you haven't yet, you need to visit the following web page and follow its instructions: https://cse22x1.engineering.osu.edu/2231/web-sw2/extras/instructions/environment-setup/home-vm-for-Eclipse-setup.html.