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
• 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 (inkl. Connect Tools)
• 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

• 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

• exitrace
  Exim-Log-Trace & Status für einzelne Mails/Adressen/Domain-Ziele mit Status-Klassifikation (OK/PARTIAL/DELAY/FAIL)

WH20 Snippets

• plesk
  Dieses Skript stellt eine SSH-Verbindung zu einem angegebenen Webserver her und generiert so einen einmaligen Login-Link für das Plesk Admin Panel des gewünschten Servers.

---

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
• Legacy Tools: checkms, go, pincMails, exitrace für Legacy-Infrastruktur
• WH20 Tools: plesk für WH20-Infrastruktur

How-To: Neues Skript anlegen

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

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

   bashprofiles/<username>/
   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>.sh
   chmod +x wh20/<scriptname>/<scriptname>.sh
   

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
   • 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.