INSTALLING MAVEN - Goto Help- >Install New Software - In the Work With drop down select Juno - In the filter text box type Maven

Transcription

1 CS281: Advanced Programming Configuration Information: How to: install eclipse install maven configure java 1.6 jdk install tomcat create and deploy a simple html web application create and deploy a simple servlet web application create and deploy a simple wicket web application INSTALLING ECLIPSE Download Eclipse IDE for Java EE Developers at: Place the eclipse folder in a location that you have access to on your computer. Create a desktop shortcut to the eclipse executable in the eclipse folder. Start eclipse. INSTALLING MAVEN Goto Help>Install New Software In the Work With drop down select Juno In the filter text box type Maven Click Next Click Next Accept the terms of license agreement Wait for Installing Software process to complete Restart eclipse You ll see an Updating Index process run for a while

2 INSTALLING THE JAVA SDK You need the Java 1.6 SDK, located here: html MAKE SURE THAT THE VERSION YOU DOWNLOAD IS USING JAVA 1.6 NOT JAVA 1.7 For OS X things are trickier if you have Mountain Lion, Apple will force you to upgrade to Java 1.7, but you can circumvent the upgrade by reading this: INSTALLING TOMCAT goto: Download either the zip file (os x) or (Windows) Unzip the file into a folder in your home directory For OS X: o Create a file called start_tomcat in your home directory with these contents: #!/bin/sh export CATALINA_HOME=~/apachetomcat $CATALINA_HOME/bin/startup.sh o Create a file called stop_tomcat in your home directory with these contents: #!/bin/sh export CATALINA_HOME=~/apachetomcat $CATALINA_HOME/bin/shutdown.sh o Open a terminal window, type cd to go to the home directory, and type this command: chmod a+x startup_tomcat.sh chmod a+x stop_tomcat.sh o From the terminal window, run startup_tomcat.sh like this:./startup_tomcat.sh For Windows: o Add the following environment variables (see this link for how to in Windows 7: CATALINA_HOME = c:\users\<youruserid>\apachetomcat JAVA_JRE = c:\program Files\Java\jre6

3 o Create a shortcut to startup.bat and shutdown.bat on your desktop. You ll find these batch files in %CATALINA_HOME%\bin. Make sure that the Start In directory is set to %CATALINA_HOME%\bin. o Click on the startup.bat shortcut Test Tomcat by opening a browser and typing the following URL: You should see this: Set up permissions so that you can deploy applications from Eclipse to Tomcat. Edit the $CATALINA_HOME/conf/tomcatusers.xml file and add the following line immediately after the xml element (choose appropriate password) <tomcatusers>:... <tomcat-users> <user username="admin" password="xxxxx" roles="manager-gui,manager-script"/>..

4 . Test the permissions by going to the following url: Enter userid admin and password xxxxx (whatever the password was you specified). You should see this:

5 CREATING AND DEPLOYING A WEB PAGE: startup Eclipse, and do File>New>Other>Maven Project Next Click on the Configure button next to the filter box:

6 Click on Add Remote Catalog

7 Enter: in the first text box Enter: CS281 Maven Archetypes in the second text box Click OK to dismiss the Remote Archetype Catalog Click OK to dismiss the Archetypes

8 Use the Catalog dropown to select CS281 Maven Archetypes Select webhtmlarchetype Press Next

9 Fill in: o Group id: cs.stonehill.edu o Artifact id: WebHelloWorld Click Finish If you have problems and you are using Windows then try this. o Download this file and put it in your.m2 directory: o Edit the file and change the <localrepository> content element to be absolute location of your.m2 directory o Create a releases folder in your.m2 directory o Windows>Preferences>Maven>User Settings o Click on the update settings button o Try to load the maven archetype again

10 Now open the WebHelloWorld project using the Eclipse Project Explorer. Drill down to the index.html file: Change the HTML file so that it says Hello <yourname>! NOTE: Any html, image, or other resource files should be placed in the webapp directory if they are to be correctly deployed to the web server.

11 Modify the following plugin code in the pom.xml file set the username to admin and the password to the correct password for your tomcat installation. <plugin> <groupid>org.codehaus.mojo</groupid> <artifactid>tomcat-maven-plugin</artifactid> <configuration> <url> <username>admin</username> <password>xxxxx</password> </configuration> <version>1.1</version> </plugin> Save the pom.xml file. Now you are ready to deploy the web application to the tomcat webserver. Rightclick on the project WebHelloWorld in the project explorer, Run As > Run Configurations

12 Click on the the Maven_Build option, then press the New Configuration button (upper right corner of the dialog box):

13 In the Maven Build Configuration Dialog set: o Name: WebHelloWorld o Goals: tomcat:redeploy o Press Apply then Run

14 You should see a console window appear with lots of feedback involving the deploy. If the deploy goes successfully, then you ll see this in the console window: Test out your web application by typing the following URL: You should see this:

15 HOW TO CREATE AND DEPLOY A BASIC SERVLET SEE APPENDIX: CONFIGURING ECLOPSE, WINDOWS, and SERVLETS if you have a windows machine. startup Eclipse, and do File>New>Other>Maven Project Select the CS281 catalog and the servletarchetype Enter ServletHelloWorld for the artifact id Goto the project s pom.xml file and enter the correct url, username, and password for your tomcat installation (SEE CREATING AND DEPLOYING WEB PAGES for details) Right click on the project, Run As > Run Configuration Select Maven Build and create a new maven build for the project Run the build you ve created (SEE CREATING AND DEPLOYING WEB PAGES for details) If your deploy was successful, then you should see this when you type the servlet s url in the web browser:

16 HOW TO CREATE AND DEPLOY A WICKET APPLICATION startup Eclipse, and do File>New>Other>Maven Project Select the CS281 catalog and the wicketarchetype Enter WicketHelloWorld for the artifact id Goto the project s pom.xml file and enter the correct url, username, and password for your tomcat installation (SEE CREATING AND DEPLOYING WEB PAGES for details) Right click on the project, Run As > Run Configuration Select Maven Build and create a new maven build for the project Run the build you ve created (SEE CREATING AND DEPLOYING WEB PAGES for details) If your deploy was successful, then you should see this when you type the servlet s url in the web browser:

17 HOW TO DEPLOY TO THE DEPARTMENT SERVER You can access the department server like this: ssh use the password xxxxx You should be able to start the tomcat web server immediately by entering the following command:./start_tomcat You should be able to stop the tomcat web server by entering the following command:./stop_tomcat You should be able to access the tomcat web server using the following url: where xxxxx is: bdugan > 8080 jmcbrine > kbhatt > kboates > llange > mplummer > roshea > ssifferlen > 17080

18 To deploy to the department server (and your tomcat server running on the server) you will use the following plugin in your project pom.xml: <plugin> <groupid>org.codehaus.mojo</groupid> <artifactid>tomcat-maven-plugin</artifactid> <configuration> <url> <username>xxxxx</username> <password>xxxxxx</password> </configuration> <version>1.1</version> </plugin>

19 WANT TO CREATE YOUR OWN ARCHETYPES? Read about this here:

20 APPENDIX: CONFIGURING ECLIPSE, WINDOWS, and SERVETS 1) Install the Java SE 1.6 JDK using this URL: html 2) Start up eclipse again 3) Goto Windows>Preferences>Java>Installed JREs 4) Click Add

21 5) Click Directory and select the directory for the Java 1.6 SDK For me this was located at: C:\Program Files\Java\jdk1.6.0_39 6) Now select the Java 1.6 JDK jre as the default jre for eclipse: 7) Click OK 8) You won t have to do steps 18 anymore yeah!

22 9) Create a maven servletarchetype project from the CS281 archetypes. There are FIVE problems you have to correct to get your project working: incorrect build path missing resources directory incorrect name for main java program tomcat admin userid/password need to be set incorrect JRE selected for maven build

23 10) To correct the build path, right click on the JRE System Library and select properties. Select the Workspace default JRE radio button and click OK:

24 11) To correct the missing resources directory, expand the src folder, right click on the main folder, select New>Folder, name the folder resources, press Finish:

25 14) To correct the file naming problem, expand the java folder, right click the file ServletHelloWorld.java, select rename, set the new name of the file to the artifactid that you provided when you created the maven project. In this example, my artifactid was ServletTestII, then press OK.

26 12) At this point you should not have any errors in your project and it should look something like this: The last thing you have to do is set the correct tomcat deployment url,, userid, password in the project s pom.xml file.

27 13) To correct the incorrect JRE for the maven build do the following:. Assuming that you ve set a run configuration for servlet builds: Run>Run Configurations. select the servlet build click on the JRE tab make sure that the WORKSPACE DEFAULT JRE is checked click APPLY click RUN