Tabelle

Allgemein

Profil

Herunterladen (3,41 KB)

Anforderung #238 » Handbuch.md

a adm, 11.06.2022 21:20

 

IT-Aufträge und Dokumentation

Bedienung - Links bzw. Verknüpfungen

  • Per Zeilennummer -> #228

    #228

  • Als Link innerhalb der Anwendung -> .pdf erstellen

    [.pdf erstellen](/issues/228)

  • Absoluter Link mit Host, wird als eigener Tab geöffnet -> .pdf erstellen

    [.pdf erstellen](http://3.67.180.30/issues/228)

( eine weitere möglichkeit wäre "Zugehörige Tickets" )

Bedienung - Nach dem Projekt (Anforderung umgesetzt) ist vor dem Projekt "Dokumentation"

Durch kopieren der Zeile Anforderung
in

  • Bedienung
  • Fachliche Details
  • Wartung
  • Technische Details
  • Quelle (bzw. Herkunft)

ist die Dokumentation akkurat zu erledigen.

(Berechtigung "Ticket-kopieren" erforderlich (s.a. #234)

Bedienung - Projekte anlegen

Unterprojekte

sind mit

anzulegen.

Für die Gliederung der Projekte sollten folgende Kriterien beachtet werden

  • fachlich
  • technisch
  • geographisch

Existierende Projekte, die sich grundsätzlich ändern, sind neu anzulegen

  • mit dem existierendem Projektnamen + Jahr (z.B. CMS 2022)

Bedienung - nützliche Abfragen

Fachliche Details - Status-Ablauf einer Zeile unter IT-Aufträge und Dokumentation

  • New
  • begonnen
  • umgesetzt
  • nicht umgesetzt (bitte in der Beschreibung oder im Kommentar den Grund für die "nicht Umsetzung" angeben)
  • freigegeben
  • aktiv (in Betrieb (Dokumentation nicht vergessen) bzw. Dokumente sind sichtbar )
  • inaktiv
  • entsorgt

Fachliche Details - Zeilen im Bereich IT-Aufträge und Dokumentation

IT-Aufträge

  • Anforderung
  • Fehler

Dokumentation

  • Bedienung
  • Fachliche Details -> z.B. Sonderbehandlungen
  • Wartung -> z.B. Monitoring, tägliche, monatliche jährliche Wartung
  • Technische Details -> z.B. Abhängigkeiten, Installation, Backup, Notbetrieb
  • Quelle (bzw. Herkunft mit Angabe entsprechender Abhängigkeit Vorgänger oder Nachfolger unter Zugehörige Tickets)

Quelle - Anforderungen

Technische Details - mit autom. täglichen Cronjob die Handbuch.pdf's erstellen und im Textformat (z.B. Netzwerk-Handbuch.md) archivieren

Handbücher

  • Bedienungsanleitung.pdf ( Auswahl Tracker "Bedienung" oder Inhalt "Bedienungsanleitung" im Feld ".pdf" )
  • Wartungshandbuch.pdf
  • Client-Handbuch.pdf
  • Server-Handbuch.pdf
  • Netzwerk-Handbuch.pdf

Nur Status "aktiv"

Bedienungsanleitung_erstellen_und_archivieren.sh

  • $MANUAL=Bedienungsanleitung ...
  • java ...MarkdownReader --manual $MANUAL ... tracker_id in (38,39) ...
  • pandoc $MANUAL.md --pdf-engine=xelatex --toc --toc-depth=5 -o $MANUAL.pdf

Archivierung bzw. zeitliche (monatliche) Versionierung im Textformat

  • cp $MANUAL.md handbuch_archiv/`date +%Y`/`date +%m` -> ermöglicht den Vergleich von Handbüchern mit dem Vormat, Vorjahr ...
  • Detailiertere Vergleiche sind mit audit-Tabellen oder den Datenbanksicherungen im Textformat möglich

( diese Möglichkeiten sind eine Ergänzung zu der Änderungsprotokollierung der Anwendung )

Clients

Aussendienst-IT

Bedienung - Eingabe von AltGr - Sonderzeichen für VNC- und RDP-Viewer ohne diese Unterstützung

z.B.

  • Alt 126
  • Strg GROSS 7e
/       47  2F
~       126 7E
y       121 79
z       122 7A
Ä      196 C4
Ö      214 D6
Ü      220 DC
ä      228 E4
ö      246 F6
ü      252 FC
{       123 7B
[       91  5B
]       93  5D
}       125 7D
@           64  40
\           92  5C
<           60  3C
>           62  3E
|           124 7C

{} \;       
-       45  2D
:       58  3A

Bedienung - Handy mit Desktop-Adapter (für HDMI, Maus und Tastatur) verbinden

  • Ladegerät per USB-C-Kabel mit Desktop-Adapter verbinden
  • Handy per USB-C-Kabel mit Desktop-Adapter verbinden
  • Display (min. 1920x1080 Auflösung) per HDMI-Kabel mit Desktop-Adapter verbinden
  • Maus und Tastatur per USB-Kabel mit Desktop-Adapter verbinden
  • VPN aktivieren (kann erforderlich sein, wenn dass Netzwerk gewechselt wurde (z.B. abends ins WLAN))
  • Remote-Desktop-App starten

z.B.

Fachliche Details - Täglich zu erledigende Aufgaben

  • Terminkalender aktualisieren
  • Kilometerbuch aktualisieren
  • Spesenbuch aktualisieren
  • Offene Anfragen / Aufträge etc. checken

Quelle - S AG

Netzwerk

Glas

Quelle - Router von Energie AG

Mobilnetz

Quelle - Telekom

Server

Access on Rails

Quelle - AoR-Theme und AoR-Plugin

Wartung - Update

vor einem Update

  • Datenbank- Sicherung bzw. db-dump

nach einem Update

  • Seiten, die vom plugin betroffen sein könnten, testen
  • Neue Texte in plugin - de.yml nachpflegen

Apache HTTP Server

Quelle - Package apache2

Markdown CMS

Quelle - Anforderung #238

#238

Pandoc

Quelle - Package pandoc, texlive-xetex

s.a.

Redmine

Quelle - Package redmine

Alternativen:

Ruby on Rails

Quelle - Package ruby-rails

Server ub22a

Quelle - Ubuntu 22.04

Verwaltung

Bestanderfassung

Bedienung - Bedienungsanleitung für die Bestandserfassung

Erfassungen nach Anforderung

In der Zentrale werden die zu erfassenden Zeilen manuell oder automatisch
mit

  • Thema (= zu erfassendes Teil)
  • Termin (= gewünschter Termin der Erfassung)

ohne Angabe der Menge vorerfasst.

Am jeweiligem Standort sind dann zum gewünschten Termin die Mengen zu erfassen.

Vor dem scannen des BAR-Codes ist der Focus auf das Feld "BAR-Code/EAN" zu setzen.

Hier sind nur Bestanderfassungen vorgesehen,
die das ERP-System nicht abdeckt .

Bedienung - Kommentarvorschläge

Sind unter Dokumente
mit dem Dokumenttyp "Kommentarvorschlag"
zu pflegen.

Fachliche Details - Entsorgung -- Scanner

  • sind im Zentrallager im Container Elektronikschrott zu sammeln
  • und beim qualifiziertem Entsorger abzugeben

Quelle - Anforderung #204

#204

Technische Details - Datensicherung per rsync

s.a. https://wiki.ubuntuusers.de/rsync | https://wiki.ubuntuusers.de/SSH

set -e
ssh -i ~/.ssh/pkey.pem  adm@2400.2.20.56  \
    'sqldump  --extended-insert=FALSE   --host 127.0.0.1  -u backupuser -p843cdde901 accessdb  > accessdb_dump.txt'
BAKDIR=~/backup/backup_access_`date +%Y%m%d`
if         test -d $BAKDIR; then
  echo Verzeichnis $BAKDIR bereits vorhanden
else  
  mkdir            $BAKDIR
fi
rsync \
    --verbose --delete --archive  \
    -e  'ssh -i ~/.ssh/pkey.pem'  'adm@2400.2.20.56:~'  \
    $BAKDIR

Technische Details - view public.bestaende_qry

In der Zentrale sind die Bestände
über die view public.bestaende_qry für ERP und Access verfügbar.

Wartung - Laufende Wartung Monitoring

minütlich per Monitoringserver .57

  • ping
  • curl GET

Wartung - Laufende Wartung jährlich -- Scannertest

  • BAR-Code
  • EAN 8-stellig
  • EAN 13-stellig

mit den Codes

  • lt. Testblatt
  • und realen Codes vor Ort.

Wartung - Laufende Wartung monatlich -- Termine pflegen

14 Tage vor den Bestandsaufnahmen

  • 30.6.
  • 31.12.

sind die zu erfassenden Teile mit Angabe des Termines einzugeben oder zu importieren.

( laufende oder individuell veranlasste Bestandsaufnahmen bedürfen keiner Terminpflege )

Wartung - Laufende Wartung wöchentlich -- Update

  • apt update && apt upgrade && apt autoremove && apt autoclean
  • reboot
  • Ablauf von Zertifikaten prüfen

Planung:
über /etc/crontab umsetzen

(2-2/2)