Handbuch

IT-Aufträge und Dokumentation

Bedienung - Links bzw. Verknüpfungen

#228
[.pdf erstellen](/issues/228)
[.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 - /projects/new

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

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

z.B.

Fachliche Details - Täglich zu erledigende Aufgaben

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

nach einem Update

Apache HTTP Server

Quelle - Package apache2

Markdown CMS

Quelle - Anforderung #238

#238

Pandoc

Quelle - Package pandoc, texlive-xetex

s.a. - https://pandoc.org

Redmine

Quelle - Package redmine

Alternativen: - AWS - Azure

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

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

Wartung - Laufende Wartung jährlich – Scannertest

mit den Codes

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

Planung: über /etc/crontab umsetzen