User's Guide c-treeace TPCA Test

Size: px

Start display at page:

Download "User's Guide c-treeace TPCA Test"

Emily Daniel
5 years ago
Views:

1 User's Guide c-treeace TPCA Test

3 1. Introduction The c-treeace TPCA Test benchmark utility is a multithreaded application that implements the Transaction Processing Performance Council Benchmark A test (also referred to as TPC-A). This test attempts to emulate an update intensive database environment. A brief description of the TPC-A test is available on the TCP website ( The c-treeace TPCA Test operates on 4 tables: branch - fixed record size of 166 bytes teller - fixed record size of 166 bytes account - fixed record size of 166 bytes history - fixed record size of 70 bytes A single TCP-A transaction consists of reading and updating 1 record in each of the first 3 tables and adding 1 record in the history table. Therefore each transaction is actually 7 database operations. The c-treeace TPCA Test benchmark utility implements the TPC-A test using each of the following c-treeace APIs: 1. c-treeace ISAM API 2. c-treeace C Database API 3. c-treeace SQL ODBC API The purpose of this test is to provide an "Apples-to-Apples" comparison across these three popular c-treeace APIs. 1.1 Login Details The user specifies the following required c-treeace Server parameters in this section: User Name The user name. Any c-tree user can run this test application. The default user is ADMIN (the user is not case sensitive). Password The user password. The default value for the ADMIN user is ADMIN (case sensitive). Server Name The server name as specified in the c-treeace Server configuration file (ctsrvr.cfg). The default value is FAIRCOMS. All Rights Reserved 3

Introduction Host The network IP address, or DNS name for the computer hosting the c-treeace Server. If the Server is running on the same machine as the client, use localhost for the best performance.

4 Introduction Host The network IP address, or DNS name for the computer hosting the c-treeace Server. If the Server is running on the same machine as the client, use localhost for the best performance. 1.2 ISAM & CTDB Tabs The c-treeace TPCA Test has three tabs across the top. This chapter will discuss portions of the ISAM and CTDB APIs window. Transaction Mode c-tree supports three levels of transaction control (also referred to in the industry as Journaling). These levels span the tradeoff between absolute data integrity to extreme performance. The choice of transaction control is application dependent, and is dictated by the application developer. TRNLOG Create - Full Transaction Processing -- When selecting TRNLOG, full transaction capability is enabled for the file. This provides two primary benefits: a. atomicity - means a set of operations may be grouped together and the updates to any files involved will all be committed or aborted together; and All Rights Reserved 4

5 Introduction b. automatic recovery - transaction logs are written to disk at every commit, and in case of any failure in the system, such as power supply problems, the c-treeace Server will automatically recover the files to the latest synchronous state. This is the most secure and expensive in terms of performance because of the time required to write the transaction log to disk. PREIMG Create - PreImage Processing -- PREIMG files still provide atomicity, however they do not allow for automatic recovery. This option is faster than TRNLOG since the transaction logs are not maintained, thereby eliminating the overhead of writing the transactions to disk. However, this mode does not guarantee the automatic recovery of the data and index files to their latest synchronous state in case of a failure in the system. No Transaction Processing -- Finally, it is possible to create files without any level of transaction support (e.g., no atomicity or automatic recovery). The performance increases as compared to TRNLOG and PREIMG, however the data integrity of the system is not guaranteed. This may be appropriate for conditions where absolute data is not a requirement (e.g., for temporary files, real-time transient data, or situations where the data is otherwise recoverable). The best choice for these parameters in an actual application depends on the specific application design. Run Details The Run Details portion of the screen allows the user to control two mutually exclusive options for controlling the duration of the test and provides the ability to modify the number of threads. Seconds To Run - This is the number of seconds for this test iteration to run. This option is mutually exclusive to Transactions To Run. Transactions To Run - This option specifies the number of transactions to run. This option is mutually exclusive to Seconds To Run. Number of Threads - This is the number of unique instances of this test program that will be simultaneously running against the c-treeace Server. Think of each thread as a user. All Rights Reserved 5

6 Introduction 1.3 ODBC Test The ODBC tab loads the following screen, which is similar to the ISAM and CTDB tabs. The primary differences are: The ODBC tab requires the user to specify the ODBC Driver to be used for the test. To execute this test using the ODBC API, you must have the c-treeace SQL Server and the <FC_PROD_ODBC> loaded locally or available on your network. Pull down the Driver list box to select the <FC_PROD_ODBC> as shown here: All Rights Reserved 6

7 Introduction The Transaction Mode is automatically set to full the Full Transaction Processing (page 4) mode (TRNLOG mode). 1.4 Last Run Threads This section of the c-treeace TPCA Test illustrates the per thread test results for the most recent test. The window below was executed with five threads and detail about the processing of each thread is listed. Last Run Thread Columns # Thread - This is a unique number assigned by the test program for uniquely identifying each thread. You should see one thread (numbered 1 through n) row for each thread specified in the Number of Threads field. Transactions - This is the number of transactions completed within the amount of time specified in the Seconds To Run option, or this is the number of transactions specified in the Transactions To Run option. Seconds - This is the number of seconds the test took to run the transactions specified in the Transactions To Run option, or the number of seconds specified in the Seconds To Run option. Max - This is the maximum time it took for the slowest operation to complete. Average - This column is the average time for each thread to complete 1 operation. Transactions Per Second Average - This column is the average time (measured in seconds) for each thread to complete all its operations. All Rights Reserved 7

Introduction 1.5 Results History For each execution of c-treeace TPCA Test a number of statistics are saved for comparison and are displayed in this section.

Average Time - This column is the average time for each thread to complete one transaction. # of Threads - This is the Number of Threads this test was executed with.

8 Introduction 1.5 Results History For each execution of c-treeace TPCA Test a number of statistics are saved for comparison and are displayed in this section. Total Transactions - This is the total number of operations all threads completed. Max Time - This is the maximum time it took for the slowest operation to complete. Average Time - This column is the average time for each thread to complete one transaction. # of Threads - This is the Number of Threads this test was executed with. Total Run Time - This is the total elapsed time it took for this test to complete; measured from the time the first thread started until the last thread completed. Transactions Per Second Average - This column provides the average number of transactions during the entire test, averaged across all threads. Run Mode - Lists the API used to conduct the test. Output will be one of the following: "ISAM Client", "CTDB Client", or "ODBC Client". Run Time - This is the date and time the test was executed. Note, it is also possible to save the Total History output to a text file. Right-click on any row within the "Total Results History" pane to access the Clear results and Dump Data menu as seen below. All Rights Reserved 8

9 Copyright Notice Copyright FairCom Corporation. All rights reserved. No part of this publication may be stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise without the prior written permission of FairCom Corporation. Printed in the United States of America. Information in this document is subject to change without notice. Trademarks c-treeace, c-treertg, c-treeams, c-tree Plus, c-tree, r-tree, FairCom and FairCom s circular disc logo are trademarks of FairCom, registered in the United States and other countries. The following are third-party trademarks: AMD and AMD Opteron are trademarks of Advanced Micro Devices, Inc. Macintosh, Mac, Mac OS, and Xcode are trademarks of Apple Inc., registered in the U.S. and other countries. Embarcadero, the Embarcadero Technologies logos and all other Embarcadero Technologies product or service names are trademarks, service marks, and/or registered trademarks of Embarcadero Technologies, Inc. and are protected by the laws of the United States and other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company. HP and HP-UX are registered trademarks of the Hewlett-Packard Company. AIX, IBM, POWER6, POWER7, and pseries are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Intel, Intel Core, Itanium, Pentium and Xeon are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Microsoft, the.net logo, the Windows logo, Access, Excel, SQL Server, Visual Basic, Visual C++, Visual C#, Visual Studio, Windows, Windows Server, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Novell and SUSE are registered trademarks of Novell, Inc. in the United States and other countries. Oracle and Java are registered trademarks of Oracle and/or its affiliates. QNX and Neutrino are registered trademarks of QNX Software Systems Ltd. in certain jurisdictions. CentOS, Red Hat, and the Shadow Man logo are registered trademarks of Red Hat, Inc. in the United States and other countries, used with permission. UNIX and UnixWare are registered trademarks of The Open Group in the United States and other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Python and PyCon are trademarks or registered trademarks of the Python Software Foundation. OpenServer is a trademark or registered trademark of Xinuos, Inc. in the U.S.A. and other countries. Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. in the United States and other countries. Btrieve is a registered trademark of Actian Corporation. ACUCOBOL-GT, MICRO FOCUS, RM/COBOL, and Visual COBOL are trademarks or registered trademarks of Micro Focus (IP) Limited or its subsidiaries in the United Kingdom, United States and other countries. iscobol and Veryant are trademarks or registered trademarks of Veryant in the United States and other countries. All other trademarks, trade names, company names, product names, and registered trademarks are the property of their respective holders. Portions Copyright Unicode, Inc. All rights reserved. Portions Copyright The OpenSSL Project. All rights reserved. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit ( Portions Copyright Eric Young (eay@cryptsoft.com). All rights reserved. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com). Portions Dharma Systems, Inc. All rights reserved. This software or web site utilizes or contains material that is DUNDAS DATA VISUALIZATION, INC. and its licensors, all rights reserved. Portions Copyright Jean-loup Gailly and Mark Adler. 8/14/2018

User's Guide c-treeace Load Test

User's Guide c-treeace Load Test Contents 1. Introduction to c-treeace Load Test... 3 1.1 Login Info... 4 1.2 Create Tables... 5 1.3 Run Test... 6 1.4 Last Run Threads... 7 1.5 Total Results History...