WebFund 2013F: Tutorial 1 - Revision history

Soma at 14:44, 6 September 2013

2013-09-06T14:44:00Z

← Older revision		Revision as of 14:44, 6 September 2013
Line 1:		Line 1:
	For this class you will be using a [http://www.lubuntu.net/ Lubuntu] virtual machine appliance. We will be using [https://www.virtualbox.org/ VirtualBox] as our preferred virtualization platform; however, VMware Workstation/Fusion and other virtualization platforms should be able to run the appliance as well. In this first tutorial you will be becoming familiar with [http://nodejs.org/ node.js]-based development environment provided by this appliance.		For this class you will be using a [http://www.lubuntu.net/ Lubuntu] virtual machine appliance. We will be using [https://www.virtualbox.org/ VirtualBox] as our preferred virtualization platform; however, VMware Workstation/Fusion and other virtualization platforms should be able to run the appliance as well. In this first tutorial you will be becoming familiar with [http://nodejs.org/ node.js]-based development environment provided by this appliance.

			To get credit for this lab, show a TA or the instructor that you have completed all of the following steps.

			If you finish early (which you are likely to do), try exploring node and the Lubuntu environment. You will be using them a lot this semester!

	==Running the VM==		==Running the VM==

Soma: /* Saving your work */

2013-09-06T14:42:22Z

Saving your work

← Older revision		Revision as of 14:42, 6 September 2013
Line 57:		Line 57:

	==Saving your work==		==Saving your work==

			You can save your work to your SCS account by running

			save2406 <SCS username>

			This will rsync /home/student to the COMP2406 directory in your SCS account by connecting to access.scs.carleton.ca.

			When you wish to restore your student account, run

			restore2406 <SCS username>

			Note that both of these commands are destructive - they will wipe out all the files in the COMP2406 folder on SCS or /home/student in your VM. If you want to see what the differences are between the two versions, run

			compare2406 <SCS username>

Soma: /* Simple Changes */

2013-09-06T14:38:56Z

Simple Changes

← Older revision		Revision as of 14:38, 6 September 2013
Line 51:		Line 51:
	==Simple Changes==		==Simple Changes==

			Now that you have an app up and running, use geany to edit to make the following simple changes:
			* Change the default port to 2000 (<tt>app.js</tt>)
			* Change the title to "My First Web App" (<tt>routes/index.js</tt>)
			* Get rid of the default stylesheet (<tt>views/layout.jade</tt>)

	==Saving your work==		==Saving your work==

Soma: /* Running the VM */

2013-09-06T14:00:04Z

Running the VM

← Older revision		Revision as of 14:00, 6 September 2013
Line 4:		Line 4:

	In the SCS labs you should be able to run the VM by starting Virtualbox (listed in the Applications menu) and selecting the COMP 2406 or Lubuntu virtual machines. After the VM has fully booted up you can login to the student account using the password "tneduts!". This account has administrative privileges; in addition, there is the admin account in case your student account gets corrupted for any reason. The password for it is "nimda!".		In the SCS labs you should be able to run the VM by starting Virtualbox (listed in the Applications menu) and selecting the COMP 2406 or Lubuntu virtual machines. After the VM has fully booted up you can login to the student account using the password "tneduts!". This account has administrative privileges; in addition, there is the admin account in case your student account gets corrupted for any reason. The password for it is "nimda!".

			We highly recommend running your VM in full-screen mode. Do all of your work inside of the VM; it should be fast enough and you won't have any issues with sharing files or with firewalls.

	If you want to run the appliance on your own system (running essentially any desktop operating system you want), just download the [http://homeostasis.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova Lubuntu.ova] [http://people.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova (alternate source)] virtual appliance file and import. If the application is not VirtualBox, you'll need to:		If you want to run the appliance on your own system (running essentially any desktop operating system you want), just download the [http://homeostasis.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova Lubuntu.ova] [http://people.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova (alternate source)] virtual appliance file and import. If the application is not VirtualBox, you'll need to:

Soma: /* Your First Web App */

2013-09-06T13:58:47Z

Your First Web App

← Older revision		Revision as of 13:58, 6 September 2013
Line 32:		Line 32:
	==Your First Web App==		==Your First Web App==

			Web applications, even simple ones, are a bit more complex than our "Hello, world!" example. Fortunately in node we have the [http://expressjs.com/ express] web application framework to make getting up and running quite easy.

			In a terminal window, run the following commands:

			express first
			cd first
			npm install
			node app.js

			You should get a message at the end saying that your app is listening on port 3000. To see what your app is doing, start up a web browser in your VM and visit the following URL:

			http://localhost:3000

			You should see a message from your first web application!

	==Simple Changes==		==Simple Changes==

Soma: /* Hello, World! */

2013-09-06T12:14:15Z

Hello, World!

← Older revision		Revision as of 12:14, 6 September 2013
Line 28:		Line 28:
	You can also run node interactively by simply running <tt>node</tt> with no arguments. You'll then get a prompt where you can enter any code that you like and see what it does. To exit this environment, type Control-D.		You can also run node interactively by simply running <tt>node</tt> with no arguments. You'll then get a prompt where you can enter any code that you like and see what it does. To exit this environment, type Control-D.

	Note that when run interactively, we say that node is running a "read-eval-print" loop. It reads input, evaluates it, and then prints the results. This structure is very old in computer science, going back to the first LISP interpreters from the early 1960's.		Note that when run interactively, we say that node is running a [http://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop read-eval-print loop] (REPL). It reads input, evaluates it, and then prints the results. This structure is very old in computer science, going back to the first LISP interpreters from the early 1960's.

	==Your First Web App==		==Your First Web App==

Soma: /* Hello, World! */

2013-09-06T12:12:37Z

Hello, World!

← Older revision		Revision as of 12:12, 6 September 2013
Line 27:		Line 27:

	You can also run node interactively by simply running <tt>node</tt> with no arguments. You'll then get a prompt where you can enter any code that you like and see what it does. To exit this environment, type Control-D.		You can also run node interactively by simply running <tt>node</tt> with no arguments. You'll then get a prompt where you can enter any code that you like and see what it does. To exit this environment, type Control-D.

			Note that when run interactively, we say that node is running a "read-eval-print" loop. It reads input, evaluates it, and then prints the results. This structure is very old in computer science, going back to the first LISP interpreters from the early 1960's.

	==Your First Web App==		==Your First Web App==

Soma: /* Hello, World! */

2013-09-06T12:07:10Z

Hello, World!

← Older revision		Revision as of 12:07, 6 September 2013
Line 15:		Line 15:
	==Hello, World!==		==Hello, World!==

			To create your first node application, start the [http://www.geany.org/ geany] code editor under the Programming LXDE start menu (the icon in the bottom right of the screen). In it, create a file <tt>hello.js</tt> in your Documents folder with the following contents:

			console.log("Hello World!");

			You can now run this file by opening an LXTerminal (under Accessories) and typing:

			cd Documents
			node hello.js

			And you should see <tt>Hello, World!</tt> output to your terminal.

			You can also run node interactively by simply running <tt>node</tt> with no arguments. You'll then get a prompt where you can enter any code that you like and see what it does. To exit this environment, type Control-D.

	==Your First Web App==		==Your First Web App==

Soma: /* Running the VM */

2013-09-06T11:46:13Z

Running the VM

← Older revision		Revision as of 11:46, 6 September 2013
Line 7:		Line 7:
	If you want to run the appliance on your own system (running essentially any desktop operating system you want), just download the [http://homeostasis.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova Lubuntu.ova] [http://people.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova (alternate source)] virtual appliance file and import. If the application is not VirtualBox, you'll need to:		If you want to run the appliance on your own system (running essentially any desktop operating system you want), just download the [http://homeostasis.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova Lubuntu.ova] [http://people.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova (alternate source)] virtual appliance file and import. If the application is not VirtualBox, you'll need to:
	* Have the VM platform ignore any errors in the structure of the appliance;		* Have the VM platform ignore any errors in the structure of the appliance;
	* Uninstall the VirtualBox guest additions by typing starting a terminal application and running ~~<tt>~~sudo /opt/VBoxGuestAdditions-4.2.16/uninstall.sh~~</tt>~~		* Uninstall the VirtualBox guest additions by typing starting a terminal application and running
			sudo /opt/VBoxGuestAdditions-4.2.16/uninstall.sh
	* Install your platform's own Linux guest additions, if available.		* Install your platform's own Linux guest additions, if available.

Soma at 11:45, 6 September 2013

2013-09-06T11:45:03Z

← Older revision		Revision as of 11:45, 6 September 2013
Line 1:		Line 1:
			For this class you will be using a [http://www.lubuntu.net/ Lubuntu] virtual machine appliance. We will be using [https://www.virtualbox.org/ VirtualBox] as our preferred virtualization platform; however, VMware Workstation/Fusion and other virtualization platforms should be able to run the appliance as well. In this first tutorial you will be becoming familiar with [http://nodejs.org/ node.js]-based development environment provided by this appliance.

	==Running the VM==		==Running the VM==

			In the SCS labs you should be able to run the VM by starting Virtualbox (listed in the Applications menu) and selecting the COMP 2406 or Lubuntu virtual machines. After the VM has fully booted up you can login to the student account using the password "tneduts!". This account has administrative privileges; in addition, there is the admin account in case your student account gets corrupted for any reason. The password for it is "nimda!".

			If you want to run the appliance on your own system (running essentially any desktop operating system you want), just download the [http://homeostasis.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova Lubuntu.ova] [http://people.scs.carleton.ca/~soma/webfund-2013f/Lubuntu.ova (alternate source)] virtual appliance file and import. If the application is not VirtualBox, you'll need to:
			* Have the VM platform ignore any errors in the structure of the appliance;
			* Uninstall the VirtualBox guest additions by typing starting a terminal application and running <tt>sudo /opt/VBoxGuestAdditions-4.2.16/uninstall.sh</tt>
			* Install your platform's own Linux guest additions, if available.

			Note as we will explain, you will have the ability to easily save the work you do from any VM to your SCS account and restore it to any other copy of the class VM. Thus feel free to play around with VMs; if you break anything, you can always revert. Remember though that in the labs you '''must''' save and restore your work; the any changes you make to them during your session are otherwise deleted upon logout!

	==Hello, World!==		==Hello, World!==