move IT Home Base

IssueTracker

anonymous@undisclosed.example.com (Anonymous) — Thu, 24 Feb 2022 09:02:24 +0000

IssueTracker

Diese Anleitung ist zur Zeit in Bearbeitung und daher noch nicht vollständig! Wenn Sie zu dieser Anleitung etwas beitragen möchten können Sie sich kostenfrei als Mitglied registrieren und haben dann die Möglichkeit Seiten zu editieren, oder sich Änderungen an Seiten per E-Mail zuschicken zu lassen (abonnieren).

Preamble

Der IssueTracker ist ein Plugin für DokuWiki und ergänzt dieses um ein leicht zu handhabendes, einfaches Ticket-System mit dem Aufgaben erfasst, verwaltet und bearbeitet werden können. Er stützt sich dabei auf die bereits vorhandene Zugriffs- und Rechteverwaltung von DokuWiki, sowie anderer Core-Funktionen. Der IssueTracker selbst liefert eine Eingabemaske zum Erstellen der Tickets, sortier- und editierbare Übersichtslisten und Detailansichten. Der Administrator kann wählen welche Produkte oder Themen er in einem Projekt behandeln möchte. Über die Verwendung von Projekt und Produkt/Thema lassen sich auch unterschiedliche Kundenprojekte getrennt voneinander adressieren und darstellen. Mit der entsprechenden ACL-Konfiguration von Dokuwiki ist es auch möglich kundenspezifische Ticketportale zu schaffen.

Eigenschaften

Durch die Vergabe von voreingestellten Filtern können die Anwender gezielt geleitet werden, aber auch selbst die Filter anpassen. Zum Blättern über der Übersichtsliste und den Filtern auf Stati oder Priorität werden entsprechende Kontrollelemente bereitgestellt. Das gesamte Erscheinungsbild des IssueTracker läßt sich nach eigenen Vorstellungen gestalten. Einige Eigenschaften sind sehr einfach über die Konfiguration umstellbar. Es lassen sich eigene Symbole für Status und Priorität einstellen, für andere optische Finessen braucht es etwas Erfahrung mit CSS.

Trotz seiner überschaubaren Anzahl an Konfigurationsparametern läßt er sich recht flexibel für unterschiedliche Anwendungsfälle einstellen. So können Sie je nach Bedarf Elemente der Eingabemaske ausblenden, die Darstellung der Übersichtsliste für Benutzer reduzieren, DokuWiki Gruppen als Ressourcen verwenden, die Anzahl und Bezeichnung für Stati und Prioritäten festlegen, sowie diese mit eigenen Bildern gestalten und noch vieles mehr. Zur besseren Orientierung der Anwender in der Übersichtsliste besitzen die einzelnen Einträge neben dem Erstellungsdatum einen weiteren Zeitstempel. Dieser gibt Auskunft wann das Ticket letztmalig bearbeitet wurde. Zusammen mit der sortierbaren Übersichtsliste der Tickets lässt sich so sehr schnell ein Überblick über die Aktualität verschaffen.

Tickets suchen und finden

Da die Tickets und Kommentare wegen ihres Objektcharakters nicht als Seiten im DokuWiki Format gespeichert werden können, kann die DokuWiki-interne Suchfunktion leider nicht verwendet werden. Dies trifft auch auf die Funktion „Letzte Änderungen“ zu. Der IssueTracker hat aber eine eigene Suchfunktion mit der alle Tickets nach einem Suchbegriff durchsucht werden können. Eine Änderungsverfolgung ist allerdings nicht implementiert.

Zusätzlich zum Hinzufügen von Kommentaren lassen sich in der Detailansicht eines Tickets viele Elemente je nach Nutzerrolle verändern. Werden beispielsweise Kommentare nachträglich geändert, so erhalten sie einen entsprechenden Hinweis, inklusive einem Zeitstempel. Auch die ursprünglichen Titel und Beschreibungen eines Tickets oder die Links lassen sich nachträglich abändern. Der Arbeitsablauf wird mit einigen Automatismen unterstützt. Wenn Sie beispielsweise einem Ticket eine Ressource zuweisen, dann wird auch der zugehörige Status geändert, oder wenn Sie in der Detailansicht eines Reports einen Lösungseintrag schreiben, dann erhält das Ticket den entsprechenden Lösungs-Status gesetzt. Je nach Anwendungsfall lassen sich die automatisch versandten Status E-Mails variabel einstellen. Damit kann der Administrator entscheiden, ob und welche Art von Änderungen per E-Mail Benachrichtigung versendet werden.

Einsatzgebiet

Das Einsatzgebiet des IssueTrackers reicht vom Ticket-System bis hin zur sehr einfachen Kommunikationsplattform. Der IssueTracker wird durch seinen Entwickler sehr aktiv gewartet und Fehler zügig behoben. Auch funktionalen Erweiterungen steht er sehr aufgeschlossen gegenüber. Darüber hinaus ist das Plugin auch in der DokuWiki Dokumentation beschrieben und wird seitens der Community unterstützt. Der IssueTracker hat nicht den Anspruch kommerzielle, datenbankgestützte Ticket-Systeme für internationale Großprojekte mit hochkomplexen Service-Prozessen (ITIL) zu ersetzen. Sein Einsatz ist an DokuWiki geknüpft und ist gut geeignet um dafür eine Aufgabenverwaltung umzusetzen.

Installation

Wir gehen davon aus das Sie bereits ein fertig laufendes DokuWiki in der aktuellen Version installiert haben. Den IssueTracker können Sie auf zwei verschiedene Weisen in das DokuWiki als Funktionserweiterung installieren. Entweder nutzen Sie den sehr bequemen Weg über die Plugin-Administration, indem Sie dort in das Eingabefeld die URL des IssueTracker-Downloads eingeben, oder per FTP direkt auf den Webserver.

Eingabeseite: neue Tickets eines beliebigen Produkts eines bestimmten Projekts erstellen

Beispiel-Syntax:

~~NOCACHE~~
{{issuetracker>project=projektname|display=form}}

Eingabeseite: neue Tickets eines bestimmten Produkts eines bestimmten Projekts erstellen

Beispiel-Syntax:

~~NOCACHE~~
{{issuetracker>project=projektname|product=produktname|status=all|severity=all|display=form}}

Ausgabeseite: alle Tickets aller Produkte eines bestimmten Projekts als Übersichtsseite anzeigen

Beispiel-Anwendungsgebiet

Alle Produkte eines Herstellers anzeigen. Der Kundenname wird zum Projektnamen.

Beispiel-Syntax

~~NOCACHE~~
{{issuetracker>project=projektname|product=all|status=all|severity=all|display=issues|view=500}}

Ausgabeseite: alle Tickets eines bestimmten Produkts eines bestimmten Projekts als Übersichtsseite anzeigen

Beispiel-Syntax:

~~NOCACHE~~
{{issuetracker>project=projektname|product=produktname|status=all|severity=all|display=issues|view=500}

Ausgabeseite: alle Tickets ausser abgebrochenen und gelösten Tickets anzeigen

In der Statistik erscheinen die ausgeblendeten Tickets trotzdem noch. Beispiel-Syntax:

~~NOCACHE~~
{{issuetracker>project=projektname|status=New,Assigned,External Pending,In Progress,Solved, Canceled,Double |severity=all|display=issues}}

Parameter

Die Parameter „status“, „severity“, „view“, „controls“ und „display“ werden zu folgenden Standardwerten zurückgesetzt wenn sie nicht explizit verwendet werden:

status = ALL
severity = ALL
view = 10
controls = ON
display = ISSUES

Folgende Parameter gibt es

project = Pflichtangabe, der Name darf nur einmalig verwendet werden um zwischen den einzelnen Projekten unterscheiden zu können
product = optionale Angabe, um die Eingabeseite oder Ausgabeseite auf ein bestimmtes Produkt zu begrenzen
status = optionale Angabe, definiert die Ausgabeseite auf Tickets mit einem bestimmten Status (Werte mit Komma getrennt)
severity = optionale Angabe, definiert die Ausgabeseite auf Tickets mit einem bestimmten Schweregrad (Werte mit Komma getrennt)
display = Pflichtangabe, definiert ob es sich um eine Eingabeseite oder Ausgabeseite handelt
view = optionale Angabe, definiert die Anzahl der Tickets die auf der Ausgabeseite gesamt angezeigt werden sollen
controls = optionale Angabe, prevents output of controls above and edit of the issue list (on or off)

Warum der NOCACHE Befehl?

Der NOCACHE Befehl sollte stets direkt vor der Syntax des IssueTrackers verwendet werden um zu verhindern das der Webbrowser die Daten zwischenspeichert und wohlmöglich veraltete Daten anzeigt.

Searx

anonymous@undisclosed.example.com (Anonymous) — Wed, 28 Sep 2022 08:36:06 +0000

Searx

Searx ist eine frei konfigurierbare Open Source Meta-Suchmaschine zum selbst installieren auf einem eigenen Server die viele andere Suchmaschinen gleichzeitig abfragt und dabei besonders auf den persönlichen Datenschutz achtet.

Offizielle Website

Eigene SearX-Instanz

Die bei uns laufende SearX Instanz hat eine eigene Domain bekommen und ist unter folgender URL erreichbar:

https://www.sitecrawl.de

Über SearX

https://aware7.de/blog/searx-eigene-private-suchmaschine

Unternamensraum:

Keine Unternamensräume.

Seiten in diesem Namensraum:

S (Fortsetzung)

Searx starten

Searx Fehler

anonymous@undisclosed.example.com (Anonymous) — Tue, 28 Sep 2021 21:43:35 +0000

Searx Fehler

Leider muß man sagen sind viele SearX Installationsanleitungen fehlerhaft, weil fast immer benötigte Abhängigkeiten im Betriebssystem oder verwendeten Komponenten, Modulen u.a. fehlen die in den Anleitungen referenziert werden, beispielsweise GIT, VIRTUALENV oder PIP. So kommt es regelmäßig dazu das trotz peinlichst genauen abarbeiten der einzelnen Installationsschritte es zu Fehlern kommt, auch wenn das Betriebssystem gerade erst frisch aufgesetzt wurde. Aus diesem Grund werden auf dieser Seite typische Fehler bei oder nach der Installation aufgelistet und mögliche Lösungen vorgeschlagen.

Klassische Fehler bei der Installation sind fehlenden Berechtigungen oder Abhängigkeiten. Vieles lässt sich dadurch lösen indem man sich angewöhnt vor dem Kommando ein sudo davorzusetzen. Bei vielen Installationsanleitungen fehlt dies und daher kommt es zu Fehlern.

2.ter Start schlägt fehl

Beim zweiten Start von Searx kommt ein Syntax-Fehler bei Zeile 31 weil für den Betrieb benötigte Module fehlen.

Lösung

Die benötigten Module können folgendermassen nachinstalliert werden:

sudo apt-get install python-pip pip install –upgrade -r requirements.txt

Fehlermeldung beim aktualisieren

./manage.sh: 19: ./manage.sh: pip: not found

Lösung

Auch hier ist der Grund das zum Aktualisieren Software benötigt wird die nicht Teil der Installation ist, also erst nachinstalliert werden muß. In diesem Fall ist es PIP. Dies fehlt quasi in allen gefundenen Installationsanleitungen. Zumindest in Ubuntu 18.04 muss PIP erst manuell nachinstalliert werden:

sudo apt-get install pip

Fehlermeldung beim starten

Traceback (most recent call last): File „searx/webapp.py“, line 31, in <module> import requests ImportError: No module named requests

Lösung:

Auch hier ist wieder der Grund das Module fehlen die für den Betrieb notwendig sind:

sudo apt-get install pip pip install requests pip install pyyaml pip install pygments

Das kann hier noch beliebig so weitergehen bis es zu keinen Fehlern mehr kommt. Installieren sie nach dieser Art alle fehlenden Module nach bis sich SearX fehlerfrei starten lässt. Bei SearX in der Version 0.16.0. sind dies

certifi==2019.3.9
babel==2.7.0
flask-babel==1.0.0
flask==1.0.2
idna==2.8
jinja2==2.10.1
lxml==4.3.3
pygments==2.1.3
pyopenssl==19.0.0
python-dateutil==2.8.0
pyyaml==5.1
requests[socks]==2.22.0

Searx konfigurieren

anonymous@undisclosed.example.com (Anonymous) — Wed, 07 Apr 2021 16:49:20 +0000

Searx konfigurieren

Die Konfiguration wird in folgender Textdatei vorgenommen

/usr/local/searx/searx/settings.yml oder
/etc/searx/settings.yml

Konfigurations-Parameter

Parameter	Beschreibung
port	port number of the searx web application if you run it directly using python searx/webapp.py. Doesn't apply to searx running on Apache or Nginx.
secret_key	used for cryptography purpose.
debug	allow a more detailed log if you run searx directly. Display detailed error messages in the browser too, so this must be deactivated in production.
request_timeout	global timeout of the requests made to others engines in seconds. A bigger timeout will allow to wait for answers from slow engines, but in consequence will slow searx reactivity
	(the result page may take the time specified in the timeout to load)
base_url	the base URL where searx is deployed. Used to create correct inbound links.
themes_path	path to where the themes are located. If you didn't develop anything, leave it blank.
default_theme	name of the theme you want to use by default on you searx instance.
useragent_suffix	suffix to the user-agent searx uses to send requests to others engines. If an engine wish to block you, a contact info here may be useful to avoid that.
image_proxy	allow your instance of searx of being able to proxy images. Uses memory space.
default_locale	interface language. If blank, the locale is detected by using the browser language. If it doesn't work, or you are deploying a language specific instance of searx,
	a locale can be defined using an ISO language code, like fr, en, de.
outgoing_proxies	define a proxy you wish to use.
source_ips	if you use multiple nework interfaces, define from which IP the requests must be made.
locales	locales codes and their names. Available translations of searx interface.