108 lines
2.2 KiB
Markdown
108 lines
2.2 KiB
Markdown
# wh20 - SSH-Shortcuts für easyname WH20 Webserver
|
|
|
|
## Funktion
|
|
|
|
Dieses Skript stellt eine SSH-Verbindung zu einem angegebenen WH20 Webserver her. Optional kann über den Parameter `--tenant` die Domain angepasst werden, um auf Server in verschiedenen Tenant-Umgebungen zuzugreifen.
|
|
|
|
## Voraussetzungen
|
|
|
|
- SSH-Zugriff auf den Zielserver
|
|
- Der Benutzername muss als Umgebungsvariable `WHUSER` gesetzt sein
|
|
- Das Skript muss ausführbar sein (`chmod +x wh20.sh`)
|
|
|
|
## Installation
|
|
|
|
1. **WHUSER Variable setzen** (in `~/.bashrc` oder `~/.bash_env`):
|
|
```bash
|
|
export WHUSER="deinusername"
|
|
```
|
|
|
|
2. **Installation über Installer**:
|
|
```bash
|
|
# Im Repository-Hauptverzeichnis
|
|
./install.sh
|
|
```
|
|
|
|
## Verwendung
|
|
|
|
### Standard-Verbindung (easyname.systems)
|
|
```bash
|
|
wh20 web15
|
|
```
|
|
→ Verbindet zu `web15.wh20.easyname.systems`
|
|
|
|
### Mit Tenant adino
|
|
```bash
|
|
wh20 web15 --tenant adino
|
|
```
|
|
→ Verbindet zu `web15.adino.at`
|
|
|
|
### Mit Tenant dona
|
|
```bash
|
|
wh20 web15 --tenant dona
|
|
```
|
|
→ Verbindet zu `web15.inname.net`
|
|
|
|
## Syntax
|
|
|
|
```bash
|
|
wh20 <webserver> [--tenant adino|dona]
|
|
```
|
|
|
|
### Parameter
|
|
|
|
- `<webserver>`: Name des Webservers (z.B. `web15`, `srv272`, `ws12`)
|
|
- `--tenant`: Optional. Bestimmt die Domain-Endung:
|
|
- `adino` → `<webserver>.adino.at`
|
|
- `dona` → `<webserver>.inname.net`
|
|
- Ohne Angabe → `<webserver>.wh20.easyname.systems`
|
|
|
|
## Domain-Mapping
|
|
|
|
| Tenant | Domain-Pattern |
|
|
|--------|----------------|
|
|
| (kein) | `<webserver>.wh20.easyname.systems` |
|
|
| `adino` | `<webserver>.adino.at` |
|
|
| `dona` | `<webserver>.inname.net` |
|
|
|
|
## Beispiele
|
|
|
|
```bash
|
|
# Standard WH20 Server
|
|
wh20 web15
|
|
wh20 srv272
|
|
|
|
# Adino Tenant
|
|
wh20 web15 --tenant adino
|
|
wh20 ws12 --tenant adino
|
|
|
|
# Dona Tenant
|
|
wh20 web15 --tenant dona
|
|
wh20 srv272 --tenant dona
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### WHUSER nicht gesetzt
|
|
```
|
|
Fehler: Bitte WHUSER setzen!
|
|
```
|
|
**Lösung**: `export WHUSER="deinusername"` in ~/.bashrc hinzufügen
|
|
|
|
### Unbekannter Tenant
|
|
```
|
|
Unbekannter Tenant: <tenant>
|
|
```
|
|
**Lösung**: Nur `adino` oder `dona` als Tenant-Wert verwenden
|
|
|
|
### Webserver-Name fehlt
|
|
```
|
|
Usage: wh20 <webserver> [--tenant adino|dona]
|
|
```
|
|
**Lösung**: Webserver-Namen als erstes Argument angeben
|
|
|
|
---
|
|
|
|
*Maintainer: ado*
|
|
|