ECE 264 Advanced C Programming Fall 2014
	HOWTO
	  
 
 
	How to connect to the ECE cluster
	Option A: Work in the lab
	The simplest way to do these assignments is to do them in the lab (ECE 206). 
	Option B: Mac, Linux, or Cygwin command line
	ssh aq@ecegrid.ecn.purdue.edu 
	Option C: PuTTY
	- 
		Download PuTTY if you haven't done so already.
 
	- 
		Open PuTTY and enter 
aq@ecegrid.ecn.purdue.edu for the host name. 
 
	Option D: ThinLinc client application
	- 
		Download and install the ThinLinc client software on your computer.
 
	- 
		Start ThinLinc.
 
	- 
		Enter ecegrid.ecn.purdue.edu as the host name.
 
	- 
		Log in with your Purdue username and password.
 
 
	To exit ThinLinc, press F8 and select Disconnect session. 
	This option has a known issue. Sometimes after logging in, you may find that the screen is blank. If that happens, you might try disconnecting the ThinLinc session, restarting ThinLinc, selecting End existing session, and logging in again. If that fails, you may need to try one of the other options above. 
	Option E: ThinLinc web interface
	- 
		Go to http://ecegrid.ecn.purdue.edu .
 
	- 
		Log in with your Purdue username and password.
 
 
	This option also has a known issue. Sometimes, after logging in, it may be unresponsive. If that happens, try one of the other options above. 
	How to download the homework assignments from the public course repository
	- 
		Make a directory for this class.
 
		mkdir ece264 
		  
	- 
		Change into the directory you just created.
 
		cd ece264 
		  
	- 
		Clone the public course repository. This downloads all of the assignments.
 
		git clone https://github.com/yunghsianglu/ECE264Assignments.git 
 
	How to update the homework assignments with changes
	git pull 
	How to set up a private repository
	- 
		Get a "micro" account for free on GitHub.
		
			- 
				Go to http://education.github.com .
 
			- 
				Click Request a discount.
 
			- 
				Sign into your GitHub account. If you don't already have one, you will need to create a "free" account.
 
			- 
				Select Student and Individual account.
 
			- 
				Select your Purdue email address and verify it.
 
			- 
				Enter your name.
 
			- 
				Add and verify your Purdue email address.
 
			- 
				Enter your school name ("Purdue University").
 
			- 
				For "How do you plan to use GitHub" you might type "required for class work".
 
			- 
				Click Next.
 
			- 
				Wait for an email from GitHub confirming that your application has been approved. The web page says it may take up to a week, but it normally takes less than 1 minute.
 
				  
		 
	 
	- 
		Create a repository
		
			- 
				Go to https://github.com/new .
 
			- 
				Enter "ece264hw" (for example) as the repository name.
 
			- 
				Select Private.
 
			- 
				Clone your blank repository.  The first line of this 
 
				unset SSH_ASKPASS 
				git clone https://alexquinn@github.com/alexquinn/ece264hw.git 
				The first line of that (unset SSH_ASKPASS) is a workaround for this issue with the password prompt.  To avoid typing it each time, you could add it to your .bashrc file. 
			- 
				Set some git configuration variables
 
				git config --global user.name "Alex Quinn" 
				git config --global user.email "aq@purdue.edu" 
				  
		 
	 
	- 
		Add the homework starter files to your blank repository.
		
			- 
				cp -R ~/ece264/ECE264Assignments/Fall2014/PA01 .
 
			- 
				git add *
 
			- 
				git commit -a -m "Add assignment #1 starter files"
 
			- 
				git push origin
 
			- 
				Go to https://github.com/
alexquinn/ece264hw to verify that your code has been pushed to GitHub. 
		 
	 
 
	How to add more files to your private repository
	- 
		Add the changes to your local repository.
 
		git add some_new_file.txt 
		  
	- 
		Commit the changes to your local repository.
 
		git commit -a -m "adding … because …" 
		  
	- 
		Push the changes to the remote repository.
 
		git push origin master 
 
	How to commit your recent code changes to your private repository
	- 
		Commit the changes to your local repository.
 
		git commit -a -m "adding … because …" 
		  
	- 
		Push the changes to the remote repository.
 
		git push origin master 
 
	How to transfer your ZIP file from the ECE cluster back to your local computer
	Option A: Mac, Linux, or Cygwin command line
	scp aq@ecegrid.ecn.purdue.edu:ece264/ece264hw/PA01/pa01.zip . 
	Option B: Windows command line using pscp (part of PuTTY)
	This will copy your ZIP file (pa01.zip) to your desktop. 
	- 
		Make sure the pscp command is on your system's PATH variable.
 
	- 
		pscp 
aq@ecegrid.ecn.purdue.edu:ece264/ece264hw/PA01/pa01.zip %USERPROFILE%\Desktop 
 
	Option C: Mount home directory
	If you have already mounted your Purdue home directory on your local computer, then it may be trivial to copy your pa01.zip file over. 
  
      
      
     |