wa2404 dependency management with nexus, apache maven … › setupguides › wa2404... · wa2404...

WA2404 Dependency Management with Nexus, Apache Maven and Apache Ivy - Classroom Setup Guide

WA2404 Dependency Management with Nexus,Apache Maven and Apache Ivy

Classroom Setup Guide

Web Age Solutions Inc.

© Web Age Solutions Inc. 1


Table of ContentsPart 1 - Minimum Hardware Requirements .........................................................................................3Part 2 - Minimum Software Requirements ...........................................................................................3Part 3 - Software Provided....................................................................................................................4Part 4 - Instructions...............................................................................................................................4Part 5 - Installing JDK 7 Update 45......................................................................................................5Part 6 - Verification of JDK 7 Update 25..............................................................................................9Part 7 - Install Nexus...........................................................................................................................11Part 8 - Install Maven..........................................................................................................................16Part 9 - Setup Maven in Eclipse..........................................................................................................18Part 10 - Jenkins Installation...............................................................................................................19Part 11 - Set Up Subversion................................................................................................................25Part 12 - Privileges to Users................................................................................................................27Part 13 - Verification of Jenkins..........................................................................................................30Part 14 - Verification of Subversion....................................................................................................30Part 15 - Summary...............................................................................................................................31



Part 1 - Minimum Hardware Requirements

● 2 GB RAM minimum, 3 GB recommended

● 15 GB in the hard disk

● Access to internet

Part 2 - Minimum Software Requirements

● One of the following Windows versions:

○ Windows Vista (Professional, Enterprise, or Ultimate)

○ Windows 7 (Professional, Enterprise, or Ultimate)

● The following web browsers:

○ Internet Explorer 8 or above

○ Mozilla Firefox

● Adobe Acrobat Reader

● Zip extraction utility

● JDK 7 Update 45 *

● Eclipse JEE Kepler SR1*

● Sonatype Nexus Pro 2.9.2-01 Trial *

● Apache Maven 3.1.1 *

● Apache Tomcat 6.0.37 *

● Jenkins *

● Subversion *

* - indicates software provided as part of the courseware.



Part 3 - Software Provided

Name of the file you will receive:

• WA2404.ZIP

All other software listed under Minimum Software Requirements is either commercially licensed software that you must provide or software that is freely available off the Internet.

Part 4 - Instructions

__1. Login with an administrator account. NOTE. THIS COURSE REQUIRES ADMIN PRIVILEGES TO THE STUDENT ACCOUNT.

__2. Extract the ZIP file directly to C:\

__3. Review that the following folders were created:

• C:\LabFiles

• C:\Software\apache-maven-3.1.1

• C:\Software\apache-tomcat-6.0.37

• C:\Software\eclipse

__4. Review that the following files were created:

• C:\Software\jdk-7u45-windows-i586.exe

• C:\Software\nexus-pro-trial-installer-2.9.2-01-win32.exe

• C:\Software\jenkins.war

• C:\Software\Setup-Subversion-1.7.4.msi



Part 5 - Installing JDK 7 Update 45

__1. Make sure there is no previous Java version already installed on the system. You can check this by using the Windows “Add/Remove Programs” utility. For the best compatibility with the labs it is suggested that all previous versions of Java be uninstalled before proceeding with these instructions. If this is an issue, please contact the setup support person for the course.

__2. From the C:\Software directory run the following file: jdk-7u45-windows-i586.exeNote: If using prompted by a security prompt allow the installation to continue.

__3. When the initial step of the setup appears, press the Next button.

__4. Leave the defaults for installation location and options, and press the Next button.

Note: The installation directory may be slightly different for example C:\Program Files (x86)\Java\jdk1.7.0_45



The installation will begin installing files.

__5. The Destination Folder will appear, leave the default folder and click Next.

Note: The installation directory may be slightly different for example C:\Program Files (x86)\Java\jdk1.7.0_45

Wait until the software is completely installed.

__6. Click Close.



__7. Close any browser that appears asking to register the JDK software.

Set the Environment variables.

__1. Open a Command Prompt. You can do this with 'Start → Programs → Accessories → Command Prompt'.

__2. Use the 'cd' command to attempt to switch to the following directory. This will verify the presence of a directory used later so make sure you do not get any errors about not being able to “find the path specified”.cd C:\Progra~1\Java\jdk1.7.0_45

Note: The installation directory may be slightly different depending your operating system. You may need to use the following directory instead of the one listed above:

C:\Progra~2\Java\jdk1.7.0_45

Some of the remaining steps will use the slightly different directory.

__3. Make sure you can reach the java folder and remember the value entered because you will use this value in the following steps.

__4. Close the command prompt window.



__5. In the Windows Start Menu, right-click on the Computer link in the right-hand side of the Start panel, and then select Properties.

__6. Click on Advanced system settings.

__7. The system will display the System Properties dialog. Select the Advanced tab and click Environment Variables.

__8. Under the System Variables list, click the New button.

__9. Enter JAVA_HOME as Variable name.

__10. As Variable value enter the following. This should be the value you verified in the Set the Environment variables section - step 2.C:\Progra~1\Java\jdk1.7.0_45

Note: If you are using a 64-bit OS you may have to use C:\Progra~2\Java\jdk1.7.0_45

__11. Click OK to create the variable.

__12. From the System Variables list, select Path and click Edit.

__13. At the beginning of the line enter the following. Make sure to include the semi-colon on the end:%JAVA_HOME%\bin;



__14. Click OK.

__15. Click OK to close the Environment Variables window.

__16. Click OK to close the System Properties window.

Part 6 - Verification of JDK 7 Update 25

__1. Open a Windows command prompt. You can do this by selecting 'Start -> Run', entering 'cmd', and then pressing the OK button. Make sure it is a new command prompt and not one open previously.

__2. Enter the following command:echo %PATH%Make sure you see the Java 'bin' directory listed at the beginning as shown below.

Note: You may see C:\Progra~2\Java\jdk1.7.0_45

__3. Enter the following command:java -versionMake sure you see the response shown below.

Troubleshooting: If you get an error message means that your Environment variable was incorrectly entered, go back and fix the values.



__4. Enter the following command:javacVerify that you get the options to run the Java compiler:

__5. Close the command prompt window and any extra windows that are open.

__6. From Start, select All Programs > Java > Check for Updates.

__7. Select the Update tab.

__8. Un-check the Check for updates automatically check box.

__9. A popup will open, click Do not check.

__10. Make sure the box is not checked and click OK.



__11. Click OK to close the Java Control Panel.

Java has been installed.

Part 7 - Install Nexus

__1. Open C:\Software.

__2. Double-click on Nexus-Pro-Trial-xxxxxx.exe

__3. When the User Account Control dialog appears, click Yes.

__4. At the setup wizard's first screen, click Next.



__5. Change the destination directory to 'C:\Program Files\nexus-pro' and then click Next.

__6. At the Review Components screen, click Next.

__7. The installer will display the Select Nexus Work Directory dialog. Change the Work Directory to 'c:\Software\nexus-pro' and then click Next.

__8. Leave the evaluation guide directory as-is, and then click Next.

__9. The installer will display the Nexus Configuration Options dialog. Check that the HTTP Port is set to '8081' and then click Next.



__10. If the Windows Firewall dialog displays, click Allow Access.

__11. The installer displays the Select Start Menu Folder dialog. Leave the folder set to Sonatype Nexus Pro Trial and click Next.

__12. Click on I accept the agreement and then click Install.



__13. When the Start Nexus screen displays, leave Yes I would like to start Nexus selected, and then click Next.

__14. De-select the check boxes for Create desktop icons and Open Evaluation guide and then click Finish.

__15. Open a browser window, and enter 'http://localhost:8081/nexus' as the url if the window didn't open.

__16. Fill out the evaluation form and click Submit. When you receive the trial license, enter it into the form. Note, If you already have a license then click the Already have a license link.

__17. Accept the trial license, and click Activate License.

__18. Nexus will open.



__19. Close all.

__20. Right click C:\Software\nexus-pro and select Properties.

__21. Click the Security tab.

__22. Click Advanced.

__23. Click Change Permissions.

__24. Select the Users entry (add one if not present) and click Edit…

__25. Check the Allow checkbox to the right of Full Control and click OK.

__26. Select the checkbox for Replace all child permissions with inheritable permissions from this objects and then click OK.



__27. A Windows Security dialog will open. Click Yes.

__28. Wait until Windows finishes updating security.

__29. Back in the Advanced Security Settings dialog, click OK.

__30. Back in the Properties dialog, click OK.

Nexus Pro Trial Version is now installed.

Part 8 - Install Maven

__1. Open a file explorer a navigate to C:\Software\apache-maven-3.1.1

The following steps are based on Windows 7, other Windows versions instructions may vary.






__5. Verify the JAVA_HOME variable is set to C:\Progra~1\Java\jdk1.7.0_45 or similar path.

__6. In the 'System Variables' panel, locate the entry for 'Path' and double-click on it.

__7. Add the following to the end of the Variable Value field (including the semi-colon);C:\Software\apache-maven-3.1.1\bin

__8. Click OK on the variable editor dialog.

__9. Click OK on the Environment Variables dialog.

__10. Click OK in the System Properties dialog.

__11. Open a command prompt window (in the start menu, click All Programs --> Accessories --> DOS Prompt.



__12. In the command window, type:mvn -version

__13. You should see output similar to:

Part 9 - Setup Maven in Eclipse

__1. Use Windows Explorer to navigate to C:\Software\eclipse, and then double-click on 'eclipse.exe' to start up the IDE.

__2. You may see a security dialog. If so, un-check the box for “Always ask before opening this file” and then click Run.

__3. Change the workspace to C:\Workspace and click OK.

__4. Eclipse Kepler will start launching.

__5. Close Eclipse.

__6. Close all.



Part 10 - Jenkins Installation

__1. Open command prompt and check the correct version of the Java is installed:java -version

__2. Open a file browser and navigate to C:\Software

__3. Create Jenkins installation directory called Jenkins under C:\Software folder.




__7. Click New under System variables.

__8. Enter JENKINS_HOME as variable name.

__9. Enter C:\Software\Jenkins as variable value.



__10. Click OK.

__11. From the System Variables list, select Path and click Edit.

__12. At the beginning of the line enter the following. Make sure to include the semi-colon on the end:%JENKINS_HOME%;

__13. Click OK.

__14. Click OK to close the Environment Variables window.

__15. Click OK to close the System Properties window.

We just changed the default path of Jenkins to C:\Software\Jenkins.

__16. In the command prompt window, change the directory to C:\Software

__17. Jenkins Installation WAR file is already downloaded to above directory for your convenient, follow the next step to start.

__18. To start Jenkins, enter:java -jar jenkins.war



__19. A window may open asking to let Java run, allow to continue.

__20. Windows Firewall may (or may not) display a window asking if you want to let Jenkins run. If such a window appears, click the button to allow Jenkins to continue.

__21. Once Jenkins has started, you should see the following message. Minimize, but don't close the command prompt window.

NOTE: The "Install as Windows Service" link indicated above will not appear if Jenkins is already running as a service on the machine. You can verify that Jenkins is running as a service by launching the Services app from the Windows Start Menu and looking for a running service called "Jenkins" among the list of all windows services running on the machine.

__22. To connect to Jenkins, open Firefox and enter the following URL .http://localhost:8080/

Jenkins console will open.



__23. Click on the Manage Jenkins link.

__24. Look for the "Install as Windows Service" link and click on it.

__25. Enter the directory C:\Software\Jenkins where Jenkins should be installed (directory must already exist). This will become JENKINS_HOME and used to store data files.



__26. Click Install.

__27. Windows may (or may not) display the User Account Control dialog shown below. If it appears, click Yes.

__28. Upon successful completion of the installation, you should see a page asking you to restart Jenkins. Click Yes to re-start.

__29. You may see a dialog like below asking to make changes, click Yes.



__30. You'll see a message saying wait until the restart completes.

__31. To confirm that Jenkins is running as a windows service, open the Service Manager window and verify that Jenkins service is started, also make sure Startup type is set to Automatic.

__32. Close the services window.

__33. Close the browser.

__34. Close all command prompt windows.

__35. To connect to Jenkins again, open Firefox and enter the following URL .http://localhost:8080/

Jenkins console will open.




Part 11 - Set Up Subversion

In this lab part, you will install and start the Subversion server, create a new repository, add a user and import some code.

__1. Open a command prompt window.

__2. Execute the following file:C:\Software\Setup-Subversion-1.7.4.msi

__3. The Subversion Welcome page will open, click Next.

__4. Click Next on the Information window.

__5. Change folder to C:\Software\Subversion



Note. It's important that you change the installation path in order to let the students to complete the labs.

__6. Click Next.

__7. Click Install.

__8. In case any popup shows up, click Yes as shown below.

__9. Click Finish when installation is completed.



__10. Close any window and command prompt window.

Subversion has been installed.

Part 12 - Privileges to Users

__1. Create the user that the students will use during the class.

__2. Open Windows Explorer.

__3. Right click C:\Software and select Properties.

__4. Click the Security tab.

__5. Click Advanced.



__6. Click Change Permissions.

__7. Select the Users entry (add one if not present) and click Edit…



__8. Check the Allow checkbox to the right of Full Control and click OK.

__9. Select the checkbox for Replace all child permissions with inheritable permissions from this objects and then click OK.



__10. A Windows Security dialog will open. Click Yes.

__11. Wait until Windows finishes updating security.

__12. Back in the Advanced Security Settings dialog, click OK.

__13. Back in the Properties dialog, click OK.

__14. Do the same steps to the C:\LabFiles folder.

__15. Create a folder called C:\Workspace if its not already created.

__16. Do the same steps to the C:\Workspace folder.

Part 13 - Verification of Jenkins

In this part we will verify that the students can start Jenkins and Subversion using the assigned user to do the labs. This part is important if the students don't have admin privileges.

__1. If you are connected as admin then logoff and then login with the user that the students will use during the class.

__2. To connect to Jenkins, open Firefox and enter the following URL.http://localhost:8080/

__3. Make sure you see the Jenkins page.


Part 14 - Verification of Subversion

__1. Open a command prompt and change to C:\Software\Subversion\bin



__2. Run the following command to create a repository:svnadmin create c:\Software\Temp

The C:\Software\repo folder will be created.

__3. Enter the following to start a subversion server:svnserve -d -r c:\Software\Temp

__4. If a Firewall windows open, allow to continue.

__5. The cursor won't do anything as shown below.

__6. Close the command prompt window.

Part 15 - Summary

You have successfully installed the software for this course!

If you have any question please contact us by email at [email protected]

From US and Canada call: 1-877-812-8887 ext. 26

International call: 416-406-3994 ext. 26


mailto:[email protected]

wa2404 dependency management with nexus, apache maven … › setupguides › wa2404... · wa2404...

Documents