Project Setup

Setup for the project requires three steps.

• Check out the project files using CVS.
• Create a Netbeans project to use the project files.
• Set up a web server for testing changes before committing them.

CVS Checkout

To check out the project files complete the following steps.

1. Start Netbeans.

2. Click on the "Checkout..." menu item in the "Team" menu. This will pop up a wizard for entering the required information. The remaining steps refer to steps in that wizard.

3. You should see the "CVS Root" dialog below.
   
   1. Click on the "Edit" button at the end of the "CVS Root:" combo box. This will bring up the following dialog:
      
      Enter everything as shown above except use your own UMD login name and use "marengo.d.umn.edu" as the host. Then click the "OK" button. Continue filling out the "CVS Root" dialog.
   2. Click on the "Use Internal SSH" radio button.
   3. Enter your UMD password in the "Password" text field.
   4. Click on the "Next" button.

4. You should see the "Module to Checkout" dialog below.
   
   1. Enter "JSLIB" in the "Module:" text field.
   2. Leave the "Branch:" text field blank.
   3. Specify the folder in which you want the project files subdirectory in the "Local Folder:" text field. A new folder named "JSLIB" will be placed in the folder that you specify.
   4. Click on the "Finish" button. When a dialog asks you if you want to create a project for the checked out file click on "Cancel" - Netbeans does not create the kind of project that you need.

That completes the CVS checkout. You should check to make sure the new folder "JSLIB" was created correctly.

Creating the Netbeans Project

1. In Netbeans, click on the "New Project..." menu item in the "File" menu. You should see the "Choose Project" dialog below.
   
   Fill in this dialog as shown above. Then click on the "Next" button.

2. You should see the "Name and Location" dialog below.
   
   Fill in the "Project Name:" and "Project Location:" text fields with the name and location that you want for the project folder. The "Project Folder:" text field will fill in automatically. The location has no relation to the files you checked out earlier. They will soon be added to the project. Now click on the "Finish" button. A new project should appear soon in the "Projects - Development" pane. When it does, right click on the bottom "Properties" menu item.

3. You should see the "Project Properties" dialog below. If necessary click on the "Sources" button in the "Categories:" pane.
   
   Click on the entry in the "Source Package Folders:" pane then click the "Remove" button to the right. You can also remove the entry in the "Test Package Folders:" in the same way. Now click on the "Add Folder..." button to the right of the "Source Package Folders" pane. Use the "Add Source Folder" browser that pops up to locate the "JSLIB" directory that you checked out earlier. Select it then click on the "OK" button.

That completes the creation if the Netbeans project. Browse through the source folders to make sure you got everything. There should be 4 .css files, 9 .js files, a "test" subdirectory, and a "documentation" subdirectory.

Setting Up the Web Server

Setting up the web server involves 4 major steps:

• Installing an Apache web server
• Checking the installation
• Configuring the Apache web server to access the contents of the JSLIB directory
• Checking the configuration

Apache Installation

1. Download apache_2.2.14-win32-x86-openssl-0.9.8k.msi from http://httpd.apache.org/download.cgi. Click here to open this url in a new tab or window. The desired download is the next to last bullet in the "Apache HTTP Server 2.2.14" section. Move the downloaded file to your desktop if it isn't already there.
2. Click on the apache icon on the desktop. This will bring up the installation wizard. The remaining steps refer to the panes in that wizard.
3. Welcome
   Click on "Next >".
4. License Agreement
   Click on the "I accept ..." radio button.
   Click on "Next >".
5. Read This First
   Click on "Next >".
6. Server Information
   Enter "localdomain" in the "Network Domain" text field.
   Enter "localhost.localdomain" in the "Server Name" text field.
   Enter your email address in the "Administrator's Email Address" text field.
   Click on "Next >".
7. Setup Type
   Click on "Next >".
8. Destination Folder
   Click on the "Change..." button. This brings up the "Change Current Destination Folder" dialog.
9. Change Current Destination Folder dialog
   Browse to find your "Desktop" folder.
   Click on the button from the "Look in:" text field.
   This will create a new folder in the large pane. Change its name to "Apache2".
   Click on "OK". Then go back to the "Destination Folder" wizard pane.
10. Destination Folder
    Check the destination.
    If it is ok click on the "Next >" button.
11. Ready to Install the Program
    Click on the "Install" button.
12. Installation Wizard Completed
    Click on the "Finish" button.

Installation Check

1. Click on the Windows "Start" button and click on the "All Programs" arrowhead.
   Select "Apache HTTP Server 2.2" -> "Control Apache Server" -> "Start Apache in Console".
   A Console window will appear indicating that the server has started. You cannot do anything with this window except minimize it or close it.
   Minimize it for now; closing it shuts down the server.
2. Now click here to open a new browser tab or window. In that tab or window you should see a web page that just displays "It works!".
3. Shut down the server by closing the console window that appeared in step 1.

Apache Configuration

1. Download httpd-jsLib.conf. You can do this by right clicking on this link and selecting "Save Link As..." in the menu that pops up. Save httpd-jsLib.conf into Apache2\conf\extra (Apache2 is the directory you created when you installed Apache).
2. Edit the file you just downloaded, changing the two paths to refer to the JSLIB directory that you retrieved using CVS.
3. Download httpd.conf. You can do this by right clicking on this link and selecting "Save Link As..." in the menu that pops up. Save httpd.conf into Apache2\conf. When asked if you want to replace the existing file click on the "Yes" button.
   

Configuration Check

1. Start the web server as in the installation check. If the "Start Apache in Console" menu item appears in the Windows "Start" menu just click it. If not, repeat Step 1. of the installation check.
2. Now click here to open a new browser tab or window. You should see a web page titled "Index of /jsLib". If so, you may want to bookmark it. You could also go to this page and bookmark it.
3. Shut down the server by closing its console window.

Congratulations, you have completed the setup for the project.