Quick Start Tutorial

This quick start tutorial gets you up and running with the essentials of load testing for Oracle and MySQL . We assume that you have a standalone notebook or desktop running Windows or Linux and connection to the internet. We do not assume you already have Oracle or MySQL installed and assume no prior knowledge in scripting or coding. All software referenced is free so no licenses are required. You should be able to complete all of the tasks within approximately 1 hour and we recommend that you approach each task in order. On completion of this tutorial your system will be installed with Oracle and MySQL and you will have created a schema, populated it with data and run a load test on both databases. This guide will provide you with the fundamental knowledge of installing and configuring Hammerora to proceed to more sophisticated database load testing projects. Task 1. Install Oracle Express Edition Task 2. Install Hammerora Task 3. Create an Oracle Test Schema Task 4. Run an Oracle Load Test Task 5. Install MySQL Community Edition Task 6. Create a MySQL Test Schema Task 7. Run a MySQL Load Test Task 8. Next Steps

Task 1. Install Oracle Express Edition Fetch Oracle Express Edition from Oracle at the following URL: http://www.oracle.com/technology/software/products/database/xe/index.html and run the installer package.

Figure 1 Prepare to install

Click next on the Welcome Screen.

Figure 2 Welcome

Click next, to agree to the license agreement

Figure 3 License Agreement

Choose your destination location. In this example Oracle Express will be installed in the D:\oraclexe directory.

Figure 4 Destination Location

Specify your Database passwords and note them down as you will need them later for Hammerora. It is the SYSTEM user password we are going to use which is set to the same as the SYS user.

Figure 5 Set Password

click Install Figure 6 Install The installer copies the install files Figure 7 Copy Files .On the Summary page.

And shows the progress of the install Figure 8 install Progress When the install is complete click Finish to launch the homepage .

Figure 9 Install complete Login as the sys or system user using the password you set earlier Figure 10 Login Get familiar with the Oracle Express interface .

net/projects/hammerora/ The page will show you the right version for your operating system. You now have an installation of the Oracle Database. Task 2. Install Hammerora Download Hammerora from Sourceforge http://sourceforge.Figure 11 Oracle Express Interface Now Reboot your system. If you need a different version click “view all files” NOTE : Known Oracle Product Issue Bug #3807408 Before installing Hammerora on Windows you should note that there is a bug in some versions of the Oracle client and database software (including Oracle XE) that causes Oracle error: ORA-12154: TNS:could not resolve the connect identifier specified This bug is caused whenever any Oracle client program (including Hammerora) is installed in a directory containing parenthesis such as the following: . Oracle Express modifies the PATH environment variable and for subsequent Program installations you must reboot for this change to take effect across the system.

When using Oracle XE you should ensure that Hammerora is installed to a directory that does not contain parenthesis. you must relocate the application to a directory without any parenthesis in the path. OR •Find the location of the application that is generating the error.. The workaround is as follows: •Use a version of the Oracle client AND database software that contains the fix for Bug 3807408."C:\Program Files (x86)\. This fix requires that both the client and database software be patched.. Run the Hammerora installer and select the install language Figure 12 Select Language Click on Yes to start the installation Figure 13 Start Installation Click Next on the Installer Wizard Welcome . If so. Check the path to this location and see if it contains any parenthesis." (NOTE: This is an Oracle software bug not a Hammerora one).

Figure 14 installer Welcome Choose your installation destination. Figure 15 Choose Destination .

You should ensure that you have permission to write to the destination by checking the folder properties. Figure 16 Read Only You can change the permissions to enable the installation to proceed or run the installer program as the administrator user. . For example the following Folder cannot be written to.On some versions of Windows security can be restrictive.

Figure 17 Read Write Permissions When you have the correct location click Next to Start Copying Files .

Figure 18 start Copying Files Wait whilst the installer copies Hammerora to your chosen destination Figure 19 Installing .

When the Install wizard is complete click the Finish button. Figure 20 Install wizard Complete The installation is now complete and Hammerora has been started for the first time. .

.Task 3. Within this Window enter the details of your newly installed configuration with a service name of xe the system user password you entered during the install and a default tablespace of users which already exists within Express Edition. 5 or 10 is good for a first test and set the Number of Threads to the number of cores or Hyper Threads on your system. Click OK. Select a number of warehouses with the slider. Note that the data populated here is derived from the configuration file config. Create a Test Schema Click on the Benchmark Menu and under the TPC-C Menu select TPC-C Schema options to display the TPC-C Schema options Window.xml in the Hammerora directory so you can change the data to suit your environment without typing it in every time.

.Figure 21 TPC-C Schema Options Select the Building Blocks Icon as shown in Figure 22.

the time to completion depends on your system but should normally be less than 5 minutes. Figure 23 Create Schema Prompt If you got an error at this point did you reboot after installing Oracle Express Edition? If not now is a good time to do the reboot to set your environment variables system wide. . Wait for the Schema creation to complete.Figure 22 Create TPC Schema On the Create Schema prompt check the details and Click Yes.

Press the red traffic light icon to close the users down. .Figure 24 Schema Creating When the Display shows TPCC SCHEMA COMPLETE and all users have completed successfully the build is finished.

.Figure 25 Schema Complete Now log in to the Oracle Express Homepage as the user tpcc with the password you specified.

Figure 26 Login as TPCC Take a moment to browse the schema and observe the created tables and data that has populated them. .

. this populates the Script Editor Window with the driver script.Figure 27 Browse Schema Task 4. You do not need to edit the script. Run an Oracle Load Test You can now proceed to run a load test against your created schema. You can observe that the EDITABLE OPTIONS correspond to the driver script options set when the schema was created. Under the benchmark and TPC-C Sub Menu now select the Menu option TPC-C Driver Script.

Don’t select too many to start with as the workload is intensive. . however note that displaying the output will reduce the overall level of performance and click OK.Figure 28 Driver Script Under the Virtual Users menu select Vuser Options and enter the number of users you wish to run against your system. If you wish check the Show Output button to see what your users are doing whilst the test is running.

Figure 29 Virtual User Options Click the Create Virtual Users button as shown in Figure 30 to create the virtual users. . Figure 30 Create Virtual Users You can observe that the virtual users have been created but their status is shown as waiting. they will not start running yet.

Figure 31 Virtual Users Created Now click the Run hammerora Loadtest button as shown in figure 32 to start the test. . The virtual users will begin to execute the driver script in the Script Editor Window.

.Figure 32 Run Hammerora Loadtest You can now observe that the load test is in progress as the virtual users display their output.

.Figure 33 Running a Load Test Also observe your system Task Manager or system performance monitor utilities. You can see that a load has been placed on the system.

.Figure 34 Task Manager The virtual users will show a Green tick when the load test is complete or you can press the red traffic light icon to stop the workload mid-test and destroy the virtual users.

Figure 35 Virtual Users Complete You can also observe the Oracle Performance whilst the test is in progress. . Figure 36 Transaction Counter Options Now Press the Pencil Icon as shown in figure 37 to start the transaction counter. To do so on the TX Counter Menu select TX Counter Options and in the connect string enter the system user with the password you set and the xe service name as shown in Figure 36.

Figure 37 Start Transaction Counter The transaction Counter notebook pane is now activated and the message Waiting for Data… is shown as Hammerora gathers your transaction information. .

On the Transaction Counter Pane observe the database performance of your system. in this example Virtual User Output has been disabled.Figure 38 Transaction Counter Started Run the Hammerora Load Test as you did previously. .

Install MySQL Community Edition You can now proceed to installing and configuring MySQL on your system. You can close Hammerora by selecting Exit from the File Menu. Download the community edition of MySQL from the following location.Figure 39 Transaction Counter The traffic light icons can be used to close down the Transaction Counter and Virtual Users Respectively.mysql. http://www. . Task 5.com/downloads/mysql/ Run the installer and select Next. Congratulations you have now run your first Oracle load test.

Figure 41 Setup Type In this example we will select Custom to change the installation directory .Figure 40 MySQL Welcome If you are happy with the default options select a typical install and press Next.

Figure 42 Custom Setup Type Choose your installation options and press next. Figure 43 Custom Setup Options Confirm your selected options and press Install .

Figure 44 ready to Install Press next on the MySQL Enterprise information page Figure 45 MySQL Enterprise Press Next on the MySQL Enterprise Monitor page .

Figure 46 MySQL Enterprise Monitor When the installer has completed choose to configure now and press Finish. Figure 47 Wizard Completed .

Figure 49 Instance Configuration .At the configuration wizard press Next. Figure 48 Configuration Wizard Welcome On the Instance Configuration Page choose Standard Configuration and Press Next.

Figure 50 MySQL Service Choose a password for your root user and Press Next. Figure 51 Create Account .Accept MySQL as a service and choose to add the MySQL directory to your path and press Next.

.tcl in the hammerora install directory.Press Execute to process your configuration and when complete press Finish.bat on Linux you can start hammerora by running . On Windows you can start Hammerora by running hammerora./hammerora. Figure 52 Processing Configuration Task 6. Create MySQL Schema Now Start Hammerora again.

On the confirmation window press OK. . enter your chosen configuration on this screen and Press OK. Figure 54 Select TPC-C for MySQL Now when you select TPC-C Schema Options under the Benchmark and TPC-C Menus observe that the options have changed from the Oracle information to MySQL.Figure 53 Start Hammerora Under the Benchmark Menu select Benchmark Options and select TPC-C for MySQL.

.Figure 55 MySQL TPC-C SChema Options Start the schema build in exactly the same way that you did for Oracle by pressing the building blocks icon. Figure 56 create MySQL Schema Prompt The Creation process begins in the same manner you are familiar with from Oracle except this time it is populating your MySQL Database. Press Yes on the create schema prompt.

.Figure 57 MySQL Schema Creation Wait until your schema creation has completed as shown in Figure 58.

.Figure 58 MySQL Schema Creation Complete Take a moment to browse the schema that you have created and observe the populated data.

Run a MySQL Load Test In the same manner as you did for Oracle select the TPC-C Driver Script from the Benchmark and TPC-C Menus to populate the Script Editor Window. Observe that the driver script contains the MySQL and not the Oracle options.Figure 59 MySQL Data Task 7. .

Figure 60 MySQL Driver Script In the same way as you did for Oracle create the Virtual Users and Run the Hammerora Load Test. .

.Figure 61 MySQL Load Test The Load Test will show the status of the virtual users when the test is complete.

Figure 62 MySQL Test Complete You can also observe the Transaction Counter for MySQL throughput. . Figure 63 MySQL Transaction Counter Start the Transaction Counter in the same way as you did for Oracle with the pencil icon. Under the TX Counter Menu select TX Counter Options and populate the fields with your data.

You will benefit from taking the time to browse the documentation guides on the Hammerora website to improve your load testing expertise. Figure 64 MySQL Transaction Counter Task 8. In particular you may wish to investigate the following features: 1. MySQL timed tests and the generation of Oracle AWR reports to accurately assess the performance of your system and compare and contrast with the NOPM value. Hammerora will scale to test the largest of enterprise database environments processing many millions of transactions a minute and we have barely scratched the surface on Hammerora’s capabilities. 2. Next Steps In this tutorial we have introduced you to Hammerora and the steps to begin creating your own load testing scenarios.Re-run the load test and observe the MySQL Transaction Counter. The TPC-H workload will be of interest to Data Warehouse Users .

3. 4. Oracle Trace File Conversion and replay allows you to record and replay the bespoke Oracle environments and write your own load tests. Figure 65 Uninstall Hammerora . 5. The Modes feature allows you to connect multiple instances of Hammerora across a network to generate as large a load as required. The Autopilot feature also gives you the opportunity to run multiple tests with a varying number of users without interaction for overnight and weekend testing to improve your productivity. Finally if you wish to uninstall Hammerora you do do so with the uninstall executable in the hammerora directory as shown in figure 65. Middleware users can take advantage of HTTP Web Testing capabilities and record web browsing sessions using the Firefox web browser and replay them through hammerora. 6.

Sign up to vote on this title
UsefulNot useful