User's Guide c-treeace Replication Monitor

Transcription

1 User's Guide c-treeace Replication Monitor

2 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/13/2018

3 Contents 1. Introduction Startup Using the Main Window c-treeace Replication Monitor Menus and Toolbar Default Server Name Index... 8 All Rights Reserved iii

4

5 1. Introduction c-treeace Replication Monitor displays the activity of the c-treeams Replication Agent. The Replication Agent, ctreplagent, acts as a conduit to pass data from transaction log entries on a master server to a local replica. The Replication Agent is responsible for establishing connections to both c-treeace database engines, maintaining a current position in case of connection failures, and logging exceptional transactions that cannot be reliably replicated. For more detailed information about the c-treeams Replication Agent, see the ctrepl.chm help file installed with the product or view the c-treeace Replication Guide ( on the FairCom website. For additional information, view these online manuals: c-treeace Administrator s Guide ( c-treeace SQL Operations Guide ( All Rights Reserved 1

6 2. Startup The following connection window appears each time an instance of this utility is started. Server Connection Server Name/Port Number - Using this combo box you can select if you are going to specify the c-treeace Server Name or its TCP/IP port number in the underlying text box. This example shows the Server Name "FAIRCOMS". Machine Name/IP Address - Use this text box to specify the IP address or the machine name where the c-treeace Server is running. If your c-treeace Server is running on your local machine, using the "localhost" machine name will provide better performance. User Options User Name - Specify the user name you want to use to make the connection to the c-treeace Server. Password - Use this text box to enter the user's password. Note the default "User Name" and "User Password" are both "ADMIN" and the Password is case sensitive. When you are done, press OK to establish the connection. If you press Cancel the tool will not be connected to the c-treeace Server. All Rights Reserved 2

7 3. Using the Main Window Once you are connected to a c-treeace Server, the c-treeace Replication Monitor will allow you to view activity of the c-treeace Replication Agent. 3.1 c-treeace Replication Monitor The c-treeace Replication Monitor allows you to view the activities of the Replication Agent. This section contains some tips for using this tool. Replication Agent Buttons The buttons at the top of the Replication tab control the Replication Agent: Mode - Select Statistics or Exception Log to choose the information displayed in the grid below. Connect to Agent - Click this button to connect to the Replication Agent. Pause Agent - Click this button to pause operation of the Replication Agent (e.g., if you need to stop replication which you make a backup). Stop Agent - Click this button to shut down the Replication Agent. After stopping, it must be restarted manually. Upper Rows Date/Time - Shows the time stamp of the most recent transaction. Connection to Target - Shows if the connection to the Target Server (the local Replicated Server) is live. Connection to Source - Shows if the connection to the Source Server (Master Server) is live. Log Number - Shows the number of the entry in the Transaction Log that is being replicated. Log Position - Shows the position of the entry in the Transaction Log that is being replicated. State - Displays the state of the Replication Agent: Idle, Paused, Started, Stopped, in a call to the Target Server or Source Server, or Self (doing something in its own code). Sequence Number - Shows the number of times the function displayed in the Function column has been called. This is a number the Replication Agent increments for every function call it makes to the source and target servers. It is provided as an easy way to confirm activity is occurring within the system. Function - Shows the internal function that is being called. This field and Sequence Number are intended as a "heartbeat" to show that the system is running. All Rights Reserved 3

8 Using the Main Window Lower Rows Commits Pass - Shows the number of successful transaction commits on the Target Server. Adds Pass - Shows the number of successful adds on the Target Server. Deletes Pass - Shows the number of successful deletes on the Target Server. Commits Fail - Shows the number of unsuccessful transaction commits on the Target Server. Adds Fail - Shows the number of unsuccessful adds on the Target Server. Deletes Fail - Shows the number of unsuccessful deletes on the Target Server. Updates Fail - Shows the number of unsuccessful updates on the Target Server. 3.2 Menus and Toolbar Server Menu Use this menu to manage c-treeace Replication Monitor connections with the c-treeace Server. Connect - Shows the connection dialog in order to create a new connection between this utility and the c-treeace Server. Disconnect - Closes the current connection between this utility and the c-treeace Server. Exit - Disconnects this utility from the c-treeace Server and closes this utility. Options Menu Use this menu to access the c-treeace Monitor option settings. AutoConnect - If this option is active, a checkbox will appear next to the menu label and this utility will save the connection information used the last time to connect to the c-treeace Server. This will keep the Connection Options dialog box from appearing the next time this utility is started. AutoRefresh - Shows the dialog box that allows you to enable/disable auto refresh and to specify the number of seconds to wait between refresh operations. Set to 0 (zero) to disable this feature. All Rights Reserved 4

9 Using the Main Window Help Menu Use this menu to access the c-treeace Monitor help information. Help Contents - Display the c-treeace Replication Monitor help file. Help Index - Display the c-treeace Replication Monitor help index. Help Search - Display the c-treeace Replication Monitor help search window. About - Provide information about the version of the c-treeace Replication Monitor executable. Replication Monitor Tool Bar Tool bar items are shortcuts to the Menu commands, they can be very useful to pick fast server operation. - Connect - Shows the connection dialog in order to create a new connection between this utility and the c-treeace Server. or Disconnect - Closes the current connection between this utility and the c-treeace Server. If the "gray" icon is currently showing it means this utility is not currently connected to the Server. Servers Manager - Opens the Servers Manager window, which allows you to specify which c-treeace Servers will be monitored. Refresh - Refreshes the values displayed in the monitor. Auto Refresh - Allows the display to refresh automatically at a rate set using the Auto Refresh option in the Options drop-down menu. Back - In the Help tab, allows you to navigate through your browsing history to go back to pages you have read previously. Froward - In the Help tab, allows you to navigate through your browsing history to go forward after you have used the Back button. This button is not currently functional. Replication Agent Buttons This buttons at the top of the Replicaton tab control the Replication Agent: Mode - Select Statistics or Execption Log to choose the information displayed in the grid below. Connect to Agent - Click this button to connect to the Replication Agent. All Rights Reserved 5

10 Using the Main Window Pause Agent - Click this button to pause operation of the Replication Agent (e.g., if you need to stop replication which you make a backup). Stop Agent - Click this button to stop the Replication Agent. All Rights Reserved 6

11 4. Default Server Name Note: This is a Compatibility Change in V11.5. The default server name for the ctreplagent.exe process is FAIRAGENT. However, the default server in c-treereplmonitor.exe was FAIRCOMR. This utility's default server name has been changed from FAIRCOMR to FAIRAGENT so it will connect by default out-of-the-box. Note: After the first successful login, the Replication Agent server name is stored in the utility user registry, so users that are already logged in may still see the old server name. All Rights Reserved 7

12 5. Index C Copyright Notice ii c-treeace Replication Agent 1 c-treeace Replication Monitor 3 D Default Server Name 7 Documentation links 1 I Introduction 1 M Main Window 3 Menus and Toolbar 4 R Replication Agent 1 S Startup 2 U Using the Main Window 3 All Rights Reserved 8