7. Installing and Starting HammerDB on Windows

To install HammerDB on Windows you have the option of using the self-extracting installer or zipfile. The self-extracting installer will create an uninstall executable for you. A zipfile installation can be deleted manually. In both cases the install is entirely self-contained within the installation directory.

7.1. Self Extracting Installer

Double click on the Setup file the installer will confirm the Verified Publisher as the TRANSACTION PROCESSING PERFORMANCE COUNCIL. Click Yes to start the installation.

Figure 1.1. Verified Publisher

Verified Publisher

Click continue to begin the installation.

Figure 1.2. HammerDB Version

HammerDB Version

Read and Accept the GPL License Agreement.

Figure 1.3. GPL v3 License

GPL v3 License

Choose the installation directory.

Figure 1.4. Choose the Installation Directory

Choose the Installation Directory

Press Next to begin the install.

Figure 1.5. Files copying

Files copying

The installer will extract the files into the chosen directory.

Figure 1.6. Complete

Complete

Complete the Install by viewing the Readme File and running HammerDB. If both options are chosen HammerDB will run after the Readme is closed.

Figure 1.7. Complete the Setup Wizard

Complete the Setup Wizard

HammerDB will start ready for you to use. The default order of the databases in the treeview is in the order that they were added to HammerDB, however this is user configurable and will persist across restarts of HammerDB. To change the default order and understand how settings are persisted see section 9 XML Configuration further in this Chapter.

If it is the first time that HammerDB has run it will create a new Jobs repository database called hammer.DB, in the configured location in the config/generic.xml file which by default is set to TMP <commandline><sqlite_db>TMP</sqlite_db></commandline> to find a suitable temp location. Subsequent use will use the same file for storing job related data. This file can moved if another location is preferred or if deleted a new one will be recreated.

Figure 1.8. HammerDB Started

HammerDB Started

7.2. tar.gz file

As an alternative to the self-extracting installer you can download and extract the .tar.gz file HammerDB-5.0-Prod-Win.tar.gz into a directory of your choice using a utility such as 7-zip.

7.3. Starting HammerDB

After installation double-click on the executable file hammerdb.exe to start hammerdb.

Figure 1.9. hammerdb executable

hammerdb executable

7.4. Uninstalling HammerDB

For a zipfile installation, delete the hammerDB directory. For an installer based installation double-click on uninstall and follow the on-screen prompts.

Figure 1.10. Uninstall

Uninstall

In addition to the HammerDB software deletion there is also a number of SQLite database files by default stored in the temporary area that hold the state of the current HammerDB configuration for each database. These can be safely removed on uninstall. Also present in this area is the hammer.DB file that stores all of the data related to HammerDB jobs. This be removed if no longer needed, however also note that this file can be copied (and is compatible on both Linux and Windows) and moved to another system to view the results recorded in this file with the HammerDB web service.


Figure 1.11. Uninstall database files

Uninstall database files