Get Setup!
Due: 09-04
Please do the following:
Sign up for github.com if you haven't do so already.
-
Install git
-
We highly suggest you create a directory called
workspace
(or whatever name) that will serve as the root for all your work:mkdir workspace; cd workspace
-
Clone this repository:
https://github.com/alexmilowski/iolab.git
git clone https://github.com/alexmilowski/iolab.git
-
Install a local Web server for testing. You'll need this because certain security rules require scripts and requests to come from a Web server and not from local files. You have choices:
Apache2 — classic, well known, stable.
NGINX — super fast, popular, complex to configure.
Jetty — light weight, Java servlet container, embeddable.
Tomcat — Java servlet container, well known, stable, and a 1000lb tank.
XProclet — my project that uses Restlet, light weight, stable, and
simple
to configure.
It doesn't hurt to try more than one.
To test a Web server: .
- Locate the 'examples/web' directory in the iolab git repository
- Locate the documentation for your chosen Web server.
- Configure the Web server to listen on port 8080.
- Configure the Web server to serve 'examples/web' as the root (e.g. '/').
- Open http://localhost:8080/ in your favorite browser.
- If you get a 'Congratulations' message, you have successfully configured the server.
Find one that fits your style. How hard was it to use? Does it have the features you want?
Note: You'll need Java for Jetty, Tomcat, and XProclet.
Install other software you may want:
- oXygen - an IDE for web authoring, projects, and very XML aware. It also has a Eclipse plugin.
- node.js - a JavaScript engine and something we'll use for some examples.
- MarkLogic - a NoSQL database with special XML powers!
- eXist - an XML native database (open source & requires Java)
- BaseX - an XML native database (open source & requires Java)
A virtual machine is something to consider having for various purposes. If you run a Windows or Mac desktop, a VM will allow you to install various server operating systems and run them locally. On the Mac, a VM allows you to run Windows for testing or specific Windows-only software.
- Parallels - a VM for OS X (not free)
- VMWare Fusion - a VM for OS X (not free)
- VirtualBox - a cross-platform VM (open source)
You must send me, via e-mail to milowski@ischool.berkeley.edu, the following:
- Your github user account name.
- The list of software you installed.
- Any issues you resolved during setup.
- Any outstanding issues you might have so we can discuss them in class.
We want to record issues so we make sure you are sorted and to avoid them in the future.