esn-support-bash-snippets

Sammel-Repository für Bash-Skripte des easyname Support-Teams.
Hier sammeln wir kleine Helfer für Log-Analysen, Automatisierungen und typische Support-Fälle.

Inhaltsverzeichnis

• Quick Start
• Übersicht
• Bash-Profile
• Connect Tools
• Legacy Snippets
• WH20 Snippets
• Installation
• Updates
• How-To: Neues Skript anlegen
• Lizenz / Sichtbarkeit

Übersicht

Die Skripte sind nach Kategorie getrennt:

• Bashprofiles – Optimierte Bash-Konfigurationen
• Legacy – Snippets für Legacy-Umgebungen
• WH20 – Snippets für WH20-Umgebungen

Bash-Profile

Optimierte Bash-Konfigurationen für verschiedene Support-Umgebungen:

• pl
  → Dokumentation & Beispiele
  Basis-Profil mit erweiterter History, farbigem Prompt und modularer Struktur

Legacy Snippets

Aktuell enthalten:

• checkms
  Analyse von Microsoft-spezifischen SMTP Fehlercodes (S3150, S775, S7771…) in den Exim-Logs.

• go
  SSH-Shortcuts mit Kerberos-Auth für Web-, MX-, Logger- und Support-Server

• pincMails
  Sucht nach versendeten PINC Mails einer bestimmten Kundennummer und kopiert diese in einen lokalen Unterordner

Weitere Snippets für Legacy kommen hier dazu.

WH20 Snippets

(noch leer, Platzhalter für künftige Snippets)

---

Quick Start

One-liner Installation:

git clone http://vps.dominikus.one:3000/ljp/esn-support-bash-snippets.git esn-support-tools && cd esn-support-tools && ./install.sh

One-liner Update:

cd esn-support-tools && ./update.sh

Installation

Nach dem Klonen des Repositories steht ein interaktives Installationsscript zur Verfügung:

# Repository klonen
git clone http://vps.dominikus.one:3000/ljp/esn-support-bash-snippets.git

# WICHTIG: Repository umbenennen (empfohlen)
mv esn-support-bash-snippets esn-support-tools
cd esn-support-tools

# Installation testen (empfohlen)
./install.sh --dry-run

# Installationsscript ausführen
./install.sh

# Hilfe anzeigen
./install.sh --help

⚠️ Wichtiger Hinweis zu Symlinks:
Das Installationsscript erstellt Symlinks zu den Scripts im aktuellen Repository-Pfad. Wenn du das Repository später verschiebst oder umbenennst, funktionieren die installierten Tools nicht mehr. Empfehlung: Repository vor der Installation in einen permanenten Pfad legen (z.B. ~/tools/esn-support-tools).

Updates

Für Updates bestehender Installationen:

# In Repository-Verzeichnis wechseln
cd /pfad/zu/esn-support-tools

# Update testen (empfohlen)
./update.sh --dry-run

# Update durchführen
./update.sh

Features des Installers:

• Dry-Run Modus: --dry-run testet Installation ohne Dateiveränderungen
• Interaktive Auswahl: Kategorien und einzelne Tools wählbar
• Automatische Backups: Vorhandene Dateien werden gesichert
• Symlink-Management: Tools werden in ~/bin verlinkt
• LUSER-Setup: Automatische Konfiguration für go-Tool
• Modular erweiterbar: Neue Tools einfach hinzufügbar

Verfügbare Kategorien:

• Bash-Profile: .bashrc Optimierungen und modulare Konfiguration
• Connect Tools: SSH-Shortcuts (go-Tool) mit Kerberos-Setup
• Legacy Tools: checkms, quicknav für Legacy-Infrastruktur
• WH20 Tools: Platzhalter für zukünftige WH20-Tools

How-To: Neues Skript anlegen

Um ein neues Bash-Skript in dieses Repository aufzunehmen, bitte folgende Schritte:

1. Ordnerstruktur anlegen
   Je nach Kategorie (bashprofiles, connect, legacy oder wh20) einen Unterordner erstellen:

   bashprofiles/<username>/
   connect/<scriptname>/
   legacy/<scriptname>/
   wh20/<scriptname>/
   

2. Skript hinzufügen
   Das eigentliche Skript im neuen Ordner ablegen:

   legacy/<scriptname>/<scriptname>
   

   oder

   wh20/<scriptname>/<scriptname>
   

   und ausführbar machen:

   chmod +x legacy/<scriptname>/<scriptname>
   chmod +x wh20/<scriptname>/<scriptname>
   

3. README.md erstellen
   Als Basis das Template verwenden:
   README_template_script.md
   → kopieren, anpassen und ins Skript-Verzeichnis legen:

   legacy/<scriptname>/README.md
   

   oder

   wh20/<scriptname>/README.md
   

4. Übersicht aktualisieren
   Das Skript in die Übersicht der passenden Kategorie-README eintragen:

   • bashprofiles/README.md
   • connect/README.md
   • legacy/README.md
   • wh20/README.md

5. Install-Script erweitern
   Neue Tools zum install.sh hinzufügen für automatische Installation

6. Commit & Push
   Änderungen ins Repo übernehmen:

   git add .
   git commit -m "Add <scriptname> to <category>"
   git push
   

Lizenz / Sichtbarkeit

Dieses Repository ist intern für easyname Support.
Falls eine Freigabe nach extern geplant ist, bitte vorab mit Teamleitung abklären.