Universal Logging System

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== News =====

These are the news and changes. Some news are in German, depending on the nationality of the developer, sorry for the inconvenience.

==== 2017-06-15 ====

ULS Server Version 1.9.2 released.

Breadcrumbleiste
  * Wird die Maus über die Breadcrumbleiste bewegt, werden Informationen zum Server angezeigt. 
  * Beim Firefox kann über die rechte Maustaste per "Copy to Clipboard" der Servername, die Server-IP, der Kontakt oder das Verfahren des Servers in den Copy/Paste-Buffer kopiert werden.

Überwachungen

  * Limits können gruppiert und gewichtet werden. Neuer Menüpunkt: "Gruppen Status" und "Verwalten" -> "gruppierte Überwachung" 
  * "nootherflag" berücksichtig auch Domain-Autos

Überwachungsdefinitionen

  * Lange Werte werden in der Anzeige auf 30 Zeichen gekürzt, der volle Werte wird angezeigt, wenn die Maus über den Wert bewegt wird.
  * Neue Makros bei Meldungstexten
    * $ULSTABLELINK fügt Link zur ULS-Tabelle ein.
    * $ULSCHARTLINK fügt Link zur ULS-Grafik ein.
    * $DIFFERENCE entspricht $DIFF_OF(<Det mit Limit>)
    * $SERVERDESCRIPTION Beschreibung des Servers
    * $SECTIONDESCRIPTION Beschreibung der Section
    * $TESTSTEPDESCRIPTION Beschreibung des Teststeps
    * @ERRORLEVEL(<n>), @WARNLEVEL(<n>), @INFOLEVEL(<n>) Festlegen des Alarmierungs Levels für exterene Ticket-Programme (z. B. ITSM) Bei isAlives muss @WARNLEVEL(<n>) verwendet werden.
    * $EGREP_OF(<detail>, <REGEXP>) Es werde nur die Zeilen, die dem Extended-Regexp "<REGEXP>" entsprechen in die Meldung übernommen. Kann auch bei Dateien oder gepackten Dateien ('.xz', '.gz' und '.bz2') verwendet werden.
    * $HEAD_OF(<detail>, <n>), $TAIL_OF(<detail>, <n>) Es werden die ersten/letzten <n> Zeilen in die Meldung übernommen. Kann auch bei Dateien oder gepackten Dateien ('.xz', '.gz' und '.bz2') verwendet werden.

Überwachungspausen

  * Klasse hinzugefügt
  * "Überwachungspausen Übersicht (alle)" mit Filtermöglichkeit. Sobald ein Filter auf Klasse, Server, Section, Teststep oder Detail gesetzt ist, werden nur die Überwachungspausen angezeigt, für die Werte vorhanden sind. Ein Filter auf Verfahren schränkt nur die Anzeigen der gesetzten Überwachungspausen ein.
  * "Überwachungspausen Übersicht (7/24)" listet alle Überwachungspausen auf, die von 00:00 Uhr bis 23:59 und an 7 Tagen die Woche gelten.
  * Vom Client aus kann abgefragt warden, ob der Server zurzeit in einer Überwachungspause ist.

Letzte Werte, Average, Min, Max, ...

  * Sortierung nach Wert und Datum ermöglicht. Ist '#D' gesetzt, werden nur so viele Details ausgegeben. Z. B. zeige die 10 am längsten laufenden Server: Letzter Wert von System/Uptime sortiert nach Wert absteigend mit '#D' limitiert auf 10.


Gruppen-Reports

  * Reports können einer Benutzergruppe übergeben werden. Diese Gruppen-Reports gehören dann der ganzen Gruppe, so dass alle Mitglieder der Gruppe den Report bearbeiten können. Die dazugehörigen Mailreports gehören dann automatisch ebenfalls der Gruppe und können auch von allen bearbeitet werden.
  * Reports, die als Server- oder Sektion-Seite eingetragen sind, können nicht zu Gruppen-Reports umgewandelt werden. 
  * Gruppen-Reports haben immer nur die Rechte der Gruppe. 
  * Neue Variable in Report Beschreibung und Reportdetail Beschreibung: $MAINTENANCEWINDOW (nur wenn ein einziger Server ausgewählt ist)

Mailreports

  * Eine cc-Adresse kann angegeben werden
  * Mit der Aktivierung von cc-Adresse als "Absender-Adresse" wird diese Adresse als Absender verwendet. Im E-Mail Client kann damit direkt die Antwort Funktion verwendet werden, um dieser Adresse zu antworten und nicht der E-Mail Adresse des ULS Servers.
  * Verschickte E-Mail Reports werden protokolliert und könnnen über den Link "gesendet" angezeigt werden.


Server

  * Server mit Status "no alarms" können über "Verwalten" -> "Überwachungspausen" angezeigt und aktiviert werden.

UTT

  * Unter "Optionen" kann eingestellt werden,
     * dass auf der UTT Übersichtsseite die Meldung nicht mehr als "Title" angezeigt wird und dass die Meldung nicht mehr erweiterbar ist.
     * dass auf der UTT Detailseite die Werte und die Meldung nur noch verkürzt angezeigt werden.
     * wie viele Werte nach dem Event angezeigt werden sollen: "UTT Links: Werte nach Event". 0 bedeutet alle Werte nach dem Event.

==== 2016-08-23 ====

ULS-Server Version 1.9.1 released.

Vor dem Upgrade des ULS Servers sollte gnuplot Version 4.6 (oder neuer) mit 'pngcairo'
installiert werden, damit utf8 vollständig in Grafikausgaben unterstützt wird.

Werteverarbeitung
  * ACHTUNG: Das Datumsformat tt.mm.jj in Wertedateien von ULS Clients wird nicht mehr unterstützt nur noch: yyyy-mm-dd :!:

Allgemein

  * Neue Einheiten: '[ ]' und '[_]' analog zu ' ' und '_' fuer kurze Strings bis 200 Zeichen, die in "twerte" gespeichert werden.
  * Neuer Servername: 'DOMAIN:<hostname>:' wird umgewandelt in: @<class of hostname>, z.B. @PROD oder @STAGE
    * Allgemein: 'DOMAIN:<hostname>:<classname>' -> es wird @<classname> angelegt und wenn es die Klasse <classname> gibt, dann wird @<classname> der Klasse <classname> zugeordnet. Andernfalls ist @<classname> klassenlos.
  * Wenn in Suchfeldern auch nach "leer" gesucht werden soll, dann muss vor dem ersten Begriff ein ',' eingetragen werden. Z. B. Suche nach Servern, die keiner Klasse oder der Klasse "Prod" angehören -> ",Prod". Oder im UTT Suche nach Tickets, die einem bestimmten User oder niemandem zugewiesen sind -> ",<USERNAME>".


Erweiterte Detailauswahl

  * Bei letzte Werte kann der Wertefilter zum "Displayfilter" umgeschaltet werden. Ist "Displayfilter" nicht angehakt, wird der letzte Werte gesucht, der dem eingestellten Filter entspricht. Ist "Displayfilter" angehakt, dann wird erst der letzte Wert gesucht und nur dann angezeigt, wenn er dem Filter entspricht. Beispiel:
    * Zeige die letzten erfolgreichen Datensicherungen: Wertefilter auf '= "OK"' und kein "Displayfilter"
    * Zeige alle Datensicherungen, die zuletzt nicht erfolgreich waren: Wertefilter auf '!= "OK"' und "Displayfilter"
  * Wenn als Zeitbereich "komplett" ausgewählt ist, kann nach Datum sortiert werden.


Limitprüfung und Alarmierung

  * Meldungszielarten um "SendStatusChange" erweitert. Wenn "SendStatusChange" gesetzt ist, dann wird bei jeder Über- oder Unterschreitung eines Info/Warn/Error-Levels eine Meldung generiert. Ein Wechsel zu unter Info hat den Text "OK" und Level 0. Die Checkboxen I, W und E unter der Meldungszielauswahl habe keine Bedeutung bzw. werden ausgeblendet.
  * Die Übersetzung der Namen Error/Warn/Info/OK wird in der /etc/ulsserver.conf festgelegt über die Namen "ERRORNAME", "WARNNAME", "INFONAME" und "OKNAME".
  * Bei Datumswerten (Einheit {DT} oder {TT}) kann auf "remaining" geprüft werden, um z. B. rechtzeitig vor Ablauf von Zertifikaten zu alarmieren.
  * Der Server-Status "keine Alarmierung" wird bei den Limit-Übersichten angezeigt.

Wertelimits

  * neues Feld exclude: Es wird zuerst exclude geprüft und wenn erfüllt, wird nicht alarmiert.
  * Bei Datumswerten (Einheiten {DT} und {TT}) neue Funktion "remaining", entspricht -age.

Überwachungspausen

  * Man kann beim Löschen einer Überwachungspause eine Bemerkung eingeben, die im Changelog gespeichert wird.

UTT

  * Werden UTT-Tickets auf gelöst gesetzt, dann werden Limits ohne Mittelung sofort für die Wiederalarmierung freigeschaltet. Ansonsten muss die niedrigste Schwelle unterschritten werden, damit wieder alarmiert werden kann.
  * Bei Auswahl von "meine Tickets" und Selektierung über Checkboxen werden zusätzlich die Master-Tickets anderer User angezeigt.
  * Neuer Status: 'assigned'
  * Wird Ticket auf gelöst gesetzt, dann wird erneut alarmiert, wenn mindestens eine Limitprüfung OK ergab. (Außer bei komprimierten Limits.)
  * Status "no alarms" wird auch bei Limit Übersichten angezeigt.
  * Neue Gruppierung: "Server, Teststep" und "Section, Teststep".


Hauptmenü

  * Menüpunkt "letzte Werte" gestrichen, da inzwischen zu umfangreich.
  * Der Block mit den UTT-Links kann unter Verwalten - Optionen frei gestaltet werden. Die drei Links können durch Reports oder Favoriten ersetzt werden und es können beliebig viele zusätzliche Reports/Favoriten als Links eingerichtet werden.

Reports

  * Serverreport: Wird abgezeigt, wenn ein Server ausgewählt wird. Muss über Verwalten - Optionen - Serverseite ausgewählt werden.
  * Es können im Reportnamen und dessen Beschreibung folgende Variablen genutzt werden:
    * $SERVER, $IPADDRESS, $LOCATION, $CONTACT, $DOMAIN und $DESCRIPTION (nur bei Beschreibung).
  * Bei den Namen der Reports wird der ':' als Leveltrenner interpretiert und nicht angezeigt, mit '::' im Namen wird ein einzelner ':' angezeigt. 
  * Beim Anzeigen eines Reports oder Favoriten als Serverreport werden die Felder "Verfahren", "Klasse" und "Server" ignoriert.

  * Reportdetails erweitert um:
    * "hide on empty": Wenn die Autoauswahl keine Elemente liefert, dann wird nichts ausgegeben - keine Abgrenzungen, Seitenwechsel, Name oder Beschreibung
    * "pagebreaks": "before" - vor der Abgrenzung wird ein Seitenumbruch eingefügt (auch vor der ersten Seit möglich).
    * "on separation" - Seitenumbruch einfügen bei "Trennung nach" (nur wenn getrennt wird).
    * "on new table or chart" - Seitenumbruch, wenn die maximale Zahl von Spalten bei Tabellen oder Details bei Grafiken erreicht ist.
  * Reports/Favoriten Bearbeiten: Link auf Details als laufende Nummer an den Anfang der Tabelle.
  * Section Report:  Wird abgezeigt, wenn eine bestimmte Sektion ausgewählt wird. Muss über Verwalten - Optionen - Sektion Seite ausgewählt werden.
    * Es gilt der Report/Favorit, bei dem als erstes der gewählte Sectionname zu der Section-Auswahl des Reports/Favoriten passt. Man kann also z. B. einen Section-Favoriten für die Section "System" anlegen und einen Section-Report für die Sectionen "Oracle*".


Bugfixe

  * Zuordnung Verfahren zu Gruppe kann bei offenen UTTs nicht mehr gelöscht werden.
  * Bei Grafikanzeige ist der Button "als Tabelle anzeigen" nach Datumsänderung wieder verfügbar.
  * Bei Strings mit mehreren Einträgen pro Zeitstempel konnte es nach erfolgter Alarmierung zum Überspringen der nächsten Werte zum gleichen Zeitstempel der Alarmierung kommen.
  * Hostname "DOMAIN:<host>:<class>": Nach Verfahrensnamen Änderungen wurde keine ID geliefert.
  * UTT - nach Selektierung und Deselektierung per Checkboxen wird der alte Suchstatus wiederhergestellt.
  * Gruppierte Ausgabe von online und komprimierten Werten lieferte nur leere Tabelle.
  * AVG und SUM bei gruppierten Tabellen wird in der Fußzeile sinnvoll gerundet.
  * Reaktivieren von Gruppen-Auto-Limits setzt nicht mehr alle Logfilelimits zurück.
  * Speicherung der Detailsortierung im Reports Textmdous.

==== 2015-08-03 ====

ULS Server Version 1.9.0 released! 

Allgemein

Einführung von Serverklassen.

  * Server können Serverklassen zugeordnet werden.
  * Nutzung möglich bei: Limits, isAlive, Kombilimits und komprimierten Limits.
  * Nicht möglich bei: Komprimierung, Aufbewahrung und Kombidetails.

Weboberfläche für UTT

  * Filterung auf Verfahren und Server hinzugefügt.
  * Zusätzliche Links, um von der Ticketbearbeitung direkt zu den Werten zu gelangen.
  * Mastertickets können zu anderem Master hinzugefügt werden indem der neue Master die Slaves übernimmt und aus dem Master wird ein Slave.
  * Anzal der UTT-Tickets in der History kann über die Optionen eingestellt werden.
  * UTT-Tickets werden nur noch automatisch geschlossen, wenn sie noch nicht in Bearbeitung genommen wurden.
  * Wird bei der erweiterten Suche eine UTT-ID ohne Wildcards eingegeben, dann werden die anderen Filter ignoriert.

Überwachungspausen

  * Start- und Endedatum um Zeit erweitert. Der Beginn und das Ende der Überwachungspause kann zusäztlich mit einer Uhrzeit angegeben werden.
  * Zusätzliche "Überwachungspausen Übersicht" am Ende der Verfahrensliste unter "Admin" -> "Überwachungspausen".
  * Das Ende der vom Client initiierten Überwachungspausen kann geändert werden über die Kennung PC. In der GUI könne vom Client initiierte Pausen nicht geändert werden. Sie können nur gelöscht werden.

Histogramme

  * Sortierung nach Wert ermöglicht. Wird bei Detailsortierung "Wert" oder "Wert absteigend" ausgewählt, dann werden die Balken in auf- oder absteigender Reihenfolge angeordnet.

Limits

  * Wiederalarmierung erweitert um "once" und "6 h".
  * Alle Limits, isAlive usw., die von Domain-Autos oder Gruppen-Autos stammen und geändert wurden, werden farblich gekennzeichnet. Zusätzliche Checkbox zum Zurücksetzen auf die Einstellungen des Masters (Domain- oder Gruppen-Auto). Bei den Domain- und Gruppen-Autos gibt es einen oder zwei zusätzlichen Links auf die Slaves jenachdem, ob es geänderte Slaves gibt oder nicht.
  * Neue Variable bei Meldungen: $CLASS - Klasse des Servers
  * Neue Funktion bei Meldungen:
    *  $LINK_OF(<BLOB>) - ULS-Link direkt auf das Dokument
    *  $FILE_OF(<BLOB>) - Dokument als Anhang (bisher nur bei Mails)

isAlives

  * Checkbox 'autoclose'. Wenn aktiviert, werden UTT-Tickets automatisch geschlossen, sobald wieder Werte vorhanden sind.

Aggregatfunktionen

  * "Diffto": Es wird der Unterschied zum Datensatz mit dem Zeitstempel aus dem Argumentfeld bestimmt. Ausgeben der Unterschiede in der Meldung über: $DIFFERENCE
  * "Age" bei Zeitstempel der Einheit "{DT}" oder "{TT}". Age berechnet das Alter des Zeitstempels in Sekunden. Als Vergleich kann "<n> <u>" mit <u> = {'s', 'min', 'h', 'd', 'days', 'weeks', 'months', 'a'} verwendet werden.

Reports

  * Ausgabe "keine Daten", um zusätzliche Hinweise ausgeben zu können.
  * Bei Name und Beschreibung ist weitere Variable $CLASSES möglich.
  * Freigaben auf Reports über Gruppen ermöglicht.

Mailreports

  * Erweitert um Ausgabeformat als Dropdown-Liste. "PDF+Files ..." bedeutet, dass zusätzlich zum Report auch alle Dateien, die in den Tabellen als BLOBS gespeichert sind, mitgesendet werden. Bei "Files only" werden nur die Dateien gesendet. Z. B. es wird ein fertiger Report direkt an ULS gesendet.
  * Als Monatstage sind Bereiche und Aufzählungen möglich, wie 1,2,5 oder 1-7,15-21

Favoriten

  * Die Unterstützung beliebiger URLs wird demnächst eingestellt. Noch vorhandene Favoriten sollten durch Aufrufen und "als Favorit speichern" umgewandelt werden.
  * Freigaben auf Favoriten über Gruppen ermöglicht.
  * Favoriten anderer User können kopiert werden.

Server Favorit / Server Report

  * Unter Optionen kann als "Serverseite" ein Favorit oder Report gewählt werden. Wenn ein Server selektiert wird, dann wird dieser Favorit/Report im rechten Frame angezeigt. Dabei wird das Serverfeld des Favoriten/Reports durch den selektierten Server übersteuert. In den Namen und Berschreibungen der einzelnen Abschnitte sollte der Server mit "$SERVER" angegeben werden, denn der wird jeweils ersetzt.

Administration

  * Die Rechte auf ein Verfahren können zu einem anderen Verfahren kopiert werden.

==== 2014-06-25 ====

Finally, we succeeded in applying our new web site. Well, as I said before, 
its structure has changed but the contents is nearly the same. 
We still work on completing the docs.
==== 2014-06-13 ====

ULS version 1.8.0 has passed most tests. 
Storing of data, notifications on threshold violations do work. 
Aggregation and the new group based notification definitions work.
Use it!

==== 2014-04-25 ====

ULS Server Version 1.8.0 released!

Allgemein

  * Umstellung textbasierten Datenbankinhalte auf UTF-8. Dadurch ist die Länge der Textwerte auf 20000 Zeichen beschränkt. Längere Textwerte sollten als Datei gesendet werden, die Textwerte werden abgeschnitten.
  * Sektion, Testschritt, Details und Einheiten wurden auf die Unterscheidung von Groß- und Kleinschreibung umgestellt. Dadurch kann es sein, dass isAlive-Meldungen ausgelöst werden, die auf eine bzgl. der Groß- und Kleinschreibung abweichende Schreibweise zeigen. Suchmuster in Formularen werden weiterhin unabhängig von Groß- und Kleinschreibung ausgewertet.
  * Die Berechtigungen für das Admin- und Operatormenü wird dem ULS-Benutzer vergeben. Der ULS-Master-Admin wird nicht mehr benötigt. Es wird der ULS-Benutzer "admin" eingerichtet, der ULS-Master-Admin-Rechte hat. Über diesen ULS-Benutzer können weitere ULS-Benutzer für das Admin- und Operatormenü eingerichtet und berechtigt werden. Anschließend kann der ULS-Benutzer "admin" gelöscht werden oder dessen Kennwort nach dem 4-Augenprinzip neu vergeben werden.

Weboberfläche

Die Weboberfläche wurde neu gestaltet.

  * Die Menüs wurden umstrukturiert, eine "Breadcrumb" Leiste in den oberen Frame eingebaut. Im linken und im rechten Frame wird der gewählte Zeitbereich als Link zum ändern angezeigt. Online und aggregierte Werte können über "Zeitraum ändern" direkt ausgewählt und kombiniert werden.
  * Bei allen Textmode-Exports wird der Access-Code mit ausgegeben. Beim Import wird bei fehlendem Access-Code der niedrigste Access-Code, für den man berechtigt ist, eingesetzt.
  * Globale "Autos" auf Gruppenebene implementiert:
    * Gruppen-Auto-Limits, Gruppen-Auto-isAlive, Gruppen-Auto-Kombilimits,
    * Gruppen-Auto-Kombidetails, Gruppen-Auto-Komprimierung,
    * Gruppen-Auto-Limits auf komprimierte Werte, Gruppen-Auto-Aufbewahrung,
    * Gruppen-Auto-Aufbewahrung für komprimierte Werte.
  * Zu Sektion und Teststep kann eine Beschreibung hinzugefügt werden. Befindet sich der Mauszeiger über Server, Sektion, Testschritt oder Testschrittdetails, dann wird dessen Beschreibung eingeblendet. Dazu wurden auch neue Platzhalter bei Meldungstexten eingerichtet: $SERVERDESCRIPTION, $SECTIONDESCRIPTION, $TESTSTEPDESCRIPTION.
  * Kombidetails für komprimierte Werte. Das Detail in den Funktionen muss in ' ' oder "" eingeschlossen werden, da die Details enthalten Klammern.
  * Kombidetails und Kombilimits können verfahrensübergreifend definiert werden. Es kann auf alle Werte des gleichen Verfahrens zugegriffen werden: $VALUE_OF('|<server>|<section>|<teststep>|<detail>[/<einheit>][@<zieleinheit>]') <server>, <section>, <teststep> können leer sein, dann entspricht der Wert der Position der Definition. Bei Kombidetails muss mindestens ein Element aus dem aktuellen ULS-Pfad stammen. Dieses Element ist die Referenz. Die kann auch per $REF() definiert sein. Wenn Kombidetails aus Gruppen-Kombidetails resultieren, sind sie nur für Mitglieder der Gruppe sichtbar. Wenn man Mitglied mehrerer Gruppen ist, die jeweils ein Kombidetail mit gleichem Namen und Einheit erstellt haben, können die einzelnen Kombidetails bei einer "Autoauswahl" nur über die Gruppe selektiert bzw. deselektiert werden. Um die Eingabe der Formeln bei Kombidetails und Kombilimits zu erleichtern, sind die Funktionen und Details unter der Tabelle als Links ausgelegt. Durch einen Klick auf den jeweiligen Link wird diese oder das Detail an die aktuelle Cursorposition in der Textbox platziert. Hinweis: Die Einheit '[E]' als Ergebnis eines Kombidetails wird derzeit noch nicht unterstützt.
  * Das Ergebnis eines Kombilimits kann auch ein Textausdruck sein, der mit $VALUE in der Meldung ausgegeben werden kann. Ein Kombilimit gilt als erfüllt, wenn das Ergebnis ungleich 0 und ungleich '' (leerer Textausdruck) ist.
  * Bei Name und Beschreibung in Reports und Reportdetails sind die Platzhalter: $DOMAINS, $SERVER, $SECTIONS, $TESTSTEPS, $DETAILS, $UNITS, $TIMERANGE (Text "ab gestern", "2013-08-21 - 2013-08-30"), $DATESTART(<format>) (<format> wie bei dem Kommando "date"), $DATEEND(<format>) (<format> wie bei dem Kommando "date"). Die Platzhalter werden durch die jeweiligen Angaben als kommagetrennte Liste ersetzt.
  * Protokollierung von Änderungen durch den ULS-Benutzer. Alle Änderungen an Definitionen (Überwachungsdefinitionen, Überwachungspausen, Komprimierungen, Aufbewahrungszeiten) durch einen ULS-Benutzer werden protokolliert.
  * Die Aufbewahrung der Änderungen durch ULS-Benutzer wird unter den Systemvariablen in Tagen festgelegt. Beim Löschen wird immer die jüngste Änderung, die ausserhalb der Aufbewahrung liegt, nicht gelöscht. Dadurch verbleiben die Werte von vor der letzten Änderung im Zugriff. Daraus folgt auch, dass erste Eintrag nicht gelöscht wird, solange es keine nachfolgenden Änderungen gibt.
  * Die Serverdoku wurde um eine Aufbewahrungszeit erweitert. Die Standardeinstellung erfolgt im Admin-Menü. Die Aufbewahrung wird in Tagen als zusätzlicher Parameter "rettime" bei doku_upload.s2w angegeben bzw. im Dateiformat nach <description> angegeben (dieser Wert wurde bisher ignoriert).

Administration

  * Ein Meldungsziel kann durch ein anderes ersetzt werden.


==== 2014-01-21 ====

ULS version 1.8.0 is installed in stage environment, tests have started...
==== 2014-01-03 ====

Well, finally we were able to move our local dokuwiki installation to our webspace as interims solution.
It will go online in a few days, although not everything is already documented as it should (as always).

==== 2013-12-04 ====

We moved from a sphinx generated website to dokuwiki, that was some work
but also cleared up several lose ends of our previous website. Thanks a lot, sphinx!
But we need collaboration.
Universal Logging System

User Tools

Site Tools

Page Tools
