WA2387 Hands-On soapui Classroom Setup Guide Web Age Solutions Inc. 1
Table of Contents Part 1 - Minimum Hardware Requirements...3 Part 2 - Minimum Software Requirements...3 Part 3 - Software Provided...4 Part 4 - Important Ghosting or Imaging Information...4 Part 5 - Instructions...4 Part 6 - Installing JDK 7 Update 45...5 Part 7 - Verification of JDK 7 Update 45...9 Part 8 - Verification of Apache Tomcat 7.0.65...11 Part 9 - Verification of groovy-2.4.5...12 Part 10 - Installing MySQL 5.5.46...13 Part 11 - Verification of Apache ActiveMQ-5.11.1...19 Part 12 - Installing SoapUI_5.2.1...20 Part 13 - Installing SoapUI_5.1.2(PRO)...25 Part 14 - Installing ReadyAPI(SOAPUI PRO NG)...30 Part 15 - Summary...34 2
Part 1 - Minimum Hardware Requirements CPU to meet the minimum requirements of the operating system being used 3 GB RAM minimum 25 GB in the hard disk Internet Part 2 - Minimum Software Requirements Windows 7 (Professional, Enterprise, or Ultimate) The following updated web browsers: Internet Explorer Firefox Chrome Adobe Acrobat Reader Zip extraction utility Apache ActiveMQ 5.11.1 * Apache Tomcat 7.0.65 * Groovy 2.4.5 * JDK 7u45 * MySQL 5.5.46 * MySQL Connector 5.1.37 * SoapUI 5.2.1 * * - indicates software provided as part of the courseware. 3
Part 3 - Software Provided List of ZIP files required for this course and used in next steps on this document: WA2387_REL_xxx.ZIP Send an email to support@webagesolutions.com in order to obtain a copy of the software for this course if you haven't receive it yet. 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 - Important Ghosting or Imaging Information Some of the software installed for this course will not function after changing the computer hostname. As such, cloning or imaging should not be used on a fully installed system. You can save time by extracting the contents of the USB memory stick to C:\ on a clean OS install (no other software installed) and then imaging that hard drive. After restoring the image to the other computers and changing the hostnames, you can then install the software on each computer individually by following the instructions that are detailed later in this document. Part 5 - Instructions 1. Extract all the.zip files to C:\ 2. Review that the following folders were created: C:\LabFiles C:\Software\apache-activemq-5.11.1-bin C:\Software\apache-tomcat-7.0.65 C:\Software\groovy-2.4.5 C:\Software\mysql-connector-java-5.1.37 C:\Software\SoapUI-Pro 4
3. Review that the following files were created: C:\Software\jdk-7u45-windows-i586.exe C:\Software\mysql-5.5.46-win32.msi C:\Software\ReadyAPI-x32-1.5.0.exe C:\Software\SoapUI-x32-5.2.1.exe 4. Disable the Firewall. 5. Make sure the student has a administrator account in order to preform the labs. 6. Make sure the C:\LabFiles and C:\Software folders are not read only. Part 6 - 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.exe Note: 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. 5
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. 6
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. 7
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; 8
14. Click OK. 15. Click OK to close the Environment Variables window. 16. Click OK to close the System Properties window. Part 7 - Verification of JDK 7 Update 45 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 -version Make 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: 9
javac Verify that you get the options to run the Java compiler: 5. Enter the following command: java -XshowSettings:all 2>&1 findstr /c:"sun.arch.data.model" Verify that it displays the correct value of 32. This indicates that it is 32-bit java that is installed. Troubleshooting: If it displays 64 for the value, then you have 64 bit java installed and this will cause issues. Please uninstall the 64-bit java and reinstall the indicated 32-bit jdk. 6. Close the command prompt window and any extra windows that are open. 7. From Start, expand All Programs > Java then right click Check for Updates and select Run as Administrator. 8. Select the Update tab. 9. Un-check the Check for updates automatically check box. 10. A popup will open, click Do not check. 11. Make sure the box is not checked and click OK. 10
12. Click OK to close the Java Control Panel. Java has been installed. Part 8 - Verification of Apache Tomcat 7.0.65 1. Open a command prompt window. 2. Change to the following directory: C:\Software\apache-tomcat-7.0.65\bin 3. Run the command: startup.bat 4. Windows Security Alert may open. Click Allow Access. 5. Apache will start in a new window. 6. Open another command prompt window. 11
7. Change to the following directory: C:\Software\apache-tomcat-7.0.65\bin 8. Run the command: shutdown.bat 9. Apache will stop and the window where it was running will close. 10. Close All command prompts. Part 9 - Verification of groovy-2.4.5 1. Open a command prompt window. 2. Change to the following directory: C:\Software\groovy-2.4.5\bin 3. Run the command: groovyconsole GroovyConsole will start in a new window. 4. Close it. 5. Close the command prompts. 12
Part 10 - Installing MySQL 5.5.46 1. From C:\Software, launch mysql-5.5.46-win32.msi The Setup Wizard window will launch. 2. Click Next. 3. Accept the license and click the Next button. 4. In the Setup Type window click the Typical button. 13
5. Click Install. If prompted by Windows security allow the installation to continue. 6. The installation will start and the MySQL Enterprise window will appear. Click Next. 14
7. The MySQL Enterprise Monitor Service window will appear. Click Next. 8. The Wizard Completed window will appear. Make sure the Launch the MySQL Instance Configuration Wizard option is checked and click Finish. If prompted by Windows security allow the program to launch. 15
9. The MySQL Server Instance Configuration Wizard window will appear. Click Next. Note: If the wizard does not appear select Start Programs MySQL MySQL Server 5.5 MySQL Server Instance Config Wizard. If prompted by Windows security allow the program to execute. 16
10. In the Instance Configuration window, select Standard Configuration. Click Next. 11. When presented with the Windows options, check the option for Include Bin Directory in Windows PATH. 17
12. Make sure your window looks like above and click Next. 13. The Security options window will appear. For the New root password and Confirm fields, enter root123 and then click Next. 14. The Ready to Execute window will appear. Click Execute. 18
The database will configure. This will take a moment. Eventually, you should see the following: 15. Click Finish. MySQL has been installed. Part 11 - Verification of Apache ActiveMQ-5.11.1 1. Open a command prompt window. 2. Change to the following directory: C:\Software\apache-activemq-5.11.1\bin 3. Run the command: activemq.bat start Make sure no errors on the console and it says started. 4. Close by pressing Ctrl-C and then click Y. 19
5. Close the command prompt window. Part 12 - Installing SoapUI_5.2.1 1. The installation is pretty straightforward. Start it by just double-clicking on C:\Software\SoapUIx32-5.2.1.exe. The installer will start immediately. You may need to allow changes in your computer. You'll soon see the starting screen. 2. Click Next. You'll be asked to accept the license agreement. 20
3. Click Next. You'll be able to select the destination folder, which by default is set to C:\Program Files\SmartBear\SoapUI-5.2.1, but can be changed. 4. Click Next. 21
Next step gives you the opportunity to include, as additional components, soapui source files and Hermes installation 5. Make sure you've chosen to install Hermes, and click Next. You'll get the Hermes license agreement. 6. Accept and Click Next. 22
7. Then, change the path as follows to the directory where the tutorials will be installed. C:\Software\SoapUI-Tutorials 8. Click Next. Then, you'll be able to select the Start Menu folder where you want the soapui shortcut to be added. 9. Click Next. 10. Make sure Create a desktop icon is checked to create shortcut on desktop. 23
11. Click Next. Finally, the installation starts. 12. After couple of minutes at most, the installation should be finished and you should see the next screen. 24
13. Click Finish. 14. Close the note file that opens. 15. Click No in the usage statistics window. 16. Click Ignore this update in the New version check window. 17. SoapUI will open. Click Skip in the Stay Tuned window. 18. Windows Security Alert may open. Click Allow Access. 19. Now you are ready to use soapui. 20. Close soapui. Part 13 - Installing SoapUI_5.1.2(PRO) Installing SOAPUI PRO version. 25
1. The installation is pretty straightforward. Start it by just double-clicking on C:\Software\soapUIPro\SoapUI-Pro-x32-5.1.2.exe. The installer will start immediately. You'll soon see the starting screen. 2. Just click Next to continue. You'll be asked to accept the license agreement. 26
3. After accepting and clicking Next, you'll be able to select the destination folder, which by default is set to C:\Program Files\SmartBear\SoapUI-Pro-5.1.2, but it can be changed. 4. Click Next. Next step gives you the opportunity to include, as additional components, soapui-pro source files and Hermes installation. 27
5. Make sure you've chosen to install Hermes, Click Next. 6. You'll get the Hermes license agreement. Accept and Click Next. 7. Change the path as follows to the directory where the tutorials will be installed and click Next. C:\Software\SoapUI-Tutorial 8. Then, you'll be able to select the Create Start Menu folder where you want the soapui-pro 28
shortcut to be added. Click Next. 9. Check Create a desktop icon to create shortcut on desktop. Click Next. 10. Finally, the installation starts. 29
11. After couple of minutes at most, the installation should be finished and you should see the next screen. If ask to overwrite tutorials click Yes to All. 12. Uncheck both and click Finish. Students will have to request for a Trial and activate it during the labs. Part 14 - Installing ReadyAPI(SOAPUI PRO NG) 30
1. The installation is pretty straightforward. Start it by just double-clicking on C:\Software\ReadyAPI-x32-1.5.0.exe. The installer will start immediately. 2. You will see the starting screen. Just click Next to continue. 3. You'll be asked to accept the license agreement. Accept and click Next. 31
4. Select full installation and click Next. 32
5. Now, you'll be able to select the destination folder, which by default is set to C:\Program Files\SmartBear\ReadyAPI-1.5.0, but can be changed, click Next. 6. Accept and click Next. 7. Finally, the installation starts. 33
8. After couple of minutes at most, the installation should be finished and you should see the next screen. 9. Click Finish. 10. The software will open asking for a license, click No and close the software. The student will activate a trial during the labs. Part 15 - Summary You have successfully installed the software for this course! If you have any question please contact us by email at support@webagesolutions.com From US and Canada call: 1-877-812-8887 ext. 26 International call: 416-406-3994 ext. 26 34