Summary of Contents for Sybase Adaptive Server Anywhere SNMP Extension Agent
Page 1
® Adaptive Server Anywhere SNMP Extension Agent User’s Guide Part number: DC00192-01-0902-01 Last modified: December 2004...
Page 2
No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of iAnywhere Solutions, Inc. iAnywhere Solutions, Inc. is a subsidiary of Sybase, Inc.
I Using the Adaptive Server Anywhere SNMP Ex- tension Agent 1 The Adaptive Server Anywhere SNMP Extension Agent Introduction to the Adaptive Server Anywhere SNMP Exten- sion Agent ......
Audience This manual is for Adaptive Server Anywhere users who wish to use the Adaptive Server Anywhere SNMP Extension Agent on Windows 2000, Windows XP, or Windows Server 2003 (32-bit versions). It is to be used in conjunction with other manuals in the documentation set.
PowerBuilder can use the programming interfaces provided by those tools. It also describes the Adaptive Server Anywhere ADO.NET data provider. Adaptive Server Anywhere SNMP Extension Agent User’s Guide This book describes how to configure the Adaptive Server Anywhere SNMP Extension Agent for use with SNMP management applications to manage Adaptive Server Anywhere databases.
Page 7
Anywhere databases using an indirect link such as e-mail or file transfer. This book includes the context-sensitive SQL Anywhere Studio Help help for Sybase Central, Interactive SQL, and other graphical tools. It is not included in the printed documentation set. This book is intended for all UltraLite Database User’s Guide...
Page 8
files, viewable with Adobe Acrobat Reader. The PDF books are accessible from the online books, or from the Windows Start menu. The complete set of books is available from Sybase Printed books sales or from eShop, the Sybase online store at http://eshop.sybase.com/eshop/documentation...
Documentation conventions This section lists the typographic and graphical conventions used in this documentation. The following conventions are used in the SQL syntax descriptions: Syntax conventions Keywords All SQL keywords appear in upper case, like the words ALTER TABLE in the following example: ALTER TABLE [ owner.]table-name Placeholders Items that must be replaced with appropriate identifiers...
Page 10
The following icons are used in this documentation. Graphic icons A client application. A database server, such as Sybase Adaptive Server Anywhere. A database. In some high-level diagrams, the icon may be used to represent both the database and the database server that manages it.
The Adaptive Server Anywhere sample database Many of the examples throughout the documentation use the Adaptive Server Anywhere sample database. The sample database is held in a file named asademo.db , and is located in your SQL Anywhere directory. The sample database represents a small company. It contains internal information about the company (employees, departments, and finances) as well as product information and sales information (sales orders, customers, and contacts).
You can provide feedback on this documentation and on the software through newsgroups set up to discuss SQL Anywhere technologies. These newsgroups can be found on the forums.sybase.com news server. The newsgroups include the following: Newsgroup disclaimer iAnywhere Solutions has no obligation to provide solutions, information...
The Adaptive Server Anywhere SNMP Extension Agent This chapter introduces you to the Adaptive Server Anywhere SNMP About this chapter Extension Agent. Contents Topic: Introduction to the Adaptive Server Anywhere SNMP Extension Agent Understanding SNMP Using the Adaptive Server Anywhere SNMP Extension Agent page...
One agent can be used to monitor several different databases running on different database servers running on different machines. Using the Adaptive Server Anywhere SNMP Extension Agent, you can do the following: The following files for the Adaptive Server Anywhere SNMP Extension Supplied files...
Page 17
Chapter 1. The Adaptive Server Anywhere SNMP Extension Agent asasnmp.ini This file lists the databases that the Adaptive Server Anywhere SNMP Extension Agent monitors. By default, this file is located in C:\Program Files\Sybase\SQL Anywhere 9\win32 .
MIBs: 1.3.6.1.4.1.897 Adaptive Server Anywhere MIB Adaptive Server Anywhere SNMP Extension Agent. All the OIDs in the Adaptive Server Anywhere MIB begin with Adaptive Server Anywhere MIB lists the OIDs for the statistics, properties, and option values that can be retrieved, and in some cases set, using the Adaptive Server Anywhere SNMP Extension Agent.
Page 19
Chapter 1. The Adaptive Server Anywhere SNMP Extension Agent The Adaptive Server Anywhere MIB The Adaptive Server Anywhere MIB was created for the Adaptive Server Anywhere SNMP Extension Agent. It includes all database server statistics and properties, as well as all database statistics, properties, and options. The statistics and properties are all read-only (with a few exceptions), and the database options are all read-write.
Page 20
1.3.6.1.4.897.2.3.3. db 1.3.6.1.4.897.2.3.4. db 1.3.6.1.4.897.2.3.5. db 1.3.6.1.4.897.2.4 Note that when stopping a database by setting this variable, the stop is unconditional, meaning that the database will be stopped even if it has active connections. In order to be able to start a database by setting this variable, the DBF parameter must be specified in the connection string (along with DBN if desired and DBKEY if required), and either (a) the UtilDbPwd field must be set in the asasnmp.ini file, or (b) the start database permission on the server...
The RDBMS MIB uses virtual tables to return information on the servers and databases. The base OID is Adaptive Server Anywhere SNMP Extension Agent supports 8 of these virtual tables. The Adaptive Server Anywhere Extension Agent provides read-only access to all of the supported variables in the RDBMS MIB.
Using the Adaptive Server Anywhere SNMP Extension Agent In order to use the Adaptive Server Anywhere SNMP Extension Agent, you must have SNMP installed on your machine and you must create an asasnmp.ini file that contains information about the databases that are monitored by the Adaptive Server Anywhere SNMP Extension Agent.
Page 23
To check that the SNMP services are installed on your computer 1. Open the Control Panel. On Windows 2000, from the Start menu choose Settings Panel. On Windows XP, from the Start menu choose Control Panel. 2. In the Control Panel, double-click Administrative Tools. 3.
Page 24
file in the C:\Program Files\Sybase\SQL Anywhere 9\win32 directory. Once you edit this file, you must restart the SNMP service or reset the Adaptive Server Anywhere SNMP Extension Agent so that the new settings are used by the Agent. To restart the SNMP service (Control Panel) 1.
Page 25
TrapPollTime field is not required, you can omit the entire section. TrapPollTime they are specified. The Adaptive Server Anywhere SNMP Extension Agent polls the values every 5 seconds by default. Setting this value to 0 disables dynamic traps. This field is optional.
Page 26
UtilDbPwd the Adaptive Server Anywhere SNMP Extension Agent attempts to connect to the database with the DBF parameter, which tells the database server where to find the database file. However, if the permission required to start the database is DBA (the default for the network server, which can also be set using the -gd dba option for both the personal and network servers), then the server will not allow the connection.
Page 27
ConnStr=UID=DBA;PWD=SQL;LINKS=tcpip;ENG=server2;DBN=hq;DBF=hq.db UtilDbPwd=test Because there are no parameters specified in the ASAAgent section, the Adaptive Server Anywhere SNMP Extension Agent will poll values every 5 seconds. The Adaptive Server Anywhere SNMP Extension Agent is monitoring 3 different databases running on two different servers. Database 3 is running on a different machine, so the LINKS connection parameter is required to specify the protocol.
Page 28
The way you retrieve these values will depend on your SNMP management software. Examples The table below provides a description and sample value that could be returned for the following OIDs. 1.3.6.1.4.1.897.2.1.1.1.1 1.3.6.1.4.1.897.2.1.2.1.3 1.3.6.1.4.1.897.2.2.1.4.1 1.3.6.1.4.1.897.2.2.2.7.4 1.3.6.1.4.1.897.2.2.3.5.2 1.3.6.1.4.1.897.2.3.1 1.3.6.1.4.1.897.2.3.2.1 For a list of the database server statistic OIDs, see on page Database options For a list of the database option OIDs, see...
Page 29
The way you set these values depends on your SNMP management software. be set with the Adaptive Server Anywhere SNMP Extension Agent, see “The Adaptive Server Anywhere MIB” on page Executing stored procedures using the Adaptive Server Anywhere SNMP...
Page 30
For example, setting the value of “ pchin.updatesales( ’param1’, 2) procedure owned by user pchin. The way you set the value of this OID to the procedure name will depend on your SNMP management software. page Using traps A trap is an OID that is sent by an SNMP agent when a particular event occurs.
Page 31
Chapter 1. The Adaptive Server Anywhere SNMP Extension Agent Adaptive Server The Adaptive Server Anywhere SNMP Extension Agent sends a trap whenever a connection is dropped by the database server. The OID of this Anywhere SNMP trap is Extension Agent traps The only other traps sent by the Adaptive Server Anywhere agent are dynamic traps.
Page 32
Note Only equality or inequality are supported for string values. value in single or double quotes; these quotes will not be included in the value. If you want the beginning or closing quotation marks to be included in the string, you must double them. Note that single quotes occurring within the string should not be doubled.
DAPTIVE ERVER SNMP NYWHERE XTENSION GENT EFERENCE This section lists the OIDs supported by the Adaptive Server Anywhere SNMP Extension Agent. It lists the contents of the tables in the Adaptive Server Anywhere MIB and the RDBMS MIB.
CHAPTER 2 Adaptive Server Anywhere MIB Reference About this chapter This chapter contains descriptions of the tables in the Adaptive Server Anywhere MIB. Contents Topic: The Adaptive Server Anywhere MIB page...
The Adaptive Server Anywhere MIB The following sections list the OIDs of the statistics, properties, and options that can be retrieved and set using the Adaptive Server Anywhere SNMP Extension Agent. By default, Agent The Agent table lists information about the Adaptive Server Anywhere SNMP Extension Agent.
Page 37
1.3.6.1.4.1.897.2.4.1.1.1.1. db 1.3.6.1.4.1.897.2.4.1.1.1.2. db 1.3.6.1.4.1.897.2.4.1.1.1.3. db 1.3.6.1.4.1.897.2.4.1.1.1.4. db 1.3.6.1.4.1.897.2.4.1.1.1.5. db Values: 1=Server, 2=Database Values: 1=Statistic, 2=Property, 3=Option The OID returned does not include the database number. You must append the database number to the OID before it can be used in a query. asaSrvMetaData.asaSrvPropMetaDataTable This table contains metadata about the database server properties.
Page 38
The value db is the database number in the asasnmp.ini file. 1.3.6.1.4.1.897.2.4.2.1.1.1. db 1.3.6.1.4.1.897.2.4.2.1.1.2. db 1.3.6.1.4.1.897.2.4.2.1.1.3. db 1.3.6.1.4.1.897.2.4.2.1.1.4. db 1.3.6.1.4.1.897.2.4.2.1.1.5. db Values: 1=Server, 2=Database Values: 1=Statistic, 2=Property, 3=Option The OID returned does not include the database number. You must append the database number to the OID before it can be used in a query.
OID before it can be used in a query. Server statistics This table lists the OIDs and names of the database server statistics that can be retrieved using the Adaptive Server Anywhere SNMP Extension Agent. The value n is the database number in the asasnmp.ini file. Type 1.3.6.1.4.1.897.2.1.1.1.
Page 40
Type 1.3.6.1.4.1.897.2.1.1.9. n Counter64 1.3.6.1.4.1.897.2.1.1.10. n Counter64 1.3.6.1.4.1.897.2.1.1.11. n Integer32 1.3.6.1.4.1.897.2.1.1.12. n Counter64 1.3.6.1.4.1.897.2.1.1.13. n Integer32 1.3.6.1.4.1.897.2.1.1.14. n Integer32 1.3.6.1.4.1.897.2.1.1.15. n Integer32 1.3.6.1.4.1.897.2.1.1.16. n Integer32 1.3.6.1.4.1.897.2.1.1.17. n Counter64 1.3.6.1.4.1.897.2.1.1.18. n Integer32 1.3.6.1.4.1.897.2.1.1.19. n Integer32 1.3.6.1.4.1.897.2.1.1.20. n Integer32 1.3.6.1.4.1.897.2.1.1.21. n Integer32 1.3.6.1.4.1.897.2.1.1.22.
Server properties The following table lists OIDs and names of the database server properties that can be retrieved using the Adaptive Server Anywhere SNMP Extension Agent. Writable properties are marked with an asterisk (*). The value n is the database number in the asasnmp.ini file. Type 1.3.6.1.4.1.897.2.1.2.1.
Page 42
Type 1.3.6.1.4.1.897.2.1.2.23. n String 1.3.6.1.4.1.897.2.1.2.24. n String 1.3.6.1.4.1.897.2.1.2.25. n String 1.3.6.1.4.1.897.2.1.2.26. n String 1.3.6.1.4.1.897.2.1.2.27. n String 1.3.6.1.4.1.897.2.1.2.28. n String 1.3.6.1.4.1.897.2.1.2.29. n String 1.3.6.1.4.1.897.2.1.2.30. n String 1.3.6.1.4.1.897.2.1.2.31. n String 1.3.6.1.4.1.897.2.1.2.32. n String 1.3.6.1.4.1.897.2.1.2.33. n String 1.3.6.1.4.1.897.2.1.2.34. n String 1.3.6.1.4.1.897.2.1.2.35. n String 1.3.6.1.4.1.897.2.1.2.36.
Page 43
String Database statistics The following table lists the OIDs and names the database statistics that can be retrieved using the Adaptive Server Anywhere SNMP Extension Agent. The value n is the database number in the asasnmp.ini file. Type 1.3.6.1.4.1.897.2.2.1.1. n Counter64 1.3.6.1.4.1.897.2.2.1.2.
Page 44
Type 1.3.6.1.4.1.897.2.2.1.12. n Integer32 1.3.6.1.4.1.897.2.2.1.13. n Integer32 1.3.6.1.4.1.897.2.2.1.14. n Integer32 1.3.6.1.4.1.897.2.2.1.15. n Integer32 1.3.6.1.4.1.897.2.2.1.16. n Integer32 1.3.6.1.4.1.897.2.2.1.17. n Integer32 1.3.6.1.4.1.897.2.2.1.18. n Integer32 1.3.6.1.4.1.897.2.2.1.19. n Integer32 1.3.6.1.4.1.897.2.2.1.20. n Integer32 1.3.6.1.4.1.897.2.2.1.21. n Integer32 1.3.6.1.4.1.897.2.2.1.22. n Integer32 1.3.6.1.4.1.897.2.2.1.23. n Integer32 1.3.6.1.4.1.897.2.2.1.24. n Integer32 1.3.6.1.4.1.897.2.2.1.25.
Type 1.3.6.1.4.1.897.2.2.1.36. n Integer32 1.3.6.1.4.1.897.2.2.1.37. n Integer32 1.3.6.1.4.1.897.2.2.1.38. n Integer32 1.3.6.1.4.1.897.2.2.1.39. n Integer32 1.3.6.1.4.1.897.2.2.1.40. n Integer32 1.3.6.1.4.1.897.2.2.1.41. n Integer32 1.3.6.1.4.1.897.2.2.1.42. n Integer32 1.3.6.1.4.1.897.2.2.1.43. n Integer32 1.3.6.1.4.1.897.2.2.1.44. n Integer32 1.3.6.1.4.1.897.2.2.1.45. n Counter64 1.3.6.1.4.1.897.2.2.1.46. n Integer32 1.3.6.1.4.1.897.2.2.1.47. n Integer32 1.3.6.1.4.1.897.2.2.1.48. n Integer32 1.3.6.1.4.1.897.2.2.1.49.
Page 46
can be retrieved using the Adaptive Server Anywhere SNMP Extension Agent. Writable properties are marked with an asterisk (*). The value n is the database number in the asasnmp.ini file. 1.3.6.1.4.1.897.2.2.2.1. n 1.3.6.1.4.1.897.2.2.2.2. n 1.3.6.1.4.1.897.2.2.2.3. n 1.3.6.1.4.1.897.2.2.2.4. n 1.3.6.1.4.1.897.2.2.2.5. n 1.3.6.1.4.1.897.2.2.2.6.
Page 47
Type 1.3.6.1.4.1.897.2.2.2.25. n String 1.3.6.1.4.1.897.2.2.2.26. n String 1.3.6.1.4.1.897.2.2.2.27. n String 1.3.6.1.4.1.897.2.2.2.28. n String 1.3.6.1.4.1.897.2.2.2.29. n String 1.3.6.1.4.1.897.2.2.2.30. n String 1.3.6.1.4.1.897.2.2.2.31. n String 1.3.6.1.4.1.897.2.2.2.32. n String 1.3.6.1.4.1.897.2.2.2.33. n String 1.3.6.1.4.1.897.2.2.2.34. n String 1.3.6.1.4.1.897.2.2.2.35. n String 1.3.6.1.4.1.897.2.2.2.36. n String 1.3.6.1.4.1.897.2.2.2.37. n String 1.3.6.1.4.1.897.2.2.2.38.
Database options The following table lists the OIDs and names of the database options that can be retrieved using the Adaptive Server Anywhere SNMP Extension Agent. Writable options are marked with an asterisk (*). The value n is the database number in the asasnmp.ini file.
Page 49
1.3.6.1.4.1.897.2.2.3.19. n 1.3.6.1.4.1.897.2.2.3.20. n 1.3.6.1.4.1.897.2.2.3.21. n 1.3.6.1.4.1.897.2.2.3.22. n 1.3.6.1.4.1.897.2.2.3.23. n 1.3.6.1.4.1.897.2.2.3.24. n 1.3.6.1.4.1.897.2.2.3.25. n 1.3.6.1.4.1.897.2.2.3.26. n 1.3.6.1.4.1.897.2.2.3.27. n 1.3.6.1.4.1.897.2.2.3.28. n 1.3.6.1.4.1.897.2.2.3.29. n 1.3.6.1.4.1.897.2.2.3.30. n 1.3.6.1.4.1.897.2.2.3.31. n 1.3.6.1.4.1.897.2.2.3.32. n 1.3.6.1.4.1.897.2.2.3.33. n 1.3.6.1.4.1.897.2.2.3.34. n 1.3.6.1.4.1.897.2.2.3.35. n 1.3.6.1.4.1.897.2.2.3.36. n 1.3.6.1.4.1.897.2.2.3.37. n 1.3.6.1.4.1.897.2.2.3.38. n 1.3.6.1.4.1.897.2.2.3.39.
Page 50
1.3.6.1.4.1.897.2.2.3.43. n 1.3.6.1.4.1.897.2.2.3.44. n 1.3.6.1.4.1.897.2.2.3.45. n 1.3.6.1.4.1.897.2.2.3.46. n 1.3.6.1.4.1.897.2.2.3.47. n 1.3.6.1.4.1.897.2.2.3.48. n 1.3.6.1.4.1.897.2.2.3.49. n 1.3.6.1.4.1.897.2.2.3.50. n 1.3.6.1.4.1.897.2.2.3.51. n 1.3.6.1.4.1.897.2.2.3.52. n 1.3.6.1.4.1.897.2.2.3.53. n 1.3.6.1.4.1.897.2.2.3.54. n 1.3.6.1.4.1.897.2.2.3.55. n 1.3.6.1.4.1.897.2.2.3.56. n 1.3.6.1.4.1.897.2.2.3.57. n 1.3.6.1.4.1.897.2.2.3.58. n 1.3.6.1.4.1.897.2.2.3.59. n 1.3.6.1.4.1.897.2.2.3.60. n 1.3.6.1.4.1.897.2.2.3.61. n 1.3.6.1.4.1.897.2.2.3.62. n 1.3.6.1.4.1.897.2.2.3.63.
Page 51
1.3.6.1.4.1.897.2.2.3.67. n 1.3.6.1.4.1.897.2.2.3.68. n 1.3.6.1.4.1.897.2.2.3.69. n 1.3.6.1.4.1.897.2.2.3.70. n 1.3.6.1.4.1.897.2.2.3.71. n 1.3.6.1.4.1.897.2.2.3.72. n 1.3.6.1.4.1.897.2.2.3.73. n 1.3.6.1.4.1.897.2.2.3.74. n 1.3.6.1.4.1.897.2.2.3.75. n 1.3.6.1.4.1.897.2.2.3.76. n 1.3.6.1.4.1.897.2.2.3.77. n 1.3.6.1.4.1.897.2.2.3.78. n 1.3.6.1.4.1.897.2.2.3.79. n 1.3.6.1.4.1.897.2.2.3.80. n 1.3.6.1.4.1.897.2.2.3.81. n 1.3.6.1.4.1.897.2.2.3.82. n 1.3.6.1.4.1.897.2.2.3.83. n 1.3.6.1.4.1.897.2.2.3.84. n 1.3.6.1.4.1.897.2.2.3.85. n 1.3.6.1.4.1.897.2.2.3.86. n 1.3.6.1.4.1.897.2.2.3.87.
Page 52
1.3.6.1.4.1.897.2.2.3.91. n 1.3.6.1.4.1.897.2.2.3.92. n 1.3.6.1.4.1.897.2.2.3.93. n 1.3.6.1.4.1.897.2.2.3.94. n 1.3.6.1.4.1.897.2.2.3.95. n 1.3.6.1.4.1.897.2.2.3.96. n 1.3.6.1.4.1.897.2.2.3.97. n 1.3.6.1.4.1.897.2.2.3.98. n 1.3.6.1.4.1.897.2.2.3.99. n 1.3.6.1.4.1.897.2.2.3.100. n 1.3.6.1.4.1.897.2.2.3.101. n 1.3.6.1.4.1.897.2.2.3.102. n 1.3.6.1.4.1.897.2.2.3.103. n 1.3.6.1.4.1.897.2.2.3.104. n 1.3.6.1.4.1.897.2.2.3.105. n 1.3.6.1.4.1.897.2.2.3.106. n 1.3.6.1.4.1.897.2.2.3.107. n 1.3.6.1.4.1.897.2.2.3.108. n 1.3.6.1.4.1.897.2.2.3.109. n 1.3.6.1.4.1.897.2.2.3.110. n 1.3.6.1.4.1.897.2.2.3.111.
CHAPTER 3 RDBMS MIB Reference This chapter contains descriptions of each of the tables in the RDBMS MIB. About this chapter Contents Topic: The RDBMS MIB page...
The RDBMS MIB The following sections list the OIDs of the values that can be retrieved using the Adaptive Server Anywhere SNMP Extension Agent. By default, the RDBMS MIB is located in C:\Program Files\Sybase\SQL Anywhere 9\snmp\RDBMS-MIB.mib . rdbmsDbTable This table lists information about the databases installed on a system.
Page 55
1.3.6.1.2.1.39.1.2.1.3. db 1.3.6.1.2.1.39.1.2.1.4. db 1.3.6.1.2.1.39.1.2.1.5. db 1.3.6.1.2.1.39.1.2.1.6. db This OID is not currently supported by the Adaptive Server Anywhere SNMP Extension Agent. rdbmsDbParamTable This table lists the configuration parameters for the databases on the system. The value db is the database number in the asasnmp.ini file, while n is the index of the option in the 1.3.6.1.2.1.39.1.3.1.1.
Page 56
This OID is not currently supported by the Adaptive Server Anywhere SNMP Extenstion Agent. rdbmsDbLimitedResourceTable This table lists free space information on each dbspace. In this table, n represents each dbspace as follows: The value db is the database number in the asasnmp.ini file. 1.3.6.1.2.1.39.1.4.1.1.
Page 57
rdbmsSrvTable This table lists the database servers running or installed on your system. The value db is the database number in the asasnmp.ini file. Type 1.3.6.1.2.1.39.1.5.1.1. db 1.3.6.1.2.1.39.1.5.1.2. db String 1.3.6.1.2.1.39.1.5.1.3. db String 1.3.6.1.2.1.39.1.5.1.4. db String rdbmsSrvInfoTable This table lists additional information about the database servers in your system.
Page 58
Type 1.3.6.1.2.1.39.1.6.1.13. db Integer 1.3.6.1.2.1.39.1.6.1.14. db Integer This OID is not currently supported by the Adaptive Server Anywhere SNMP Extenstion Agent. rdbmsSrvParamTable This table lists the server options that can be set by the Adaptive Server Anywhere SNMP Extension Agent through the Adaptive Server Anywhere MIB.
Page 59
The value db is the database number in the asasnmp.ini file, while n is the index of the resource as follows: Type 1.3.6.1.2.1.39.1.8.1.1. db String 1.3.6.1.2.1.39.1.8.1.2. db 1.3.6.1.2.1.39.1.8.1.3. db Integer 1.3.6.1.2.1.39.1.8.1.4. db Integer 1.3.6.1.2.1.39.1.8.1.5. db Integer 1.3.6.1.2.1.39.1.8.1.6. db Integer 1.3.6.1.2.1.39.1.8.1.7. db String This OID is not currently supported by the Adaptive Server Anywhere SNMP Extenstion Agent.
Need help?
Do you have a question about the Adaptive Server Anywhere SNMP Extension Agent and is the answer not in the manual?
Questions and answers