|
<!DOCTYPE html>
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
|
|
<head>
|
|
<meta charset="utf-8" />
|
|
<meta name="generator" content="pandoc" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
|
|
<title>Handbuch</title>
|
|
<style>
|
|
code{white-space: pre-wrap;}
|
|
span.smallcaps{font-variant: small-caps;}
|
|
span.underline{text-decoration: underline;}
|
|
div.column{display: inline-block; vertical-align: top; width: 50%;}
|
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
|
ul.task-list{list-style: none;}
|
|
|
|
ul {
|
|
list-style: disc;
|
|
padding: 0.5rem;
|
|
margin: 0.5rem;
|
|
}
|
|
|
|
a {
|
|
text-decoration: none;
|
|
color: #222;
|
|
font-weight: 600;
|
|
}
|
|
|
|
a:hover {
|
|
text-decoration: underline;
|
|
}
|
|
|
|
|
|
h3 {
|
|
background-color: lightGrey;
|
|
font-weight: bold;
|
|
}
|
|
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<header id="title-block-header">
|
|
<h1 class="title">Handbuch</h1>
|
|
</header>
|
|
<nav id="TOC" role="doc-toc">
|
|
<ul>
|
|
<li><a href="#it-aufträge-und-dokumentation">IT-Aufträge und Dokumentation</a>
|
|
<ul>
|
|
<li><a href="#clients">Clients</a>
|
|
<ul>
|
|
<li><a href="#aussendienst-it">Aussendienst-IT</a></li>
|
|
</ul></li>
|
|
<li><a href="#netzwerk">Netzwerk</a>
|
|
<ul>
|
|
<li><a href="#glas">Glas</a></li>
|
|
<li><a href="#mobilnetz">Mobilnetz</a></li>
|
|
</ul></li>
|
|
<li><a href="#server">Server</a>
|
|
<ul>
|
|
<li><a href="#access-on-rails">Access on Rails</a></li>
|
|
<li><a href="#apache-http-server">Apache HTTP Server</a></li>
|
|
<li><a href="#markdown-cms">Markdown CMS</a></li>
|
|
<li><a href="#pandoc">Pandoc</a></li>
|
|
<li><a href="#redmine">Redmine</a></li>
|
|
<li><a href="#ruby-on-rails">Ruby on Rails</a></li>
|
|
<li><a href="#server-ub22a">Server ub22a</a></li>
|
|
</ul></li>
|
|
<li><a href="#verwaltung">Verwaltung</a>
|
|
<ul>
|
|
<li><a href="#bestanderfassung">Bestanderfassung</a></li>
|
|
</ul></li>
|
|
</ul></li>
|
|
</ul>
|
|
</nav>
|
|
<h1 id="it-aufträge-und-dokumentation">IT-Aufträge und Dokumentation</h1>
|
|
<hr />
|
|
<p><strong>Bedienung - Links bzw. Verknüpfungen</strong></p>
|
|
<ul>
|
|
<li>Per Zeilennummer -> #228</li>
|
|
</ul>
|
|
<pre><code>#228</code></pre>
|
|
<ul>
|
|
<li>Als Link innerhalb der Anwendung -> <a href="/issues/228">.pdf erstellen</a></li>
|
|
</ul>
|
|
<pre><code>[.pdf erstellen](/issues/228)</code></pre>
|
|
<ul>
|
|
<li>Absoluter Link mit Host, wird als eigener Tab geöffnet -> <a href="http://3.67.180.30/issues/228">.pdf erstellen</a></li>
|
|
</ul>
|
|
<pre><code>[.pdf erstellen](http://3.67.180.30/issues/228)</code></pre>
|
|
<hr />
|
|
<p><em>( eine weitere möglichkeit wäre “Zugehörige Tickets” )</em></p>
|
|
<hr />
|
|
<p><strong>Bedienung - Nach dem Projekt (Anforderung umgesetzt) ist vor dem Projekt “Dokumentation”</strong></p>
|
|
<p>Durch <strong>kopieren</strong> der Zeile <strong>Anforderung</strong> in - <strong>Bedienung</strong> - Fachliche Details - Wartung - Technische Details - Quelle (bzw. Herkunft)</p>
|
|
<p>ist die Dokumentation akkurat zu erledigen.</p>
|
|
<p><em>(Berechtigung “Ticket-kopieren” erforderlich (s.a. #234)</em></p>
|
|
<hr />
|
|
<p><strong>Bedienung - Projekte anlegen</strong></p>
|
|
<p>Unterprojekte</p>
|
|
<p>sind mit - <a href="/projects/new">/projects/new</a></p>
|
|
<p>anzulegen.</p>
|
|
<hr />
|
|
<p>Für die Gliederung der Projekte sollten folgende Kriterien beachtet werden - <strong>fachlich</strong> - technisch - geographisch</p>
|
|
<p>Existierende Projekte, die sich grundsätzlich ändern, sind neu anzulegen - mit dem existierendem Projektnamen <strong>+ Jahr</strong> <em>(z.B. CMS 2022)</em></p>
|
|
<hr />
|
|
<p><strong>Bedienung - nützliche Abfragen</strong></p>
|
|
<ul>
|
|
<li><a href="/issues?query_id=22">offene Anforderungen / Fehler</a></li>
|
|
<li><a href="/issues?query_id=33">Dokumentation (aktiv)</a></li>
|
|
</ul>
|
|
<hr />
|
|
<p><strong>Fachliche Details - Status-Ablauf einer Zeile unter IT-Aufträge und Dokumentation</strong></p>
|
|
<ul>
|
|
<li>New<br />
|
|
</li>
|
|
<li>begonnen<br />
|
|
</li>
|
|
<li>umgesetzt<br />
|
|
</li>
|
|
<li>nicht umgesetzt (bitte in der Beschreibung oder im Kommentar den Grund für die “nicht Umsetzung” angeben)</li>
|
|
<li>freigegeben<br />
|
|
</li>
|
|
<li>aktiv (in Betrieb <em>(<a href="/issues/235">Dokumentation nicht vergessen</a>)</em> bzw. Dokumente sind sichtbar )</li>
|
|
<li>inaktiv<br />
|
|
</li>
|
|
<li>entsorgt</li>
|
|
</ul>
|
|
<hr />
|
|
<p><strong>Fachliche Details - Zeilen im Bereich IT-Aufträge und Dokumentation</strong></p>
|
|
<p>IT-Aufträge - <strong>Anforderung</strong> - Fehler</p>
|
|
<p>Dokumentation - <strong>Bedienung</strong> - 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 <strong>Abhängigkeit</strong> <a href="/issues/252"><em>Vorgänger</em></a> oder <a href="/issues/253"><em>Nachfolger</em></a> unter <strong>Zugehörige Tickets</strong>)</p>
|
|
<hr />
|
|
<p><strong>Quelle - Anforderungen</strong></p>
|
|
<hr />
|
|
<p><strong>Technische Details - mit autom. täglichen Cronjob die Handbuch.pdf’s erstellen und im Textformat (z.B. Netzwerk-Handbuch.md) archivieren</strong></p>
|
|
<p><strong>Handbücher</strong> - <strong>Bedienung</strong>sanleitung.pdf <em>( Auswahl Tracker “Bedienung” oder Inhalt “Bedienungsanleitung” im Feld “.pdf” )</em> - <strong>Wartung</strong>shandbuch.pdf - <strong>Client</strong>-Handbuch.pdf - <strong>Server</strong>-Handbuch.pdf - <strong>Netzwerk</strong>-Handbuch.pdf</p>
|
|
<p><strong>Nur Status “aktiv”</strong></p>
|
|
<p><strong>Bedienungsanleitung_erstellen_und_archivieren.sh</strong> - $MANUAL=Bedienungsanleitung … - java …MarkdownReader –manual $MANUAL … tracker_id in (38,39) … - pandoc $MANUAL.md –pdf-engine=xelatex –toc –toc-depth=5 -o $MANUAL.pdf</p>
|
|
<p>Archivierung bzw. zeitliche (monatliche) <strong>Versionierung im Textformat</strong> - cp $MANUAL.md handbuch_archiv/`date +%Y`/`date +%m` <em>-> ermöglicht den Vergleich von Handbüchern mit dem Vormat, Vorjahr …</em> - Detailiertere Vergleiche sind mit audit-Tabellen oder den Datenbanksicherungen im Textformat möglich</p>
|
|
<p><em>( diese Möglichkeiten sind eine Ergänzung zu der Änderungsprotokollierung der Anwendung )</em></p>
|
|
<h2 id="clients">Clients</h2>
|
|
<h3 id="aussendienst-it">Aussendienst-IT</h3>
|
|
<hr />
|
|
<p><strong>Bedienung - Eingabe von AltGr - Sonderzeichen für VNC- und RDP-Viewer ohne diese Unterstützung</strong></p>
|
|
<p>z.B. - Alt 126 - Strg GROSS 7e</p>
|
|
<pre><code>/ 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</code></pre>
|
|
<hr />
|
|
<p><strong>Bedienung - Handy mit Desktop-Adapter (für HDMI, Maus und Tastatur) verbinden</strong></p>
|
|
<ul>
|
|
<li><strong>Ladegerät</strong> per USB-C-Kabel mit Desktop-Adapter verbinden</li>
|
|
<li><strong>Handy</strong> per USB-C-Kabel mit Desktop-Adapter verbinden</li>
|
|
<li><strong>Display</strong> (min. 1920x1080 Auflösung) per HDMI-Kabel mit Desktop-Adapter verbinden</li>
|
|
<li><strong>Maus</strong> und <strong>Tastatur</strong> per USB-Kabel mit Desktop-Adapter verbinden</li>
|
|
</ul>
|
|
<hr />
|
|
<ul>
|
|
<li><strong>VPN</strong> aktivieren (kann erforderlich sein, wenn dass Netzwerk gewechselt wurde (z.B. abends ins WLAN))</li>
|
|
<li><strong>Remote-Desktop</strong>-App starten</li>
|
|
</ul>
|
|
<hr />
|
|
<p>z.B.</p>
|
|
<p><img src="http://3.67.180.30/attachments/download/49/beispiel_vnc_unzureichend.jpg" /></p>
|
|
<hr />
|
|
<p><strong>Fachliche Details - Täglich zu erledigende Aufgaben</strong></p>
|
|
<ul>
|
|
<li>Terminkalender aktualisieren</li>
|
|
<li>Kilometerbuch aktualisieren</li>
|
|
<li>Spesenbuch aktualisieren</li>
|
|
<li>Offene Anfragen / Aufträge etc. checken</li>
|
|
</ul>
|
|
<hr />
|
|
<p><strong>Quelle - S AG</strong></p>
|
|
<h2 id="netzwerk">Netzwerk</h2>
|
|
<h3 id="glas">Glas</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Router von Energie AG</strong></p>
|
|
<h3 id="mobilnetz">Mobilnetz</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Telekom</strong></p>
|
|
<h2 id="server">Server</h2>
|
|
<h3 id="access-on-rails">Access on Rails</h3>
|
|
<hr />
|
|
<p><strong>Quelle - AoR-Theme und AoR-Plugin</strong></p>
|
|
<hr />
|
|
<p><strong>Wartung - Update</strong></p>
|
|
<p><strong>vor</strong> einem Update</p>
|
|
<ul>
|
|
<li>Datenbank- <strong>Sicherung</strong> bzw. db-dump</li>
|
|
</ul>
|
|
<p><strong>nach</strong> einem Update</p>
|
|
<ul>
|
|
<li>Seiten, die vom plugin betroffen sein könnten, <strong>testen</strong></li>
|
|
<li>Neue Texte in plugin - de.yml <strong>nachpflegen</strong></li>
|
|
</ul>
|
|
<h3 id="apache-http-server">Apache HTTP Server</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Package apache2</strong></p>
|
|
<h3 id="markdown-cms">Markdown CMS</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Anforderung #238</strong></p>
|
|
<p>#238</p>
|
|
<h3 id="pandoc">Pandoc</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Package pandoc, texlive-xetex</strong></p>
|
|
<p>s.a. - https://pandoc.org</p>
|
|
<h3 id="redmine">Redmine</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Package redmine</strong></p>
|
|
<p>Alternativen: - <a href="https://aws.amazon.com/marketplace/pp/prodview-urx6afmwf5y64?sr=0-1&ref_=beagle&applicationId=AWSMPContessa">AWS</a> - <a href="https://azuremarketplace.microsoft.com/en-us/marketplace/apps/bitnami.redmine?tab=Overview">Azure</a></p>
|
|
<h3 id="ruby-on-rails">Ruby on Rails</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Package ruby-rails</strong></p>
|
|
<h3 id="server-ub22a">Server ub22a</h3>
|
|
<hr />
|
|
<p><strong>Quelle - Ubuntu 22.04</strong></p>
|
|
<h2 id="verwaltung">Verwaltung</h2>
|
|
<h3 id="bestanderfassung">Bestanderfassung</h3>
|
|
<hr />
|
|
<p><strong>Bedienung - Bedienungsanleitung für die Bestandserfassung</strong></p>
|
|
<p><strong>Erfassungen nach Anforderung</strong></p>
|
|
<p>In der Zentrale werden die zu erfassenden Zeilen manuell oder automatisch mit - Thema (= zu erfassendes Teil) - Termin (= gewünschter Termin der Erfassung)</p>
|
|
<p>ohne Angabe der Menge vorerfasst.</p>
|
|
<hr />
|
|
<p>Am jeweiligem Standort sind dann zum gewünschten Termin die Mengen zu erfassen.</p>
|
|
<p>Vor dem scannen des BAR-Codes ist der Focus auf das Feld “BAR-Code/EAN” zu setzen.</p>
|
|
<hr />
|
|
<p>Hier sind nur Bestanderfassungen vorgesehen, die das <strong>ERP-System nicht abdeckt</strong> .</p>
|
|
<hr />
|
|
<p><strong>Bedienung - Kommentarvorschläge</strong></p>
|
|
<p>Sind unter Dokumente mit dem Dokumenttyp “Kommentarvorschlag” zu pflegen.</p>
|
|
<hr />
|
|
<p><strong>Fachliche Details - Entsorgung – Scanner</strong></p>
|
|
<ul>
|
|
<li>sind im Zentrallager im Container <strong>Elektronikschrott</strong> zu sammeln</li>
|
|
<li>und beim qualifiziertem Entsorger abzugeben</li>
|
|
</ul>
|
|
<hr />
|
|
<p><strong>Quelle - Anforderung #204</strong></p>
|
|
<p>#204</p>
|
|
<hr />
|
|
<p><strong>Technische Details - Datensicherung per rsync</strong></p>
|
|
<p>s.a. https://wiki.ubuntuusers.de/rsync | https://wiki.ubuntuusers.de/SSH</p>
|
|
<pre><code>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</code></pre>
|
|
<hr />
|
|
<p><strong>Technische Details - view public.bestaende_qry</strong></p>
|
|
<p>In der Zentrale sind die Bestände über die <strong>view public.bestaende_qry</strong> für ERP und Access verfügbar.</p>
|
|
<hr />
|
|
<p><strong>Wartung - Laufende Wartung Monitoring</strong></p>
|
|
<p>minütlich per Monitoringserver .57</p>
|
|
<ul>
|
|
<li>ping</li>
|
|
<li>curl GET</li>
|
|
</ul>
|
|
<hr />
|
|
<p><strong>Wartung - Laufende Wartung jährlich – Scannertest</strong></p>
|
|
<ul>
|
|
<li>BAR-Code</li>
|
|
<li>EAN 8-stellig</li>
|
|
<li>EAN 13-stellig</li>
|
|
</ul>
|
|
<p>mit den Codes</p>
|
|
<ul>
|
|
<li>lt. Testblatt</li>
|
|
<li>und realen Codes vor Ort.</li>
|
|
</ul>
|
|
<hr />
|
|
<p><strong>Wartung - Laufende Wartung monatlich – Termine pflegen</strong></p>
|
|
<p>14 Tage vor den Bestandsaufnahmen - 30.6. - 31.12.</p>
|
|
<p>sind die zu erfassenden Teile mit Angabe des Termines einzugeben oder zu importieren.</p>
|
|
<p><em>( laufende oder individuell veranlasste Bestandsaufnahmen bedürfen keiner Terminpflege )</em></p>
|
|
<hr />
|
|
<p><strong>Wartung - Laufende Wartung wöchentlich – Update</strong></p>
|
|
<ul>
|
|
<li>apt update && apt upgrade && apt autoremove && apt autoclean</li>
|
|
<li>reboot</li>
|
|
<li>Ablauf von Zertifikaten prüfen</li>
|
|
</ul>
|
|
<p><em>Planung:</em> über /etc/crontab umsetzen</p>
|
|
</body>
|
|
</html>
|