IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
aa1.properties
The following properties are listed in the aa.properties file. If you have more than one instance of the Archive Agent, you will have aa1.properties, aa2.properties, and so on.
- serverPortNumber
- This value specifies the port where the Archive Agent listens for the socket connections from the other components.
- queues.pmi.size
- The default value is 1024 Performance Monitoring Infrastructure (PMI) records. This value specifies the size of the PMI queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server pushes PMI data to this queue.
- queues.pmijmxengine.size
- The default value is 1024 PMI records. This value specifies the number of slots in the PMI Java Management Extensions (JMX) engine queue used to process data going from the Publish Server to the Archive Agent. If you are seeing items being dropped from the queue, you can increase the size, but that would also require an increase in the maximum heap size.
- queues.pmi.priority
- Request help from IBM support before attempting to modify this parameter. The default value is 5. This value specifies the priority of the PMI dequeuing thread (also known as the PMI Reader Thread). The default values range from 1 to 10.
- queues.method.size
- The default value is 5120 request records. This value specifies the size of the method or request queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server pushes request or method data to this queue.
- queues.method.priority
- Request help from IBM support before attempting to modify this parameter. The default value is 5 method availability records. This value specifies the priority of the method or request dequeuing thread (also known as the Request Reader Thread).
- queues.availability.size
- The default value is 3072 availability records. This value specifies the size of the availability queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server and Kernel push availability data to this queue.
- queues.availability.priority
- Request help from IBM support before attempting to modify this parameter. The default value is 5. This value specifies the priority of the availability dequeuing thread (also known as the Availability Reader Thread).
- queues.memory.size
- The default value is 1024 memory records. This value specifies the size of the memory queue. This is a circular queue and the Archive Agent wraps the queue (cleans the queue). If the queue reaches this set size, the Publish Server pushes memory related data (Garbage Collection data and Heap Dump data) to this queue.
- queues.memory.priority
- Request help from IBM support before attempting to modify this parameter. The default value is 5. This value specifies the priority of the memory dequeuing thread (also known as the Memory Reader Thread).
- queues.trap_actionHistory.size
- The default value is 1024 PMI records. This value specifies the number of slots in the trap action history queue used to process data going from the Publish Server to the Archive Agent. If you are seeing items being dropped from the queue, you can increase the size, but that would also require an increase in the maximum heap size.
- queues.polling.size
- The default value is 1024 PMI records. This value specifies the number of slots in the polling queue used to process data going from the Publish Server to the Archive Agent. If you are seeing items being dropped from the queue, you can increase the size, but that would also require an increase in the maximum heap size.
- TEXTSTRING_SEQ_BLOCK
- The default value is 1000. This value specifies how many keys the primary key generator should cache in memory for the table TEXTSTRING. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.
- TEXTSTRING_LENGTH
- The default value is 60. This value specifies the length of the URL string and method or class name string stored in the database. The maximum length is 256.
- PROBES_SEQ_BLOCK
- The default value is 10. This value specifies how many keys the primary key generator should cache in memory for the table PROBES. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However, this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.
- REQUEST_SEQ_BLOCK
- The default value is 200. This value specifies how many keys the primary key generator should cache in memory for the table REQUEST. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However, this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.
- REQUESTDATA_READER_SLEEPTIME
- The default value is 2000 milliseconds. This value specifies the time for which the Request reader thread sleeps if no data is available in the request or method queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue. The request data reader reads data from the request or method queue and processes the data and puts it in a temporary request buffer. A different thread (Request Data writer thread) reads data from this buffer and inserts it into the database.
- REQUESTDATA_WRITER_SLEEPTIME
- The default value is 180000 milliseconds. This value specifies the time interval at which the Request writer thread will be inserting data into the database. Request writer thread reads data from the request buffer and inserts it into the database.
- REQUESTDATA_BUFFER_THRESHOLD
- The default value is 20. If the number of requests in the request buffer exceeds this size, the writer thread wakes up and inserts requests into the database irrespective of the REQUESTDATA_WRITER_SLEEPTIME property.
- BATCH_THRESHOLD
- The default threshold is 10000 inserts in a batch. This value specifies the maximum number of database inserts that can be executed in a batch. When this number is exceeded, the database insert buffer is flushed to avoid running out of memory space.
- AVAILABILITY_READER_SLEEPTIME
- The default value is 2000 milliseconds. This value specifies the time that the Availability reader thread sleeps if no data is available in the availability queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue.
- PMI_READER_SLEEPTIME
- The default value is 2000 milliseconds. This value specifies the time that the PMI reader thread sleeps if no data is available in the PMI queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue.
- MEMORY_READER_SLEEPTIME
- The default value is 2000 milliseconds. This value specifies the time that the memory reader thread sleeps if no data is available in the memory queue for dequeuing (queue is empty). After this time elapses, the thread wakes up and re-checks the queue to see if data is available in the queue.
- TRAP_SEQ_BLOCK
- The default value is 100. This value specifies how many keys the primary key generator should cache in memory for the tables TRAP_HISTORY, TRAP_THREAD_DUMP, TRAP_METHOD_DETAIL, and TRAP_STACK_TRACE. A higher number increases efficiency by reducing the number of calls to the database to fetch the next block of keys. However, this might cause large gaps in the primary key sequence, because when the Archive Agent is stopped, all unused keys in memory are discarded.
- CLOB_BLOCK_SIZE
- Default 4000. This is the Character Large Object (CLOB) default reading size.
- ENABLE_DATATRIMMER
- The default value is true. When set to true, the Archive Agent cleans records that are more than two days old in some tables every two hours. If set to false, you need to manually run aa_deletedata.sh to clean tables. The aa_deletedata.properties contains a list of tables and frequency to delete data.
- MEMORY_DATA_DELETE_TIME
- The default value is 2940 minutes. This is the amount of time to keep data in the MEMORY_DATA table before it is deleted.
- GC_DATA_DELETE_TIME
- The default value is 2940 minutes. This is the amount of time to keep data in the GC_DATA table before it is deleted.
- SR_OVERVIEW_DATA_DELETE_TIME
- The default value is 70 minutes. This is the amount of time to keep data in the SR_OVERVIEW_DATA table before it is deleted.
- IMS_THREAD_DATA_DELETE_TIME
- The default value is 60 minutes. This is the amount of time to keep data in the IMS_THREAD_DATA table before it is deleted.
Parent topic:
Managing Server properties files