Bischeck
-
Release Notes
Version 1.1.2
2014-11-23
Legal Notice Copyright
© 2013-2014 Ingenjörsbyn AB.
This document is licensed by Ingenjörsbyn AB under the Creative Commons Attribution-ShareAlike 3.0 Unported License,
http://creativecommons.org/licenses/by-sa/3.0/. If you distribute this document, or a modified version of it, you have to provide attribution to Ingenjörsbyn AB. and provide a link to the original.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
Nagios® is an official trademark of Nagios Enterprise Inc.
All other trademarks are the property of their respective owners.
1 Release 1.1.2 - 2015-11-23
Release 1.1.2 is a bug fix release.
1.1 New features
1.2 Bugs fixed and important issues
-
[TR-266,264] - “Using 2 periods for cache purge.” When using purge with period of week or year a NumberFormatException was thrown due to the fact that week and year was calculated to a timestamp.
-
[TR-265] - “Problem with negative values”. Negative metrics values became positive.
1.3 Upgrading
Release 1.1.2 support upgrade from release 1.1.X.
2 Release 1.1.1 - 2014-09-23
Release 1.1.1 is a minor upgrade of Bischeck. The most important is a fix for a major performance issue related to time based queries. Even if the performance issue was reported as bug, the result was correct. If you store a high number of items per service definitions in the cache, +1000, you should definitely upgrade.
2.1 New features
2.2 Bugs fixed and important issues
-
[TR-259] - “Using period rather than count for cache purge throws error”. A NullPointerExceptions was thrown when there where no items in the cache for the specific service definition that was older then the time interval defined by the purging interval. That means that there are no items in the cache that should be removed which is correct. The problem was that the null was not handled. When there where items older then the specified purge period the items are correctly removed.
-
[TR-260] - “High CPU consumption by bischeck and redis-server”. This issue was related to time based Redis cache queries. The cpu was especially high when the cache linked list was very large, +1000 items. From doing a sequential search to find the “right” timestamp, we now do a binary search resulting in a much more predictive response and utilization. For a linked list with 15000 items we would with the previous version had to search 15000 times if the time query resolved to the last item in the cache. With the binary search we get instead on around 13 searches independent of location of the cache.
2.3 Upgrading
Release 1.1.1 support upgrade from release 1.1.0.
3 Release 1.1.0 - 2014-06-16
Release 1.1.0 is a minor upgrade of Bischeck with some new features.
3.1 New features
-
Command line utility to explore cache content. Support for full syntax of Bischeck mathematical expression to enable simple testing of threshold expressions and virtual services. For more information see the “Bischeck - Installation and administration guide”.
-
Server integration with Librato, https://metrics.librato.com/, is now supported. The server integration with Librato enables Bischeck metrics to be sent to Librato’s cloud monitoring service. For more information see the “Bischeck - Configuration guide”.
-
NRDP server integration is supported over SSL. Use the property ssl in the server.xml in the NRDP section to enable SSL. Default is false.
-
Support to disable SSL (X.509) certification validation for connection over HTTPS, like NRDP. Set the property disableCertificateValidation in the properties.xml. Disable validation have its risks - you have been warned. The default is false.
A more secure way to manage certificates is to create a local keystore for Bischeck, see http://docs.oracle.com/javase/6/docs/technotes/tools/solaris/keytool.html. This will also require setup of additional system properties to java that has to be added in the $BISHOME/bin/bischeck script. Loads of documentation exists on the web.
-
Support for Jolokia, http://www.jolokia.org/, for JMX remoting. Jolokia is a jmx agent that support HTTP/JSON access and remove all the problems with the standard JMX agent that use RMI. RMI is especially problematic in any network environment with firewalls. With Jolokia its simple to tunnel the JMX connection over ssh. Jolokia provides fine grain security and access capabilities.
The RMI based JMX agent is still the default, but that will change in the future releases of Bischeck. If you like to use Jolokia with Bischeck 1.1.0 just uncomment row 53 and comment row 52 in the $BISHOME/bin/bischeck script.
Two additional configuration files has been added to the $BISHOME/resources directory to control the behavior of Jolokia:
-
Add function to calculate the standard deviation on a series of data.
-
Add function to calculate the median value on a series of data.
-
[FR-252] “Adding the hour level to the period definition”. This feature request enable fine grain granularity of the warning and critical level for a specific hour interval.
Between 00 - 11:59 the warning and critical values in the period section will be used and between 12 and 23:59 the warning and critical "override" values are used. For the threshold between 11 and 12 the linear equation will be used to calculate the threshold value starting at 1000 at 11:00 and 2000 at 12:00, but the warning and critical will in that time interval be the values from the period section. For more information see the “Bischeck - Configuration guide”.
-
Testing of thresholds rules has been enhanced. The bin/bischeck threshold.Twenty4HourThreshold command will list the resolved threshold configuration depending on the service definition and date, and in addition calculate the state and threshold for specific measured value and at the time of the day. For thresholds that are based on cached expression the threshold will be calculate if the data are available in the cache. For more information see the “Bischeck - Installation and administration guide”.
-
[FR-254] “Enable to test service in op5 web interface”. This request is not limited to Nagios/OP5, but the capability to on-demand execute a service and its serviceitems in Bischeck. This functionality has been implemented using JMX. The MBean is called com.ingby.socbox.bischeck.service:type=ExecuteServiceOnDemand and have a method with the following signature:
boolean execute(java.lang.String host,java.lang.String service)
If you using Jolokia as JMX agent a valid call to execute the service sshport for host moon would be:
$ curl http://localhost:7777/jolokia/exec/com.ingby.socbox.bischeck.service:type=ExecuteServiceOnDemand/execute/moon/sshport
{"timestamp":1400018354,"status":200,"request":{"operation":"execute","mbean":"com.ingby.socbox.bischeck.service:type=ExecuteServiceOnDemand","arguments":["moon","sshport"],"type":"exec"},"value":true}
To use the function from Nagios as a check command their are a number of things to consider when implementing a check command (we have not done that, thats your task):
-
Use the $HOSTNAME$ macro has the host parameter
-
Use the $SERVICEDESC$ macros has the service parameter
-
Make sure that check command return the same status as the current status since the “real” status will come from Bischeck through the normal passive check and not from the check command. That means that the check command must also use the macro $SERVICESTATEID$ to return the same value so the state is not changed.
-
Its also important to understand that the on-demand function will not return any performance data. The MBean only return true if the job could be scheduled and false if the host and/or service name do not exists or that the scheduling fail.
3.2 Bugs fixed and important issues
-
[TR-257] “No Nagios state on null”. This bug caused no state information to be sent to Nagios if any serviceitems for a service if the serviceitems metrics was null.
-
Bischeck is not longer checking if the pid file exist on start up. This was removed since it’s problematic from Java in a standard way determine the pid of the running process. Instead the its now up to the bischeckd script.he
-
If many services definitions are configured with aggregation the peek load every hour can be very high. In previous release the schedule was kicked off with a cron definition where the second was set to 0. With 1.1.0 the second field will be set to a random value between 0-59. This distribute the scheduling off aggregation over a interval of a minute.
-
The install script with the upgrade option -X will copy existing logback.xml configuration in addition to all configuration files in the etc directory.
3.3 Upgrading
Release 1.1.0 support upgrade from release 1.0.0, 1.0.1 and 1.0.2. If you upgrade from 0.4.3 please upgrade to version 1.0.x first.
4 Release 1.0.2 - 2014-04-04
Release 1.0.2 is a minor bug fix release.
4.1 New features
None
4.2 Bugs fixed and important issues
-
[TR-256] “Error with Null value in the cache“. It is strongly recommended that upgrade is done immediately.
4.3 Upgrading
Release 1.0.2 support upgrade from release 0.4.3, 1.0.0 and 1.0.1. If you upgrade from 0.4.3, please follow the upgrade instructions described in the below upgrading section for 1.0.0.
5 Release 1.0.1 - 2014-03-27
Release 1.0.1 is a minor bug fix release, but fixing a major bug related to threshold management.
5.1 New features
None
5.2 Bugs fixed and important issues
-
[TR-255] “Bug in class Twenty4HourThreshold when configure periods with months and weeks”. This bug require immediate upgrade.
5.3 Upgrading
Release 1.0.1 support upgrade from release 0.4.3 and 1.0.0. If you upgrade from 0.4.3, please follow the upgrade instructions described in the below upgrading section for 1.0.0.
6 Release 1.0.0 - 2014-03-15
Release 1.0.0 is a major upgrade of Bischeck.
6.1 New features
-
The installation script support installation as none root.
-
Cache improvements
-
Redis is now the default Bischeck cache. With redis the persistence and availability of the cached data is improved. Using Redis enable third party to easy access the cached data.
-
The number of cached data can now be set by service definition through the cache template configuration.
-
Automatic aggregations of cached service definition data is implement with resolution of hour, day, week and month.
-
END statement is support in a list based cache query like host-service-serviceitem[-24H:END]. This will retrieve all data from 24 hours ago to the oldest data that exists in the cache for the service definition.
-
Configuration improvements
-
[FR-245] “Templates for threshold and baseline definitions”.
-
Templates has been implement both for bischeck.xml and and 24thresholds.xml. Templates will improve configuration reuse.
-
Template overrides allowing overriding definitions in a template.
-
Configuration macros enable dynamic configuration.
-
Cache directives to control aggregation and cache sizing per service definition.
-
Inactivation of hosts and services
-
Automatic aggregation of monitored data on hour, day, week and month period.
-
[FR-243] “Least square method calculation” - new mathematical function to do linear prediction.
-
The execution flow has been changes from a synchronous process where each ServiceJob thread executed the whole process from data collection to send monitoring result to servers. The new architecture is based on an asynchronous design separating the ServiceJob execution and the server integration. Jetlang, https://code.google.com/p/jetlang/, is used to pass messages between the independent threads.
-
Servers integrations improvements:
-
NSCA and NRDP workers - A worker pool enables parallel access to the NSCA and NRDP server. This enables better concurrency and throughput especially for “slow” servers like NSCA in daemon mode.
-
Circuit breaks - is an optional configuration for NSCA and NRDP. If the remote server connection fails or is timing-out the circuit break will go to an OPEN state and stop sending data to the remote server for a specific time period before retrying. This prevents Bischeck from overloading the remote server.
-
[FR-250] “Adding warning and critical level values in the performance data”.
-
Logback has replaced log4j as the logging framework. Configuration of logback is done in the $BISHOME/resources/logback.xml file.
-
JEP custom development has been improved.
-
New manual set. The manuals are now divided into “Bischeck installation and administration guide”, “Bischeck configuration guide” and “Bischeck release notes”.
-
Improved JMX monitoring especially for monitoring the different execution steps with timers and counters.
6.2 Bugs fixed and important issues
-
[TR-248] “If bischeck output contains a decimal mark the systems locale settings affect the bischeck output to NSCA”
-
[TR-249] “Aggregated data can not be retrieved from the cache”
-
[TR-251] “Bug in the formatting of the threshold values”
-
All configuration management classes is moved to a separate java package.
-
Bisconf 0.3.1 do not support Bischeck 1.0.0. A later version of Bisconf is target for Bischeck 1.0.0.
-
The DocManager utility has been removed.
-
New java interface for Service and ServiceItem. This may break custom developed Service and Serviceitem classes. Review javadoc to see the changes.
6.3 Upgrading
Release 1.0.0 support upgrade from release 0.4.3. The install scripts upgrade option will not migrate the 0.4.3 cache to Redis automatically. After the upgrade has been ran the following steps must be conducted to migrate the cached Bischeck data to Redis.
-
First run the migration according to the procedure in the “Bischeck installation and administration guide”.
-
Make sure Bischeck is not started, but that Redis is started when doing the following steps.
-
Make sure the Redis related properties in the properties.xml of the new installation is correct according to your Redis installation. The data migration program MoveCache2Redis will use the setting in the properties.xml or if not set use the default values. Please see the “Bischeck installation and administration guide” for more information.
-
Run the data migration program supplied with Bischeck in the following way:
$BISHOME/bin/bischeck migration.MoveCache2Redis
or if the cache file is located in different location then default:
$BISHOME/bin/bischeck migration.MoveCache2Redis -f /tmp/lastStatusCacheDump
$BISHOME should be replaced with the path to the location of the newly installed Bischeck installation directory. The data migration program can be run with the -v option to show the data migration in verbose mode. You can also run the data migration just in test mode by using the flag -c. If the migration of cache data fails it can be rerun, but the Redis data storage should be flushed using the Redis FLUSHDB command. For more information about Redis please visit http://redis.io/.
7 Release 0.4.3 - 2013-03-27
This release is a minor upgrade.
7.1 New features
-
[FR-231] “Add Livestatus as a new server integration alongside nsca and nrdp”.
-
[FR-236] “Extended configuration of threshold for threshold class Twenty4HourThreshold”. This include the new hours format with to-from definition
-
The installer script was updated to manage configuration of JMX. The installer add switches for which JMX port to use (-p), which JMX RMI server IP address to bind the port to (-i) and if authentication should be enforced or not (-a). This is related to the [TR-238].
If Bisconf will be used its required to configure JMX RMI support by defining hostname/IP and port.
-
The internal surveillance of Bischeck that is based on JMX Mbeans was cleaned up.
-
The initial configuration files have changed to an example using a Nagios check command instead of the previous example that used a database connection to mysql. This will be easier to get started with since no JDBC drivers for mysql is required.
7.2 Bugs fixed and important issues
-
[TR-235] “NullPointer in management of exponential data”
-
[TR-237] “Faulty behavior for property lastStatusCacheDumpDir”
-
[TR-238] “Bischeck will not start without hostname in /etc/hosts”. This is not a bug in Bischeck, but more a configuration of JMX to work with remote connections. The install script how been updated to manage the this in a better way.
7.3 Upgrading
Release 0.4.3 support upgrade from release 0.4.2.
8 Release 0.4.2 - 2012-12-21
Except for the new features introduced and bugs that has been fixed in 0.4.2, there has also been some major work in making Bischeck more stable and performance enhancements running many host, service and service items configurations. Our goal has been to secure a stable resource utilization of the Java virtual machine (jvm) when running Bischeck over a long period of time.
8.1 New features
-
[FR-234] Distribute the start time when running interval based scheduling. This will increase the distribution of service executions especially if Bischeck is configured with many services that is executed on the same interval.
-
[FR-233] Support for server integration with Graphite. See section.
-
[FR-232] Support for executing check commands. The check commands that can be used must support an output of performance data. Bischeck will not care about the status that comes from a check command. Instead it will only use the performance data to evaluate its own threshold. This include the new service class ShellService and serviceitem class CheckCommandServiceItem.
-
[FR-224] Support for NRDP through the new server class NRDPServer.
-
Related to bug [TR-227 ] the naming of host, service and serviceitem names has been improved. This include quoting of dash (-) if used in a name of a host, service or serviceitem.
-
Execution statements and thresholds hour specification where cache data is retrieved as a list, like in a function as avg(x-y-z[4:10]) and max(x-y-z[-5M:-15M]), can now be configured to return a value as long as at least one index in the range is not null. To support backwards capability the new functionality will only be used if the property notFullListParse is set to true in the properties.xml. The default value is false.
-
There has been some discussion about what Nagios state should be sent if the a the returned execute statement of a service item is null. In previous releases this has been hard coded to OK, but now its possible to define it by setting the property stateOnNull. The property can be set to an integer 0,1,2 or 3 or to a string OK, WARNING, CRITICAL or UNKNOWN. The default is UNKNOWN.
-
When a service class get an exception when creating a connection the previous versions did not save any data to the cache. If the property saveNullOnConnectionError you will now get a null value inserted into the cache when a connection exception is thrown. For backwards compatibility the default value of the property is false.
-
More mathematical functions like multNull and divNull that support null value as part of the calculation and can be used with functions that take a list of numbers to manage calculation where cache data may be null.
8.2 Bugs fixed and important issues
-
[TR-227] “Cache parser do not work for host, service or serviceitems if the name include 0 (zero)” has been resolved.
-
[TR-228] “Threshold factory return wrong threshold definition if service and serviceitem name is the same for different hosts” has been resolved.
-
[TR-229] “When using service ShellService the number of open files limit will be reached” has been resolved.
-
[TR-230] “NRDP submissions all come in as OK” has been resolved.
-
Fixed migration script from 0.4.0 to copy etc directory content correctly. Changes in the file urlservices.xml will be overwritten. Existing 0.4.0 configuration will still be available in the previous version backup directory, bischeck_0.4.0.
8.3 Upgrading
Release 0.3.3, 0.4.0 and 0.4.1 is supported for upgrade to 0.4.2. The upgrading is NOT applicable for release candidate.
9 Release 0.4.1 - 2012-10-01
9.1 New features
-
[FR-224] Beta support for NRDP through the new server class NRDPServer.
-
Beta support for executing check commands. The check commands that can be used must support an output of performance data. Bischeck will not care about the status that comes from a check command. Instead it will only use the performance data to evaluate its own threshold. This include the new service class ShellService and serviceitem class CheckCommandServiceItem.
-
[FR-223] Instrumentation metrics provided by http://metrics.codahale.com/ has been implemented to enable fine grain real time process measuring through JMX. This is implemented for
-
All external interfaces to measure response time
-
Service execution time
-
Threshold processing time, etc.
9.2 Bugs fixed and important issues
-
[TR-225] “A service url that has no equivalent in urlservices.xml generate a NullPointerException” has been resolved.
-
[TR-226] “For thresholds with more the two decimals will not be correctly validated” has been fixed. The bug was related to when Bischeck was used with data points with many decimals, like the result from a ping. Bischeck would strip of all decimals except 2 with caused small values to become 0. Now Bischeck will determine the number of decimals used by the collected data point and use it when formatting the calculated threshold, warning and critical value. This will hopefully make data presented in Nagios UIs and graphs like pnp4nagios look better.
9.3 Upgrading
Release 0.4.0 is supported for upgrade to 0.4.1.
10 Release 0.4.0 - 2012-08-31
10.1 New features
-
[FR-197] Support for different and multiple integration with different surveillance and monitoring systems. With version 0.4.0 Bischeck is not limited to send data to Nagios. It can now send the data to multiple Nagios servers and to other servers like OpenTSB. This is done by moving server formatting and protocol to server integration classes that implements the interface com.ingby.socbox.bischeck.servers.Server. The server integration is described in the xml configuration file servers.xml. This also means that that some Nagios NSCA specific properties previous configured in properties.xml has been moved to the servers.xml file in the NSCA section. The OpenTSDB server class should be regarded as beta.
-
[FR-204] The bischeck cache will be saved when the bischeck daemon is shutdown and reloaded on bischeck startup. Keeping the cache persistent between restarts is important since 0.4.0 support time based cache retrieval. The limitations is currently that if the Bischeck daemon is killed by a signal that can not be caught or the daemon crash the data will not be saved. This will be improved in future versions.
-
[FR-202] The implementation of running bischeck once, in a none daemon mode, is changed so the same code is used as running in daemon mode. The only difference is that the initialization of triggers are different so all service items are just ran directly and and just once.
-
[FR-218] The bischeck daemon can now reload the configuration without a process restart. This is support through the JMX operation “reload”. The feature will limit the need of operating system access and authorization.
-
[FR-219] Bischeck can now retrieve state and performance data from a Nagios server supporting livestatus. With the service class LivestatusService a connection is set up over livestatus and with the and serviceitem class LivestatusServiceItem state and/or performance data can be retrieved from the a Nagios service. This can be useful when when creating virtual services in Bischeck or used in complex thresholds.
-
[FR-220] Bischeck now support one additional scheduling method where scheduling can be defined to run a service after a different service has executed. This can be useful when a service is depending on data for another service for its thresholds or execution statement.
-
[FR-221] Cache retrieval is now support by using a time offset to find the nearest cache element to the time offset.
-
Cache data can be retrieved as a list of elements based both on index and time.
-
Support for additional mathematical functions like average, min and max calculations on list of elements.
-
Bischeck can now support the usage of cached data in an execution statement of a serviceitem. This is typical useful when a serviceitem execute statement is depending on other service data. For example in a SQL query string:
select value from table1 where id = host1-web-state[0] and createdate = ’%%yyyy-MM-dd%%’");
-
Added support for other Linux distributions then Redhat based. Bischeck should now install on Debian 6 and Ubuntu 10/11.
-
Configuration listing. The configuration listing has been moved from the ConfigurationManager class to the DocManager class. Currently html and text listing is supported. The generated configuration data will by default placed in the bischeckdoc directory.
-
A configured service can be configured not to send its data to a the configured monitoring servers like Nagios. This can be useful if the service is just to be used to create virtual services or just to be used as thresholds.
-
The bischeck script now support JMX authentication. The authentication files are located in the etc directory and named jmxremote.password and jmxremote.access. Default is to that authentication is disabled by the system property
“-Dcom.sun.management.jmxremote.authenticate=false”. To enable authentication set the property to true. For more info about JMX see
http://www.oracle.com/technetwork/java/javase/tech/javamanagement-140525.html.
10.2 Bugs fixed and important issues
-
The Twenty4Thresholds class was in previous version not doing a correct linear equation calculation if a expression based threshold was defined. Lets illustrate the errors with this example from the 24thresholds.xml configuration file having a mix with static and expression based thresholds.
....
<!-- 12:00 -->
<hour>7000</hour>
<!-- 13:00 -->
<hour>testhost-testservice-testitem[1] / 3</hour>
<!-- 14:00 -->
<hour>testhost-testservice-testitem[1] / 2</hour>
<!-- 15:00 -->
<hour>testhost-testservice-testitem[1] + 1000 </hour>
<!-- 16:00 -->
<hour>12000</hour>
....
In the previous version the threshold value between 12:00 and 13:00 would be null since it was a mix of static and expression based thresholds. And between 15:00 and 16:00 the threshold would have been calculated as “testhost-testservice-testitem[1] + 1000” independent of the time between 15:00 and 16:00.
Now the linear equation will correctly be calculated with any mix of static and expression based definitions. In the above example the calculated threshold for 12:20 will now be:
20*((testhost-testservice-testitem[1]/3) - 7000)/60 + 7000
This fix will improve the correctness and also the capability of threshold adaptivity.
-
The Service interface has a number of new methods that should been there from the beginning. If you developed any service class you need to add these, but if you just inherited ServiceAbstract its fixed for you. The new methods are:
public NAGIOSSTAT getLevel();
public void setLevel(NAGIOSSTAT level);
public boolean isConnectionEstablished();
public void setConnectionEstablished(boolean connected);
public Boolean isSendServiceData();
public setSendServiceData(Boolean sendServiceData);
-
Property cacheclear is renamed to thresholdCacheClear.
-
All the nsca related properties has been moved from properties.xml to servers.xml when used for the NSCAServer class. The new property names has also gone through some minor changes. When upgrading a manual update is needed of the servers.xml file with the current setting of nsca related properties in properties.xml. Recommended that these are later removed.
-
All JAXB generated configuration classes now support serialization.
-
Quartz jar is upgraded from 2.0.1 to 2.1.5.
-
[TR-216] “Shutdown is automatic triggered”
-
[TR-217] “Configuration Manager initialization failed with java.lang.NullPointerException”
-
[TR-207] “sudo in bischeckd script cause problem at boot”
10.3 Upgrading
Release 0.3.3 and 0.4.0_RC2 are supported for upgrade to 0.4.0.
11 Release 0.3.3 - 2011-11-14
11.1 New features
-
Bischeck are no longer limited to just be integrated with a single Nagios server over the NSCA protocol. Now is it possible to integrate with multiple monitoring servers over different protocols. Currently Nagios/NSCA and OpenTSDB is support. To enable this a new class component called Server has been introduced. The class is responsible for communication and formatting for the specific monitoring server it integrate against. A new configuration file, server.xml is used for configuration of server integration.
11.2 Bugs fixed and important issues
-
[TR-207] “sudo in bischeckd script cause problem at boot”
-
[TR-214] “Threshold object cache is no cleared”
12 Release 0.3.2 - 2011-07-29
12.1 New features
-
The configuration system has been completely rewritten and now us xml based configuration files. Each configuration file has a corresponding xsd file that can be used for verifications. The dependencies to sqlite3 has been deprecated and is just part of this release to support upgrade.
-
The scheduling of services and its related serviceitem(s) has been rewritten to support different scheduling polices per service instead of earlier versions of fixed interval scheduling. With 0.3.2 each service can have one to many schedule tags in bischeck.xml configuration file. For more info please see the chapter on page 1↓.
12.2 Bugs fixed and important issues
-
The active attribute on Hosts, Services and Serviceitem has been removed.
-
The interface com.ingby.socbox.bischeck.threshold.Threshold has a new signature on the method init(). This method now throws Exception.
-
The Service interface has two additional methods, setSchedules() and getSchedules().
-
The Service interface has changed the signature of getServicesItems() to return Map instead of HashMap.
-
buildr has been replaced by ant as the build management system.
13 Release 0.3.1 - 2011-04-08
13.1 New features
-
The ServiceFactory class now use a property table, urlservice, to map what Service class should be instantiate for a specific url schema. The url schema is the key. The current default mapping are:
-
jdbc -> JDBCService
-
bischeck -> LastCacheService
-
The ServiceItemFactory class use an additional field, serviceitemclass, in the items configuration table to determine what ServiceItem class to instantiate.
-
Calendar in Bischeck follows the ISO 8601 date standard by default. This means that the first day in the week is Monday, day 2 according to java.utilCalendar, and that the first week of the year must have a minimum of 4 days. The importance of this is to get the week numbering correct that is used in the configuration in Twenty4HourThreshold class, but day one (1) in the week is still Sunday when defining the tag dayofweek in 24threshols.xml. The setting can be overidden by setting the properties “mindaysinfirstweek” (default 4) and “firstdayofweek” (default 2) in the properties.xml file.
-
If no threshold class has been specified, null in the thresholdclass field in the items table, Bischeck will instantiate the “empty” class DummyThreshold.
-
For all class configuration of Service, ServiceItem and Threshold its now possible to specify the class name without the package path if the class is part of the Bischeck distribution.
-
Clean up of the exception handling process when starting Bischeck. Now the execution should not start if there are configuration issues with missing classes for Service, ServiceItem and Threshold.
13.2 Bugs fixed and important issues
13.3 Upgrade issues
-
Upgrade by doing a fresh installation, but first save the old installation directory. After saving the old installation do a new install. Then copy the files bischeck.conf and 24threshold.conf from old to new installation dir.
-
The field serviceitemclass (varchar(256)) in table items in configuration database bischeck.conf must be manual added and populated with the right Service class name. If corresponding service is jdbc:// set the field serviceitemclass to SQLServiceItem and if the service is bischeck:// set the field to CalculateOnCache.
-
To add the column:
$ sqlite3 bischeck.conf sqlite> ALTER TABLE items ADD COLUMN serviceitemclass varchar(256);
-
Update the serviceitemclass for all rows in items:
-
sqlite> update items set serviceitemclass=’SQLServiceItem’ where .... ....
-
sqlite> update items set serviceitemclass=’CalculateOnCache’ where ..... ....
-
Add the new table url2service in database bischeck.conf.
$ cat << EOF | sqlite3 bischeck.conf
drop table IF EXISTS urlservice;
create table urlservice(key varchar(128), value varchar(256));
insert into urlservice values ("jdbc","JDBCService");
insert into urlservice values ("bischeck","LastCacheService");
EOF
-
Copy all file located in the old installation customlib directory to the customlib directory in the new installation.
14 Release 0.3.0 - 2011-03-03
14.1 New features
-
This is the first binary distribution, but should be regarded as a beta version.
14.2 Bugs fixed and important issues