docs/hs.docs.users.git - Hostsharing Git Server

Jan Ulrich Hasecke

2022-08-12 c8bdf77b377186fa864460b51f3f8ddf1bfa5598

commit \| author \| age
457647	1	<!DOCTYPE html>
JUH	2	<html lang="de"><head>
	3	<meta http-equiv="content-type" content="text/html; charset=UTF-8">
747a05	4	<meta name="description" content="<p>Dieses Handbuch richtet sich an
JUH	5	Anwender, welche ihre Internetprojekte bei der Hostsharing eG betreiben
	6	möchten. Es bietet einen Überblick über die Infrastruktur, eine
	7	Einführung in deren Nutzung sowie eine Beschreibung typischer
	8	Prozesse.</p>">
	9	<meta name="DC.description" content="<p>Dieses Handbuch richtet sich
	10	an Anwender, welche ihre Internetprojekte bei der Hostsharing eG
	11	betreiben möchten. Es bietet einen Überblick über die Infrastruktur,
	12	eine Einführung in deren Nutzung sowie eine Beschreibung typischer
	13	Prozesse.</p>">
457647	14	<meta name="DC.title" content="Managed Operations Platform">
747a05	15	<meta name="author" content="">
457647	16
JUH	17	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	18	<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
	19
	20	<meta name="twitter:card" content="summary_large_image">
	21	<meta name="twitter:image" content="https://www.hostsharing.net/images/hostsharing-logo.jpg">
	22
	23	<meta name="twitter:title" content="Managed Operations Platform">
747a05	24	<meta name="twitter:description" content="<p>Dieses Handbuch richtet
JUH	25	sich an Anwender, welche ihre Internetprojekte bei der Hostsharing eG
	26	betreiben möchten. Es bietet einen Überblick über die Infrastruktur,
	27	eine Einführung in deren Nutzung sowie eine Beschreibung typischer
	28	Prozesse.</p>">
457647	29	<meta property="og:title" content="Managed Operations Platform">
747a05	30	<meta property="og:description" content="<p>Dieses Handbuch richtet sich
JUH	31	an Anwender, welche ihre Internetprojekte bei der Hostsharing eG
	32	betreiben möchten. Es bietet einen Überblick über die Infrastruktur,
	33	eine Einführung in deren Nutzung sowie eine Beschreibung typischer
	34	Prozesse.</p>">
457647	35	<meta property="og:type" content="article">
JUH	36	<meta property="og:url" content="">
	37	<meta property="og:image" content="https://www.hostsharing.net/images/hostsharing-logo.jpg">
	38	<meta itemprop="name" content="Managed Operations Platform">
747a05	39	<meta itemprop="description" content="<p>Dieses Handbuch richtet sich an
JUH	40	Anwender, welche ihre Internetprojekte bei der Hostsharing eG betreiben
	41	möchten. Es bietet einen Überblick über die Infrastruktur, eine
	42	Einführung in deren Nutzung sowie eine Beschreibung typischer
	43	Prozesse.</p>">
457647	44	<meta itemprop="image" content="https://www.hostsharing.net/images/hostsharing-logo.jpg">
JUH	45	<meta itemprop="image" content="https://www.hostsharing.net/images/hostsharing-logo.jpg">
	46	<meta itemprop="keywords" content="">
	47	<title>Managed Operations Platform</title>
	48	<link rel="icon" href="https://www.hostsharing.net/hs-theme/hostsharing/img/favicon.ico">
	49	<link rel="shortcut icon" href="https://www.hostsharing.net/hs-theme/hostsharing/img/favicon.ico">
	50	<link rel="stylesheet" href="https://www.hostsharing.net/hs-theme/optimized/optimized.min.css">
	51	<link href="https://www.hostsharing.net/optimized/optimized.min.css" rel="stylesheet">
	52	</head>
	53	<body class="documentation">
	54	<nav class="navbar navbar-expand-xl navbar-light fixed-top">
	55	<div class="container">
	56	<a class="navbar-brand" href="https://www.hostsharing.net/"><img src="https://www.hostsharing.net/hs-theme/hostsharing/img/logo.svg" alt="Hostsharing eG – Genossenschaftliches Webhosting"></a>
	57	<button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Navigation umschalten">
	58	<span class="navbar-toggler-icon"></span>
	59	</button>
	60	<div class="collapse navbar-collapse" id="navbarSupportedContent">
	61	<ul class="navbar-nav ml-auto">
	62	<li class="nav-item dropdown">
	63	<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown-ccc" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Cooperative Community Cloud</a>
	64	<div class="dropdown-menu" aria-labelledby="navbarDropdown-ccc">
	65	<a class="dropdown-item" href="https://www.hostsharing.net/ziele/">Ziele</a>
	66	<a class="dropdown-item" href="https://www.hostsharing.net/vorteile/">Vorteile</a>
	67	<a class="dropdown-item" href="https://www.hostsharing.net/features/">Plattform</a>
	68	<a class="dropdown-item" href="https://www.hostsharing.net/hosting/">Lösungen</a>
	69	<div class="dropdown-divider"></div>
	70	<a class="dropdown-item" href="https://www.hostsharing.net/genossenschaft">Genossenschaft</a>
	71	<a class="dropdown-item" href="https://www.hostsharing.net/referenzen">Mitglieder</a>
	72	<a class="dropdown-item" href="https://www.hostsharing.net/team">Team</a>
	73	<div class="dropdown-divider"></div>
	74	<a class="dropdown-item" href="https://www.hostsharing.net/genossenschaft/mitgliedschaft">Mitglied werden</a>
	75	</div>
	76	</li>
	77	<li class="nav-item dropdown">
	78	<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown-hosting" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Hosting</a>
	79	<div class="dropdown-menu" aria-labelledby="navbarDropdown-hosting">
	80	<a class="dropdown-item" href="https://www.hostsharing.net/angebote/">Übersicht</a>
	81	<div class="dropdown-divider"></div>
	82	<a class="dropdown-item" href="https://www.hostsharing.net/angebote/managed-webspace">Managed Webspace</a>
	83	<a class="dropdown-item" href="https://www.hostsharing.net/angebote/managed-server/">Managed Server</a>
	84	<a class="dropdown-item" href="https://www.hostsharing.net/angebote/cloud-server/">Cloud Server</a>
	85	<div class="dropdown-divider"></div>
	86	<a class="dropdown-item" href="https://www.hostsharing.net/angebote/domains">Domains</a>
	87	</div>
	88	</li>
	89	<li class="nav-item dropdown">
	90	<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown-service" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Service</a>
	91	<div class="dropdown-menu" aria-labelledby="navbarDropdown-service">
	92	<a class="dropdown-item" href="https://www.hostsharing.net/service/">Übersicht</a>
	93	<div class="dropdown-divider"></div>
	94	<a class="dropdown-item" href="https://www.hostsharing.net/service/sla-service-level-agreements/">Service Level Agreements</a>
	95	<a class="dropdown-item" href="https://www.hostsharing.net/service/webmaster-as-a-service/">Webmaster as a Service</a>
	96	<a class="dropdown-item" href="https://www.hostsharing.net/service/webmaster-on-demand/">Webmaster on Demand</a>
	97	<div class="dropdown-divider"></div>
	98	<a class="dropdown-item" href="https://www.hostsharing.net/service/installationsservice/">Installationsservice</a>
	99	<a class="dropdown-item" href="https://www.hostsharing.net/service/umzugsservice/">Umzugsservice</a>
	100	</div>
	101	</li>
	102	<li class="nav-item dropdown">
	103	<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown-bbb" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">BigBlueButton</a>
	104	<div class="dropdown-menu" aria-labelledby="navbarDropdown-bbb">
	105	<a class="dropdown-item" href="https://www.hostsharing.net/bigbluebutton/">Übersicht</a>
	106	<div class="dropdown-divider"></div>
	107	<a class="dropdown-item" href="https://www.hostsharing.net/bigbluebutton/bbb-meeting/">BBB Meeting</a>
	108	<a class="dropdown-item" href="https://www.hostsharing.net/bigbluebutton/bbb-conference/">BBB Conference</a>
	109	<a class="dropdown-item" href="https://www.hostsharing.net/bigbluebutton/bbb-server/">BBB Server</a>
	110	</div>
	111	</li>
	112	<li class="nav-item dropdown">
	113	<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown-aktuell" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">News</a>
	114	<div class="dropdown-menu" aria-labelledby="navbarDropdown-aktuell">
	115	<a class="dropdown-item" href="https://www.hostsharing.net/blog/">Blog</a>
	116	<a class="dropdown-item" href="https://www.hostsharing.net/termine/">Termine</a>
	117	<div class="dropdown-divider"></div>
	118	<a class="dropdown-item" href="https://www.hostsharing.net/newsletter/">Newsletter</a>
	119	</div>
	120	</li>
	121	<li class="nav-item dropdown">
	122	<a class="nav-link dropdown-toggle" href="#" id="navbarDropdown-kontakt" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Kontakt</a>
	123	<div class="dropdown-menu" aria-labelledby="navbarDropdown-kontakt">
	124	<a class="dropdown-item" href="https://www.hostsharing.net/webform/contact">Kontakt</a>
	125	<div class="dropdown-divider"></div>
	126	<a class="dropdown-item" href="https://www.hostsharing.net/datenschutz-webangebot/">Datenschutz Web-Angebot</a>
	127	<a class="dropdown-item" href="https://www.hostsharing.net/datenschutz-social-media/">Datenschutz Social Media</a>
	128	<div class="dropdown-divider"></div>
	129	<a class="dropdown-item" href="https://www.hostsharing.net/impressum/">Impressum</a>
	130	</div>
	131	</li>
	132	<li class="nav-item">
	133	<a class="nav-link" href="https://www.hostsharing.net/intern/"><i class="fas fa-portrait fa-lg" aria-label="Login zum Mitgliederbereich"></i></a>
	134	</li>
	135	</ul>
	136	<form method="get" action="https://search.hostsharing.net/search" role="search" class="form-inline">
	137	<div class="input-group ml-2">
	138	<input name="q" class="form-control" type="search" placeholder="Suchen…" aria-label="Suchen">
	139	<div class="input-group-append">
	140	<button type="submit" class="btn btn-secondary">
	141	<i class="fa fa-search" aria-label="Suchen"></i>
	142	</button>
	143	</div>
	144	</div>
	145	</form>
	146	</div>
	147	</div>
	148	</nav>
	149	<main class="container">
	150	<div class="row mb-4">
	151	<div class="col-12 mt-5 mb-4">
	152	<h1 class="display-4 text-primary">Managed Operations Platform</h1>
	153	<h2 class="display-6 text-secondary">Handbuch für Anwender</h2>
747a05	154	<p class="lead mt-4 mb-1"><p>Dieses Handbuch richtet sich an Anwender,
JUH	155	welche ihre Internetprojekte bei der Hostsharing eG betreiben möchten.
	156	Es bietet einen Überblick über die Infrastruktur, eine Einführung in
	157	deren Nutzung sowie eine Beschreibung typischer
	158	Prozesse.</p> Unser Dank gilt allen, die zu diesem Handbuch beigetragen haben, insbesondere: Purodha
	159	Blissenbach, Christian Günter, Michael Hierweck, Peter Hormanns, Uwe
	160	Müller, Veit Schiele, Dominic Schlegel, Lars Trebing, Jan Ulrich
	161	Hasecke.</p>
457647	162	</div>
JUH	163	</div>
	164
	165	<div class="row">
	166	<div class="col-lg-8 order-lg-1">
747a05	167	<aside class="jumbotron shadow-sm">
JUH	168	<div class="container">
	169	<div class="row">
	170	<div class="col-4">
	171	<a href="">
	172	<img
	173	class="img-fluid"
	174	src=""
	175	alt=""
	176	title=""
	177	</a>
	178	</div>
	179	<div class="col-sm-6 col-8 align-self-end">
	180	<a
	181	class="btn btn-lg btn-success"
	182	href="benutzerhandbuch.pdf"
	183	<i class="fas fa-angle-right" aria-hidden="true">PDF herunterladen</i
	184	></a>
	185	</div>
	186	</div>
	187	</div>
	188	</aside>
457647	189	<div class="content clearfix">
747a05	190
457647	191	<section id="kap-einfuehrung" class="level1">
JUH	192	<h1>Einleitung</h1>
	193	<div class="intro">
	194	<p>Hostsharing betreibt seine Cooperative Community Cloud auf Basis
	195	einer hochverfügbaren und redundant ausgelegten Cloud Infrastructure.
	196	Auf dieser Infrastruktur baut die <a
	197	href="https://www.hostsharing.net/features/">Managed Operations
	198	Platform</a> auf, die den Betrieb von Webanwendungen durch zahlreiche
	199	Features unterstützt. Das Handbuch erklärt die Nutzung dieser
	200	Features.</p>
	201	</div>
	202	<figure>
	203	<img src="images/ccc.svg" style="width:100.0%"
	204	alt="Schematische Darstellung der Architektur und Leistungen" />
	205	<figcaption aria-hidden="true">Schematische Darstellung der
	206	Architektur und Leistungen</figcaption>
	207	</figure>
	208	<p>Die gesamte bereitgestellte Infrastruktur – von der Hardware über
	209	Netze bis zur Softwareumgebung mit ihren administrativen Tools – wird
	210	von der Hostsharing eG bereitgestellt, gewartet, aktualisiert und
	211	überwacht, sodass sich die Mitglieder auf den Betrieb ihrer
	212	indviduellen Internetangebote konzentrieren können. Das Angebot wird
	213	durch Videokonferenzdienste ergänzt und durch passende Beratungs- und
	214	Unterstützungsleistungen abgerundet.</p>
	215	<section id="web-pakete" class="level2">
	216	<h2>Web-Pakete</h2>
	217	<p>Die Mitglieder nutzen die Managed Operations Platform in Form von
	218	Web-Paketen.</p>
	219	<p>Ein Web-Paket stellt einen Verbund von Benutzerkennungen, Domains,
	220	E-Mail-Adressen, Postfächern, Datenbanken und weiteren Funktionen dar,
	221	welchem Ressourcen wie Speicherplatz und Datentransfervolumen
	222	zugeordnet sind.</p>
	223	<p>Ein Web-Paket ermöglicht die Nutzung von:</p>
	224	<ul>
	225	<li>Web-Anwendungen</li>
	226	<li>Daemons</li>
	227	<li>E-Mail-Infrastruktur</li>
	228	<li>Domains und Subdomains</li>
	229	<li>TLS-Verschlüsselung</li>
	230	<li>Datenbanken</li>
	231	<li>verschiedenen Programmiersprachen</li>
	232	</ul>
	233	<p>Web-Pakete eignen sich zum Betrieb eines oder mehrerer
	234	Internetangebote. Jedes Mitglied kann beliebig viele Web-Pakete
	235	bestellen und verwalten.</p>
	236	<p>Ein Web-Paket kann einzeln als <a
	237	href="https://www.hostsharing.net/angebote/managed-webspace/">Managed
	238	Webspace</a> gebucht werden. Auf einem <a
	239	href="https://www.hostsharing.net/angebote/managed-server/">Managed
	240	Server</a> können ein oder mehrere Web-Pakete betrieben werden.</p>
	241	</section>
	242	<section id="managed-webspace" class="level2">
	243	<h2>Managed Webspace</h2>
	244	<p><img src="images/icons/icon-managedwebspace.svg"
	245	style="width:30.0%" /></p>
	246	<p>Mit der Buchung eines Managed Webspace erhält das Mitglied ein
	247	Webpaket, welches auf einem Server untergebracht ist, dessen
	248	Ressourcen sich die Mitglieder teilen (Shared Hosting). Mitglieder
	249	können mehrere Managed Webspaces buchen und erhalten mit jeder Buchung
	250	ein weiteres Web-Paket.</p>
	251	<p>Mit der Buchung von Managed Webspace erhält das Mitglied
	252	Speicherplatz zugewiesen, ein Traffic-Kontingent und ein Kontingent
	253	von Benutzerkonten, Datenbanken und E-Mail-Adressen. Diese Ressourcen
	254	sind modular zubuchbar. CPU und RAM werden gemeinsam genutzt.</p>
	255	</section>
	256	<section id="managed-server" class="level2">
	257	<h2>Managed Server</h2>
	258	<figure>
	259	<img src="images/icons/icon-managedserver.svg" style="width:30.0%"
	260	alt="image" />
	261	<figcaption aria-hidden="true">image</figcaption>
	262	</figure>
	263	<p>Mit der Buchung eines Managed Servers erhält das Mitglied
	264	Speicherplatz, CPU und RAM dediziert zugewiesen sowie ein
	265	Traffic-Kontingent. Diese Ressourcen sind modular zubuchbar. Das
	266	Mitglied kann beliebig viele Benutzerkonten, Datenbanken und
	267	E-Mail-Adressen einrichten und sie in Form von Web-Paketen
	268	mandantenfähig gruppieren. Um einen Managed Server nutzen zu können,
	269	werden also auf diesem wenigstens ein, bei Bedarf auch mehrere
	270	Web-Pakete eingerichtet.</p>
	271	<p>Verschiedene Managed Server eines Mitglieds können auf Wunsch über
	272	interne Netze miteinander verbunden werden, um sichere Kommunikation
	273	zwischen Komponenten eines verteilten Deployments zu realisieren.</p>
	274	<p>Mehrere Mitglieder können sich einen Managed Server teilen. Ein
	275	Reselling an Endkunden ist möglich.</p>
	276	</section>
	277	<section id="best-practice" class="level2">
	278	<h2>Best Practice</h2>
	279	<p>Mitglieder von Hostsharing können den Aufbau ihrer Webanwendungen
	280	sehr frei gestalten, denn Hostsharing bietet ein hohes Maß an
	281	Flexibilität. Dennoch ist es sinnvoll, bei der Organisation seiner
	282	Webanwendungen bestimmte Verfahrensweisen zu beachten, die
	283	erfahrungsgemäß die Sicherheit erhöhen. Dazu gehört vor allem die
	284	Nutzung der Vorteile, die das Linux-Betriebssystem aufgrund seiner
	285	Mehrbenutzerfähigkeit bietet.</p>
	286	<section id="pro-anwendung-ein-benutzer" class="level3">
	287	<h3>Pro Anwendung ein Benutzer</h3>
	288	<p>Wenn auf einem Linux-Betriebssystem zwei Anwendungen (A und B)
	289	unter verschiedenen Benutzern (<code>xyz00-a</code> und
	290	<code>xyz00-b</code>) laufen, sind sie in gewisser Hinsicht
	291	gegeneinander abgeschottet. Wenn es einem Angreifer gelingt, durch
	292	eine Sicherheitslücke in Anwendung A die Benutzerrechte von
	293	<code>xyz00-a</code> zu erlangen, kann er mit diesen Rechten im
	294	Heimverzeichnis von <code>xyz00-a</code> jeden beliebigen Schaden
	295	anrichten. Im Heimverzeichnis von <code>xyz00-b</code> besitzt er
	296	jedoch keine Lese- und Schreibrechte, sodass er dort auch keine
	297	Schäden verursachen kann.</p>
	298	<p>Deshalb gilt es bei Hostsharing als Best Practice für jede Domain
	299	und jede Anwendung einen eigenen Benutzer anzulegen. Hostsharing hat
	300	verschiedene Benutzerrollen vorgesehen, die jeweils spezifische
	301	Aufgaben übernehmen. Die Rollen werden in <code
	302	class="interpreted-text" role="numref">kap-benutzerrollen</code>
	303	ausführlich erklärt.</p>
	304	</section>
	305	</section>
	306	<section id="weitere-informationsquellen" class="level2">
	307	<h2>Weitere Informationsquellen</h2>
	308	<p>Wenn Ihnen dieses Handbuch nicht weiterhilft, können Sie die
	309	folgenden Informationsquellen nutzen.</p>
	310	<dl>
	311	<dt>Das Hostsharing Wiki</dt>
	312	<dd>
	313	<p>Das <a
	314	href="https://wiki.hostsharing.net/index.php?title=Hauptseite">Hostsharing
	315	Wiki</a> wird von den Mitgliedern der Hostsharing eG gepflegt. Es
	316	enthält vor allem <a
	317	href="https://wiki.hostsharing.net/index.php?title=Kategorie:Installationsanleitungen">Installationsanleitungen</a>
	318	für die diversen Webanwendungen, die unsere Mitglieder auf der Managed
	319	Operations Platform betreiben.</p>
	320	</dd>
	321	<dt>Die Support-Mailingliste</dt>
	322	<dd>
	323	<p>Die Mitglieder der Hostsharing eG helfen sich gegenseitig auf der
	324	<a
	325	href="https://lists.hostsharing.net/mailman/listinfo/support">Support-Mailingliste</a>.
	326	Sie müssen die Mailingliste abonnieren, um Fragen zu stellen. Werfen
	327	Sie einen Blick in das Mailinglisten-Archiv, bevor Sie Ihre Frage
	328	stellen. Unter Umständen wurde sie schon beantwortet.</p>
	329	</dd>
	330	<dt>Der Hostsharing-Service</dt>
	331	<dd>
	332	<p>Falls Sie ein besonderes Problem mit Ihrem Web-Paket haben, können
	333	Sie per E-Mail den <a
	334	href="service@hostsharing.net">Hostsharing-Service</a> direkt fragen.
	335	In dringenden Fällen können Sie den Service auch telefonisch unter der
	336	Nummer +49 40 2093313-11 erreichen.</p>
	337	</dd>
	338	</dl>
	339	</section>
	340	</section>
	341	<section id="kap-hsadmin-einstieg" class="level1">
	342	<h1>Einführung in HSAdmin</h1>
	343	<p>Für einen erfolgreichen Start mit Hostsharing wird hier
	344	schrittweise gezeigt, wie ein Benutzer eine Domain mit E-Mail-Adresse
	345	und eine Datenbank in einem neuen Web-Paket angelegt wird. Die
	346	Einrichtung erfolgt mit dem Webfrontend von <code>HSAdmin</code>.
	347	Freunde der Konsole können alle Schritte mit der CLI-Variante
	348	<code>hsscript</code> erledigen.</p>
	349	<section id="rundgang-durch-hsadmin" class="level2">
	350	<h2>Rundgang durch HSAdmin</h2>
	351	<video
	352	width="786"
	353	height="590" controls
	354	<source src="https://media.hostsharing.net/Erster-Rundgang-HSAdmin.webm" type="video/webm">
	355	<source src="https://media.hostsharing.net/Erster-Rundgang-HSAdmin.mp4" type="video/webm">
	356	>
	357	Ihr Browser unterstützt keine Videos.
	358	</video>
	359	</section>
	360	<section id="kap-erstes-einloggen" class="level2">
	361	<h2>Erstes Einloggen und Änderung des Passworts</h2>
	362	<p>Wir gehen im Folgenden davon aus, dass der Service für Sie ein
	363	Web-Paket eingerichtet hat und Sie per E-Mail die Zugangsdaten
	364	bekommen haben. In der Regel wird der Service Ihnen den Benutzernamen
	365	des <code class="interpreted-text" role="role">Paket-Admin</code>
	366	zusenden. Sie erkennen dies daran, dass der Benutzername sich aus der
	367	Mitgliederkennung und einer Zahl zusammensetzt. In unserem Beispiel
	368	ist das <code>xyz00</code>.</p>
	369	<div class="hint">
	370	<p>Sie werden auf der Hostsharing-Plattform mit verschiedenen
	371	Benutzernamen arbeiten, von denen einige genau definierte Rollen auf
	372	der Plattform ausüben. Ausführlich werden die Benutzerrollen im
	373	Abschnitt <a href="#kap-benutzerrollen">Benutzerrollen</a>
	374	beschrieben.</p>
	375	</div>
	376	<section id="änderung-des-passworts" class="level3">
	377	<h3>Änderung des Passworts</h3>
	378	<p>Zunächst sollten Sie das Passwort, das Sie vom Service erhalten
	379	haben, ändern. Rufen Sie in Ihrem Browser <a
	380	href="https://admin.hostsharing.net"
	381	class="uri">https://admin.hostsharing.net</a> auf, um sich in
	382	<code>HSAdmin</code> einzuloggen (siehe Abbildung <a
	383	href="#fig-hsadmin-login-xyz00">Das Login-Fenster von
	384	HSADmin</a>).</p>
	385	<div id="fig-hsadmin-login-xyz00">
	386	<figure>
	387	<img src="images/hsadmin-login-xyz00.jpg" style="width:70.0%"
	388	alt="Das Login-Fenster von HSAdmin" />
	389	<figcaption aria-hidden="true">Das Login-Fenster von
	390	HSAdmin</figcaption>
	391	</figure>
	392	</div>
	393	<p>Loggen Sie sich mit den Zugangsdaten ein, die Sie vom Service
	394	erhalten haben.</p>
	395	<p>Nach dem Einloggen werden Sie zum Startbildschirm von HSAdmin
	396	weitergeleitet (vgl. Abb. <a href="#fig-hsadmin-start-paketadmin">Der
	397	Startbildschirm von HSAdmin nach dem Einloggen als Paket-Admin.</a>
	398	dargestellten weitergeleitet.</p>
	399	<div id="fig-hsadmin-start-paketadmin">
	400	<figure>
	401	<img src="images/hsadmin-start-paketadmin.jpg" style="width:100.0%"
	402	alt="Der Startbildschirm von HSAdmin nach dem Einloggen als Paket-Admin." />
	403	<figcaption aria-hidden="true">Der Startbildschirm von HSAdmin nach
	404	dem Einloggen als Paket-Admin.</figcaption>
	405	</figure>
	406	</div>
	407	<p>In HSAdmin gibt es zwei Bereiche zwischen denen Sie hin- und
	408	hernavigieren können:</p>
	409	<dl>
	410	<dt>Web-Paket</dt>
	411	<dd>
	412	<p>Hinter diesem Menü finden Sie alle Ihre Web-Pakete. In unserem
	413	Beispiel ist dies nur ein Web-Paket mit dem Namen <code>xyz00</code>.
	414	In diesem Menü können Sie Benutzer, Domains, Datenbanken und
	415	Datenbank-Benutzer anlegen sowie E-Mail-Aliase vergeben.</p>
	416	</dd>
	417	<dt>Domain</dt>
	418	<dd>
	419	<p>Unter diesem Menü verwalten Sie die E-Mail-Adressen in Ihren
	420	Domains. Eventuell ist hier bereits eine Beispiel-Domain
	421	eingerichtet.</p>
	422	</dd>
	423	</dl>
	424	<p>Rechts oben sehen Sie einen Link mit der Bezeichnung
	425	<code>xyz00</code>. Dies ist der Benutzername, mit dem Sie sich
	426	eingeloggt haben. Nach einem Klick auf den Link öffnet sich das
	427	Bearbeitungsmenü für den Benutzer (siehe Abb. <a
	428	href="#fig-hsadmin-pa-bearbeiten">Dialog zum Ändern des
	429	Passworts</a>).</p>
	430	<div id="fig-hsadmin-pa-bearbeiten">
	431	<figure>
	432	<img src="images/hsadmin-pa-bearbeiten.jpg" style="width:100.0%"
	433	alt="Dialog zum Ändern des Passworts" />
	434	<figcaption aria-hidden="true">Dialog zum Ändern des
	435	Passworts</figcaption>
	436	</figure>
	437	</div>
	438	<p>Geben Sie ein neues Passwort ein und bestätigen Sie die Änderung
	439	mit einem Klick auf OK.</p>
	440	<video
	441	width="786"
	442	height="590"
	443	controls
	444	<source src="https://media.hostsharing.net/Passwort-des-Paketbenutzers-aendern.webm" type="video/webm">
	445	<source src="https://media.hostsharing.net/Passwort-des-Paketbenutzers-aendern.mp4" type="video/mp4">
	446	>
	447	</video>
	448	</section>
	449	<section id="kap-einloggen-mitglied" class="level3">
	450	<h3>Einloggen mit dem Mitglieds-Account</h3>
	451	<p>Eventuell hat Ihnen der Service auch die Zugangsdaten für einen
	452	Benutzernamen mitgeteilt hat, der nur aus drei Buchstaben besteht. Es
	453	handelt sich dabei um Ihren Mitglieds-Account. Ändern Sie auch in
	454	diesem Fall sofort das Passwort, indem Sie sich mit diesem Benutzer
	455	einloggen, auf die Benutzerkennung rechts oben klicken und wie im
	456	letzten Abschnitt beschrieben ein neues Passwort eingeben.</p>
	457	<div id="fig-hsadmin-mitglied-webpaket-benutzer">
	458	<figure>
	459	<img src="images/hsadmin-mitglied-start.jpg" style="width:100.0%"
	460	alt="Der Begrüßungsbildschirm von HSAdmin, wenn Sie als Mitglied eingeloggt sind." />
	461	<figcaption aria-hidden="true">Der Begrüßungsbildschirm von HSAdmin,
	462	wenn Sie als Mitglied eingeloggt sind.</figcaption>
	463	</figure>
	464	</div>
	465	<p>Wenn Sie als Mitglied eingeloggt sind, ist das linke
	466	Navigationsmenü um einen Eintrag erweitert:</p>
	467	<dl>
	468	<dt>Kunde/Mitglied</dt>
	469	<dd>
	470	<p>In diesem Menü finden Sie Ihre Mitgliedsdaten. Sie können hier zum
	471	Beispiel Ihre Anschrift oder Kontoverbindung ändern.</p>
	472	</dd>
	473	</dl>
	474	<p>Wenn Sie als Mitglied eingeloggt sind, können Sie auch das Passwort
	475	des Paket-Admin verändern. Gehen Sie dazu in den Bereich Web-Paket,
	476	wählen Sie Ihr Web-Paket aus und gehen Sie im rechten Feld in das Menü
	477	<code>Benutzer/Postfach</code>. Wählen Sie dort den Paket-Admin
	478	<code>xyz00</code> aus.</p>
	479	<div id="fig-hsadmin-mitglied-webpaket-benutzer-auswaehlen">
	480	<figure>
	481	<img src="images/hsadmin-mitglied-webpaket-benutzer-auswaehlen.jpg"
	482	style="width:100.0%"
	483	alt="Der ausgewählte Paket-Admin ist farbig hinterlegt." />
	484	<figcaption aria-hidden="true">Der ausgewählte Paket-Admin ist farbig
	485	hinterlegt.</figcaption>
	486	</figure>
	487	</div>
	488	<p>Klicken Sie in der Symbolleiste auf das Bearbeitungssymbol. Es
	489	öffnet sich ein Menü, in dem Sie ein neues Passwort eingeben
	490	können.</p>
	491	<div id="fig-hsadmin-mitglied-webpaket-benutzer-passwort-aendern">
	492	<figure>
	493	<img
	494	src="images/hsadmin-mitglied-webpaket-benutzer-passwort-aendern.jpg"
	495	style="width:100.0%"
	496	alt="Das Menü zur Bearbeitung eines Benutzers." />
	497	<figcaption aria-hidden="true">Das Menü zur Bearbeitung eines
	498	Benutzers.</figcaption>
	499	</figure>
	500	</div>
	501	<p>Bestätigung mit dem <code>OK</code>-Button.</p>
	502	</section>
	503	</section>
	504	<section id="domain-benutzer-anlegen" class="level2">
	505	<h2>Domain-Benutzer anlegen</h2>
	506	<p>Bevor wir eine Domain aufschalten, müssen wir einen Benutzer mit
	507	der Rolle <code>Domain-Admin</code> anlegen. Rufen Sie dazu das
	508	Webfrontend von HSAdmin über den Link <a
	509	href="https://admin.hostsharing.net"
	510	class="uri">https://admin.hostsharing.net</a> auf und loggen Sie sich
	511	mit der Benutzerkennung des <code>Paket-Admin</code> ein. In unserem
	512	Beispiel ist das <code>xyz00</code>.</p>
	513	<p>Gehen Sie in den Bereich <code>Web-Paket</code> und dort in das
	514	Menü <code>Benutzer/Postfach</code>. Klicken Sie nun auf das
	515	Plus-Symbol <code>Neuen Eintrag anlegen</code>. Es öffnet sich das
	516	Menü zum Anlegen eines neuen Benutzers (siehe Abbildung <a
	517	href="#fig-domain-admin-anlegen">Das Menü zum Anlegen eines neuen
	518	Benutzers</a>).</p>
	519	<figure>
	520	<img src="images/hsadmin-da-anlegen-1.jpg" style="width:100.0%"
	521	alt="Das Menü zum Anlegen eines neuen Benutzers." />
	522	<figcaption aria-hidden="true">Das Menü zum Anlegen eines neuen
	523	Benutzers.</figcaption>
	524	</figure>
	525	<p>Die Felder für den Benutzer und das Passwort sind rot umrandet. Das
	526	zeigt an, dass Sie diese Felder bearbeiten müssen. Das Kürzel für den
	527	Paket-Admin ist bereits eingetragen. Sie müssen lediglich nach dem
	528	Bindestrich eine Bezeichnung eingeben, die Ihnen sinnvoll erscheint.
	529	Während das Kürzel am Anfang (z.B. <code>xyz00</code>) zwingend
	530	vorgegeben ist, können Sie die Bezeichnung dahinter frei wählen.
	531	Denken Sie an den Zweck des Benutzers. Er verwaltet eine oder mehrere
	532	Domains. Wenn Sie in Ihrem Web-Paket nur eine Domain verwalten wollen,
	533	können Sie den Benutzer zum Beispiel <code>xyz00-domain</code> nennen.
	534	Wenn der Benutzer mehrere Domains verwalten soll, kann sein Name zur
	535	verständlichen Kennzeichung <code>xyz00-doms</code> lauten. Und wenn
	536	Sie mehrere Domains mit unterschiedlichen Domain-Admins in einem Paket
	537	verwalten wollen, können Sie in den Namen auch die jeweilige Domain
	538	einfügen, wie zum Beispiel <code>xyz00-hs_example.de</code>. Wir
	539	empfehlen aus Sicherheitsgründen für jede Domain einen eigenen
	540	Domain-Admin anzulegen. Im Abschnitt <a
	541	href="#kap-hsscript-skript">HSADmin über Skripte steuern</a> erfahren
	542	Sie, wie Sie mit Hilfe eines Skripts die Anlage neuer Domains und
	543	neuer Domain-Admins vereinfachen können.</p>
	544	<div class="admonition">
	545	<p>Beachten Sie die Namenskonvention</p>
	546	<p>Alle Benutzernamen beginnen mit dem Kürzel für das Paket, in
	547	unserem Beispiel <code>xyz00</code>. Ergänzungen können mit einem
	548	Bindestrich abgetrennt werden wie zum Beispiel in dem Benutzernamen
	549	für den Domain-Admin <code>xyz00-doms</code>. Es ist nur ein
	550	Bindestrich zulässig. Weitere gültige Trennzeichen zur Verbesserung
	551	der Lesbarkeit sind ein Punkt und der Unterstrich. Es sind also
	552	folgende Benutzernamen für Domain-Benutzer möglich:
	553	<code>xyz00-example_de</code>, <code>xyz00-example.de</code> oder
	554	<code>xyz00-hs_example.de</code>.</p>
	555	</div>
	556	<p>Durch die Anlage eines Domain-Admins erzeugen Sie einen
	557	Unix-Benutzer mit einer eigenen Verzeichnisstruktur in Ihrem Webpaket.
	558	Die Arbeit mit verschiedenen Benutzern dient der Sicherheit. Falls
	559	durch eine Sicherheitslücke in einer Website jemand Zugang zum
	560	Verzeichnis des Domain-Admins erhält, kann er nur dort Schaden
	561	anrichten und nicht im gesamten Web-Paket, das von dem Paket-Admin
	562	verwaltet wird. Lesen Sie mehr dazu im Abschnitt <a
	563	href="#kap-benutzerrollen">Benutzerrollen</a>.</p>
	564	<p>Es ist möglich einem Domain-Admin mehrere Domains zuzuordnen. Die
	565	Ordner und Dateien für jede einzelne Domain befinden sich dann alle im
	566	Heimverzeichnis des Domain-Admins im Ordner <code>/doms</code>. Dieses
	567	Vorgehen, das der leichteren Übersicht dient, reduziert die
	568	Sicherheit, da mehrere Domains mit einem Unix-Benutzer betrieben
	569	werden. Wenn Sie unsicher sind, welches Vorgehen Sie bei der
	570	Organisation Ihrer Websites nutzen sollen, fragen Sie den Service.</p>
	571	<p>In Abb. <a href="#fig-domain-admin-ausgefuellt">Das ausgefüllte
	572	Formular zur Anlage eines Benutzers.</a> sehen Sie ein Beispiel mit
	573	dem Benutzernamen <code>xyz00-doms</code>.</p>
	574	<figure>
	575	<img src="images/hsadmin-da-anlegen-2.jpg" style="width:100.0%"
	576	alt="Das ausgefüllte Formular zur Anlage eines Benutzers." />
	577	<figcaption aria-hidden="true">Das ausgefüllte Formular zur Anlage
	578	eines Benutzers.</figcaption>
	579	</figure>
	580	<p>Bei der Anlage eines Benutzers müssen Sie folgendes
	581	berücksichtigen:</p>
	582	<dl>
	583	<dt>Benutzer/Postfach</dt>
	584	<dd>
	585	<p>Der Benutzername muss immer mit dem Kürzel des Paket-Admins
	586	beginnen. Wenn Sie als Paket-Admin in HSAdmin eingeloggt sind, ist das
	587	Kürzel schon im Formular eingetragen.</p>
	588	</dd>
	589	<dt>Passwort</dt>
	590	<dd>
	591	<p>HSAdmin erzwingt ein Passwort mit einer Mindestlänge von 6 Zeichen.
	592	Es muss aus Kleinbuchstaben, Großbuchstaben, Ziffern und Sonderzeichen
	593	bestehen, wobei Zeichen aus mindestens drei dieser Gruppen verwendet
	594	werden müssen.</p>
	595	</dd>
	596	<dt>Kurzbeschreibung</dt>
	597	<dd>
	598	<p>In der Kurzbeschreibung können Sie Informationen vermerken, die
	599	Ihnen helfen, den Benutzer zuzuordnen.</p>
	600	</dd>
	601	<dt>Shell-/Kommando-Interpreter</dt>
	602	<dd>
	603	<p>Domain-Admins benötigen eine Shell. Wählen Sie deshalb zum Beispiel
	604	<code>/bin/bash</code> aus.</p>
	605	</dd>
	606	<dt>Quota (Soft-Limit)</dt>
	607	<dd>
	608	<p>Hiermit können Sie dem Benutzer und seinen Daten ein
	609	Festplatten-Quota zuteilen. Man unterscheidet das Soft- und das
	610	Hard-Limit. Lesen Sie mehr dazu im Abschnitt <a
	611	href="#kap-quota">Speicherbelegung</a>. Wenn Sie nichts eintragen,
	612	wird kein gesondertes Quota für den Benutzer gesetzt. Lassen Sie die
	613	beiden Felder im Zweifelsfall leer.</p>
	614	</dd>
	615	<dt>Quota (Hard-Limit)</dt>
	616	<dd>
	617	<p>Das Hard-Limit des Quota.</p>
	618	</dd>
	619	</dl>
	620	<p>Bestätigen Sie die Anlage mit <code>OK</code>.</p>
	621	<p>Nach der Anlage erscheint der neue Benutzer in der Liste des Menüs
	622	<code>Benutzer/Postfach</code>.</p>
	623	<div id="fig-domain-admin-angelegt">
	624	<figure>
	625	<img src="images/hsadmin-da-anlegen-3.jpg" style="width:100.0%"
	626	alt="Der neue Domain-Admin ist angelegt." />
	627	<figcaption aria-hidden="true">Der neue Domain-Admin ist
	628	angelegt.</figcaption>
	629	</figure>
	630	</div>
	631	<div class="admonition">
	632	<p>Best Practice</p>
	633	<p>Legen Sie für jede Domain einen gesonderten Domain-Admin an. Nutzen
	634	Sie dabei zum Beispiel das Namensschema
	635	<code>xyz00-hs_example.de</code>.</p>
	636	</div>
	637	</section>
	638	<section id="domain-anlegen-und-bestellen" class="level2">
	639	<h2>Domain anlegen und bestellen</h2>
	640	<p>Eine Domain wird in zwei Schritten angelegt:</p>
	641	<ol type="1">
	642	<li>Die Domain im Web-Paket aufschalten</li>
	643	<li>Die Domain im Domainbestellsystem bestellen</li>
	644	</ol>
	645	<p>Aus technischen Gründen ist es sinnvoll, diese Reihenfolge
	646	einzuhalten. Die automatische Konnektierung einer neu bestellten
	647	Domain erfolgt nur, wenn sie in HSAdmin bereits angelegt ist.</p>
	648	<section id="kap-hsadmin-domain-anlegen" class="level3">
	649	<h3>Domain in HSAdmin anlegen</h3>
	650	<p>Melden Sie sich in HSAdmin als Paket-Admin (im Beispiel:
	651	<code>xyz00</code>) an. Wechseln Sie in den Bereich
	652	<code>Web-Paket</code>, wählen Sie Ihr Web-Paket aus und öffnen Sie
	653	das Menü <code>Domain</code>. Die Liste (siehe Abb. <a
	654	href="#fig-hsadmin-domain-anlegen-0">Das leere Menü mit den
	655	Domains</a> ist leer, da noch keine Domain angelegt wurde.</p>
	656	<div id="fig-hsadmin-domain-anlegen-0">
	657	<figure>
	658	<img src="images/hsadmin-domain-anlegen-0.jpg" style="width:100.0%"
	659	alt="Das leere Menü mit den Domains." />
	660	<figcaption aria-hidden="true">Das leere Menü mit den
	661	Domains.</figcaption>
	662	</figure>
	663	</div>
	664	<p>Klicken Sie auf das Plus-Symbol <code>Neuen Eintrag anlegen</code>.
	665	Es öffnet sich das Menü zum Aufschalten einer Domain (siehe Abb. <a
	666	href="#%60fig-hsadmin-domain-anlegen-1">Das Menü zur Aufschaltung
	667	einer Domain</a>).</p>
	668	<div id="fig-hsadmin-domain-anlegen-1">
	669	<figure>
	670	<img src="images/hsadmin-domain-anlegen-1.jpg" style="width:100.0%"
	671	alt="Das Menü zur Aufschaltung einer Domain bei Hostsharing." />
	672	<figcaption aria-hidden="true">Das Menü zur Aufschaltung einer Domain
	673	bei Hostsharing.</figcaption>
	674	</figure>
	675	</div>
	676	<p>Tragen Sie hier den Namen der Domain ein, die Sie anlegen wollen
	677	und wählen Sie den Domain-Admin aus, in dessen Benutzerverzeichnis die
	678	Verzeichnisse der Domain angelegt werden sollen.</p>
	679	<div class="attention">
	680	<p>In diesem Menü ist der Benutzer, mit dem Sie sich eingeloggt haben,
	681	vorausgewählt. Wenn dies der Paket-Admin (z.B. <code>xyz00</code>)
	682	ist, wählen Sie den gewünschten Domain-Admin aus.</p>
	683	</div>
	684	<p>Bestätigen Sie die Eingaben mit <code>OK</code>.</p>
	685	<p>Damit ist die Domain in dem Web-Paket <code>xyz00</code> technisch
	686	angelegt. Sie erscheint in der Liste im Menü <code>Domain</code>
	687	(siehe Abb. <a href="#fig-hsadmin-domain-anlegen-2">Die neu angelegte
	688	Domain erscheint in der Liste</a>).</p>
	689	<div id="fig-hsadmin-domain-anlegen-2">
	690	<figure>
	691	<img src="images/hsadmin-domain-anlegen-2.jpg" style="width:100.0%"
	692	alt="Die neu angelegte Domain erscheint in der Liste." />
	693	<figcaption aria-hidden="true">Die neu angelegte Domain erscheint in
	694	der Liste.</figcaption>
	695	</figure>
	696	</div>
	697	<p>Wenn Sie die Domain auswählen und das Editier-Symbol
	698	<code>Ausgewählten Eintrag bearbeiten</code> anklicken, können Sie die
	699	eben erstellte Domain bearbeiten (siehe Abb. <a
	700	href="#fig-hsadmin-domain-bearbeiten">Das Bearbeitungsmenü einer
	701	Domain</a>).</p>
	702	<div id="fig-hsadmin-domain-bearbeiten">
	703	<figure>
	704	<img src="images/hsadmin-domain-bearbeiten.jpg" style="width:100.0%"
	705	alt="Das Bearbeitungsmenü einer Domain." />
	706	<figcaption aria-hidden="true">Das Bearbeitungsmenü einer
	707	Domain.</figcaption>
	708	</figure>
	709	</div>
	710	<p>Das Menü zeigt den Domainnamen, den Domain-Admin, das
	711	Erstellungsdatum, die Domain-Optionen (siehe Abschnitt <a
	712	href="#kap-domain-optionen">Domain-Optionen</a> und die gültigen
	713	Subdomains (siehe Abschnitt <a
	714	href="#kap-ref-subdomains">Subdomains</a>. Ändern Sie hier zunächst
	715	nichts.</p>
	716	<p>Wenn Sie im Feld <code>gültige Subdomains</code> ein <code>*</code>
	717	als Wildcard eintragen, können Sie sehr einfach leichtgewichtige
	718	Subdomains erzeugen. Was innerhalb von HSAdmin als leichtgewichtige
	719	Subdomain bezeichnet wird, erfahren Sie im Abschnitt <a
	720	href="#kap-ref-subdomains">Subdomains</a>.</p>
	721	<video
	722	width="786"
	723	height="590"
	724	controls
	725	<source src="https://media.hostsharing.net/Domain-einrichten.webm" type="video/webm">
	726	<source src="https://media.hostsharing.net/Domain-einrichten.mp4" type="video/mp4">
	727	>
	728	</video>
	729	</section>
	730	<section id="domain-im-domainbestellsystem-bestellen" class="level3">
	731	<h3>Domain im Domainbestellsystem bestellen</h3>
	732	<p>Anschließend kann die Domain hs-example.de unter dem Link <a
	733	href="https://www.domain-bestellsystem.de"
	734	class="uri">https://www.domain-bestellsystem.de</a> bestellt werden.
	735	Die Login-Daten dafür wurden Ihnen auf einem separatem Weg
	736	mitgeteilt.</p>
	737	</section>
	738	<section id="domain-löschen" class="level3">
	739	<h3>Domain löschen</h3>
	740	<p>Beim Löschen einer Domain gehen Sie am besten folgendermaßen
	741	vor.</p>
	742	<ol type="1">
	743	<li>Die Domain im Domainbestellsystem löschen</li>
	744	<li>Die Domain in HSAdmin löschen</li>
	745	</ol>
	746	<p>Es ist die umgekehrte Reihenfolge wie bei der Bestellung einer
	747	Domain.</p>
	748	<p>Wenn Sie eine Domain an einen anderen Domainverwalter übertragen
	749	wollen, müssen Sie die Domain im Domainbestellsystem <em>in den
	750	Transfer geben</em>. Löschen Sie die Domain in HSAdmin erst, wenn die
	751	Löschung der Domain erfolgt ist beziehungsweise wenn die Domain
	752	transferiert und bei einem anderen Hoster aufgeschaltet wurde.</p>
	753	</section>
	754	</section>
	755	<section id="webspace-einrichten" class="level2">
	756	<h2>Webspace einrichten</h2>
	757	<p>Ihre Webanwendungen – im einfachsten Fall statische HTML-Seiten –
	758	richten Sie in dem Heimverzeichnis des jeweiligen Domain-Admin
	759	ein.</p>
	760	<p>Loggen Sie sich dazu mit Hilfe von <code>ssh</code> ein:</p>
	761	<pre class="console"><code>$ ssh xyz00-doms@xyz00.hostsharing.net</code></pre>
	762	<p>Sie erreichen alle Benutzerverzeichnisse über die Adresse des
	763	jeweiligen Pakets. In unserem Beispiel ist das
	764	<code>xyz00.hostsharing.net</code>. Nach dem Einloggen finden Sie die
	765	im nächsten Abschnitt beschriebene Ordnerstruktur vor.</p>
	766	<section id="kap-einstieg-ordnerstruktur" class="level3">
	767	<h3>Ordnerstruktur</h3>
	768	<p>Die exemplarische Struktur des Home-Verzeichnisses eines
	769	Domain-Admins sieht folgendermaßen aus:</p>
	770	<pre><code>├── doms
	771	│ ├── hs-example.de
	772	│ │ ├── app
	773	│ │ ├── app-ssl
	774	│ │ ├── cgi
	775	│ │ ├── cgi-ssl
	776	│ │ ├── etc
	777	│ │ │ └── pri.hs-example.de
	778	│ │ ├── fastcgi
	779	│ │ │ └── phpstub
	780	│ │ ├── fastcgi-ssl
	781	│ │ │ └── phpstub
	782	│ │ ├── htdocs
	783	│ │ │ └── .htaccess
	784	│ │ ├── htdocs-ssl
	785	│ │ │ └── .htaccess
	786	│ │ ├── subs
	787	│ │ │ ├── www
	788	│ │ │ │ └── index.html
	789	│ │ │ └── example
	790	│ │ ├── subs-ssl
	791	│ │ │ └── www
	792	│ │ │ └── index.html
	793	│ │ └── var
	794	│ └── domain2.tld
	795	│ ├── app
	796	│ └── …
	797	├── etc
	798	│ └── config.ini
	799	└── Maildir</code></pre>
	800	<dl>
	801	<dt><code>~/doms</code></dt>
	802	<dd>
	803	<p>Alle dem Domain-Admin zugewiesenen Domains liegen im Verzeichnis
	804	<code>~/doms</code>.</p>
	805	</dd>
	806	<dt><code>~/doms/hs-example.de</code></dt>
	807	<dd>
	808	<p><code>hs-example.de</code> die Beispiel-Domain, für die die
	809	Verzeichnisse von HSAdmin automatisch angelegt wurden.</p>
	810	</dd>
	811	<dt><code>~/doms/hs-example.de/app</code></dt>
	812	<dd>
	813	<p>Dieses Verzeichnis ist als <code>PassengerAppRoot</code> des
	814	Apache-Webserver-Moduls <a
	815	href="https://www.phusionpassenger.com/">Phusion Passenger</a>
	816	konfiguriert.</p>
	817	</dd>
	818	<dt><code>~/doms/hs-example.de/app-ssl</code></dt>
	819	<dd>
	820	<p>Auch dieses Verzeichnis ist als <code>PassengerAppRoot</code> des
	821	Apache-Webserver-Moduls konfiguriert. Es wird für https-Zugriffe
	822	genutzt.</p>
	823	</dd>
	824	<dt><code>~/doms/hs-example.de/cgi</code></dt>
	825	<dd>
	826	<p>Dies ist das Basisverzeichnis für CGI-Skripte. Ein Alias bildet
	827	HTTP-Requests auf <code>http://hs-example.de/cgi-bin/</code> auf
	828	dieses Verzeichnisses ab.</p>
	829	</dd>
	830	<dt><code>~/doms/hs-example.de/cgi-ssl</code></dt>
	831	<dd>
	832	<p>Analog zu <code>~/doms/hs-example.de/cgi</code> ist dies das
	833	Basisverzeichnis für CGI-Skripte beim Zugriff via https.</p>
	834	</dd>
	835	<dt><code>~/doms/hs-example.de/etc</code></dt>
	836	<dd>
	837	<p>Dieses Verzeichnis enthält ggf. das Zonefile, mit dem sich der
	838	Nameserver <a href="http://de.wikipedia.org/wiki/BIND">BIND</a>
	839	konfigurieren lässt</p>
	840	</dd>
	841	<dt><code>~/doms/hs-example.de/etc/pri.hs-example.de</code></dt>
	842	<dd>
	843	<p>Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst
	844	verwalten. Damit können zum Beispiel einzelne Subdomains auf andere
	845	Server umgeleitet oder eigene Mailserver angesprochen werden.</p>
	846	</dd>
	847	<dt><code>~/doms/hs-example.de/fastcgi</code></dt>
	848	<dd>
	849	<p>Dies ist das Basisverzeichnis für FastCGI-Skripte. Ein Alias bildet
	850	HTTP-Requests auf <code>http://hs-example.de/fastcgi-bin/</code> auf
	851	dieses Verzeichnis ab.</p>
	852	</dd>
	853	<dt><code>~/doms/hs-example.de/fastcgi-ssl</code></dt>
	854	<dd>
	855	<p>Analog zu <code>~/doms/hs-example.de/fastcgi</code> ist dies das
	856	Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen. Ein Alias
	857	bildet HTTP-Requests auf
	858	<code>https://hs-example.de/fastcgi-bin/</code> auf dieses Verzeichnis
	859	ab.</p>
	860	</dd>
	861	<dt><code>~/doms/hs-example.de/htdocs</code></dt>
	862	<dd>
	863	<p>Dieses Verzeichnis ist als <code>DocumentRoot</code> des Apache
	864	Webserver konfiguriert. Es dient auch zur Aufnahme statischer Inhalte
	865	im Zusammenhang mit der Nutzung von Phusion Passenger zur Auslieferung
	866	der statischen Dateien.</p>
	867	</dd>
	868	<dt><code>~/doms/hs-example.de/htdocs/.htaccess</code></dt>
	869	<dd>
	870	<p>In der Standardkonfiguration enthält diese Datei die Weiterleitung
	871	auf die <code>www</code>-Subdomain:</p>
	872	<pre><code>Redirect permanent / http://www.hs-example.de/</code></pre>
	873	<p>Die verwendeten Regeln werden auf <strong>alle</strong> Subdomains
	874	von <code>hs-example.de</code> angewendet. In der
	875	<code>.htaccess</code> können</p>
	876	<ul>
	877	<li>eigene Fehlerseiten definiert,</li>
	878	<li>MIME-Typen zugewiesen,</li>
	879	<li>Passwortschutz eingerichtet,</li>
	880	<li>Weiterleitungen durchgeführt werden.</li>
	881	</ul>
	882	</dd>
	883	<dt><code>~/doms/hs-example.de/htdocs-ssl</code></dt>
	884	<dd>
	885	<p>Analog zu <code>~/doms/hs-example.de/htdocs</code> ist dieses
	886	Verzeichnis als <code>DocumentRoot</code> des Apache Webserver für
	887	Zugriffe via https konfiguriert.</p>
	888	</dd>
	889	<dt><code>~/doms/hs-example.de/subs</code></dt>
	890	<dd>
	891	<p>Dieses Verzeichnis enthält alle Subdomains. Hier findet sich auch
	892	die Subdomain <em>www.hs-example.de</em>.</p>
	893	</dd>
	894	<dt><code>~/doms/hs-example.de/subs/example</code></dt>
	895	<dd>
	896	<p>Dies ist ein Beispiel für eine Subdomain, die Sie einfach selbst
	897	anlegen können. Sie müssen hierzu nur im Verzeichnis <code>subs</code>
	898	ein Verzeichnis mit dem Namen der gewünschten Subdomain anlegen und
	899	anschließend die Dateien in das Verzeichnis übertragen.</p>
	900	</dd>
	901	<dt><code>~/doms/hs-example.de/subs/www</code></dt>
	902	<dd>
	903	<p>Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom
	904	Webserver angesprochen, wenn keine Subdomain explizit genannt wird.
	905	Die Adresse <code>http://hs-example.de</code> verweist üblicherweise
	906	auf <code>http://www.hs-example.de</code>.</p>
	907	</dd>
	908	<dt><code>~/doms/hs-example.de/subs-ssl</code></dt>
	909	<dd>
	910	<p>Analog zu <code>~/doms/hs-example.de/subs</code> enthält dieses
	911	Verzeichnis alle Subdomains auf die via https zugegriffen wird.</p>
	912	</dd>
	913	<dt><code>~/doms/hs-example.de/var</code></dt>
	914	<dd>
	915	<p>In diesem Verzeichnis werden in der Nacht die Log-Dateien mit den
	916	Zugriffen auf die Domain in gepackter Form bereitgestellt, wenn dies
	917	in <code>/home/pacs/xyz00/etc/config.ini</code> entsprechend angegeben
	918	ist.</p>
	919	</dd>
	920	</dl>
	921	</section>
	922	<section id="zugangsdaten-und-einstellungen" class="level3">
	923	<h3>Zugangsdaten und Einstellungen</h3>
	924	<!-- todo Das ist altbacken. Kommandozeile erklären -->
	925	<p>Sie können Dateien mit einem FTP-Programm wie
	926	<code>FileZilla</code>, <code>WinSCP</code> oder <code>scp</code> in
	927	das Web-Paket kopieren. Sie benötigen dazu die gleichen Zugangsdaten
	928	wie beim Einloggen via <code>ssh</code>.</p>
	929	<dl>
	930	<dt>Server:</dt>
	931	<dd>
	932	<p>xyz00.hostsharing.net</p>
	933	</dd>
	934	<dt>Benutzer:</dt>
	935	<dd>
	936	<p>xyz00-doms</p>
	937	</dd>
	938	<dt>Passwort:</dt>
	939	<dd>
	940	<p>PASSWORT</p>
	941	</dd>
	942	</dl>
	943	<figure>
	944	<img src="images/ftp-filezilla.jpg" style="width:70.0%"
	945	alt="Eingabe der Zugangsdaten in Filezilla." />
	946	<figcaption aria-hidden="true">Eingabe der Zugangsdaten in
	947	Filezilla.</figcaption>
	948	</figure>
	949	<p>Wechseln Sie in den Ordner
	950	<code>~/doms/hs-example.de/subs/www</code>, um zum Beispiel statische
	951	Webseiten hochzuladen.</p>
	952	<figure>
	953	<img src="images/ftp-filezilla-www.jpg" style="width:70.0%"
	954	alt="Wechsel in das Verzeichnis www." />
	955	<figcaption aria-hidden="true">Wechsel in das Verzeichnis
	956	<code>www</code>.</figcaption>
	957	</figure>
	958	<p>Auf der Kommandozeile geben Sie folgende Befehle ein:</p>
	959	<pre class="console"><code>$ cd ~/website-dateien
	960	$ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/hs-example.de/subs-ssl/www</code></pre>
	961	<p>Die Dateien in dem lokalen Ordner <code>website-dateien</code>
	962	werden dadurch rekursiv in das Verzeichnis
	963	<code>~/doms/hs-example.de/subs-ssl/www</code> des Domain-Admin
	964	kopiert.</p>
	965	</section>
	966	</section>
	967	<section id="kap-ssh-key-hochladen" class="level2">
	968	<h2>Hochladen des SSH-Keys</h2>
	969	<p>Sie können sich ohne Eingabe eines Passworts als Domain-Admin
	970	einloggen, wenn Sie Ihren öffentlichen SSH-Key in das
	971	Benutzerverzeichnis des Domain-Admins hochladen.</p>
	972	<p>Wenn Sie noch keinen SSH-Key haben, können Sie ihn unter Mac OS X
	973	und Linux mit diesem Befehl in Ihrem Heimverzeichnis erzeugen:</p>
	974	<pre class="console"><code>$ ssh-keygen -b 4096 </code></pre>
	975	<p>Der Befehl gibt eine Reihe von Meldungen aus. So werden Sie
	976	beispielsweise aufgefordert eine Passphrase einzugeben. Dies ist das
	977	Passwort, mit dem Sie Ihren SSH-Schlüssel beim Einsatz entsperren.
	978	Wählen Sie eine Phrase, die Sie sich gut merken können, da Sie sie
	979	häufig benötigen werden. Zur Sicherheit müssen Sie die Passphrase
	980	zweimal eingeben. Anschließend informiert Sie das Programm, dass Ihr
	981	geheimer Schlüssel in der Datei <code>~/.ssh/id_rsa</code> und ihr
	982	öffentlicher Schlüssel in der Datei <code>~/.ssh/id_rsa.pub</code>
	983	gespeichert wurden.</p>
	984	<p>Nach der Erzeugung des Schlüssels können Sie sich das neue
	985	Verzeichnis anschauen.</p>
	986	<pre class="console"><code>$ ls .ssh/
	987	id_rsa id_rsa.pub </code></pre>
	988	<p>Nun können Sie Ihren öffentlichen Schlüssel in das Heimverzeichnis
	989	des Domain-Admin kopieren. Unter Linux und anderen Unix-Systemen geht
	990	dies mit dem Befehl <code>ssh-copy-id</code>:</p>
	991	<pre class="console"><code>$ ssh-copy-id -i ~/.ssh/id_rsa.pub xyz00-doms@xyz00.hostsharing.net</code></pre>
	992	<p>Um unter Windows einen SSH-Key zu erzeugen und hochzuladen, können
	993	Sie das Programm <a href="https://www.putty.org/">PuTTY</a>
	994	nutzen.</p>
	995	</section>
	996	<section id="e-mail-einrichten" class="level2">
	997	<h2>E-Mail einrichten</h2>
	998	<p>In diesem Kapitel werden zwei E-Mail-Adressen für eine neue Domain
	999	angelegt:</p>
	1000	<ul>
	1001	<li>Die erste E-Mail-Adresse wird einem Postfach im Webpaket
	1002	zugeordnet</li>
	1003	<li>Die zweite E-Mail-Adresse wird einer externen E-Mail-Adresse
	1004	zugeordnet.</li>
	1005	</ul>
	1006	<section id="kap-postfach-anlegen" class="level3">
	1007	<h3>E-Mail-Adresse für Postfach im Webpaket</h3>
	1008	<p>Wir werden zunächst ein neues Postfach für Peter Mustermann anlegen
	1009	und dieses Postfach danach einer neu eingerichteten E-Mail-Adresse
	1010	zuordnen.</p>
	1011	<section id="neuen-e-mail-benutzer-anlegen" class="level4">
	1012	<h4>Neuen E-Mail-Benutzer anlegen</h4>
	1013	<p>Melden Sie sich als Paket-Admin (in unserem Beispiel
	1014	<code>xyz00</code>) bei HSAdmin an. Klicken Sie auf das Webpaket, in
	1015	dem Sie einen neuen E-Mail-Benutzer anlegen möchten, in unserem
	1016	Beispiel ist das <code>xyz00</code>, und gehen Sie dann in den Bereich
	1017	<code>Benutzer/Postfach</code>. Klicken Sie auf das Plussymbol für
	1018	<code>Neuen Eintrag anlegen</code>.</p>
	1019	<p>Tragen Sie anschließend die Zugangsdaten des neuen E-Mail-Benutzers
	1020	ein. In Abb. <a href="#fig-hsadmin-pa-postfach-anlegen">Die Angaben
	1021	für ein neues Postfach</a> lautet der Benutzernamen
	1022	<code>xyz00-mail_pm</code>.</p>
	1023	<div id="fig-hsadmin-pa-postfach-anlegen">
	1024	<figure>
	1025	<img src="images/hsadmin-pa-postfach-anlegen.jpg" style="width:100.0%"
	1026	alt="Die Angaben für ein neues Postfach." />
	1027	<figcaption aria-hidden="true">Die Angaben für ein neues
	1028	Postfach.</figcaption>
	1029	</figure>
	1030	</div>
	1031	<p>E-Mail-Benutzer bekommen keine Shell zugeordnet. Stattdessen wird
	1032	beim Einloggen das Programm <code>/usr/bin/passwd</code> gestartet.
	1033	Speichern Sie den neuen Eintrag mit <code>OK</code>. Das neue Konto
	1034	erscheint nun in der Liste der Benutzer.</p>
	1035	<div id="fig-hsadmin-pa-postfach-angelegt">
	1036	<figure>
	1037	<img src="images/hsadmin-pa-postfach-angelegt.jpg"
	1038	style="width:100.0%"
	1039	alt="Das Postfach für Peter Mustermann erscheint in der Liste." />
	1040	<figcaption aria-hidden="true">Das Postfach für Peter Mustermann
	1041	erscheint in der Liste.</figcaption>
	1042	</figure>
	1043	</div>
	1044	</section>
	1045	<section id="neues-postfach-einer-neuen-e-mail-adresse-zuordnen"
	1046	class="level4">
	1047	<h4>Neues Postfach einer neuen E-Mail-Adresse zuordnen</h4>
	1048	<p>Wir werden nun für Peter Mustermann eine neue E-Mail-Adresse
	1049	anlegen und das neue Postfach dieser Adresse zuordnen.</p>
	1050	<p>Melden Sie sich als Paket-Admin (in unserem Beispiel
	1051	<code>xyz00</code>) bei HSAdmin an. Gehen Sie nach dem Einloggen in
	1052	den Bereich <code>Domain</code>, in dem Ihre Domains aufgeführt
	1053	sind.</p>
	1054	<p>Wählen Sie die Domain aus, für die Sie eine E-Mail-Adresse
	1055	einrichten wollen. Im Hauptfenster werden die wesentlichen
	1056	Informationen zur ausgewählten Domain angezeigt (siehe Abb. <a
	1057	href="#fig-hsadmin-pa-domain-info">Die Informationen zur
	1058	Domain</a>).</p>
	1059	<div id="fig-hsadmin-pa-domain-info">
	1060	<figure>
	1061	<img src="images/hsadmin-pa-domain-info.jpg" style="width:100.0%"
	1062	alt="Die Informationen zur Domain werden angezeigt" />
	1063	<figcaption aria-hidden="true">Die Informationen zur Domain werden
	1064	angezeigt</figcaption>
	1065	</figure>
	1066	</div>
	1067	<p>Klicken Sie auf das Menü <code>E-Mail-Adresse</code>, damit die
	1068	E-Mail-Adressen angezeigt werden, die bereits für die Domain
	1069	eingerichtet wurden (siehe Abb. <a
	1070	href="#fig-hsadmin-pa-domain-emails">Bereits angelegte
	1071	E-Mail-Adressen</a>).</p>
	1072	<div id="fig-hsadmin-pa-domain-emails">
	1073	<figure>
	1074	<img src="images/hsadmin-pa-domain-emails.jpg" style="width:100.0%"
	1075	alt="Die bereits angelegten E-Mail-Adressen." />
	1076	<figcaption aria-hidden="true">Die bereits angelegten
	1077	E-Mail-Adressen.</figcaption>
	1078	</figure>
	1079	</div>
	1080	<p>Drei E-Mail-Adressen werden automatisch angelegt, wenn Sie eine
	1081	Domain eingerichtet haben:</p>
	1082	<dl>
	1083	<dt>abuse</dt>
	1084	<dd>
	1085	<p>Das ist die Adresse, an die Meldungen bei missbräuchlicher
	1086	Verwendung der Domain versendet werden. Die vollständige Adresse
	1087	lautet in unserem Beispiel <a href="mailto:abuse@hs-example.de"
	1088	class="email">abuse@hs-example.de</a></p>
	1089	</dd>
	1090	<dt>postmaster</dt>
	1091	<dd>
	1092	<p>Das ist die Adresse derjenigen Person, die für die
	1093	E-Mail-Postfächer und das E-Mail-System der Domain verantwortlich
	1094	ist.</p>
	1095	</dd>
	1096	<dt>webmaster</dt>
	1097	<dd>
	1098	<p>Das ist die Adresse des Webmasters, der für die Webauftritte unter
	1099	der Domain technisch verantwortlich ist.</p>
	1100	</dd>
	1101	</dl>
	1102	<p>Alle E-Mails an diese Adressen werden in der Voreinstellung an das
	1103	Postfach des zuständigen Domain-Admin ausgeliefert.</p>
	1104	<p>Klicken Sie nun auf das <code>+</code>-Symbol, damit sich das Menü
	1105	zum Anlegen einer neuen E-Mail-Adresse öffnet.</p>
	1106	<div id="fig-hsadmin-email-postfach-anlegen">
	1107	<figure>
	1108	<img src="images/hsadmin-email-postfach-anlegen-1.jpg"
	1109	style="width:100.0%"
	1110	alt="Anlegen einer E-Mail-Adresse mit Postfach" />
	1111	<figcaption aria-hidden="true">Anlegen einer E-Mail-Adresse mit
	1112	Postfach</figcaption>
	1113	</figure>
	1114	</div>
	1115	<p>Die Felder im Einzelnen:</p>
	1116	<dl>
	1117	<dt>lokaler Teil</dt>
	1118	<dd>
	1119	<p>der Teil der E-Mail-Adresse vor dem @-Zeichen, in unserem Beispiel
	1120	<code>pm</code>.</p>
	1121	</dd>
	1122	<dt>Subdomain</dt>
	1123	<dd>
	1124	<p>bleibt hier leer, da eine E-Mail-Adresse für die Hauptdomain
	1125	angelegt wird.</p>
	1126	</dd>
	1127	<dt>Domain</dt>
	1128	<dd>
	1129	<p>Hier erscheint die Domain, für die die Adresse eingerichtet wird.
	1130	In unserem Fall: hs-example.de</p>
	1131	</dd>
	1132	<dt>Postfach/Weiterleitung</dt>
	1133	<dd>
	1134	<p>In den Auswahlmenüs können Sie E-Mail-Adresse oder Postfach
	1135	auswählen. Im Beispiel leiten wir die E-Mails an das Postfach des
	1136	Domain-Admin <code>xyz00-mail_pm</code></p>
	1137	</dd>
	1138	</dl>
	1139	<p>Bestätigen mit dem Button <code>OK</code>.</p>
	1140	<p>Die neue E-Mail-Adresse wird nun in der Liste aufgeführt.</p>
	1141	<div id="fig-hsadmin-email-postfach-angelegt">
	1142	<figure>
	1143	<img src="images/hsadmin-email-postfach-angelegt.jpg"
	1144	style="width:100.0%"
	1145	alt="Die neue E-Mail-Adresse ist angelegt und erscheint in der Liste" />
	1146	<figcaption aria-hidden="true">Die neue E-Mail-Adresse ist angelegt
	1147	und erscheint in der Liste</figcaption>
	1148	</figure>
	1149	</div>
	1150	<p>Peter Mustermann ist nun unter der Adresse
	1151	<code>pm@hs-example.de</code> erreichbar und kann die Mails mit seinem
	1152	neuen E-Mail-Konto abrufen.</p>
	1153	<p>In Abschnitt <a href="#kap-emails-lesen">E-Mails senden und
	1154	empfangen</a> wird beschrieben, wie Peter Mustermann seine Mails über
	1155	ein Webinterface oder mit Hilfe eines E-Mail-Programms lesen kann.</p>
	1156	<video
	1157	width="786"
	1158	height="590"
	1159	controls
	1160	<source src="https://media.hostsharing.net/E-Mail-Adresse-und-Postfach-einrichten.webm" type="video/webm">
	1161	<source src="https://media.hostsharing.net/E-Mail-Adresse-und-Postfach-einrichten.mp4" type="video/mp4">
	1162	>
	1163	</video>
	1164	</section>
	1165	</section>
	1166	<section id="e-mail-adresse-mit-weiterleitung-an-externe-mail-adresse"
	1167	class="level3">
	1168	<h3>E-Mail-Adresse mit Weiterleitung an externe Mail-Adresse</h3>
	1169	<p>Um eine weitere E-Mail-Adresse anzulegen die E-Mails an eine
	1170	<em>externe</em> E-Mail-Adresse leitet, wird in der Eingabemaske bei:
	1171	Postfach/Weiterleitung: <em>E-Mail-Adresse</em> ausgewählt und
	1172	dahinter dann die externe Mail-Adresse, hier <a
	1173	href="mailto:peter@mustermann.de"
	1174	class="email">peter@mustermann.de</a>, eingetragen.</p>
	1175	<div id="fig-hsadmin-email-weiterleitung-1">
	1176	<figure>
	1177	<img src="images/hsadmin-email-weiterleitung-anlegen.jpg"
	1178	style="width:100.0%"
	1179	alt="Eingehende E-Mails sollen an eine externe E-Mail-Adresse weitergeleitet werden." />
	1180	<figcaption aria-hidden="true">Eingehende E-Mails sollen an eine
	1181	externe E-Mail-Adresse weitergeleitet werden.</figcaption>
	1182	</figure>
	1183	</div>
	1184	<p>Liste der angelegten E-Mail-Adressen:</p>
	1185	<div id="fig-hsadmin-email-weiterleitung-2">
	1186	<figure>
	1187	<img src="images/hsadmin-email-weiterleitung-angelegt.jpg"
	1188	style="width:100.0%"
	1189	alt="Auch die zweite neue E-Mail-Adresse erscheint in der Liste" />
	1190	<figcaption aria-hidden="true">Auch die zweite neue E-Mail-Adresse
	1191	erscheint in der Liste</figcaption>
	1192	</figure>
	1193	</div>
	1194	<!--
	1195	MOS: Die erste E-Mail-Adresse <pm@hs-example.de> steht beim Screenshot
	1196	nicht mehr in der Liste (sondern <info@hs-example.de>)
	1197	-->
	1198	</section>
	1199	<section id="kap-email-alias" class="level3">
	1200	<h3>E-Mail-Alias einrichten</h3>
	1201	<p>Wenn Sie mehrere Domains mit jeweils einem Domain-Admin verwalten,
	1202	so landen E-Mails an die zwingend vorgegebenen Systemempfänger
	1203	<code>abuse@</code>, <code>postmaster@</code> und
	1204	<code>webmaster@</code> in der Voreinstellung im Postfach des
	1205	jeweiligen Domain-Admin. All diese Postfächer regelmäßig zu
	1206	kontrollieren, ist aufwändig. Deshalb gibt es bei Hostsharing die
	1207	Möglichkeit E-Mail-Aliase einzurichten. Da ein E-Mail-Alias bei der
	1208	Mailzustellung bevorzugt behandelt wird, können Sie unter dem Namen
	1209	der Domain-Admins ein E-Mail-Alias einrichten und zum Beispiel an das
	1210	Postfach des Paket-Admins weiterleiten oder die E-Mail-Adresse des
	1211	Verantwortlichen.</p>
	1212	<p>Rufen Sie dazu HSAdmin unter
	1213	<code>https://admin.hostsharing.net</code> auf und gehen Sie in den
	1214	Bereich <code>Web-Paket</code>. Wählen Sie das entsprechende Web-Paket
	1215	aus und öffnen Sie den Reiter <code>E-Mail-Alias</code> (siehe Abb. <a
	1216	href="#fig-hsadmin-email-alias-1">Der Reiter E-Mail-Alias in
	1217	HSAdmin</a>).</p>
	1218	<div id="fig-hsadmin-email-alias-1">
	1219	<figure>
	1220	<img src="images/hsadmin-email-alias-1.jpg" style="width:100.0%"
	1221	alt="Der Reiter E-Mail-Alias in HSAdmin" />
	1222	<figcaption aria-hidden="true">Der Reiter E-Mail-Alias in
	1223	HSAdmin</figcaption>
	1224	</figure>
	1225	</div>
	1226	<p>Klicken Sie auf das Pluszeichen, um ein neues E-Mail-Alias
	1227	hinzuzufügen. Es öffnet sich das in Abb. <a
	1228	href="#fig-hsadmin-email-alias-2">Das Formular zum Hinzufügen eines
	1229	neuen Alias</a> gezeigte Formular. Das Kürzel für das Web-Paket ist
	1230	bereits in das Formularfeld eingetragen.</p>
	1231	<div id="fig-hsadmin-email-alias-2">
	1232	<figure>
	1233	<img src="images/hsadmin-email-alias-2.jpg" style="width:100.0%"
	1234	alt="Das Formular zum Hinzufügen eines neuen Alias. Das Paketkürzel ist bereits eingetragen." />
	1235	<figcaption aria-hidden="true">Das Formular zum Hinzufügen eines neuen
	1236	Alias. Das Paketkürzel ist bereits eingetragen.</figcaption>
	1237	</figure>
	1238	</div>
	1239	<p>Sie können eine E-Mail-Adresse angeben (siehe Abb. <a
	1240	href="#fig-hsadmin-email-alias-3">Umleitung an eine
	1241	E-Mail-Adresse</a>).</p>
	1242	<div id="fig-hsadmin-email-alias-3">
	1243	<figure>
	1244	<img src="images/hsadmin-email-alias-3.jpg" style="width:100.0%"
	1245	alt="Umleitung an eine E-Mail-Adresse" />
	1246	<figcaption aria-hidden="true">Umleitung an eine
	1247	E-Mail-Adresse</figcaption>
	1248	</figure>
	1249	</div>
	1250	<p>Sie können aber auch das Postfach eines anderen Benutzers
	1251	eintragen; in Abb. <a href="#fig-hsadmin-email-alias-4">Umleitung an
	1252	ein Postfach</a> beispielsweise das Postfach des Paket-Admins. Das
	1253	Formularfeld bietet Ihnen alle verfügbaren Postfächer zur Auswahl
	1254	an.</p>
	1255	<div id="fig-hsadmin-email-alias-4">
	1256	<figure>
	1257	<img src="images/hsadmin-email-alias-4.jpg" style="width:100.0%"
	1258	alt="Umleitung an ein Postfach" />
	1259	<figcaption aria-hidden="true">Umleitung an ein Postfach</figcaption>
	1260	</figure>
	1261	</div>
	1262	<p>Und zu guter Letzt können Sie auch an ein anderes E-Mail-Alias
	1263	umleiten. Bestätigen Sie Ihre Eingabe mit <code>OK</code>. Das neue
	1264	Alias erscheint anschließend in der Liste (siehe Abb. <a
	1265	href="#fig-hsadmin-email-alias-5">Die Alias-Liste</a>).</p>
	1266	<div id="fig-hsadmin-email-alias-5">
	1267	<figure>
	1268	<img src="images/hsadmin-email-alias-5.jpg" style="width:100.0%"
	1269	alt="Die Alias-Liste" />
	1270	<figcaption aria-hidden="true">Die Alias-Liste</figcaption>
	1271	</figure>
	1272	</div>
	1273	<p>Gehen Sie beim Anlegen von E-Mail-Aliases systematisch vor, damit
	1274	Sie in komplexen Situationen nicht den Überblick verlieren. Leiten Sie
	1275	E-Mails an Domain-Admins beispielsweise immer an den Paket-Admin
	1276	weiter oder an denjenigen, der für die Domain verantwortlich ist. Das
	1277	System ist sehr flexibel, sodass Sie die Verantwortlichkeiten gut
	1278	abbilden können und auch für spezielle Wünsche Ihrer Benutzer immer
	1279	eine gute Lösung finden.</p>
	1280	<div class="admonition">
	1281	<p>Nutzen Sie E-Mail-Aliases möglichst nicht, um E-Mails, die an eine
	1282	Funktionsadresse wie <code>sekretariat@</code> oder
	1283	<code>vertriebsteam@</code> geht, an einzelne Benutzer weiterzuleiten.
	1284	In diesem Fall ist es übersichtlicher, wenn Sie bei der Einrichtung
	1285	der E-Mail-Adresse gleich mehrere Postfächer als Ziel angeben.
	1286	Alternativ können Sie auch einen Benutzer einrichten (zum Beispiel für
	1287	das Sekretariat <code>xyz00-sek</code>) und im Heimverzeichnis des
	1288	Benutzers eine <code>.forward</code>-Datei pflegen, die die
	1289	E-Mail-Adresse aller Empfänger enthält.</p>
	1290	</div>
	1291	</section>
	1292	</section>
	1293	<section id="datenbank-einrichten" class="level2">
	1294	<h2>Datenbank einrichten</h2>
	1295	<p>Wenn Sie für eine Webanwendung eine MySQL- oder
	1296	PostgreSQL-Datenbank benötigen, können Sie die Datenbank und den
	1297	Datenbanknutzer in <code>HSAdmin</code> anlegen.</p>
	1298	<div class="hint">
	1299	<p>Aus Lizenzgründen pflegt Hostsharing die von MySQL abgespaltene
	1300	Open-Source-Datenbank MariaDB. Das Benutzer-Interface von HSAdmin
	1301	spricht noch von MySQL. Der Einfachheit halber sprechen wir in dieser
	1302	Anleitung deshalb noch von MySQL.</p>
	1303	</div>
	1304	<p>Beim Anlegen einer Datenbank ist die Reihenfolge entscheidend:</p>
	1305	<ol type="1">
	1306	<li>Zunächst den Datenbanknutzer anlegen, den Verwalter der jeweiligen
	1307	Datenbank</li>
	1308	<li>die Datenbank anlegen.</li>
	1309	</ol>
	1310	<video
	1311	width="640"
	1312	height="480"
	1313	controls
	1314	<source src="https://media.hostsharing.net/Datenbank-anlegen.webm" type="video/webm">
	1315	<source src="https://media.hostsharing.net/Datenbank-anlegen.mp4" type="video/mp4">
	1316	>
	1317	</video>
	1318	<section id="datenbanknutzer-anlegen" class="level4">
	1319	<h4>Datenbanknutzer anlegen</h4>
	1320	<p>Melden Sie sich mit dem Paket-Admin (<code>xyz00</code>) bei
	1321	HSAdmin unter <a href="https://admin.hostsharing.net"
	1322	class="uri">https://admin.hostsharing.net</a> an und gehen Sie in den
	1323	Bereich <code>Web-Paket</code>.</p>
	1324	<p>Klicken Sie das Menü <code>MySQL-Benutzer</code> an. Es wird die
	1325	Liste der MySQL-Benutzer angezeigt (siehe Abb. <a
	1326	href="#fig-hsadmin-mysql-benutzer">Das Menü MySQL-Benutzer</a>). Es
	1327	ist leer.</p>
	1328	<div id="fig-hsadmin-mysql-benutzer">
	1329	<figure>
	1330	<img src="images/hsadmin-mysql-benutzer.jpg" style="width:100.0%"
	1331	alt="Das Menü MySQL-Benutzer mit der leeren Liste der Datenbanknutzer." />
	1332	<figcaption aria-hidden="true">Das Menü <code>MySQL-Benutzer</code>
	1333	mit der leeren Liste der Datenbanknutzer.</figcaption>
	1334	</figure>
	1335	</div>
	1336	<p>Klicken Sie auf das Plus-Icon <code>Neuen Eintrag anlegen</code>.
	1337	Es erscheint folgende Eingabemaske:</p>
	1338	<div id="fig-hsadmin-mysql-benutzer-anlegen">
	1339	<figure>
	1340	<img src="images/hsadmin-mysql-benutzer-anlegen.jpg"
	1341	style="width:100.0%"
	1342	alt="Das Menü zum Anlegen eines Datenbanknutzers." />
	1343	<figcaption aria-hidden="true">Das Menü zum Anlegen eines
	1344	Datenbanknutzers.</figcaption>
	1345	</figure>
	1346	</div>
	1347	<p>Die Felder werden wie folgt ausgefüllt:</p>
	1348	<dl>
	1349	<dt>MySQL-Benutzer:</dt>
	1350	<dd>
	1351	<p>xyz00_dbuser</p>
	1352	</dd>
	1353	<dt>Passwort:</dt>
	1354	<dd>
	1355	<p>****</p>
	1356	</dd>
	1357	</dl>
	1358	<p>Merken Sie sich den Benutzernamen und das Passwort, da Sie beides
	1359	bei der Konfiguration Ihrer Webanwendung benötigen.</p>
	1360	<p>Mit dem Button <code>OK</code> wird der Eintrag gespeichert.</p>
	1361	<p>Der neue Datenbanknutzer erscheint nun in der Liste des Menüs
	1362	<code>MySQL-Benutzer</code>.</p>
	1363	<div id="fig-hsadmin-mysql-benutzer-angelegt">
	1364	<figure>
	1365	<img src="images/hsadmin-mysql-benutzer-angelegt.jpg"
	1366	style="width:100.0%"
	1367	alt="Der neu angelegte Datenbanknutzer erscheint in der Liste." />
	1368	<figcaption aria-hidden="true">Der neu angelegte Datenbanknutzer
	1369	erscheint in der Liste.</figcaption>
	1370	</figure>
	1371	</div>
	1372	<div class="attention">
	1373	<p>Beachten Sie, dass der Name eines Datenbankbenutzers immer mit dem
	1374	Paketnamen (in unserem Beispiel <code>xyz00</code>) gefolgt von einem
	1375	Unterstrich beginnen muss. Es darf kein Minuszeichen nach dem
	1376	Paketnamen benutzt werden. Zusammen mit den Zeichen danach darf der
	1377	Name des Datenbankbenutzers höchstens 16 Zeichen lang sein, zum
	1378	Beispiel <code>xyz00_wordpress</code> (15 Zeichen).</p>
	1379	</div>
	1380	</section>
	1381	<section id="datenbank-anlegen" class="level4">
	1382	<h4>Datenbank anlegen</h4>
	1383	<p>Nun können Sie die Datenbank für Ihre Webanwendung anlegen. Gehen
	1384	Sie in das Menü <code>MySQL-Datenbank</code>. Die Liste der
	1385	Datenbanken ist noch leer. Klicken Sie auf das Plus-Icon
	1386	<code>Neuen Eintrag anlegen</code>.</p>
	1387	<p>Es öffnet sich das Menü zum Anlegen einer Datenbank.</p>
	1388	<div id="fig-hsadmin-mysql-db-anlegen">
	1389	<figure>
	1390	<img src="images/hsadmin-mysql-db-anlegen.jpg" style="width:100.0%"
	1391	alt="Das Menü zum Anlegen einer Datenbank." />
	1392	<figcaption aria-hidden="true">Das Menü zum Anlegen einer
	1393	Datenbank.</figcaption>
	1394	</figure>
	1395	</div>
	1396	<p>Die Felder hier:</p>
	1397	<dl>
	1398	<dt>MySQL-Datenbank</dt>
	1399	<dd>
	1400	<p>xyz00_dbmysql</p>
	1401	</dd>
	1402	<dt>MySQL-Benutzer</dt>
	1403	<dd>
	1404	<p>xyz00_dbuser</p>
	1405	</dd>
	1406	<dt>Zeichenkodierung</dt>
	1407	<dd>
	1408	<p>UTF8</p>
	1409	</dd>
	1410	</dl>
	1411	<p>Mit dem Button <code>OK</code> wird der Eintrag gespeichert. Die
	1412	neue Datenbank erscheint in der Liste der Datenbanken.</p>
	1413	<div class="attention">
	1414	<p>Beachten Sie, dass der Name einer Datenbank immer mit dem
	1415	Paketnamen (in unserem Beispiel <code>xyz00</code>) gefolgt von einem
	1416	Unterstrich beginnen muss. Es darf kein Minuszeichen nach dem
	1417	Paketnamen benutzt werden. Zusammen mit den Zeichen danach darf der
	1418	Name der Datenbank höchstens 16 Zeichen lang sein, zum Beispiel
	1419	<code>xyz00_wpressdb</code> (14 Zeichen).</p>
	1420	</div>
	1421	<div id="fig-hsadmin-mysql-db-angelegt">
	1422	<figure>
	1423	<img src="images/hsadmin-mysql-db-angelegt.jpg" style="width:100.0%"
	1424	alt="Die neue Datenbank erscheint in der Liste." />
	1425	<figcaption aria-hidden="true">Die neue Datenbank erscheint in der
	1426	Liste.</figcaption>
	1427	</figure>
	1428	</div>
	1429	</section>
	1430	</section>
	1431	</section>
	1432	<section id="kap-emails-lesen" class="level1">
	1433	<h1>E-Mails senden und empfangen</h1>
	1434	<p>Wenn Sie bei Hostsharing ein E-Mail-Postfach haben, können Sie auf
	1435	die Mailfunktionen entweder mit einem E-Mail-Programm wie Thunderbird
	1436	zugreifen oder Sie lesen, schreiben und verwalten Ihre E-Mails im
	1437	Webbrowser über das Webmail-Interface von Hostsharing. Wie Sie dabei
	1438	jeweils vorgehen, wird in den folgenden beiden Abschnitten
	1439	erklärt.</p>
	1440	<p>Wir benutzen dabei die folgenden Zugangsdaten.</p>
	1441	<ul>
	1442	<li>E-Mail-Adresse: <a href="mailto:pm@hs-example.de"
	1443	class="email">pm@hs-example.de</a></li>
	1444	<li>Benutzername: xyz00-mail_pm</li>
	1445	<li>Passwort: ****</li>
	1446	<li>IMAP-Server: xyz00.hostsharing.net</li>
	1447	<li>SMTP-Server: xyz00.hostsharing.net</li>
	1448	</ul>
	1449	<dl>
	1450	<dt>E-Mail-Adresse:</dt>
	1451	<dd>
	1452	<p>Das Anlegen einer E-Mail-Adresse und die Zuweisung zu einem
	1453	Postfach wird im Abschnitt <a href="#kap-postfach-anlegen">Postfach
	1454	anlegen</a> beschrieben.</p>
	1455	</dd>
	1456	<dt>Benutzername:</dt>
	1457	<dd>
	1458	<p>Das Anlegen eines E-Mail-Benutzers wird ebenfalls im Abschnitt <a
	1459	href="#kap-postfach-anlegen">Postfach anlegen</a> erklärt.</p>
	1460	</dd>
	1461	<dt>Passwort:</dt>
	1462	<dd>
	1463	<p>Dies ist das Passwort, das dem E-Mail-Benutzer vergeben wird.</p>
	1464	</dd>
	1465	<dt>IMAP-Server:</dt>
	1466	<dd>
	1467	<p>Der Name des Mail-Eingangsservers ergibt sich aus dem Paketnamen.
	1468	Es handelt sich immer um eine Subdomain der Domain
	1469	<code>hostsharing.net</code>.</p>
	1470	</dd>
	1471	<dt>SMTP-Server:</dt>
	1472	<dd>
	1473	<p>Auch der Name des Ausgangsserver ergibt sich aus dem Paketnamen.
	1474	Die Adresse ist mit der Adresse des IMAP-Servers identisch.</p>
	1475	</dd>
	1476	</dl>
	1477	<section id="webmail-einrichten" class="level2">
	1478	<h2>Webmail einrichten</h2>
	1479	<p>Eine besonders bequeme Art, E-Mails zu lesen und zu schreiben, ist
	1480	das Webinterface von Hostsharing. Hostsharing setzt dafür das
	1481	Open-Source-Programm <a href="https://roundcube.net/">Roundcube
	1482	Webmail</a> ein. Sie benötigen zur Nutzung nur den Benutzernamen für
	1483	das Postfach und das entsprechende Passwort. Geben Sie im Webbrowser
	1484	die Adresse <a href="https://webmail.hostsharing.net"
	1485	class="uri">https://webmail.hostsharing.net</a> ein. Wie in <code
	1486	class="interpreted-text" role="numref">fig-webmail-login</code>
	1487	gezeigt werden Sie aufgefordert Ihren Benutzernamen und Ihr Passwort
	1488	einzugeben.</p>
	1489	<div id="fig-webmail-login">
	1490	<figure>
	1491	<img src="images/webmail-login.jpg" style="width:100.0%"
	1492	alt="Login des Webmail-Interface" />
	1493	<figcaption aria-hidden="true">Login des
	1494	Webmail-Interface</figcaption>
	1495	</figure>
	1496	</div>
	1497	<p>Wenn Sie sich das erste Mal mit dem Benutzernamen einloggen, werden
	1498	Sie aufgefordert, Ihre Absenderkennung zu vervollständigen.
	1499	Vorausgefüllt ist der Benutzername für das E-Mail-Konto
	1500	(<code>xyz00-mail_pm</code>) sowie das Postfach des E-Mail-Benutzers
	1501	(<code>xyz00-mail_pm@xyz00.hostsharing.net</code>). Beide Angaben
	1502	werden Sie normalerweise so nicht nutzen wollen.</p>
	1503	<div id="fig-webmail-individualisierung-1">
	1504	<figure>
	1505	<img src="images/webmail-individualisierung-1.jpg"
	1506	style="width:100.0%" alt="Individualisierung des Kontos" />
	1507	<figcaption aria-hidden="true">Individualisierung des
	1508	Kontos</figcaption>
	1509	</figure>
	1510	</div>
	1511	<p>Tragen Sie deshalb hier zum Beispiel Ihren Namen und die
	1512	E-Mail-Adresse ein, unter der Sie erreichbar sind. In unserem Beispiel
	1513	sind dies, wie in der Abbildung <a
	1514	href="#fig-webmail-individualisierung-2">Individualisierung des
	1515	Kontos</a> gezeigt, der Name ›Peter Mustermann‹ und die E-Mailadresse
	1516	›pm@hs-example.de‹</p>
	1517	<div id="fig-webmail-individualisierung-2">
	1518	<figure>
	1519	<img src="images/webmail-individualisierung-2.jpg"
	1520	style="width:100.0%" alt="Individualisierung des Kontos" />
	1521	<figcaption aria-hidden="true">Individualisierung des
	1522	Kontos</figcaption>
	1523	</figure>
	1524	</div>
	1525	<p>Nach der Vervollständigung steht Ihnen die Weboberfläche von
	1526	Roundcube zur Verfügung.</p>
	1527	<div id="fig-webmail-oberflaeche">
	1528	<figure>
	1529	<img src="images/webmail-oberflaeche.jpg" style="width:100.0%"
	1530	alt="Die Benutzeroberfläche von Webmail." />
	1531	<figcaption aria-hidden="true">Die Benutzeroberfläche von
	1532	Webmail.</figcaption>
	1533	</figure>
	1534	</div>
	1535	<p>Hinweise zur Bedienung von Roundcube finden Sie im Hostsharing Wiki
	1536	auf der Seite: <a
	1537	href="https://wiki.hostsharing.net/index.php?title=Roundcube"
	1538	class="uri">https://wiki.hostsharing.net/index.php?title=Roundcube</a></p>
	1539	</section>
	1540	<section id="mail-client-einrichten" class="level2">
	1541	<h2>Mail-Client einrichten</h2>
	1542	<p>Hostsharing unterstützt die Auto-Konfiguration von E-Mail-Clients
	1543	durch die Protokolle <a
	1544	href="https://en.wikipedia.org/wiki/Autoconfig">Autoconfig</a> und
	1545	Autodiscover. Um einen E-Mail-Client zu konfigurieren, ist daher oft
	1546	nur die Eingabe der E-Mail-Adresse und des Passworts notwendig. Alles
	1547	andere handelt Ihr E-Mail-Client automatisch mit der
	1548	E-Mail-Infrastruktur von Hostsharing aus.</p>
	1549	<p>Falls dies nicht auf Anhieb funktioniert, finden Sie im Abschnitt
	1550	<a href="#">E-Mail Auto-Konfiguration</a>kap-ref-mailautoconfig)
	1551	mögliche Ursachen. Eventuell wurde die Domain nicht so konfiguriert,
	1552	dass sie die Funktion unterstützt.</p>
	1553	<p>Im Folgenden beschreiben wir, wie Sie in einem solchen Fall die
	1554	notwendigen Informationen mit der Hand eingeben können.</p>
	1555	<section id="e-mails-über-imap-abrufen" class="level3">
	1556	<h3>E-Mails über IMAP abrufen</h3>
	1557	<p>Um Mails mit Hilfe eines Desktop-Clients wie Thunderbird zu
	1558	empfangen und um Mails zu versenden, benötigen Sie bei manueller
	1559	Eingabe der Konfiguration auch die Angaben zum IMAP- und zum
	1560	SMTP-Server.</p>
	1561	<p>Im Folgenden spielen wir das Anlegen eines neuen Kontos im Programm
	1562	Thunderbird durch:</p>
	1563	<p>Gehen Sie in das Menü
	1564	<code>Bearbeiten --> Konto-Einstellungen</code>, um zu den
	1565	Konto-Einstellungen zu gelangen. Anschließend klicken Sie auf das Menü
	1566	<code>Konto-Aktionen --> E-Mail-Konto hinzufügen...</code>, damit
	1567	sich der in Abbildung <a href="#fig-mail-client-1">Eingabe von
	1568	E-Mail-Adresse und Passwort</a> gezeigte Dialog zum Anlegen eines
	1569	neuen E-Mail-Kontos öffnet.</p>
	1570	<div id="fig-mail-client-1">
	1571	<figure>
	1572	<img src="images/mail-client-1.jpg" style="width:100.0%"
	1573	alt="Eingabe von E-Mail-Adresse und Passwort" />
	1574	<figcaption aria-hidden="true">Eingabe von E-Mail-Adresse und
	1575	Passwort</figcaption>
	1576	</figure>
	1577	</div>
	1578	<p>Geben Sie dort Ihren Namen, die E-Mail-Adresse und das Passwort des
	1579	E-Mail-Benutzers ein und klicken Sie auf <code>Weiter</code>.</p>
	1580	<div id="fig-mail-client-2">
	1581	<figure>
	1582	<img src="images/mail-client-2.jpg" style="width:100.0%"
	1583	alt="Die automatisch ermittelten Zugangsdaten" />
	1584	<figcaption aria-hidden="true">Die automatisch ermittelten
	1585	Zugangsdaten</figcaption>
	1586	</figure>
	1587	</div>
	1588	<p>Thunderbird und andere E-Mail-Clients schließen aus der
	1589	E-Mail-Adresse auf die Zugangsdaten. Die ermittelten bzw. geratenen
	1590	Zugangsdaten werden in Abbildung <a href="#fig-mail-client-2">Die
	1591	automatisch ermittelten Zugangsdaten</a> angezeigt. Die automatische
	1592	Konfiguration hat nur dann funktioniert, wenn als Posteingangs- und
	1593	Postausgangsserver eine Adresse in der Form
	1594	<code>xyz00.hostsharing.net</code> gefunden wurde. Wenn dies der Fall
	1595	ist, können Sie auf <code>Fertig</code> klicken. Wenn Thunderbird
	1596	einen anderen Servernamen, zum Beispiel wie in der Abbildung unter
	1597	Verwendung Ihrer Domain, angibt, müssen Sie die richtigen Daten
	1598	manuell eingeben.</p>
	1599	<p>Klicken Sie dazu auf <code>Manuell bearbeiten</code>, damit sich
	1600	das <a href="#fig-mail-client-3">Formular für die manuelle eingabe der
	1601	Zugangsdaten</a> öffnet.</p>
	1602	<div id="fig-mail-client-3">
	1603	<figure>
	1604	<img src="images/mail-client-3.jpg" style="width:100.0%"
	1605	alt="Das Formular für die manuelle Eingabe der Zugangsdaten" />
	1606	<figcaption aria-hidden="true">Das Formular für die manuelle Eingabe
	1607	der Zugangsdaten</figcaption>
	1608	</figure>
	1609	</div>
	1610	<p>Geben Sie in dieses Formular, wie in der Abbildung gezeigt, die
	1611	richtigen Zugangsdaten für den IMAP-Server, den SMTP-Server und den
	1612	Benutzernamen ein.</p>
	1613	<div id="fig-mail-client-4">
	1614	<figure>
	1615	<img src="images/mail-client-4.jpg" style="width:100.0%"
	1616	alt="Geben Sie den Benutzernamen des E-Mail-Kontos und den richtigen Server an." />
	1617	<figcaption aria-hidden="true">Geben Sie den Benutzernamen des
	1618	E-Mail-Kontos und den richtigen Server an.</figcaption>
	1619	</figure>
	1620	</div>
	1621	<p>Bestätigen Sie die Eingabe mit einem Klick auf
	1622	<code>Fertig</code>.</p>
	1623	</section>
	1624	<section id="e-mails-über-pop3-abrufen" class="level3">
	1625	<h3>E-Mails über POP3 abrufen</h3>
	1626	<p>Sie können E-Mails auch über POP3 abrufen. Benutzen Sie dazu den
	1627	Port 110 für STARTTLS oder 995 für SSL/TLS. Die übrigen Zugangsdaten
	1628	bleiben gleich. Folgen Sie den Anweisungen Ihrer E-Mail-Software.</p>
	1629	<div class="admonition">
	1630	<p>Hostsharing unterstützt verschlüsselte Verbindungen über STARTTLS
	1631	und SSL/TLS auf unterschiedlichen Ports. Lesen Sie dazu die Abschnitte
	1632	<a href="#kap-ref-maileingang">Posteingangsserver</a> und <a
	1633	href="#kap-ref-mailausgang">Postausgangsserver</a></p>
	1634	</div>
	1635	</section>
	1636	</section>
	1637	<section id="e-mail-passwort-ändern" class="level2">
	1638	<h2>E-Mail-Passwort ändern</h2>
	1639	<p>E-Mail-Benutzer können ihr Passwort über HSAdmin und teilweise auch
	1640	per SSH ändern. Falls dem E-Mail-Benutzer vom Paket-Admin als Shell
	1641	das Programm <code>/bin/false</code> zugeteilt wurde, lässt sich das
	1642	Passwort nur über HSAdmin ändern. Hat der E-Mail-Benutzer dagegen als
	1643	Shell das Programm <code>/usr/bin/passwd</code>, so kann er sein
	1644	Passwort auch per SSH ändern. Die Hintergründe werden im Abschnitt <a
	1645	href="#kap-benutzerrechte">Benutzerrechte</a> erklärt.</p>
	1646	<section id="e-mail-passwort-in-hsadmin-ändern" class="level3">
	1647	<h3>E-Mail-Passwort in HSAdmin ändern</h3>
	1648	<p>Der Benutzer meldet sich mit seinem E-Mail-Benutzername in HSAdmin
	1649	an. Anschließend klickt er oben rechts auf seinen Benutzernamen. Es
	1650	öffnet sich ein Menü, in dem ein neues Passwort eingetragen werden
	1651	kann. Die Prozedur wurde bereits im Abschnitt <a
	1652	href="#kap-erstes-einloggen">Erstes Einloggen und Änderung des
	1653	Passworts</a> beschrieben.</p>
	1654	<video
	1655	width="786"
	1656	height="590" controls
	1657	<source src="https://media.hostsharing.net/Passwort-fuer-E-Mail-Benutzer-via-HSAdmin-aendern.webm" type="video/webm">
	1658	<source src="https://media.hostsharing.net/Passwort-fuer-E-Mail-Benutzer-via-HSAdmin-aendern.mp4" type="video/mp4">
	1659	>
	1660	</video>
	1661	</section>
	1662	<section id="e-mail-passwort-per-ssh-ändern" class="level3">
	1663	<h3>E-Mail-Passwort per SSH ändern</h3>
	1664	<p>Der Benutzer meldet sich per SSH im Webpaket an und ändert mit dem
	1665	Programm <code>passwd</code> sein Passwort. Falls der E-Mail-Benutzer
	1666	eine interaktive Shell hat, muss er dazu das Programm eigens aufrufen.
	1667	Wurde ihm jedoch lediglich das Programm <code>/usr/bin/passwd</code>
	1668	zugewiesen, öffnet sich statt einer interaktiven Sitzung sofort das
	1669	Programm <code>passwd</code>:</p>
	1670	<pre class="text"><code>$ ssh xyz00-mail@xyz00.hostsharing.net
	1671	xyz00-mail@xyz00.hostsharing.net's password:</code></pre>
	1672	<p>Nach Eingabe des aktuellen Passworts wird sofort
	1673	<code>passwd</code> gestartet und erneut das aktuelle Passwort
	1674	abgefragt:</p>
	1675	<pre class="text"><code>Changing password for xyz00-mail.
	1676	Current password: </code></pre>
	1677	<p>Nach einer erneuten Eingabe des aktuellen Passworts kann der
	1678	Benutzer zweimal ein neues eingeben. Anschließend erscheint eine
	1679	Erfolgsmeldung und die Verbindung wird geschlossen:</p>
	1680	<pre class="text"><code>New password:
	1681	Retype new password:
	1682	passwd: password updated successfully
	1683	Connection to xyz00.hostsharing.net closed.</code></pre>
	1684	<p>Damit ist das neue Passwort gesetzt.</p>
	1685	<div class="attention">
	1686	<p>Bitte vergessen Sie nicht das neue Passwort in Ihr E-Mail-Programm
	1687	einzutragen.</p>
	1688	</div>
	1689	<video
	1690	width="786"
	1691	height="590"
	1692	controls
	1693	<source src="https://media.hostsharing.net/Passwort-fuer-E-Mail-Benutzer-via-SSH-aendern.webm" type="video/webm">
	1694	<source src="https://media.hostsharing.net/Passwort-fuer-E-Mail-Benutzer-via-SSH-aendern.mp4" type="video/mp4">
	1695	>
	1696	</video>
	1697	</section>
	1698	</section>
	1699	</section>
	1700	<section id="kap-referenz" class="level1">
	1701	<h1>Referenz</h1>
	1702	<div class="intro">
	1703	<p>In diesem Kapitel werden die Dienste und Funktionen der Managed
	1704	Operations Platform von Hostsharing dokumentiert.</p>
	1705	</div>
	1706	<section id="kap-benutzerrollen" class="level2">
	1707	<h2>Benutzerrollen</h2>
	1708	<p>Um Dienste, Programme und Dämonprozesse sicher voneinander zu
	1709	trennen, laufen sie im Debian-Betriebssystem unter verschiedenen
	1710	Benutzern mit jeweils klar definierten Rechten. Dies gilt auch für die
	1711	Aufgaben, die man als Nutzer der Plattform in seinem Web-Paket
	1712	erledigt. Wer mit der Managed Operations Platform Webanwendungen
	1713	betreibt, muss im Laufe der Zeit zahlreiche Benutzer anlegen. Jeder
	1714	Benutzer erfüllt eine spezielle Rolle. Die Rollen werden durch die
	1715	Vergabe von Rechten auf Betriebssystemebene definiert. Für Personen,
	1716	die bisher noch nicht mit Unix-Systemen und dem Konzept
	1717	unterschiedlicher Benutzer gearbeitet haben, stellt dieses
	1718	Mehrbenutzerkonzept am Anfang eine Hürde dar. Ausführliche
	1719	Unix-Kenntnisse sind nicht erforderlich, um auf der
	1720	Hostsharing-Plattform Benutzer anzulegen, da das Verwaltungswerkzeug
	1721	<code>HSAdmin</code> diese Aufgabe vereinfacht. Da in diesem Handbuch
	1722	die Kenntnis der Rollen an vielen Stellen vorausgesetzt wird, werden
	1723	sie in diesem Kapitel ausführlich beschrieben.</p>
	1724	</section>
	1725	<section id="kap-benutzerrechte" class="level2">
	1726	<h2>Benutzerrechte</h2>
	1727	<p>HSAdmin bietet uns die Möglichkeit, dem Benutzer eine Login-Shell
	1728	für interaktive Sitzungen zuzuordnen oder genau dies zu verhindern.
	1729	Wir haben die Wahl zwischen den Kommandointerpretern
	1730	<code>bash</code>, <code>csh</code>, <code>ksh</code>,
	1731	<code>tcsh</code> oder <code>zsh</code> und den Programmen
	1732	<code>false</code>, <code>passwd</code> und <code>scponly</code>. Abb.
	1733	<a href="#fig-hsadmin-shell">Das Auswahlmenü mit den Shell- und
	1734	Kommando-Interpretern.</a> zeigt das entsprechende Menü.</p>
	1735	<div id="fig-hsadmin-shell">
	1736	<figure>
	1737	<img src="images/hsadmin-benutzershells.jpg" style="width:100.0%"
	1738	alt="Das Auswahlmenü mit den Shell- und Kommando-Interpretern." />
	1739	<figcaption aria-hidden="true">Das Auswahlmenü mit den Shell- und
	1740	Kommando-Interpretern.</figcaption>
	1741	</figure>
	1742	</div>
	1743	<dl>
	1744	<dt>/bin/false</dt>
	1745	<dd>
	1746	<p>Benutzer, denen das Programm <code>/bin/false</code> als Shell
	1747	zugeordnet wird, können sich nicht in ihrem Account einloggen und eine
	1748	interaktive Sitzung starten. Diese Einstellung eignet sich für
	1749	Systembenutzer, die Programme im Webpaket ausführen. sich aber nicht
	1750	von außen einloggen sollen. Dies können auch Mail-Benutzer sein.</p>
	1751	</dd>
	1752	<dt>/bin/bash</dt>
	1753	<dd>
	1754	<p>Die <a
	1755	href="https://manpages.debian.org/buster/bash/bash.1.en.html">Bourne-Again-Shell</a>.
	1756	Auf vielen Linuxsystemen ist dies die Standard-Shell.</p>
	1757	</dd>
	1758	<dt>/bin/csh</dt>
	1759	<dd>
	1760	<p>Die <a
	1761	href="https://manpages.debian.org/buster/csh/csh.1.en.html">C-Shell</a>.</p>
	1762	</dd>
	1763	<dt>/bin/ksh</dt>
	1764	<dd>
	1765	<p>Die <a
	1766	href="https://manpages.debian.org/buster/ksh/ksh.1.en.html">Korn-Shell</a>.</p>
	1767	</dd>
	1768	<dt>/bin/tcsh</dt>
	1769	<dd>
	1770	<p>Eine <a
	1771	href="https://manpages.debian.org/buster/tcsh/tcsh.1.en.html">erweiterte
	1772	C-Shell</a>.</p>
	1773	</dd>
	1774	<dt>/bin/zsh</dt>
	1775	<dd>
	1776	<p>Die <a
	1777	href="https://manpages.debian.org/buster/zsh-common/zsh.1.en.html">Z-Shell</a>.</p>
	1778	</dd>
	1779	<dt>/usr/bin/passwd</dt>
	1780	<dd>
	1781	<p>Benutzer, denen das Programm <code>/usr/bin/passwd</code>
	1782	zugeordnet wird, können beim Versuch, sich mit <code>ssh</code>
	1783	einzuloggen, ihr Passwort ändern. Eine interaktive Sitzung können sie
	1784	jedoch nicht starten. Dies ist sinnvoll, um Benutzern ein größeres Maß
	1785	an Vertraulichkeit ihrer Kommunikation zu ermöglichen. Der Paket-Admin
	1786	setzt für den E-Mail-Benutzer zwar ein initiales Passwort, der
	1787	Benutzer kann dies aber sogleich ändern, sodass der Paket-Admin den
	1788	E-Mail-Verkehr des Benutzers nicht unbemerkt mitlesen kann.</p>
	1789	</dd>
	1790	<dt>/usr/bin/scponly</dt>
	1791	<dd>
	1792	<p>Diese Zuordnung ermöglicht dem Benutzer den Gebrauch der Programme
	1793	<code>scp</code> und <code>sftp</code>. Eine interaktive Sitzung ist
	1794	nicht möglich.</p>
	1795	</dd>
	1796	</dl>
	1797	</section>
	1798	<section id="kap-webpaket" class="level2">
	1799	<h2>Web-Paket</h2>
	1800	<p>Die Mitglieder von Hostsharing nutzen die Managed Operations
	1801	Platform, indem sie ein oder mehrere Web-Pakete buchen. Technisch
	1802	gesehen ist ein Web-Paket eine UNIX-Nutzer-Gruppe. Alle Web-Pakete
	1803	sind damit durch gesonderte Zugriffsrechte gegeneinander abgeschottet.
	1804	Mit seinem Mitglieds-Account hat das Mitglied Zugriff auf alle seine
	1805	Web-Pakete und kann sie in HSAdmin verwalten. Der Paket-Admin hat nur
	1806	Zugriff auf sein eigenes Web-Paket.</p>
	1807	<p>Ein Web-Paket hat einen definierten Leistungsumfang, der durch
	1808	Optionen jederzeit erweitert werden kann. Die konkrete Staffelung der
	1809	Optionen wird auf folgenden Webseiten beschrieben:</p>
	1810	<ol type="1">
	1811	<li>Leistungsumfang <a
	1812	href="https://www.hostsharing.net/angebote/managed-webspace/">Managed
	1813	Webspace</a></li>
	1814	<li>Leistungsumfang <a
	1815	href="https://www.hostsharing.net/angebote/managed-server/">Managed
	1816	Server</a></li>
	1817	</ol>
	1818	<p>Die Web-Pakete werden nach einem einheitlichen Muster bezeichnet.
	1819	Dieses besteht aus einem dreistelligen Präfix und einem zweistelligen
	1820	Zähler (z.B xyz00). Das Präfix kann frei gewählt werden, falls es noch
	1821	nicht vergeben ist. Mit ihm wird das Mitglied identifiziert. Es dient
	1822	daher auch als Benutzername für den Mitglieds-Account (vgl. Abschnitt
	1823	<a href="#kap-benutzerrollen">Benutzerrollten</a>)</p>
	1824	<p>Aus der Paket-Bezeichnung (xyz00) ergeben sich weitere
	1825	Benennungen:</p>
	1826	<ul>
	1827	<li>der Name des Paket-Admins: Er lautet wie das Web-Paket, in diesem
	1828	Beispiel <code>xyz00</code>.</li>
	1829	<li>das Paketverzeichnis <code>/home/pacs/xyz00/</code>; es ist daher
	1830	auch das Benutzerverzeichnis des Paket-Admin.</li>
	1831	</ul>
	1832	<p>Ein Web-Paket enthält in der Regel:</p>
	1833	<ul>
	1834	<li>die Verzeichnisse von Benutzern, deren Struktur von der jeweiligen
	1835	Rolle des Benutzers abhängig ist</li>
	1836	<li>die genutzten Datenbanken</li>
	1837	<li>die aufgeschalteten Domains</li>
	1838	</ul>
	1839	<p>Jedes Web-Paket hat eine initial angelegte Verzeichnisstruktur. Die
	1840	Verzeichnisstruktur entspricht der dem jeweiligen Nutzer
	1841	zugesprochenen Rolle. Die Verzeichnisstrukturen von Paket-Admin,
	1842	Domain-Admin und E-Mail-Benutzer werden im Folgenden beschrieben.</p>
	1843	<section id="verzeichnisebene-paket-admin" class="level3">
	1844	<h3>Verzeichnisebene Paket-Admin</h3>
	1845	<p>Man kann sich als Paket-Admin in seinem Web-Paket per SSH
	1846	folgendermaßen anmelden:</p>
	1847	<pre class="console"><code>$ ssh xyz00@xyz00.hostsharing.net</code></pre>
	1848	<p>Danach können die Verzeichnisse mit dem Befehl <code>ls</code>
	1849	angezeigt werden.</p>
	1850	<pre class="console"><code>xyz00@h05:~$ ls -a</code></pre>
	1851	<p>Das Home-Verzeichnis des Paket-Admins umfasst initial folgende
	1852	Verzeichnisse:</p>
	1853	<table style="width:100%;">
	1854	<caption>Verzeichnisstruktur des Paket-Admins</caption>
	1855	<colgroup>
	1856	<col style="width: 16%" />
	1857	<col style="width: 12%" />
	1858	<col style="width: 12%" />
	1859	<col style="width: 12%" />
	1860	<col style="width: 45%" />
	1861	</colgroup>
	1862	<thead>
	1863	<tr class="header">
	1864	<th style="text-align: left;">Rechte</th>
	1865	<th style="text-align: left;">Nutzer</th>
	1866	<th style="text-align: left;">Gruppe</th>
	1867	<th style="text-align: left;">Ordner</th>
	1868	<th style="text-align: left;">Erläuterung</th>
	1869	</tr>
	1870	</thead>
	1871	<tbody>
	1872	<tr class="odd">
	1873	<td style="text-align: left;"><code>drwx-----</code></td>
	1874	<td style="text-align: left;">xyz00</td>
	1875	<td style="text-align: left;">xyz00</td>
	1876	<td style="text-align: left;">.bak</td>
	1877	<td style="text-align: left;">Ablage komprimierter Backups der
	1878	Datenbanken und Cronjobs.</td>
	1879	</tr>
	1880	<tr class="even">
	1881	<td style="text-align: left;"><code>dr-xr-x--T</code></td>
	1882	<td style="text-align: left;">httpd</td>
	1883	<td style="text-align: left;">xyz00</td>
	1884	<td style="text-align: left;">doms</td>
	1885	<td style="text-align: left;">Ablage der Paketdomain
	1886	xyz00.hostsharing.net.</td>
	1887	</tr>
	1888	<tr class="odd">
	1889	<td style="text-align: left;"><code>drwx------</code></td>
	1890	<td style="text-align: left;">xyz00</td>
	1891	<td style="text-align: left;">xyz00</td>
	1892	<td style="text-align: left;">etc</td>
	1893	<td style="text-align: left;">Ablage für eigene
	1894	Konfigurationsdateien.</td>
	1895	</tr>
	1896	<tr class="even">
	1897	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	1898	<td style="text-align: left;">xyz00</td>
	1899	<td style="text-align: left;">xyz00</td>
	1900	<td style="text-align: left;">users</td>
	1901	<td style="text-align: left;">Ablage der angelegten Nutzer</td>
	1902	</tr>
	1903	<tr class="odd">
	1904	<td style="text-align: left;"><code>drwxr-x---</code></td>
	1905	<td style="text-align: left;">xyz00</td>
	1906	<td style="text-align: left;">xyz00</td>
	1907	<td style="text-align: left;">var</td>
	1908	<td style="text-align: left;">Ablage von Logfiles (z.B. Web-Logs,
	1909	Traffic-Logs)</td>
	1910	</tr>
	1911	<tr class="even">
	1912	<td style="text-align: left;"><code>drwx------</code></td>
	1913	<td style="text-align: left;">xyz00</td>
	1914	<td style="text-align: left;">xyz00</td>
	1915	<td style="text-align: left;">Maildir</td>
	1916	<td style="text-align: left;">Mailordner des Paket-Admins.</td>
	1917	</tr>
	1918	</tbody>
	1919	</table>
	1920	</section>
	1921	<section id="verzeichnisebene-domain-admin" class="level3">
	1922	<h3>Verzeichnisebene Domain-Admin</h3>
	1923	<p>Man kann sich als Domain-Admin in seinem Web-Paket per SSH
	1924	folgendermaßen anmelden. Unter der Annahme, dass der Domain-Admin für
	1925	die Domain <code>hs-example.de</code> angelegt wurde und sein
	1926	Benutzername <code>xyz00-hs_example.de</code> ist, lautet der Befehl
	1927	zum Anmelden folgendermaßen:</p>
	1928	<pre class="console"><code>$ ssh xyz00-hs_example.des@xyz00.hostsharing.net</code></pre>
	1929	<p>Danach können die Verzeichnisse mit dem Befehl <code>ls</code>
	1930	angezeigt werden.</p>
	1931	<pre class="console"><code>xyz00-doms@h05:~$ ls -a</code></pre>
	1932	<p>Das Home-Verzeichnis des Domain-Admins umfasst folgende
	1933	Verzeichnisse:</p>
	1934	<table style="width:100%;">
	1935	<caption>Verzeichnisstruktur des Domain-Admin</caption>
	1936	<colgroup>
	1937	<col style="width: 18%" />
	1938	<col style="width: 23%" />
	1939	<col style="width: 11%" />
	1940	<col style="width: 12%" />
	1941	<col style="width: 35%" />
	1942	</colgroup>
	1943	<thead>
	1944	<tr class="header">
	1945	<th style="text-align: left;">Rechte</th>
	1946	<th style="text-align: left;">Nutzer</th>
	1947	<th style="text-align: left;">Gruppe</th>
	1948	<th style="text-align: left;">Ordner</th>
	1949	<th style="text-align: left;">Erläuterung</th>
	1950	</tr>
	1951	</thead>
	1952	<tbody>
	1953	<tr class="odd">
	1954	<td style="text-align: left;"><code>dr-xr-x--T</code></td>
	1955	<td style="text-align: left;">httpd</td>
	1956	<td style="text-align: left;">xyz00</td>
	1957	<td style="text-align: left;">doms</td>
	1958	<td style="text-align: left;">Ablage der Domains dieses
	1959	Domain-Admins.</td>
	1960	</tr>
	1961	<tr class="even">
	1962	<td style="text-align: left;"><code>drwx------</code></td>
	1963	<td style="text-align: left;">xyz00-hs_example.de</td>
	1964	<td style="text-align: left;">xyz00</td>
	1965	<td style="text-align: left;">Maildir</td>
	1966	<td style="text-align: left;">Mailordner des Domain-Admins.</td>
	1967	</tr>
	1968	</tbody>
	1969	</table>
	1970	<p>Unterhalb des Ordners <em>doms</em> findet sich für jede Domain ein
	1971	weiterer Ordner mit dem Namen der Domain, zum Beispiel
	1972	<em>example.com</em>, und darin befindet sich die Verzeichnisstruktur
	1973	für die jeweilige Domain:</p>
	1974	<table>
	1975	<caption>Verzeichnisstruktur einer Domain</caption>
	1976	<colgroup>
	1977	<col style="width: 13%" />
	1978	<col style="width: 19%" />
	1979	<col style="width: 10%" />
	1980	<col style="width: 10%" />
	1981	<col style="width: 45%" />
	1982	</colgroup>
	1983	<thead>
	1984	<tr class="header">
	1985	<th style="text-align: left;">Rechte</th>
	1986	<th style="text-align: left;">Nutzer</th>
	1987	<th style="text-align: left;">Gruppe</th>
	1988	<th style="text-align: left;">Ordner</th>
	1989	<th style="text-align: left;">Erläuterung</th>
	1990	</tr>
	1991	</thead>
	1992	<tbody>
	1993	<tr class="odd">
	1994	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	1995	<td style="text-align: left;">xyz00-hs_example.de</td>
	1996	<td style="text-align: left;">xyz00</td>
	1997	<td style="text-align: left;">cgi</td>
	1998	<td style="text-align: left;">Ablage für CGI-Skripte zur Generierung
	1999	dynamischer Webseiten in einem Webserver.</td>
	2000	</tr>
	2001	<tr class="even">
	2002	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2003	<td style="text-align: left;">xyz00-hs_example.de</td>
	2004	<td style="text-align: left;">xyz00</td>
	2005	<td style="text-align: left;">cgi-ssl</td>
	2006	<td style="text-align: left;">Ablage für CGI-Skripte zur Generierung
	2007	dynamischer Webseiten, die verschlüsselt ausgeliefert werden</td>
	2008	</tr>
	2009	<tr class="odd">
	2010	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2011	<td style="text-align: left;">xyz00-hs_example.de</td>
	2012	<td style="text-align: left;">xyz00</td>
	2013	<td style="text-align: left;">fastcgi</td>
	2014	<td style="text-align: left;">Ablage für Fast-CGI-Programme zur
	2015	Generierung dynamischer Webseiten in einem Webserver.</td>
	2016	</tr>
	2017	<tr class="even">
	2018	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2019	<td style="text-align: left;">xyz00-hs_example.de</td>
	2020	<td style="text-align: left;">xyz00</td>
	2021	<td style="text-align: left;">fastcgi-ssl</td>
	2022	<td style="text-align: left;">Ablage für Fast-CGI-Programme zur
	2023	Generierung dynamischer Webseiten, die verschlüsselt ausgeliefert
	2024	werden</td>
	2025	</tr>
	2026	<tr class="odd">
	2027	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2028	<td style="text-align: left;">xyz00-hs_example.de</td>
	2029	<td style="text-align: left;">xyz00</td>
	2030	<td style="text-align: left;">htdocs</td>
	2031	<td style="text-align: left;">Ablage für die Daten einer Webseite,
	2032	wenn diese unverschlüsselt ausgeliefert werden soll.</td>
	2033	</tr>
	2034	<tr class="even">
	2035	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2036	<td style="text-align: left;">xyz00-hs_example.de</td>
	2037	<td style="text-align: left;">xyz00</td>
	2038	<td style="text-align: left;">subs</td>
	2039	<td style="text-align: left;">Ablage für Sub-Domain aus htdocs, wenn
	2040	diese unverschlüsselt ausgeliefert werden soll.</td>
	2041	</tr>
	2042	<tr class="odd">
	2043	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2044	<td style="text-align: left;">xyz00-hs_example.de</td>
	2045	<td style="text-align: left;">xyz00</td>
	2046	<td style="text-align: left;">htdocs-ssl</td>
	2047	<td style="text-align: left;">Ablage für die Daten einer Webseite,
	2048	wenn diese verschlüsselt ausgeliefert werden soll.</td>
	2049	</tr>
	2050	<tr class="even">
	2051	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2052	<td style="text-align: left;">xyz00-hs_example.de</td>
	2053	<td style="text-align: left;">xyz00</td>
	2054	<td style="text-align: left;">subs-ssl</td>
	2055	<td style="text-align: left;">Ablage für Sub-Domain aus htdocs-ssl,
	2056	wenn diese verschlüsselt ausgeliefert werden soll.</td>
	2057	</tr>
	2058	<tr class="odd">
	2059	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2060	<td style="text-align: left;">xyz00-hs_example.de</td>
	2061	<td style="text-align: left;">xyz00</td>
	2062	<td style="text-align: left;">etc</td>
	2063	<td style="text-align: left;">Ablage für domaineigene
	2064	Konfigurationsdateien (z.B. eigenes Zonefile.</td>
	2065	</tr>
	2066	<tr class="even">
	2067	<td style="text-align: left;"><code>drwxr-xr-x</code></td>
	2068	<td style="text-align: left;">xyz00-hs_example.de</td>
	2069	<td style="text-align: left;">xyz00</td>
	2070	<td style="text-align: left;">var</td>
	2071	<td style="text-align: left;">Ablage für Logfiles.</td>
	2072	</tr>
	2073	</tbody>
	2074	</table>
	2075	<p>Die Verzeichnisstruktur wird auch im Abschnitt <a
	2076	href="#kap-einstieg-ordnerstruktur">Ordnerstruktur</a>
	2077	beschrieben.</p>
	2078	</section>
	2079	<section id="verzeichnisebene-e-mail-nutzer" class="level3">
	2080	<h3>Verzeichnisebene E-Mail-Nutzer</h3>
	2081	<p>Das Home-Verzeichnis eines E-Mail-Benutzers umfasst nur sein
	2082	Postfach:</p>
	2083	<table style="width:100%;">
	2084	<caption>Verzeichnisstruktur eines E-Mail-Benutzers</caption>
	2085	<colgroup>
	2086	<col style="width: 20%" />
	2087	<col style="width: 17%" />
	2088	<col style="width: 13%" />
	2089	<col style="width: 14%" />
	2090	<col style="width: 34%" />
	2091	</colgroup>
	2092	<thead>
	2093	<tr class="header">
	2094	<th style="text-align: left;">Rechte</th>
	2095	<th style="text-align: left;">Nutzer</th>
	2096	<th style="text-align: left;">Gruppe</th>
	2097	<th style="text-align: left;">Ordner</th>
	2098	<th style="text-align: left;">Erläuterung</th>
	2099	</tr>
	2100	</thead>
	2101	<tbody>
	2102	<tr class="odd">
	2103	<td style="text-align: left;"><code>drwxr-----</code></td>
	2104	<td style="text-align: left;">xyz00-mail</td>
	2105	<td style="text-align: left;">xyz00</td>
	2106	<td style="text-align: left;">Maildir</td>
	2107	<td style="text-align: left;">Mailordner des E-Mail-Nutzers.</td>
	2108	</tr>
	2109	</tbody>
	2110	</table>
	2111	</section>
	2112	<section id="kap-quota" class="level3">
	2113	<h3>Speicherbelegung</h3>
	2114	<p>Jedem Web-Paket steht nur ein begrenzter Speicher zur Verfügung.
	2115	Der tatsächlich belegte Speicher darf den gebuchten nicht dauerhaft
	2116	überschreiten.</p>
	2117	<p>Zum belegten Speicher zählen neben den sichtbaren Dateien in
	2118	<code>/home/pacs/xyz00</code>, die Sicherungen der Datenbanken unter
	2119	<code>/home/pacs/xyz00/.bak/</code> sowie gegebenenfalls Dateien in
	2120	<code>/home/restore</code> oder temporäre Daten im Verzeichnis
	2121	<code>/tmp</code>.</p>
	2122	<p>Die Speicherbegrenzung für ein Web-Paket ist unter Linux durch ein
	2123	Quota für die Gruppe <code>xyz00</code> realisiert. Die aktuelle
	2124	Belegung lässt sich mit dem Kommando</p>
	2125	<pre class="console"><code>$ quota -gs</code></pre>
	2126	<p>ermitteln. Die Ausgabe</p>
	2127	<pre class="console"><code>Disk quotas for group xyz00 (gid 999999):
	2128	Filesystem space quota limit grace files quota limit grace
	2129	/dev/vda2 5587M 6144M 9216M 103k 6292k 6292k </code></pre>
	2130	<p>bedeutet:</p>
	2131	<ul>
	2132	<li>Es sind 5587 MB von 6144 MB belegt</li>
	2133	<li>Temporär dürfen bis zu 9216 MB in Anspruch genommen werden</li>
	2134	<li>Außerdem sind 103.000 Dateien angelegt worden</li>
	2135	<li>Die maximale Anzahl der Dateien ist auf 6.292.000 beschränkt</li>
	2136	<li>Sobald das Quota überschritten wird, würde unter
	2137	<code>grace</code> die verbleibende Zeit angezeigt, innerhalb derer
	2138	wieder das Quota unterschritten sein muss. Sonst wird das Paket
	2139	gesperrt, das heißt es können keine Dateien mehr angelegt werden,
	2140	E-Mails werden nicht mehr zugestellt.</li>
	2141	</ul>
	2142	<p>Falls Sie dauerhaft mehr Speicherplatz benötigen, können Sie diesen
	2143	jederzeit hinzubuchen. Wenden Sie sich dazu an den <a
	2144	href="mailto:service@hostsharing.net">Service</a>.</p>
	2145	</section>
	2146	</section>
	2147	<section id="kap-ref-domain" class="level2">
	2148	<h2>Domains</h2>
	2149	<p>Die Domainverwaltung bei Hostsharing ist in zwei unabhängige
	2150	Bereiche aufgeteilt.</p>
	2151	<ol type="1">
	2152	<li><p>Die Domaineinrichtung in einem Web-Paket. Dies geschieht mit
	2153	HSAdmin. Die Benutzung der Weboberfläche wird im Abschnitt <a
	2154	href="#kap-hsadmin-einstieg">Einstieg in HSAdmin</a>, speziell im
	2155	Abschnitt <a href="#kap-hsadmin-domain-anlegen">Domain in HSAdmin
	2156	anlegen</a> beschrieben. Die Nutzung des Kommandozeilen-Tools von
	2157	HSAdmin erklärt Abschnitt <a href="#kap-hsadmin">HSAdmin</a>.</p></li>
	2158	<li><p>Die Domainregistrierung im Domainbestellsystems von Partnergate
	2159	zur Konnektierung, also der eigentlichen Registrierung von Domains bei
	2160	einem Registrar. Das Domainbestellsystem dient auch zur Vergabe
	2161	weiterer Aufträgen an Registrierungstellen. Jedes Mitglied von
	2162	Hostsharing erhält für dieses Domainbestellsystem Zugangsdaten. Sie
	2163	bestehen aus der Reseller-ID und einem Passwort.</p></li>
	2164	</ol>
	2165	<p>Hostsharing gibt seinen Mitgliedern bei der Verwaltung von Domains
	2166	große Freiheiten, da beide Bereiche nicht zwingend zusammen genutzt
	2167	werden müssen. Sie können Domains über das Domainbestellsystem
	2168	registrieren und bei anderen Hostern betreiben. Sie können Domains,
	2169	die Sie bei anderen Hostern registriert haben, bei Hostsharing
	2170	betreiben.</p>
	2171	<p>Die Verwaltung einer Domain umfasst:</p>
	2172	<ul>
	2173	<li>Domain aufschalten,</li>
	2174	<li>Domain-Registrierung,</li>
	2175	<li>Domain-Transfer zur Hostsharing eG,</li>
	2176	<li>Extern registrierte Domain aufschalten,</li>
	2177	<li>Extern registrierte Sub-Domain aufschalten,</li>
	2178	<li>Domain neu zuordnen (Domain-Admin neu zuordnen oder Zuordnung zu
	2179	einem Web-Paket ändern),</li>
	2180	<li>Sub-Domain neu zuordnen (Domain-Admin neu zuordnen oder Zuordnung
	2181	zu einem Web-Paket ändern),</li>
	2182	<li>Lokale Sub-Domain separat aufschalten,</li>
	2183	<li>Verwaltung des Zonefile,</li>
	2184	<li>Verwaltung der Domain-Daten (zum Beispiel Domain-Handle,
	2185	Kontaktdaten),</li>
	2186	<li>Transfer zu einem anderen Provider,</li>
	2187	<li>Domain löschen/kündigen.</li>
	2188	</ul>
	2189	<section id="domainverwaltung" class="level3">
	2190	<h3>Domainverwaltung</h3>
	2191	<section id="registrierung-und-aufschaltung" class="level4">
	2192	<h4>Registrierung und Aufschaltung</h4>
	2193	<p>Die Domainverwaltung ist in zwei voneinander unabhängige
	2194	Aufgabenbereiche unterteilt:</p>
	2195	<section id="domaineinrichtung-und--konfiguration-in-einem-web-paket"
	2196	class="level5">
	2197	<h5>Domaineinrichtung und -konfiguration in einem Web-Paket</h5>
	2198	<p>Die Einrichtung und Konfiguration erfolgt mit dem Werkzeug <code
	2199	class="interpreted-text" role="term">HSAdmin</code>. Die Benutzung von
	2200	HSAdmin über das Webinterface unter admin.hostsharing.net wird in
	2201	<code class="interpreted-text"
	2202	role="numref">kap-hsadmin-einstieg</code> beschrieben, die Syntax der
	2203	Kommandozeilen-Variante <code class="interpreted-text"
	2204	role="command">hsscript</code> in <code class="interpreted-text"
	2205	role="numref">kap-hsadmin</code>.</p>
	2206	<p>Aufgaben der Domainverwaltung werden vom <code
	2207	class="interpreted-text" role="role">Paket-Admin</code> oder vom <code
	2208	class="interpreted-text"
	2209	role="role">Mitglieds-Account <Mitglied></code>
	2210	wahrgenommen.</p>
	2211	</section>
	2212	<section id="vergabe-von-aufträgen-an-eine-registrierungsstelle"
	2213	class="level5">
	2214	<h5>Vergabe von Aufträgen an eine Registrierungsstelle</h5>
	2215	<p>Die Vergabe von Aufträgen (z.B. Registrierung, Transfer) an eine
	2216	Registrierungsstelle ist nur über das <a
	2217	href="https://www.domain-bestellsystem.de/">Webfrontend</a> des <code
	2218	class="interpreted-text" role="term">Domain-Bestell-System</code>
	2219	möglich und erfolgt mit Hilfe der <code class="interpreted-text"
	2220	role="role">Reseller-ID</code>.</p>
	2221	<div class="note">
	2222	<p>Die Anzahl der pro Tag möglichen Registrierungen ist beschränkt, um
	2223	Missbrauch vorzubeugen. Nach Rücksprache kann das Limit erhöht
	2224	werden.</p>
	2225	</div>
	2226	<div class="warning">
	2227	<p>Der Nutzer ist für sämtliche Aktivitäten im Domainbestellsystem
	2228	juristisch eigenverantwortlich.</p>
	2229	</div>
	2230	<div class="tip">
	2231	<p>Wenn Sie eine Domain neu registrieren, schalten Sie diese erst in
	2232	HSAdmin auf, bevor Sie sie im Domainbestellsystem registrieren. Die
	2233	Konnektierung erfolgt dann in der Regel problemlos. Wenn Sie umgekehrt
	2234	vorgehen, müssen Sie im Domainbestellsystem die Konnektierung neu
	2235	anstoßen.</p>
	2236	</div>
	2237	</section>
	2238	</section>
	2239	<section id="bestehende-domain-einem-neuen-domain-admin-zuordnen"
	2240	class="level4">
	2241	<h4>Bestehende Domain einem neuen Domain-Admin zuordnen</h4>
	2242	<p>Um eine Domain einem anderen <code class="interpreted-text"
	2243	role="role">Domain-Admin</code> zuzuordnen und damit im Dateisystem zu
	2244	verschieben, wird sie über HSAdmin gelöscht und neu angelegt.</p>
	2245	<div class="warning">
	2246	<p>Beim Löschen einer Domain in HSAdmin werden alle Dateien im
	2247	Webspace komplett gelöscht. Sichern Sie also vorher alle Daten in
	2248	einem von der Löschung nicht betroffenen Verzeichnis (zum Beispiel mit
	2249	<code class="interpreted-text" role="command">tar</code>). Es gehen
	2250	auch die Mailadressen der betreffenden Domain verloren und müssen an
	2251	neuer Stelle neu angelegt werden.</p>
	2252	</div>
	2253	<p>Der Prozess des Verschiebens läuft im Großen und Ganzen
	2254	folgendermaßen ab:</p>
	2255	<ol type="1">
	2256	<li>Sichern aller Daten im Ordner <code>doms/example.de</code> des
	2257	alten Domain-Admin</li>
	2258	<li>Löschen der Domain in HSAdmin</li>
	2259	<li>Neuanlage eines neuen Domain-Admin in HSAdmin</li>
	2260	<li>Neuanlage der Domain in HSAdmin</li>
	2261	<li>Rückspielen der gesicherten Daten in den neu erstellen Ordner
	2262	<code>doms/example.de</code> des neuen Domain-Admin</li>
	2263	</ol>
	2264	</section>
	2265	<section id="bestehende-domain-in-ein-anderes-web-paket-verschieben"
	2266	class="level4">
	2267	<h4>Bestehende Domain in ein anderes Web-Paket verschieben</h4>
	2268	<p>Um eine Domain in ein anderes Web-Paket zu verschieben, wird sie im
	2269	alten Web-Paket gelöscht und im neuen neu angelegt. Gehen Sie dabei im
	2270	Prinzip genau so vor wie im Abschnitt zuvor.</p>
	2271	<ol type="1">
	2272	<li>Sichern aller Daten im Ordner <code>doms/example.de</code> des
	2273	alten Domain-Admin im alten Web-Paket</li>
	2274	<li>Löschen der Domain <code>example.de</code> in HSAdmin im alten
	2275	Web-Paket</li>
	2276	<li>Neuanlage eines neuen Domain-Admin im neuen Web-Paket</li>
	2277	<li>Neuanlage der Domain <code>example.de</code> im neuen
	2278	Web-Paket</li>
	2279	<li>Rückspielen der gesicherten Daten in den neu erstellen Ordner
	2280	<code>doms/example.de</code> des neuen Domain-Admin im neuen
	2281	Web-Paket</li>
	2282	</ol>
	2283	<div class="tip">
	2284	<p>Wenn Sie unsicher sind, wenden Sie sich an den Service unter <a
	2285	href="mailto:service@hostsharing.net"
	2286	class="email">service@hostsharing.net</a>. Der <a
	2287	href="https://www.hostsharing.net/service/webmaster-on-demand">Webmaster
	2288	on Demand</a> kann eine Domain mit minimalen Ausfallzeiten für Sie bei
	2289	aufwandsabhängiger Abrechnung verschieben.</p>
	2290	</div>
	2291	</section>
	2292	</section>
	2293	<section id="kap-ref-subdomains" class="level3">
	2294	<h3>Subdomain</h3>
	2295	<p>Subdomains sind Domains unterhalb der Hauptdomain. Auch
	2296	<code>www</code> ist eine Subdomain. Als Subdomain der Hauptdomain
	2297	<code>hs-example.de</code> wird eine Website unter dieser Subdomain im
	2298	Browser über die Adresse <code>www.hs-example.de</code> aufgerufen.
	2299	Die Subdomain <code>test</code> würde man über die Adresse
	2300	<code>test.hs-example.de</code> erreichen.</p>
	2301	<p>Sie können bei Hostsharing beliebig viele Subdomains einrichten. Es
	2302	gibt zwei Methoden Subdomains anzulegen:</p>
	2303	<ol type="1">
	2304	<li>Leichtgewichtige Subdomains</li>
	2305	<li>Aufgeschaltete Subdomains</li>
	2306	</ol>
	2307	<section id="leichtgewichtige-subdomain" class="level4">
	2308	<h4>Leichtgewichtige Subdomain</h4>
	2309	<p>Eine Subdomains wird bei Hostsharing <em>leichtgewichtig</em>
	2310	genannt, wenn sie durch ein Unterverzeichnis von
	2311	<code>~/doms/example.com/subs/</code> definiert wurde. Dies ist die
	2312	einfachste Art und Weise, um Subdomains zu erstellen. Für jede
	2313	Subdomain wird ein Ordner im Verzeichnis <code>subs</code>
	2314	erstellt.</p>
	2315	<p>Leichtgewichtige Subdomains sollten nur verwendet werden, wenn eine
	2316	einzelne Anwendung zur Verwaltung aller dieser Subdomains verwendet
	2317	wird. Das kann zum Beispiel ein CMS oder eine
	2318	Multisite-Wordpress-Installation sein.</p>
	2319	<p>Wenn unterschiedliche Anwendungen unter Subdomains betrieben
	2320	werden, sollte</p>
	2321	<ul>
	2322	<li>für jede Subdomain ein eigener <code>Domain-Admin</code>
	2323	angelegt</li>
	2324	<li>und jede Subdomain jeweils beim entsprechenden Domain-Admin
	2325	aufgeschaltet werden.</li>
	2326	</ul>
	2327	</section>
	2328	<section id="aufgeschaltete-subdomain" class="level4">
	2329	<h4>Aufgeschaltete Subdomain</h4>
	2330	<p>Eine Subdomain wird bei Hostsharing wie die Hauptdomain
	2331	aufgeschaltet (siehe Abschnitt <a
	2332	href="#kap-hsadmin-domain-anlegen">Domain in HSAdmin anlegen</a>).
	2333	Eine Subdomain wie <code>blog.hs-example.de</code> kann im gleichen
	2334	Web-Paket aufgeschaltet werden wie die Hauptdomain oder in einem
	2335	anderen. Es ist Best-Practice bei Hostsharing für jede aufgeschaltete
	2336	Domain – also auch für jede aufgeschaltete Subdomain – einen
	2337	Domain-Admin anzulegen und die Domain bzw. Subdomain diesem
	2338	Domain-Admin zuzuordnen.</p>
	2339	</section>
	2340	</section>
	2341	<section id="kap-domain-optionen" class="level3">
	2342	<h3>Domain-Optionen</h3>
	2343	<p>Bei Aufschaltung einer Domain können verschiedene Optionen gesetzt
	2344	werden.</p>
	2345	<dl>
	2346	<dt>Greylisting</dt>
	2347	<dd>
	2348	<p>Greylisting ist eine Form der Spam-Bekämpfung bei E-Mails.
	2349	Nachrichten von unbekannten Absendern werden zunächst abgewiesen und
	2350	erst nach einem weiteren Zustellversuch angenommen. Da viele Spammer
	2351	nur einen Zustellversuch unternehmen, können Sie mit dieser Option das
	2352	Spam-Aufkommen in den Postfächern der Domain spürbar reduzieren.
	2353	Allerdings müssen Sie damit rechnen, Mails von unbekannten Absendern
	2354	erst nach einer gewissen Wartezeit zu erhalten. Falls der Absender
	2355	einen fehlerhaft konfigurierten Mailserver hat, kann es sein, dass er
	2356	keinen zweiten Zustellversuch unternimmt, sodass Sie die E-Mail gar
	2357	nicht bekommen.</p>
	2358	</dd>
	2359	<dt>Multiviews</dt>
	2360	<dd>
	2361	<p>Wenn diese Option eingeschaltet ist, berücksichtigt der Webserver
	2362	Browsereinstellungen und kann je nachdem unterschiedliche Dateien
	2363	ausliefern. Die Möglichkeiten sind in der Dokumentation zu <a
	2364	href="http://httpd.apache.org/docs/current/mod/mod_autoindex.html">mod_mime</a>
	2365	und <a
	2366	href="http://httpd.apache.org/docs/current/mod/mod_negotiation.html">mod_negotiation</a>
	2367	beschrieben.</p>
	2368	</dd>
	2369	<dt>Indexes</dt>
	2370	<dd>
	2371	<p>Wenn diese Option eingeschaltet ist, erzeugt der Webserver für
	2372	Verzeichnisse, die keine Index-Datei (<code class="interpreted-text"
	2373	role="file">index.html</code>) enthalten eine Liste mit den Inhalten
	2374	des Verzeichnisses. Weitere Informationen zu dieser Funktion des
	2375	Webservers finden Sie in der Dokumentation von <a
	2376	href="http://httpd.apache.org/docs/current/mod/mod_autoindex.html">mod_autoindex</a>.
	2377	Ist die Option nicht gesetzt, erhält der Browser stattdessen eine
	2378	404-Fehlermeldung. Sie können diese Einstellung durch eine
	2379	<code>.htaccess</code>-Datei im Verzeichnis überschreiben. Lesen Sie
	2380	dazu Abschnitt <a href="#kap-htaccess">htaccess</a>.</p>
	2381	</dd>
	2382	<dt>Fallback auf htdocs/htdocs-ssl</dt>
	2383	<dd>
	2384	<p>Wenn diese Option aktiviert ist, werden Browser-Anfragen an eine
	2385	nicht aufgeschaltete Subdomain (<code>blog.hs-example.de</code>) an
	2386	die Hauptdomain weitergeleitet. In diesem Fall an
	2387	<code>hs-example.de</code>. Falls die Option nicht gesetzt ist, erhält
	2388	der Browser stattdessen eine 404-Fehlermeldung.</p>
	2389	</dd>
	2390	<dt>Includes</dt>
	2391	<dd>
	2392	<p>Wenn diese Option gesetzt ist, unterstützt der Webserver SSI
	2393	(Server Side Includes). Weitere Informationen dazu finden Sie in der
	2394	Dokumentation von <a
	2395	href="http://httpd.apache.org/docs/current/mod/mod_include.html">mod_includes</a></p>
	2396	</dd>
	2397	<dt>Backup-MX für externen Mailserver</dt>
	2398	<dd>
	2399	<p>Wenn diese Option eingeschaltet ist, nehmen die E-Mail-Server von
	2400	Hostsharing als sogenannter Backup-MX E-Mails für einen SMTP-Server
	2401	an, der unabhängig betrieben wird. Für diese Funktion muss die
	2402	Zone-Datei angepasst werden. Lesen Sie dazu Abschnitt <a
	2403	href="#kap-ref-zonefile">Zonefile</a>.</p>
	2404	</dd>
	2405	<dt>Let's Encrypt-Zertifikat</dt>
	2406	<dd>
	2407	<p>Wenn diese Option aktiviert ist, wird automatisch ein kostenloses
	2408	LE-Zertifikat generiert und regelmäßig verlängert. Sie können Ihre
	2409	Website dann so konfigurieren, dass der Datentransfer zu den Browsern
	2410	über eine verschlüsselte Verbindung (<code>https</code>) erfolgt.</p>
	2411	</dd>
	2412	<dt>E-Mail Auto-Konfiguration</dt>
	2413	<dd>
	2414	<p>Bei Aktivierung dieser Option reicht es bei den meisten
	2415	E-Mail-Programmen (die ›autoconfig‹ oder ›autodiscover‹ unterstützen),
	2416	E-Mail-Adresse und Passwort zur Konfiguration anzugeben. Dazu muss der
	2417	E-Mail-Adresse ein eindeutiges E-Mail-Postfach bei Hostsharing
	2418	zugeordnet sein.</p>
	2419	</dd>
	2420	<dt>Domain Keys (DKIM)</dt>
	2421	<dd>
	2422	<p>Durch das Aktiveren dieser Option werden DKIM-Signaturen für
	2423	ausgehende E-Mails mit Absendern dieser E-Mail-Domain aktiviert. Vor
	2424	der Aktivierung muss der öffentliche Schlüssel des Domain Key in der
	2425	DNS Zone der Domain veröffentlicht werden. Das Zonefile muss dazu die
	2426	Zeile <code>{DKIM_RR}</code> enthalten. Die Option ist (ab 1.9.2021)
	2427	bei neu angelegten Domains in der Voreinstellung aktiviert und der
	2428	öffentliche Schlüssel wird automatisch hinterlegt.</p>
	2429	</dd>
	2430	</dl>
	2431	</section>
	2432	</section>
	2433	<section id="e-mail" class="level2">
	2434	<h2>E-Mail</h2>
	2435	<p>Jeder Benutzer im Web-Paket besitzt ein E-Mail-Konto und kann
	2436	E-Mail senden und empfangen. E-Mails werden unterhalb des
	2437	Verzeichnisses <code>~/Maildir</code> abgelegt. Der Name des Ordners
	2438	<code>Maildir</code> darf nicht verändert werden.</p>
	2439	<p>Jedes E-Mail-Konto ist POP3- und IMAP-fähig.</p>
	2440	<p>Hostsharing bietet folgende Konfigurationsmöglichkeiten:</p>
	2441	<ul>
	2442	<li>Anlegen und Löschen von E-Mail-Adressen</li>
	2443	<li>Anlegen und Löschen von E-Mail-Aliasen</li>
	2444	<li>Einrichtung von E-Mail-Weiterleitungen</li>
	2445	<li>Automatisches Versenden einer E-Mail-Bestätigung (Vacation)</li>
	2446	<li>Automatisches Filtern und Bearbeiten von E-Mails über <a
	2447	href="https://wiki.hostsharing.net/index.php?title=Sieve">Managesieve</a>
	2448	oder <a
	2449	href="https://wiki.hostsharing.net/index.php?title=Procmail">Procmail</a></li>
	2450	<li>Mit E-Mail-Aliasen kann die Zustellung von Nachrichten in die
	2451	Postfächer der Benutzer gesteuert werden.</li>
	2452	<li>E-Mail-Konten bei anderen Anbietern abfragen</li>
	2453	<li>Einrichtung von Mailinglisten</li>
	2454	</ul>
	2455	<p>Der Zugriff auf das E-Mail-Konto erfolgt über einen beliebigen
	2456	E-Mail-Client oder über Webmail.</p>
	2457	<section id="kap-ref-maileingang" class="level3">
	2458	<h3>Posteingangsserver</h3>
	2459	<p>Angaben für den Posteingangsserver:</p>
	2460	<table>
	2461	<caption>Konfiguration Eingangsserver</caption>
	2462	<colgroup>
	2463	<col style="width: 31%" />
	2464	<col style="width: 26%" />
	2465	<col style="width: 15%" />
	2466	<col style="width: 13%" />
	2467	<col style="width: 13%" />
	2468	</colgroup>
	2469	<thead>
	2470	<tr class="header">
	2471	<th style="text-align: left;">Posteingangsserver</th>
	2472	<th style="text-align: left;">Postfach/Benutzer</th>
	2473	<th style="text-align: left;">Protokoll</th>
	2474	<th style="text-align: left;">STARTTLS</th>
	2475	<th style="text-align: left;">SSL/TLS</th>
	2476	</tr>
	2477	</thead>
	2478	<tbody>
	2479	<tr class="odd">
	2480	<td style="text-align: left;">xyz00.hostsharing.net</td>
	2481	<td style="text-align: left;">xyz00-mailbox</td>
	2482	<td style="text-align: left;">POP3</td>
	2483	<td style="text-align: left;">Port 110</td>
	2484	<td style="text-align: left;">Port 995</td>
	2485	</tr>
	2486	<tr class="even">
	2487	<td style="text-align: left;">xyz00.hostsharing.net</td>
	2488	<td style="text-align: left;">xyz00-mailbox</td>
	2489	<td style="text-align: left;">IMAP</td>
	2490	<td style="text-align: left;">Port 143</td>
	2491	<td style="text-align: left;">Port 993</td>
	2492	</tr>
	2493	</tbody>
	2494	</table>
	2495	<p>Die Konfigurationsvariante IMAP über Port 143 mit STARTTLS wird
	2496	empfohlen.</p>
	2497	</section>
	2498	<section id="kap-ref-mailausgang" class="level3">
	2499	<h3>Postausgangsserver</h3>
	2500	<p>Für jedes Webpaket steht ein Postausgangsserver für reguäre E-Mails
	2501	und ein Postausgangsserver für den Massenversand von E-Mails
	2502	bereit.</p>
	2503	<p>Unter Massenversand wird der Versand von Newslettern,
	2504	Forenbenachrichtungen, der Betrieb von Mailinglisten und ähnliche
	2505	Nutzungen im Rahmen des Zulässigen verstanden. Wählen Sie bei solchen
	2506	Massenaussendungen bitte möglichst den Postausgangsserver für den
	2507	Massenversand, da Sie so mithelfen, die Reputation unserer normalen
	2508	Ausgangsserver hoch zu halten.</p>
	2509	<p>Angaben für den Postausgangsserver:</p>
	2510	<table>
	2511	<caption>Konfiguration Ausgangsserver</caption>
	2512	<colgroup>
	2513	<col style="width: 31%" />
	2514	<col style="width: 26%" />
	2515	<col style="width: 15%" />
	2516	<col style="width: 13%" />
	2517	<col style="width: 13%" />
	2518	</colgroup>
	2519	<thead>
	2520	<tr class="header">
	2521	<th style="text-align: left;">Posteingangsserver</th>
	2522	<th style="text-align: left;">Postfach/Benutzer</th>
	2523	<th style="text-align: left;">Protokoll</th>
	2524	<th style="text-align: left;">STARTTLS</th>
	2525	<th style="text-align: left;">SSL/TLS</th>
	2526	</tr>
	2527	</thead>
	2528	<tbody>
	2529	<tr class="odd">
	2530	<td style="text-align: left;">xyz00.hostsharing.net</td>
	2531	<td style="text-align: left;">xyz00-mailbox</td>
	2532	<td style="text-align: left;">SMTP</td>
	2533	<td style="text-align: left;">Port 587 oder 25</td>
	2534	<td style="text-align: left;">Port 465</td>
	2535	</tr>
	2536	</tbody>
	2537	</table>
	2538	<p>Die Konfigurationsvariante SMTP über Port 587 mit STARTTLS wird
	2539	empfohlen.</p>
	2540	<p>Angaben für den Postausgangsserver für den Massenversand:</p>
	2541	<table>
	2542	<caption>Konfiguration Ausgangsserver Massenversand</caption>
	2543	<colgroup>
	2544	<col style="width: 31%" />
	2545	<col style="width: 26%" />
	2546	<col style="width: 15%" />
	2547	<col style="width: 13%" />
	2548	<col style="width: 13%" />
	2549	</colgroup>
	2550	<thead>
	2551	<tr class="header">
	2552	<th style="text-align: left;">Posteingangsserver</th>
	2553	<th style="text-align: left;">Postfach/Benutzer</th>
	2554	<th style="text-align: left;">Protokoll</th>
	2555	<th style="text-align: left;">STARTTLS</th>
	2556	<th style="text-align: left;">SSL/TLS</th>
	2557	</tr>
	2558	</thead>
	2559	<tbody>
	2560	<tr class="odd">
	2561	<td style="text-align: left;">xyz00.hostsharing.net</td>
	2562	<td style="text-align: left;">xyz00-mailbox</td>
	2563	<td style="text-align: left;">SMTP</td>
	2564	<td style="text-align: left;">Port 4587 oder 4025</td>
	2565	<td style="text-align: left;">Port 1465</td>
	2566	</tr>
	2567	</tbody>
	2568	</table>
	2569	<p>Die Konfigurationsvariante SMTP über Port 4587 mit STARTTLS wird
	2570	empfohlen.</p>
	2571	</section>
	2572	<section id="größenbeschränkung-einer-e-mail" class="level3">
	2573	<h3>Größenbeschränkung einer E-Mail</h3>
	2574	<p>Die E-Mail-Server akzeptieren E-Mails bis zu einer maximalen Größe
	2575	von 128 MB. Dateianhänge sollten daher die Größe von ca. 90 MB nicht
	2576	überschreiten. Allgemeine Informationen zur <a
	2577	href="https://wiki.hostsharing.net/index.php?title=Gr%C3%B6%C3%9Fenbeschr%C3%A4nkung_von_E-Mails">Größenbeschränkung
	2578	von E-Mails</a> im Wiki der Hostsharing-Mitglieder.</p>
	2579	</section>
	2580	<section id="e-mail-alias-und-paketnutzer" class="level3">
	2581	<h3>E-Mail-Alias und Paketnutzer</h3>
	2582	<p>Ein E-Mail-Alias ist eine E-Mail-Adresse zur Weiterleitung von
	2583	E-Mails.</p>
	2584	<p>Ein E-Mail-Alias in der E-Mail-Konfiguration hat Vorrang vor einem
	2585	Paketnutzer gleichen Namens. Implementiert der E-Mail-Alias eine
	2586	Weiterleitung, gehen in diesem Fall in der Mailbox des Paketnutzers
	2587	keine E-Mails ein.</p>
	2588	<!-- todo: Letzten Satz prüfen -->
	2589	</section>
	2590	<section id="webmail" class="level3">
	2591	<h3>Webmail</h3>
	2592	<p>Hostsharing betreibt eine zentrale <a
	2593	href="https://webmail.hostsharing.net">Webmail-Installation</a>.
	2594	Informationen zur Einrichtung sind im Wiki der Mitglieder unter <a
	2595	href="https://wiki.hostsharing.net/index.php?title=Webmail">Webmail</a>
	2596	zu finden.</p>
	2597	</section>
	2598	<section id="kap-ref-mailautoconfig" class="level3">
	2599	<h3>E-Mail Auto-Konfiguration</h3>
	2600	<p>Die Domain-Option <em>E-Mail Auto-Konfiguration</em> ermöglicht das
	2601	einfache Konfigurieren der E-Mail-Clients mit den Daten des
	2602	Posteingangs- und Postausgangsservers. Wird diese Domain-Option für
	2603	z.B. <code>example.com</code> aktiviert, und ist der E-Mail-Adresse
	2604	<code>fred@example.com</code> (evtl. nach mehreren Weiterleitungen)
	2605	bei Hostsharing genau ein Postfach zugeordnet, dann reicht es bei den
	2606	gängigsten E-Mail-Clients aus, zur Einrichtung des Postfaches die
	2607	E-Mail-Adresse und das jeweilige Passwort anzugeben. Die restlichen
	2608	Einstellungen (Server, Postfach/Benutzername, Protokoll, Port etc.)
	2609	werden automatisch durch den E-Mail-Client von Hostsharing abgerufen
	2610	und sodann automatisch konfiguriert.</p>
	2611	<p>Dies vereinfacht aus Nutzersicht die Einrichtung eines
	2612	Hostsharing-Postfaches im eigenen E-Mail-Client erheblich.</p>
	2613	<p>Das Verfahren kann aus mehreren Gründen scheitern:</p>
	2614	<ul>
	2615	<li>Der E-Mail-Client des Nutzers unterstützt ›autoconfig‹ und
	2616	›autodiscover‹ nicht. Thunderbird ab Version 3.1 und Outlook ab
	2617	Version 2007 sollten funktionieren.</li>
	2618	<li>Die Domain-Option E-Mail Auto-Konfiguration wurde erst
	2619	<em>nach</em> einem gescheiterten Konfigurationsversuch gesetzt (sie
	2620	sollte <em>vorher</em> gesetzt werden). Vor allem Microsoft-Produkte
	2621	cachen das Abfrageergebnis für eine E-Mail-Adresse ca. zwei Wochen in
	2622	einer Microsoft-Cloud, so dass weitere automatische
	2623	Konfigurationsversuche erst nach Ablauf dieser (langen) Zeit
	2624	erfolgreich sind. In diesem Fall hilft nur, die Einstellungen im
	2625	E-Mail-Client per Hand vorzunehmen.</li>
	2626	<li>In der Domain wird ein <em>eigenes</em> Zonenfile verwendet, in
	2627	dem die nötigen Einträge (<code>MAILSERVICES_RR</code> und
	2628	<code>AUTODISCOVER_RR</code>, siehe Abschnitt <a
	2629	href="#kap-ref-zonefile-platzhalter">Platzhalter</a> fehlen. Dann
	2630	müssen sie per Hand ergänzt werden.</li>
	2631	</ul>
	2632	</section>
	2633	</section>
	2634	<section id="kap-ref-db" class="level2">
	2635	<h2>Datenbanken</h2>
	2636	<p>Jeder Hive hat einen eigenen MySQL- und PostgreSQL-Datenbankserver.
	2637	Daraus ergibt sich, dass der jeweilige MySQL- und PostgreSQL-Server
	2638	von allen auf einem Hive eingerichteten Web-Paketen gemeinsam genutzt
	2639	wird.</p>
	2640	<p>Der externe Zugriff auf die Datenbanken ist über einen SSH-Tunnel
	2641	möglich.</p>
	2642	<section id="datenbanken-und-nutzer" class="level3">
	2643	<h3>Datenbanken und Nutzer</h3>
	2644	<p>Datenbanknutzer haben eine eigene Nutzerverwaltung und sind
	2645	unabhängig von der Vergabe von Rechten auf Betriebsystemebene.</p>
	2646	<section id="verwaltung-der-datenbanken-und-datenbanknutzer"
	2647	class="level4">
	2648	<h4>Verwaltung der Datenbanken und Datenbanknutzer</h4>
	2649	<p>Die Verwaltung von Datenbanken und Nutzern erfolgt mit HSAdmin über
	2650	ein Webfrontend oder über die <code>shell</code>.</p>
	2651	</section>
	2652	<section id="rechte" class="level4">
	2653	<h4>Rechte</h4>
	2654	<p>Datenbanknutzern müssen initial die gewünschten Rechte an den
	2655	entsprechenden Datenbanken vergeben werden.</p>
	2656	</section>
	2657	<section id="name" class="level4">
	2658	<h4>Name</h4>
	2659	<ul>
	2660	<li>Datenbanknutzer haben immer den Präfix <code>xyz00_</code>.</li>
	2661	<li>Datenbanken haben immer den Präfix <code>xyz00_</code>.</li>
	2662	</ul>
	2663	</section>
	2664	</section>
	2665	<section id="datenbankzugriff" class="level3">
	2666	<h3>Datenbankzugriff</h3>
	2667	<p>Der Zugriff erfolgt über folgende Hosts und Ports:</p>
	2668	<table>
	2669	<caption>Konfiguration Datenbankzugriff</caption>
	2670	<thead>
	2671	<tr class="header">
	2672	<th style="text-align: left;">Datenbank</th>
	2673	<th style="text-align: left;">Hostnamen</th>
	2674	<th style="text-align: left;">Port</th>
	2675	</tr>
	2676	</thead>
	2677	<tbody>
	2678	<tr class="odd">
	2679	<td style="text-align: left;">MySQL</td>
	2680	<td style="text-align: left;">localhost</td>
	2681	<td style="text-align: left;">3306</td>
	2682	</tr>
	2683	<tr class="even">
	2684	<td style="text-align: left;">PostgreSQL</td>
	2685	<td style="text-align: left;">localhost</td>
	2686	<td style="text-align: left;">5432</td>
	2687	</tr>
	2688	</tbody>
	2689	</table>
	2690	</section>
	2691	<section id="datenbank-webfrontend" class="level3">
	2692	<h3>Datenbank-Webfrontend</h3>
	2693	<p>Für angelegte Datenbanken stehen folgende Webfrontends zur
	2694	Verfügung:</p>
	2695	<ul>
	2696	<li><p>Für MySQL: <a
	2697	href="https://phpmyadmin.hostsharing.net/current">phpMyAdmin</a>.</p></li>
	2698	<li><p>Für PostgreSQL: <a
	2699	href="https://phppgadmin.hostsharing.net/current">phpPgAdmin</a>.</p></li>
	2700	</ul>
	2701	</section>
	2702	</section>
	2703	<section id="tls-zertifikate" class="level2">
	2704	<h2>TLS Zertifikate</h2>
	2705	<p>Transport Layer Security (TLS) ist ein Verschlüsselungsprotokoll
	2706	zur sicheren Datenübertragung im Internet. Die Vorgängerbezeichnung
	2707	lautete Secure Sockets Layer (SSL).</p>
	2708	<p>Beim Anlegen einer Domain in HSAdmin kann als Domain-Option ein
	2709	Let’s-Encrypt-Zertifikat erstellt werden (vgl. dazu die Abschnitte <a
	2710	href="#kap-hsadmin-domain-anlegen">Domain in HSAdmin anlegen</a> und
	2711	<a href="#kap-domain-optionen">Domain-Optionen</a>. Daten können so
	2712	ohne weitere Vorbereitung über HTTPS ausgeliefert werden.</p>
	2713	<section id="kap-tls-standardkonfiguration" class="level3">
	2714	<h3>Standardkonfiguration</h3>
	2715	<p>Pro aufgeschalteter Domain ist ein Zertifikat möglich .</p>
	2716	<p>TLS-Inhalte werden durch die Verzeichnisse</p>
	2717	<ul>
	2718	<li>cgi-ssl</li>
	2719	<li>fastcgi-ssl</li>
	2720	<li>htdocs-ssl</li>
	2721	</ul>
	2722	<p>von Nicht-TLS-Inhalten getrennt. Die Ordnerstruktur im Verzeichnis
	2723	eines Domain-Admin wird in Abschnitt <a
	2724	href="#kap-einstieg-ordnerstruktur">Ordnerstruktur</a>
	2725	beschrieben.</p>
	2726	</section>
	2727	<section id="mögliche-varianten" class="level3">
	2728	<h3>Mögliche Varianten</h3>
	2729	<section id="tls-seiten-und-nicht-tls-seiten-in-einem-verzeichnis"
	2730	class="level4">
	2731	<h4>TLS-Seiten und Nicht-TLS-Seiten in einem Verzeichnis</h4>
	2732	<p>Sollen TLS- und Nicht-TLS-Seiten innerhalb eines Verzeichnis
	2733	verwaltet werden, können die TLS-Verzeichnisse gelöscht und
	2734	symbolische Links auf Nicht-TLS Verzeichnisse angelegt werden. Dies
	2735	gilt selektiv auch für Unterverzeichnisse. Symbolische Links erlauben
	2736	es, Seiten mit und ohne TLS abzurufen.</p>
	2737	<!-- todo: Mit einem Beispiel erklären -->
	2738	</section>
	2739	<section id="automatisch-auf-tls" class="level4">
	2740	<h4>Automatisch auf TLS</h4>
	2741	<p>Soll nur auf bestimmten Seiten der Zugriff mit TLS erlaubt und
	2742	automatisch auf TLS umgeschaltet werden, muss dies in einer
	2743	entsprechenden .htaccess-Datei für die betroffenen Verzeichnisse
	2744	konfiguriert werden.</p>
	2745	<!-- todo: Mit einem Beispiel erklären -->
	2746	</section>
	2747	</section>
	2748	<section id="zertifikate-einer-zertifizierungsstelle" class="level3">
	2749	<h3>Zertifikate einer Zertifizierungsstelle</h3>
	2750	<p>Für die Installation eines Zertifikate einer Zertifizierungsstelle
	2751	muss der Paket-Admin einen ›Private Key‹ und einen CSR (Certificate
	2752	Signing Request) erzeugen. Die Vorgehensweise ist in der Regel auf den
	2753	Webseiten der Zertifizierungsstelle beschrieben. Weitere Hinweise sind
	2754	im Hostsharing Wiki unter <a
	2755	href="https://wiki.hostsharing.net/index.php?title=TLS_/_SSL">TLS/SSL</a>
	2756	beschrieben.</p>
	2757	<p>Für die Aktivierung des Zertifikates wird ein Auftrag an <a
	2758	href="mailto:service@hostsharing.net"
	2759	class="email">service@hostsharing.net</a> gesendet. Die Aktivierung
	2760	des Zertifikats durch den Service ist kostenpflichtig.</p>
	2761	<!-- Evtl. ausführlich beschreiben und aus Wiki übernehmen. -->
	2762	</section>
	2763	<section id="kap-le-einrichten" class="level3">
	2764	<h3>Let´s Encrypt einrichten</h3>
	2765	<p>Wenn Sie bei der Aufschaltung der Domain noch kein Let’s Encrypt
	2766	Zertifikat eingerichtet haben, können Sie dies nachträglich
	2767	erledigen.</p>
	2768	<p>Melden Sie sich mit dem Benutzernamen Ihres Paket-Admin beim
	2769	Webfrontend von HSAdmin unter <a href="https://admin.hostsharing.net"
	2770	class="uri">https://admin.hostsharing.net</a> an. Wählen Sie im linken
	2771	Feld den Eintrag <code>Web-Paket</code> aus. Im rechten Feld
	2772	aktivieren Sie den Reiter <code>Domain</code> und wählen anschließend
	2773	die Domain aus, für die Sie Let's Encrypt einrichten möchten.</p>
	2774	<p>Klicken Sie anschließend das Editier-Symbol
	2775	<code>Ausgewählten Eintrag bearbeiten</code>, um das Bearbeitungsmenü
	2776	zu öffnen:</p>
	2777	<figure>
	2778	<img src="images/hsadmin-domain-anlegen-2.jpg" style="width:100.0%"
	2779	alt="Domain in HSAdmin auswählen" />
	2780	<figcaption aria-hidden="true">Domain in HSAdmin
	2781	auswählen</figcaption>
	2782	</figure>
	2783	<p>Setzen Sie anschließend im Feld <code>Domain-Optionen</code> das
	2784	Häkchen bei <code>Let's Encrypt-Zertifikat</code>. Speichern Sie die
	2785	Einstellung mit einem Klick auf den Button <code>OK</code>.</p>
	2786	<figure>
	2787	<img src="images/hsadmin-domain-bearbeiten.jpg" style="width:100.0%"
	2788	alt="Das Bearbeitungsformular einer Domain" />
	2789	<figcaption aria-hidden="true">Das Bearbeitungsformular einer
	2790	Domain</figcaption>
	2791	</figure>
	2792	<p>Sie können jede Subdomain, für die ein Let’s-Encrypt-Zertifikat
	2793	erstellt werden soll, einzeln in der Liste
	2794	<code>gültige Subdomains</code> eintragen. Alternativ können Sie das
	2795	Wildcard-Symbol <code>*</code> benutzen; dann wird ein
	2796	Wildcard-Zertifikat ausgestellt, das für jede leichtgewichtige
	2797	Subdomain gültig ist. Für einzeln aufgeschaltete Subdomains müssen Sie
	2798	Let’s Encrypt gesondert aktivieren.</p>
	2799	<p>Bis zur Zertifizierung vergehen normalerweise nur 2-3 Minuten, es
	2800	kann jedoch auch bis zu 36 Std dauern.</p>
	2801	<p>Wenn die Domain oder Subdomain nicht bei Hostsharing verwaltet
	2802	wird, muss beim Domainverwalter eine Nameserver-Delegation auf die
	2803	drei DNS-Server von Hostsharing eingerichtet sein, damit
	2804	Let’s-Encrypt-Zertifikate genutzt werden können. Die Nameserver, die
	2805	an der entsprechenden Stelle eingetragen werden müssen, heißen
	2806	<code>dns1.hostsharing.net</code>, <code>dns2.hostsharing.net</code>
	2807	und <code>dns3.hostsharing.net</code>.</p>
	2808	</section>
	2809	<section id="filemapping-ohne-tls" class="level3">
	2810	<h3>Filemapping ohne TLS</h3>
	2811	<p>In der folgenden Grafik ist der Entscheidungsweg beschrieben, der
	2812	durchlaufen wird, um einem anfragenden Browser die richtige Datei
	2813	auszuliefern. TLS ist nicht aktiv.</p>
	2814	<figure>
	2815	<img src="images/filemap-ohne-tls.svg" style="width:100.0%"
	2816	alt="Mapping ohne TLS" />
	2817	<figcaption aria-hidden="true">Mapping ohne TLS</figcaption>
	2818	</figure>
	2819	<p>Zunächst wird für die Anfrage
	2820	<code>http://www.example.com/<path></code> der Virtual Host
	2821	gesucht, der zum FQDN (Fully Qualified Domain Name) passt.
	2822	Anschließend entscheiden folgende Fragen über den weiteren Verlauf des
	2823	Entscheidungswegs.</p>
	2824	<ol type="1">
	2825	<li><p>Starten wir mit cgi-bin?</p>
	2826	<ol type="a">
	2827	<li><p>Ja: Das Verzeichnis <code>cgi-bin</code> wird zum
	2828	Wurzelverzeichnis und eine passende Datei daraus wird
	2829	ausgeliefert.</p></li>
	2830	<li><p>Nein: Weiter zu Frage 2</p></li>
	2831	</ol></li>
	2832	<li><p>Starten wir mit fastcgi?</p>
	2833	<ol type="a">
	2834	<li><p>Ja: Das Verzeichnis <code>fastcgi</code> wird zum
	2835	Wurzelverzeichnis und eine passende Datei daraus wird
	2836	ausgeliefert.</p></li>
	2837	<li><p>Nein aber es gibt einen FQDN-Treffer, deshalb wird
	2838	<code>htdocs</code> zum Wurzelverzeichnis und eine passende Datei
	2839	daraus ausgeliefert. Ist das nicht der Fall geht es weiter zu Frage
	2840	3.</p></li>
	2841	</ol></li>
	2842	<li><p>Gibt es eine passende Sub-Domain?</p>
	2843	<ol type="a">
	2844	<li><p>Ja: Das Verzeichnis <code>subs</code> wird zum
	2845	Wurzelverzeichnis und eine passende Datei daraus wird
	2846	ausgeliefert.</p></li>
	2847	<li><p>Nein: Weiter zu Frage 4</p></li>
	2848	</ol></li>
	2849	<li><p>Ist das Verzeichnis <code>htdocs</code> als Fallback
	2850	konfiguriert?</p>
	2851	<ol type="a">
	2852	<li><p>Ja: Das Verzeichnis <code>htdocs</code> wird zum
	2853	Wurzelverzeichnis und eine passende Datei daraus
	2854	ausgeliefert.</p></li>
	2855	<li><p>Nein: Es wurde nichts gefunden. Wir liefern die Fehlermeldung
	2856	404 aus.</p></li>
	2857	</ol></li>
	2858	</ol>
	2859	</section>
	2860	<section id="filemapping-mit-tls" class="level3">
	2861	<h3>Filemapping mit TLS</h3>
	2862	<p>In der folgenden Grafik ist der Entscheidungsweg beschrieben, der
	2863	durchlaufen wird, um einem anfragenden Browser die richtige Datei
	2864	auszuliefern. Die Website wird über <code>https</code> aufgerufen,
	2865	sodass TLS aktiv ist.</p>
	2866	<figure>
	2867	<img src="images/filemap-mit-tls.svg" style="width:100.0%"
	2868	alt="Mapping mit TLS" />
	2869	<figcaption aria-hidden="true">Mapping mit TLS</figcaption>
	2870	</figure>
	2871	<p>Zunächst wird für die Anfrage
	2872	<code>https://www.example.com/<path></code> der Virtual Host
	2873	gesucht, der zum FQDN (Fully Qualified Domain Name) passt.
	2874	Anschließend entscheiden folgende Fragen über den weiteren Verlauf des
	2875	Entscheidungswegs.</p>
	2876	<ol type="1">
	2877	<li><p>Starten wir mit cgi-ssl?</p>
	2878	<ol type="a">
	2879	<li><p>Ja: Das Verzeichnis <code>cgi-ssl</code> wird zum
	2880	Wurzelverzeichnis und eine passende Datei daraus wird
	2881	ausgeliefert.</p></li>
	2882	<li><p>Nein: Weiter zu Frage 2</p></li>
	2883	</ol></li>
	2884	<li><p>Starten wir mit fastcgi-ssl?</p>
	2885	<ol type="a">
	2886	<li><p>Ja: Das Verzeichnis <code>fastcgi-ssl</code> wird zum
	2887	Wurzelverzeichnis und eine passende Datei daraus wird
	2888	ausgeliefert.</p></li>
	2889	<li><p>Nein aber es gibt einen FQDN-Treffer, deshalb wird
	2890	<code>htdocs-ssl</code> zum Wurzelverzeichnis und eine passende Datei
	2891	daraus ausgeliefert. Ist das nicht der Fall geht es weiter zu Frage
	2892	3.</p></li>
	2893	</ol></li>
	2894	<li><p>Gibt es eine passende Sub-Domain?</p>
	2895	<ol type="a">
	2896	<li><p>Ja: Das Verzeichnis <code>subs-ssl</code> wird zum
	2897	Wurzelverzeichnis und eine passende Datei daraus wird
	2898	ausgeliefert.</p></li>
	2899	<li><p>Nein: Weiter zu Frage 4</p></li>
	2900	</ol></li>
	2901	<li><p>Ist das Verzeichnis <code>htdocs-ssl</code> als Fallback
	2902	konfiguriert?</p>
	2903	<ol type="a">
	2904	<li><p>Ja: Das Verzeichnis <code>htdocs-ssl</code> wird zum
	2905	Wurzelverzeichnis und eine passende Datei daraus
	2906	ausgeliefert.</p></li>
	2907	<li><p>Nein: Es wurde nichts gefunden. Wir liefern die Fehlermeldung
	2908	404 aus.</p></li>
	2909	</ol></li>
	2910	</ol>
	2911	</section>
	2912	</section>
	2913	<section id="kap-ref-zonefile" class="level2">
	2914	<h2>Zonefile</h2>
	2915	<p>Das Zonefile enthält die Konfiguration des Domain Name Service
	2916	(DNS) einer Domain. Im Zonefile wird hinterlegt, welche Hostnamen
	2917	innerhalb einer Domain existieren, auf welche IP-Adressen diese zeigen
	2918	und welches Mailsystem für eine Domain zuständig ist. Das
	2919	Standardzonefile ist für jede Domain unter
	2920	<code>/etc/bind/pri.example.com</code> zu finden.</p>
	2921	<p>Es ist möglich, ein eigenes Zonefile für eine Domain einzusetzen.
	2922	Dabei können und sollen Platzhalter verwendet werden, die es
	2923	ermöglichen, einen jeweils spezifischen Teil eines Zonefile zu
	2924	ändern.</p>
	2925	<section id="das-expandierte-standardzonefile" class="level3">
	2926	<h3>Das expandierte Standardzonefile</h3>
	2927	<p>:</p>
	2928	<pre><code>$TTL 6H
	2929	example.com. IN SOA h00.hostsharing.net. hostmaster.hostsharing.net. (
	2930	1303649373 ; serial secs since Jan 1 1970
	2931	6H ; refresh (>=10000)
	2932	1H ; retry (>=1800)
	2933	1W ; expire
	2934	1H ; minimum
	2935	)
	2936
	2937	example.com. IN NS dns1.hostsharing.net.
	2938	example.com. IN NS dns2.hostsharing.net.
	2939	example.com. IN NS dns3.hostsharing.net.
	2940	example.com. IN MX 30 mailin1.hostsharing.net.
	2941	example.com. IN MX 30 mailin2.hostsharing.net.
	2942	example.com. IN MX 30 mailin3.hostsharing.net.
	2943	example.com. IN A 83.223.95.160
	2944	example.com. IN AAAA 2a01:37:1000::53df:5bfc:0
	2945	_imap._tcp.example.com. IN SRV 1 0 143 xyz00.hostsharing.net.
	2946	_imaps._tcp.example.com. IN SRV 2 0 993 xyz00.hostsharing.net.
	2947	_pop3._tcp.example.com. IN SRV 3 0 110 xyz00.hostsharing.net.
	2948	_pop3s._tcp.example.com. IN SRV 4 0 995 xyz00.hostsharing.net.
	2949	_submission._tcp.example.com. IN SRV 0 0 587 xyz00.hostsharing.net.
	2950	_autodiscover._tcp.example.com. IN SRV 0 0 443 example.com.
	2951	autodiscover.example.com. IN A 0.0.0.0
	2952	autodiscover.example.com. IN AAAA ::
	2953	example.com. IN TXT "v=spf1 include:spf.hostsharing.net ?all"
	2954	*.example.com. IN MX 30 mailin1.hostsharing.net.
	2955	*.example.com. IN MX 30 mailin2.hostsharing.net.
	2956	*.example.com. IN MX 30 mailin3.hostsharing.net.
	2957	*.example.com. IN A 83.223.95.160
	2958	*.example.com. IN AAAA 2a01:37:1000::53df:5bfc:0
	2959	*.example.com. IN TXT "v=spf1 include:spf.hostsharing.net ?all"</code></pre>
	2960	</section>
	2961	<section id="kap-ref-zonefile-platzhalter" class="level3">
	2962	<h3>Platzhalter</h3>
	2963	<pre><code>Platzhalter expandiert zu
	2964
	2965	{DEFAULT_ZONEFILE} {HEADER}
	2966	{SOA_RR}
	2967	{NS_RR}
	2968	{MX_RR}
	2969	{A_RR}
	2970	{AAAA_RR}
	2971	{MAILSERVICES_RR}
	2972	{AUTODISCOVER_RR}
	2973	{SPF_RR}
	2974	{DKIM_RR}
	2975	{WILDCARD_MX_RR}
	2976	{WILDCARD_A_RR}
	2977	{WILDCARD_AAAA_RR}
	2978	{WILDCARD_SPF_RR}
	2979
	2980	{HEADER} $TTL {TTL}
	2981
	2982	{SOA_RR} {DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
	2983	{SIO} ; serial secs since Jan 1 1970
	2984	{REFRESH} ; refresh (>=10000)
	2985	{RETRY} ; retry (>=1800)
	2986	{EXPIRE} ; expire
	2987	{MINIMUM} ; minimum
	2988	)
	2989
	2990	{NS_RR} {DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
	2991	{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
	2992	{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.
	2993
	2994	{MX_RR} {DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
	2995	{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
	2996	{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.
	2997
	2998	{A_RR} {DOM_HOSTNAME}. IN A {DOM_IP4NUMBER}
	2999
	3000	{AAAA_RR} {DOM_HOSTNAME}. IN AAAA {DOM_IP6NUMBER}
	3001
	3002
	3003	{MAILSERVICES_RR} _imap._tcp.{DOM_HOSTNAME}. IN SRV 1 0 143 {PAC_HOSTNAME}.
	3004	_imaps._tcp.{DOM_HOSTNAME}. IN SRV 2 0 993 {PAC_HOSTNAME}.
	3005	_pop3._tcp.{DOM_HOSTNAME}. IN SRV 3 0 110 {PAC_HOSTNAME}.
	3006	_pop3s._tcp.{DOM_HOSTNAME}. IN SRV 4 0 995 {PAC_HOSTNAME}.
	3007	_submission._tcp.{DOM_HOSTNAME}. IN SRV 0 0 587 {PAC_HOSTNAME}.
	3008
	3009	{AUTODISCOVER_RR} _autodiscover._tcp.{DOM_HOSTNAME}. IN SRV 0 0 443 {DOM_HOSTNAME}.
	3010	autodiscover.{DOM_HOSTNAME}. IN A 0.0.0.0
	3011	autodiscover.{DOM_HOSTNAME}. IN AAAA ::
	3012
	3013	{SPF_RR} {DOM_HOSTNAME}. IN TXT "v=spf1 include:spf.hostsharing.net -all"
	3014
	3015	{WILDCARD_MX_RR} *.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
	3016	*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
	3017	*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.
	3018
	3019	{WILDCARD_A_RR} *.{DOM_HOSTNAME}. IN A {DOM_IP4NUMBER}
	3020
	3021	{WILDCARD_AAAA_RR} *.{DOM_HOSTNAME}. IN AAAA {DOM_IP6NUMBER}
	3022
	3023	{WILDCARD_SPF_RR} *.{DOM_HOSTNAME}. IN TXT "v=spf1 include:spf.hostsharing.net ?all"
	3024
	3025	{DKIM_RR} default._domainkey IN TXT "v=DKIM1; h=sha256; k=rsa; s=email; p=MIIB..."
	3026
	3027	{TTL} 6H
	3028	{SOA_HOSTNAME} <HIVE>.hostsharing.net
	3029	{SOA_EMAIL} hostmaster.hostsharing.net
	3030	{SIO} <SEKUNDEN>
	3031	{REFRESH} 6H
	3032	{RETRY} 1H
	3033	{EXPIRE} 1W
	3034	{MINIMUM} 1H</code></pre>
	3035	<p>Folgende Werte werden von Hostsharing verwaltet:</p>
	3036	<p><code><SEKUNDEN></code> für die Anzahl der Sekunden, welche
	3037	seit dem 01.01.1970 vergangen sind</p>
	3038	<p><code><FQDN></code> für den vollständigen, qualifizierten
	3039	Domainnamen der Domain, z.B. <code>example.com</code></p>
	3040	<p><code><IPv4></code> für die der Domain zugewiesene
	3041	IPv4-Adresse</p>
	3042	<p><code><IPv6></code> für die der Domain zugewiesene
	3043	IPv6-Adresse</p>
	3044	<p><code><HIVE></code> für den Server, auf dem die Domain
	3045	gehostet ist, z.B. <code>h20</code></p>
	3046	<p><code><PAC></code> für das Paket, dem die Domain zugeordnet
	3047	ist, z.B. <code>xyz00</code></p>
	3048	</section>
	3049	<section id="expansion-der-platzhalter" class="level3">
	3050	<h3>Expansion der Platzhalter</h3>
	3051	<p>Der Platzhalter für das Gesamtzonefile {DEFAULT_ZONFILE} wird in
	3052	drei Schritten folgendermaßen expandiert. Zunächst werden die
	3053	komplexen Platzhalter ersetzt. :</p>
	3054	<pre><code>{DOM_HOSTNAME}. IN SOA {SOA_HOSTNAME}. {SOA_EMAIL}. (
	3055	{SIO} ; serial secs since Jan 1 1970
	3056	{REFRESH} ; refresh (>=10000)
	3057	{RETRY} ; retry (>=1800)
	3058	{EXPIRE} ; expire
	3059	{MINIMUM} ; minimum
	3060	)
	3061	{DOM_HOSTNAME}. IN NS {DNS1_HOSTNAME}.
	3062	{DOM_HOSTNAME}. IN NS {DNS2_HOSTNAME}.
	3063	{DOM_HOSTNAME}. IN NS {DNS3_HOSTNAME}.
	3064
	3065	{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
	3066	{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
	3067	{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.
	3068
	3069	{DOM_HOSTNAME}. IN A {DOM_IP4NUMBER}
	3070	{DOM_HOSTNAME}. IN AAAA {DOM_IP6NUMBER}
	3071
	3072	_imap._tcp.{DOM_HOSTNAME}. IN SRV 1 0 143 {PAC_HOSTNAME}.
	3073	_imaps._tcp.{DOM_HOSTNAME}. IN SRV 2 0 993 {PAC_HOSTNAME}.
	3074	_pop3._tcp.{DOM_HOSTNAME}. IN SRV 3 0 110 {PAC_HOSTNAME}.
	3075	_pop3s._tcp.{DOM_HOSTNAME}. IN SRV 4 0 995 {PAC_HOSTNAME}.
	3076	_submission._tcp.{DOM_HOSTNAME}. IN SRV 0 0 587 {PAC_HOSTNAME}.
	3077
	3078	_autodiscover._tcp.{DOM_HOSTNAME}. IN SRV 0 0 443 {DOM_HOSTNAME}.
	3079	autodiscover.{DOM_HOSTNAME}. IN A 0.0.0.0
	3080	autodiscover.{DOM_HOSTNAME}. IN AAAA ::
	3081
	3082	{DOM_HOSTNAME}. IN TXT "v=spf1 include:spf.hostsharing.net ?all"
	3083
	3084	*.{DOM_HOSTNAME}. IN MX 30 {MX1_HOSTNAME}.
	3085	*.{DOM_HOSTNAME}. IN MX 30 {MX2_HOSTNAME}.
	3086	*.{DOM_HOSTNAME}. IN MX 30 {MX3_HOSTNAME}.
	3087
	3088	*.{DOM_HOSTNAME}. IN A {DOM_IP4NUMBER}
	3089	*.{DOM_HOSTNAME}. IN AAAA {DOM_IP6NUMBER}
	3090
	3091	*.{DOM_HOSTNAME}. IN TXT "v=spf1 include:spf.hostsharing.net ?all"</code></pre>
	3092	<p>Anschließend werden die atomaren Platzhalter ersetzt. :</p>
	3093	<pre><code>$TTL 6H
	3094
	3095	<FQDN>. IN SOA <HIVE>.hostsharing.net. hostmaster.hostsharing.net. (
	3096	<SEKUNDEN> ; serial secs since Jan 1 1970
	3097	6H ; refresh (>=10000)
	3098	1H ; retry (>=1800)
	3099	1W ; expire
	3100	1H ; minimum
	3101	)
	3102
	3103	<FQDN>. IN NS dns1.hostsharing.net.
	3104	<FQDN>. IN NS dns2.hostsharing.net.
	3105	<FQDN>. IN NS dns3.hostsharing.net.
	3106
	3107	<FQDN>. IN MX 30 mail1.hostsharing.net.
	3108	<FQDN>. IN MX 30 mail2.hostsharing.net.
	3109	<FQDN>. IN MX 30 mail3.hostsharing.net.
	3110
	3111	_imap._tcp.<FQDN>. IN SRV 1 0 143 <PAC>.hostsharing.net.
	3112	_imaps._tcp.<FQDN>. IN SRV 2 0 993 <PAC>.hostsharing.net.
	3113	_pop3._tcp.<FQDN>. IN SRV 3 0 110 <PAC>.hostsharing.net.
	3114	_pop3s._tcp.<FQDN>. IN SRV 4 0 995 <PAC>.hostsharing.net.
	3115	_submission._tcp.<FQDN>. IN SRV 0 0 587 <PAC>.hostsharing.net.
	3116
	3117	_autodiscover._tcp.<FQDN>. IN SRV 0 0 443 <FQDN>.
	3118	autodiscover.<FQDN>. IN A 0.0.0.0
	3119	autodiscover.<FQDN>. IN AAAA \:\:
	3120
	3121	<FQDN>. IN A <IPv4>
	3122	<FQDN>. IN AAAA <IPv6>
	3123
	3124	<FQDN>. IN TXT "v=spf1 include:spf.hostsharing.net ?all"
	3125
	3126	*.<FQDN>. IN MX 30 mail1.hostsharing.net.
	3127	*.<FQDN>. IN MX 30 mail2.hostsharing.net.
	3128	*.<FQDN>. IN MX 30 mail3.hostsharing.net.
	3129
	3130	*.<FQDN>. IN A <IPv4>
	3131	*.<FQDN>. IN AAAA <IPv6>
	3132
	3133	*.<FQDN>. IN TXT "v=spf1 include:spf.hostsharing.net ?all"</code></pre>
	3134	</section>
	3135	<section id="eigenes-zonefile" class="level3">
	3136	<h3>Eigenes Zonefile</h3>
	3137	<p>Es kann für jede aufgeschaltete Domain jeweils ein eigenes
	3138	Zonefiles angelegt werden. In der Regel ist dies nur bei folgenden
	3139	Anforderungen notwendig:</p>
	3140	<ul>
	3141	<li>Webseiten zu einer Domain oder Sub-Domain bei einem anderen Hoster
	3142	oder auf einem eigenen Server anbieten</li>
	3143	<li>Dienste (z.B. E-Mail) bei einem anderen Anbieter betreiben</li>
	3144	</ul>
	3145	<p>In eigenen Zonefiles sollten Platzhalter verwendet werden. Diese
	3146	Platzhalter ermöglichen das Ändern der DNS-Konfiguration seitens
	3147	Hostsharing, ohne dass der Domain-Admin sein Zonefile anpassen muss.
	3148	Das Zonefile für die Domain <code>example.com</code> wird als im
	3149	Verzeichnis <code>~/doms/example.com/etc/</code> als Datei
	3150	<code>pri.example.com</code> abgelegt und einige Minuten nach dem
	3151	Speichern automatisch aktiv.</p>
	3152	<div class="warning">
	3153	<p>Das unsachgemäße Erstellen oder Fehler im eigenen Zonefile können
	3154	zur Nichterreichbarkeit der Domain und zum Verlust von E-Mails
	3155	führen!</p>
	3156	</div>
	3157	<p>Im Wiki der Mitglieder finden sich <a
	3158	href="https://wiki.hostsharing.net/index.php?title=Simple_Zonefile_Howto">Beispiele
	3159	für eigene Zonefiles</a>.</p>
	3160	</section>
	3161	<section id="kontrolle-der-änderungen" class="level3">
	3162	<h3>Kontrolle der Änderungen</h3>
	3163	<p>Durchgeführte Änderungen am Zonefile können mit Hilfe der Logdatei
	3164	named.log überprüft werden:</p>
	3165	<pre class="console"><code>$ tail -f /var/log/named/named.log
	3166	$ tail -f /var/log/named/named.log \| grep example.com</code></pre>
	3167	<p>Nach einer erfolgreichen Übertragung der DNS Zone zu den drei
	3168	DNS-Servern finden sich in der Log-Datei etwa die folgenden sechs
	3169	Zeilen:</p>
	3170	<pre class="console"><code>18-Dec-2019 12:06:27.997 info: client 83.223.95.201#53191 (example.com): transfer of 'example.com/IN': AXFR-style IXFR started (serial 1576667187)
	3171	18-Dec-2019 12:06:27.998 info: client 83.223.95.201#53191 (example.com): transfer of 'example.com/IN': AXFR-style IXFR ended
	3172	18-Dec-2019 12:06:28.517 info: client 83.223.78.230#37959 (example.com): transfer of 'example.com/IN': AXFR-style IXFR started (serial 1576667187)
	3173	18-Dec-2019 12:06:28.517 info: client 83.223.78.230#37959 (example.com): transfer of 'example.com/IN': AXFR-style IXFR ended
	3174	18-Dec-2019 12:06:28.568 info: client 176.9.242.51#40371 (example.com): transfer of 'example.com/IN': AXFR-style IXFR started (serial 1576667187)
	3175	18-Dec-2019 12:06:28.569 info: client 176.9.242.51#40371 (example.com): transfer of 'example.com/IN': AXFR-style IXFR ended</code></pre>
	3176	<p>Zur Überprüfung von Änderungen am Zonefile kann zusätzlich die
	3177	Seriennummer in den DNS-Servern mit der aktuellen Seriennummer im
	3178	Zonefile verglichen werden:</p>
	3179	<pre class="console"><code>$ dig -t SOA @dns1.hostsharing.net example.com
	3180	$ cat /etc/bind/pri.example.com</code></pre>
	3181	<p>Es findet sich jeweils die Seriennummer (im obigen Log-Auszug die
	3182	'1576667187') im SOA Record.</p>
	3183	</section>
	3184	<section id="eigenes-zonefile-deaktivieren" class="level3">
	3185	<h3>Eigenes Zonefile deaktivieren</h3>
	3186	<p>Im Verzeichnis <code>~/doms/example.com/etc/</code> das vorhandene
	3187	Zonefile (pri.example.com) leeren (0 Bytes). Das leere Zonefile wird
	3188	durch einen Robot gelöscht und es gilt das Standardzonefile.</p>
	3189	</section>
	3190	</section>
	3191	<section id="kap-hsadmin" class="level2">
	3192	<h2>HSAdmin</h2>
	3193	<p>HSAdmin ist ein Werkzeug zur Verwaltung von Nutzern,
	3194	E-Mail-Adressen, E-Mail-Aliases, Domains, Datenbanken und
	3195	Datenbank-Nutzern. Die Bedienung erfolgt über ein Webfrontend, das in
	3196	<code class="interpreted-text"
	3197	role="numref">kap-hsadmin-einstieg</code> vorgestellt wird.</p>
	3198	<p>In diesem Kapitel geht es um den HSAdmin-Client <code
	3199	class="interpreted-text" role="command">hsscript</code>, der in der
	3200	Konsole benutzt wird.</p>
	3201	<p>HSAdmin verfügt über folgende Module:</p>
	3202	<table>
	3203	<caption>Die Module von HSAdmin</caption>
	3204	<colgroup>
	3205	<col style="width: 25%" />
	3206	<col style="width: 75%" />
	3207	</colgroup>
	3208	<thead>
	3209	<tr class="header">
	3210	<th style="text-align: left;">Modul</th>
	3211	<th style="text-align: left;">Erläuterung</th>
	3212	</tr>
	3213	</thead>
	3214	<tbody>
	3215	<tr class="odd">
	3216	<td style="text-align: left;"><code>user</code></td>
	3217	<td style="text-align: left;">Modul zur Nutzerverwaltung</td>
	3218	</tr>
	3219	<tr class="even">
	3220	<td style="text-align: left;"><code>mysqldb</code></td>
	3221	<td style="text-align: left;">Modul zur Verwaltung von
	3222	MySQL-Datenbanken</td>
	3223	</tr>
	3224	<tr class="odd">
	3225	<td style="text-align: left;"><code>mysqluser</code></td>
	3226	<td style="text-align: left;">Modul zur Verwaltung vom
	3227	MySQL-Datenbanknutzern</td>
	3228	</tr>
	3229	<tr class="even">
	3230	<td style="text-align: left;"><code>postgresqldb</code></td>
	3231	<td style="text-align: left;">Modul zur Verwaltung von
	3232	PostgreSQL-Datenbanken</td>
	3233	</tr>
	3234	<tr class="odd">
	3235	<td style="text-align: left;"><code>postgresqluser</code></td>
	3236	<td style="text-align: left;">Modul zur Verwaltung von
	3237	PostgreSQL-Datenbanknutzern</td>
	3238	</tr>
	3239	<tr class="even">
	3240	<td style="text-align: left;"><code>emailaddress</code></td>
	3241	<td style="text-align: left;">Modul zur Verwaltung von
	3242	E-Mail-Adressen</td>
	3243	</tr>
	3244	<tr class="odd">
	3245	<td style="text-align: left;"><code>emailalias</code></td>
	3246	<td style="text-align: left;">Modul zur Verwaltung von
	3247	E-Mail-Aliasen</td>
	3248	</tr>
	3249	<tr class="even">
	3250	<td style="text-align: left;"><code>domain</code></td>
	3251	<td style="text-align: left;">Modul zur Verwaltung von Domains in
	3252	einem Web-Paket</td>
	3253	</tr>
	3254	<tr class="odd">
	3255	<td style="text-align: left;"><code>q</code></td>
	3256	<td style="text-align: left;">Modul zur Suche von Systemaufträgen von
	3257	HSAdmin</td>
	3258	</tr>
	3259	</tbody>
	3260	</table>
	3261	<p>Die HSAdmin-Module verfügen über folgenden Funktionen:</p>
	3262	<table>
	3263	<caption>Die Funktionen von HSAdmin</caption>
	3264	<thead>
	3265	<tr class="header">
	3266	<th style="text-align: left;">Funktion</th>
	3267	<th style="text-align: left;">Erläuterung</th>
	3268	</tr>
	3269	</thead>
	3270	<tbody>
	3271	<tr class="odd">
	3272	<td style="text-align: left;">search</td>
	3273	<td style="text-align: left;">suchen</td>
	3274	</tr>
	3275	<tr class="even">
	3276	<td style="text-align: left;">add</td>
	3277	<td style="text-align: left;">hinzufügen</td>
	3278	</tr>
	3279	<tr class="odd">
	3280	<td style="text-align: left;">update</td>
	3281	<td style="text-align: left;">aktualisieren</td>
	3282	</tr>
	3283	<tr class="even">
	3284	<td style="text-align: left;">remove</td>
	3285	<td style="text-align: left;">löschen</td>
	3286	</tr>
	3287	</tbody>
	3288	</table>
	3289	<section id="kap-hsadmin-syntax" class="level3">
	3290	<h3>Syntax</h3>
	3291	<p>Die Funktionen von HSAdmin können über das Kommandozeilenprogramm
	3292	<code>hsscript</code> aufgerufen werden, welches Befehle per
	3293	Parameter, Dateiübergabe oder interaktiv entgegennimmt. Der Aufruf
	3294	erfolgt nach folgender Syntax:</p>
	3295	<pre class="console"><code>$ hsscript -u <Benutzer> -e <Befehl>...</code></pre>
	3296	<p>Die folgenden Optionen können übergeben werden.</p>
	3297	<dl>
	3298	<dt><code>-u \--user</code></dt>
	3299	<dd>
	3300	<p>Benutzer, welcher zur Authentifizierung und Autorisierung verwendet
	3301	werden soll, zum Beispiel <code>xyz00</code>.</p>
	3302	</dd>
	3303	<dt><code>-r \--runas</code></dt>
	3304	<dd>
	3305	<p>Benutzer, mit dessen Rechten der Befehl ausgeführt werden soll, zum
	3306	Beispiel <code>xzy00-doms</code>.</p>
	3307	</dd>
	3308	<dt><code>-e \--expr</code></dt>
	3309	<dd>
	3310	<p>Der Befehl, der ausgeführt werden soll. Er setzt sich aus einer
	3311	Reihe von Parametern zusammen.</p>
	3312	</dd>
	3313	</dl>
	3314	<p>Der Befehl hat folgende Syntax:</p>
	3315	<pre><code>module.function({where:{field:'value',...}, set:{field:'value',...}}) </code></pre>
	3316	<table>
	3317	<caption>Die Parameter</caption>
	3318	<colgroup>
	3319	<col style="width: 20%" />
	3320	<col style="width: 79%" />
	3321	</colgroup>
	3322	<thead>
	3323	<tr class="header">
	3324	<th style="text-align: left;">Parameter</th>
	3325	<th style="text-align: left;">Erläuterung</th>
	3326	</tr>
	3327	</thead>
	3328	<tbody>
	3329	<tr class="odd">
	3330	<td style="text-align: left;">module</td>
	3331	<td style="text-align: left;">Modul, dessen Funktion aufgerufen werden
	3332	soll (z.B. <code>user</code> oder <code>mysqldb</code>)</td>
	3333	</tr>
	3334	<tr class="even">
	3335	<td style="text-align: left;">function</td>
	3336	<td style="text-align: left;">Funktion, welche aufgerufen werden soll
	3337	(<code>search</code>, <code>add</code>, <code>update</code>,
	3338	<code>remove</code>)</td>
	3339	</tr>
	3340	<tr class="odd">
	3341	<td style="text-align: left;">where</td>
	3342	<td style="text-align: left;">selektiert nach Wert eines oder mehrerer
	3343	Felder</td>
	3344	</tr>
	3345	<tr class="even">
	3346	<td style="text-align: left;">set</td>
	3347	<td style="text-align: left;">setzt oder aktualisiert den Wert eines
	3348	oder mehrerer Felder</td>
	3349	</tr>
	3350	</tbody>
	3351	</table>
	3352	<p>Die Module und Funktionen werden in den folgenden Kapiteln
	3353	erklärt.</p>
	3354	<dl>
	3355	<dt><code>-f \--file</code></dt>
	3356	<dd>
	3357	<p>Datei, aus welcher Befehle gelesen und ausgeführt werden sollen.
	3358	Lesen Sie dazu <code class="interpreted-text"
	3359	role="numref">kap-hsscript-skript</code>.</p>
	3360	</dd>
	3361	<dt><code>-i \--interactive</code></dt>
	3362	<dd>
	3363	<p>Das Programm startet im interaktiven Modus. Die Befehle können am
	3364	Kommandozeilen-Prompt eingegeben werden.</p>
	3365	</dd>
	3366	</dl>
	3367	</section>
	3368	<section id="kap-modul-user" class="level3">
	3369	<h3>Modul user</h3>
	3370	<section id="funktionen" class="level4">
	3371	<h4>Funktionen</h4>
	3372	<dl>
	3373	<dt><code>user.search</code></dt>
	3374	<dd>
	3375	<p>Suche Benutzer nach den im Befehlsausdruck angegebenen Feldern und
	3376	Werten</p>
	3377	</dd>
	3378	<dt><code>user.add</code></dt>
	3379	<dd>
	3380	<p>Füge einen neuen Benutzer nach den im Befehlsausdruck angegebenen
	3381	Feldern und Werten hinzu.</p>
	3382	</dd>
	3383	<dt><code>user.update</code></dt>
	3384	<dd>
	3385	<p>Aktualisiere einen Benutzer nach den im Befehlsausdruck angegebenen
	3386	Feldern und Werten.</p>
	3387	</dd>
	3388	<dt><code>user.remove</code></dt>
	3389	<dd>
	3390	<p>Lösche einen Benutzer nach den im Befehlsausdruck angegebenen
	3391	Feldern und Werten.</p>
	3392	</dd>
	3393	</dl>
	3394	</section>
	3395	<section id="editierbare-felder" class="level4">
	3396	<h4>Editierbare Felder</h4>
	3397	<p>Das HSAdmin-Modul <code>user</code> kann entsprechend der folgenden
	3398	Befehlssyntax von <code>HSAdmin</code> Felder setzen oder
	3399	verändern:</p>
	3400	<pre><code>user.function({where:{field:'value',...}, set:{field:'value',...}})</code></pre>
	3401	<p>Im Modul <code>user</code> stehen folgende Felder zur
	3402	Verfügung.</p>
	3403	<dl>
	3404	<dt><code>name</code></dt>
	3405	<dd>
	3406	<p>Benutzerkennung (z.B. xyz00-abc)</p>
	3407	</dd>
	3408	<dt><code>comment</code></dt>
	3409	<dd>
	3410	<p>Kommentar, in dem zum Beispiel die Funktion des Benutzers
	3411	beschrieben werden kann</p>
	3412	</dd>
	3413	<dt><code>password</code></dt>
	3414	<dd>
	3415	<p>Das Passwort</p>
	3416	</dd>
	3417	<dt><code>shell</code></dt>
	3418	<dd>
	3419	<p>Die zugewiesene Shell (z.B. <code>/bin/bash</code>)</p>
	3420	</dd>
	3421	<dt><code>quota_softlimit</code></dt>
	3422	<dd>
	3423	<p>Das zugewiesene Quota in Megabyte</p>
	3424	</dd>
	3425	<dt><code>quote_hardlimit</code></dt>
	3426	<dd>
	3427	<p>Grenze der Grace Period, bis zu der Überschreitungen des Softlimit
	3428	toleriert werden. Angabe in Megabyte</p>
	3429	</dd>
	3430	</dl>
	3431	</section>
	3432	<section id="beispiele" class="level4">
	3433	<h4>Beispiele</h4>
	3434	<p>In einer interaktiven Sitzung wird mit folgendem Befehl der neue
	3435	Benutzer <code>xyz00-mustermann</code> angelegt.</p>
	3436	<pre class="console"><code>xyz00@hsadmin> user.add ({set:{name:'xyz00-mustermann',comment:'Max Mustermann',password:'!1?2-3aBc',shell:'/bin/bash'}})</code></pre>
	3437	<p>Man kann alle Informationen zu einem Nutzer abfragen:</p>
	3438	<pre class="console"><code>xyz00@hsadmin> user.search ({where:{name:'xyz00-mustermann'}})</code></pre>
	3439	<p>Einstellungen können nachträglich verändert werden. Dafür wird der
	3440	Befehl <code>user.update</code> benutzt. Im Befehlsausdruck wird
	3441	zunächst mit <code>where</code> nach einem Datensatz gesucht, auf den
	3442	mit <code>set</code> die Veränderung angewendet wird. Im ersten
	3443	Beispiel wird für den Benutzer <code>xyz00-mustermann</code> ein neues
	3444	Passwort gesetzt. Im zweiten Beispiel bekommt der Benutzer eine andere
	3445	Shell zugewiesen und im dritten wird ein Quota gesetzt.</p>
	3446	<pre class="console"><code>xyz00@hsadmin> user.update ({where:{name:'xyz00-mustermann'},set:{password:'neues-passwort'}})
	3447	xyz00@hsadmin> user.update ({where:{name:'xyz00-mustermann'},set:{shell:'/bin/zsh'}})
	3448	xyz00@hsadmin> user.update ({where:{name:'xyz00-mustermann'},set:{quota_softlimit:'50',quota_hardlimit:'75'}})</code></pre>
	3449	<p>Natürlich können wir Benutzer mit Hilfe des Kommandozeilen-Tools
	3450	auch wieder entfernen. Im folgenden Beispiel wird der Benutzer
	3451	<code>xyz00-mustermann</code> mit dem Befehl <code>user.remove</code>
	3452	gelöscht.</p>
	3453	<pre class="console"><code>xyz00@hsadmin> user.remove ({where:{name:'xyz00-mustermann'}})</code></pre>
	3454	</section>
	3455	</section>
	3456	<section id="kap-modul-domain" class="level3">
	3457	<h3>Modul domain</h3>
	3458	<section id="funktionen" class="level4">
	3459	<h4>Funktionen</h4>
	3460	<dl>
	3461	<dt><code>domain.search</code></dt>
	3462	<dd>
	3463	<p>Suche Domain nach den im Befehlsausdruck angegebenen Feldern und
	3464	Werten</p>
	3465	</dd>
	3466	<dt><code>domain.add</code></dt>
	3467	<dd>
	3468	<p>Füge eine neue Domain nach den im Befehlsausdruck angegebenen
	3469	Feldern und Werten hinzu.</p>
	3470	</dd>
	3471	<dt><code>domain.update</code></dt>
	3472	<dd>
	3473	<p>Aktualisiere eine Domain nach den im Befehlsausdruck angegebenen
	3474	Feldern und Werten.</p>
	3475	</dd>
	3476	<dt><code>domain.remove</code></dt>
	3477	<dd>
	3478	<p>Lösche eine Domain nach den im Befehlsausdruck angegebenen Feldern
	3479	und Werten.</p>
	3480	</dd>
	3481	</dl>
	3482	</section>
	3483	<section id="editierbare-felder" class="level4">
	3484	<h4>Editierbare Felder</h4>
	3485	<p>Das HSAdmin-Modul <code>domain</code> kann entsprechend der
	3486	folgenden Befehlssyntax von <code>HSAdmin</code> Felder setzen oder
	3487	verändern:</p>
	3488	<pre><code>domain.function({where:{field:'value',...}, set:{field:'value',...}})</code></pre>
	3489	<p>Im Modul <code>domain</code> stehen folgende Felder zur
	3490	Verfügung.</p>
	3491	<dl>
	3492	<dt><code>name</code></dt>
	3493	<dd>
	3494	<p>Name einer Domain</p>
	3495	</dd>
	3496	<dt><code>user</code></dt>
	3497	<dd>
	3498	<p>Name des Domain-Admins</p>
	3499	</dd>
	3500	<dt><code>validsubdomainnames</code></dt>
	3501	<dd>
	3502	<p>leichtgewichtige Subdomains in diesem Virtual-Host des Webservers,
	3503	gültige Werte: <code>*</code> für beliebige Subdomains oder eine
	3504	kommaseparierte Liste: <code>www,blog,other</code></p>
	3505	</dd>
	3506	<dt><code>greylisting</code></dt>
	3507	<dd>
	3508	<p>E-Mails werden verzögert durch den Mailserver angenommen, siehe
	3509	<code>Greylisting</code>. Ist die Option deaktivert, werden E-Mails
	3510	ohne Verzögerung angenommen.</p>
	3511	</dd>
	3512	<dt><code>multiviews</code></dt>
	3513	<dd>
	3514	<p>Der Webserver berücksichtigt Einstellungen im Browser beim Abruf
	3515	einer Domain (z.B. eine bevorzugte Sprache). Die Option kann mit einer
	3516	<code>.htaccess</code>-Datei für jedes Verzeichnis konfiguriert
	3517	werden.</p>
	3518	</dd>
	3519	<dt><code>indexes</code></dt>
	3520	<dd>
	3521	<p>Der Webserver erzeugt für Verzeichnisse, die keine eigene
	3522	Index-Datei enthalten, eine Liste mit den im Verzeichnis enthaltenen
	3523	Dateien. Ist die Option deaktiviert, wird ein Fehler 303 ausgegeben.
	3524	Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis
	3525	konfiguriert werden.</p>
	3526	</dd>
	3527	<dt><code>htdocsfallback</code></dt>
	3528	<dd>
	3529	<p>Der Webserver leitet auf die Hauptdomain, wenn keine Sub-Domain
	3530	angelegt ist. Ist die Option deaktivert, wird ein Fehler 404
	3531	ausgegeben: Seite nicht gefunden.</p>
	3532	</dd>
	3533	<dt><code>includes</code></dt>
	3534	<dd>
	3535	<p>Der Webserver erkennt <code>SSI</code>-Komandos und -Dateien. Die
	3536	Option kann mit einer .htaccess-Datei für jedes Verzeichnis
	3537	konfiguriert werden.</p>
	3538	</dd>
	3539	<dt><code>backupmxforexternalmx</code></dt>
	3540	<dd>
	3541	<p>Der Paket-Hive wird als Weiterleitung (transport) beim
	3542	Mail-In-Server eingetragen. Ist die Option aktiv, ist der
	3543	Hostsharing-Mail-In-Server Backup-MX. Der eigentliche Mailserver
	3544	befindet sich außerhalb der Infrastruktur von Hostsharing (z.B.
	3545	anderer Provider, DSL-Anschluss mit fester IP)</p>
	3546	</dd>
	3547	<dt><code>letsencrypt</code></dt>
	3548	<dd>
	3549	<p>Es wird automatisch ein TLS Zertifikat für diese Domain und alle im
	3550	Feld „validsubdomainnames” angegebenen Subdomains erzeugt</p>
	3551	</dd>
	3552	<dt><code>autoconfig</code></dt>
	3553	<dd>
	3554	<p>Eine Unterstützung für die Konfiguration von E-Mail-Programmen
	3555	durch die Verfahren "Autoconfig" (Mozilla) und "Autodiscover"
	3556	(Microsoft) wird für die Domain eingeschaltet</p>
	3557	</dd>
	3558	</dl>
	3559	<p>::: note Die Option <code>backupmxforexternalmx</code> erfordert
	3560	Änderungen am <code class="interpreted-text"
	3561	role="doc">Zonefile<../zonefile/index></code> einer Domain.
	3562	:::</p>
	3563	</section>
	3564	<section id="beispiele" class="level4">
	3565	<h4>Beispiele</h4>
	3566	<p>Mit dem folgenden Befehl schalten wir die Domain
	3567	<code>hs-example.de</code> auf und ordnen Sie dem Domain-Admin
	3568	<code>xyz00-hsexample</code> zu.</p>
	3569	<pre class="console"><code>xyz00@hsadmin> domain.add({set:{name:'hs-example.de',user:'xyz00-hsexample'}})</code></pre>
	3570	<p>Mit dem Befehl <code>domain.search</code> werden alle Informationen
	3571	zu einer Domain angezeigt. Die gesuchte Domain wird mit dem
	3572	Befehlsausdruck <code>where</code> ausgewählt.</p>
	3573	<pre class="console"><code>xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})</code></pre>
	3574	<p>Und mit dem Befehl <code>domain.remove</code> können wir eine
	3575	Domain entfernen.</p>
	3576	<pre class="console"><code>xyz00@hsadmin> domain.remove({where:{name:'hs-example.de'}})</code></pre>
	3577	<p>Mit dem Befehl <code>domain.update</code> lassen sich die
	3578	Einstellungen für eine Domain verändern. Bei einer Änderung der
	3579	Domain-Optionen, wie im folgenden Beispiel, müssen immer alle Optionen
	3580	angegeben werden, die gesetzt sein sollen, da der Befehl die bereits
	3581	gesetzten Domain-Optionen komplett überschreibt.</p>
	3582	<pre class="console"><code>xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:['htdocsfallback','indexes','greylisting','letsencrypt','autoconfig']}})</code></pre>
	3583	</section>
	3584	</section>
	3585	<section id="kap-modul-mysqldb" class="level3">
	3586	<h3>Modul mysqldb</h3>
	3587	<section id="funktionen" class="level4">
	3588	<h4>Funktionen</h4>
	3589	<dl>
	3590	<dt><code>mysqldb.search</code></dt>
	3591	<dd>
	3592	<p>Suche Datenbank nach den im Befehlsausdruck angegebenen Feldern und
	3593	Werten</p>
	3594	</dd>
	3595	<dt><code>mysqldb.add</code></dt>
	3596	<dd>
	3597	<p>Füge eine neue Datenbank nach den im Befehlsausdruck angegebenen
	3598	Feldern und Werten hinzu.</p>
	3599	</dd>
	3600	<dt><code>mysqldb.update</code></dt>
	3601	<dd>
	3602	<p>Aktualisiere eine Datenbank nach den im Befehlsausdruck angegebenen
	3603	Feldern und Werten.</p>
	3604	</dd>
	3605	<dt><code>mysqldb.remove</code></dt>
	3606	<dd>
	3607	<p>Lösche eine Datenbank nach den im Befehlsausdruck angegebenen
	3608	Feldern und Werten.</p>
	3609	</dd>
	3610	</dl>
	3611	</section>
	3612	<section id="editierbare-felder" class="level4">
	3613	<h4>Editierbare Felder</h4>
	3614	<p>Das HSAdmin-Modul <code>mysqldb</code> kann entsprechend der
	3615	folgenden Befehlssyntax von <code>HSAdmin</code> Felder setzen oder
	3616	verändern:</p>
	3617	<pre><code>mysqldb.function({where:{field:'value',...}, set:{field:'value',...}})</code></pre>
	3618	<p>Im Modul <code>mysqldb</code> stehen folgende Felder zur
	3619	Verfügung.</p>
	3620	<dl>
	3621	<dt><code>name</code></dt>
	3622	<dd>
	3623	<p>Datenbankname (z.B. xyz00_abc)</p>
	3624	</dd>
	3625	<dt><code>owner</code></dt>
	3626	<dd>
	3627	<p>Datenbanknutzer (z.B. xyz00_owner)</p>
	3628	</dd>
	3629	<dt><code>encoding</code></dt>
	3630	<dd>
	3631	<p>Zeichensatz der Datenbank (Standard ist UTF-8)</p>
	3632	</dd>
	3633	</dl>
	3634	</section>
	3635	<section id="beispiele" class="level4">
	3636	<h4>Beispiele</h4>
	3637	<p>Im ersten Beispiel erzeugen wir eine Datenbank mit dem Namen
	3638	<code>xyz00_abc</code> und legen als Besitzer den Datenbanknutzer
	3639	<code>xyz00_owner</code> fest.</p>
	3640	<pre class="console"><code>xyz00@hsadmin> mysqldb.add ({set:{name:'xyz00_abc',owner:'xyz00_owner'}})</code></pre>
	3641	<p>Bevor man Änderungen an einem Datensatz vornimmt, kann man sich
	3642	alle Eigenschaften einer Datenbank mit dem Befehl
	3643	<code>mysqldb.search</code> anzeigen lassen. Die gewünschte Datenbank
	3644	wird mit dem Befehlsausdruck <code>where</code> ausgewählt.</p>
	3645	<pre class="console"><code>xyz00@hsadmin> mysqldb.search ({where:{name:'xyz00_abc'}})</code></pre>
	3646	<p>Und mit dem Befehl <code>mysqldb.remove</code> können Datenbanken
	3647	gelöscht werden. Die gewünschte Datenbank wird erneut mit dem
	3648	Befehlsausdruck <code>where</code> ausgewählt.</p>
	3649	<pre class="console"><code>xyz00@hsadmin> mysqldb.remove ({where:{name:'xyz00_abc'}})</code></pre>
	3650	</section>
	3651	</section>
	3652	<section id="kap-modul-mysqluser" class="level3">
	3653	<h3>Modul mysqluser</h3>
	3654	<section id="funktionen" class="level4">
	3655	<h4>Funktionen</h4>
	3656	<dl>
	3657	<dt><code>mysqluser.search</code></dt>
	3658	<dd>
	3659	<p>Suche Datenbank-Benutzer nach den im Befehlsausdruck angegebenen
	3660	Feldern und Werten</p>
	3661	</dd>
	3662	<dt><code>mysqluser.add</code></dt>
	3663	<dd>
	3664	<p>Füge einen neuen Datenbank-Benutzer nach den im Befehlsausdruck
	3665	angegebenen Feldern und Werten hinzu.</p>
	3666	</dd>
	3667	<dt><code>mysqluser.update</code></dt>
	3668	<dd>
	3669	<p>Aktualisiere einen Datenbank-Benutzer nach den im Befehlsausdruck
	3670	angegebenen Feldern und Werten.</p>
	3671	</dd>
	3672	<dt>`mysqluser.remove´</dt>
	3673	<dd>
	3674	<p>Lösche einen Datenbank-Benutzer nach den im Befehlsausdruck
	3675	angegebenen Feldern und Werten.</p>
	3676	</dd>
	3677	</dl>
	3678	</section>
	3679	<section id="editierbare-felder" class="level4">
	3680	<h4>Editierbare Felder</h4>
	3681	<p>Das HSAdmin-Modul <code>mysqluser</code> kann entsprechend der
	3682	folgenden Befehlssyntax von <code>HSAdmin</code> Felder setzen oder
	3683	verändern:</p>
	3684	<pre><code>mysqluser.function({where:{field:'value',...}, set:{field:'value',...}})</code></pre>
	3685	<p>Im Modul <code>mysqluser</code> stehen folgende Felder zur
	3686	Verfügung.</p>
	3687	<dl>
	3688	<dt><code>name</code></dt>
	3689	<dd>
	3690	<p>Name des Datenbank-Benutzers (z.B. <code>xyz00_owner</code>)</p>
	3691	</dd>
	3692	<dt><code>password</code></dt>
	3693	<dd>
	3694	<p>Passwort des Datenbank-Benutzers</p>
	3695	</dd>
	3696	</dl>
	3697	</section>
	3698	<section id="beispiele" class="level4">
	3699	<h4>Beispiele</h4>
	3700	<p>Im ersten Beispiel fügen wir dem System den Datenbank-Benutzer
	3701	<code>xyz00_owner</code> hinzu und geben ihm ein Passwort.</p>
	3702	<pre class="console"><code>xyz00@hsadmin> mysqluser.add({set:{name:'xyz00_owner',password:'!1?2-3aBc'}})</code></pre>
	3703	<p>In den folgenden beiden Beispielen lassen wir uns zunächst mit dem
	3704	Befehl <code>mysqluser.search</code> die Informationen zu einem
	3705	Benutzer anzeigen, den wir mit dem Befehlsausdruck <code>where</code>
	3706	auswählen. Anschließend entfernen wir diesen Nutzer mit dem Befehl
	3707	<code>mysqluser.remove</code>.</p>
	3708	<pre class="console"><code>xyz00@hsadmin> mysqluser.search({where:{name:'xyz00_owner'}})
	3709	xyz00@hsadmin> mysqluser.remove({where:{name:'xyz00_owner'}})</code></pre>
	3710	<p>Im letzten Beispiel aktualieren wir einen Benutzereintrag mit dem
	3711	Befehl <code>mysqluser.update</code>. Der Benutzer wird mit
	3712	<code>where</code> ausgesucht, anschließend bekommt er mit
	3713	<code>set</code> ein neues Passwort.</p>
	3714	<pre class="console"><code>xyz00@hsadmin> mysqluser.update({where:{name:'xyz00_owner'},set:{password:'neues-passwort'}})</code></pre>
	3715	</section>
	3716	</section>
	3717	<section id="kap-modul-postgresqldb" class="level3">
	3718	<h3>Modul postgresqldb</h3>
	3719	<section id="funktionen" class="level4">
	3720	<h4>Funktionen</h4>
	3721	<dl>
	3722	<dt><code>postgresqldb.search</code></dt>
	3723	<dd>
	3724	<p>Suche Datenbank nach den im Befehlsausdruck angegebenen Feldern und
	3725	Werten</p>
	3726	</dd>
	3727	<dt><code>postgresqldb.add</code></dt>
	3728	<dd>
	3729	<p>Füge eine neue Datenbank nach den im Befehlsausdruck angegebenen
	3730	Feldern und Werten hinzu.</p>
	3731	</dd>
	3732	<dt><code>postgresqldb.update</code></dt>
	3733	<dd>
	3734	<p>Aktualisiere eine Datenbank nach den im Befehlsausdruck angegebenen
	3735	Feldern und Werten.</p>
	3736	</dd>
	3737	<dt><code>postgresqldb.remove</code></dt>
	3738	<dd>
	3739	<p>Lösche eine Datenbank nach den im Befehlsausdruck angegebenen
	3740	Feldern und Werten.</p>
	3741	</dd>
	3742	</dl>
	3743	</section>
	3744	<section id="editierbare-felder" class="level4">
	3745	<h4>Editierbare Felder</h4>
	3746	<p>Das HSAdmin-Modul <code>postgresqldb</code> kann entsprechend der
	3747	folgenden Befehlssyntax von <code>HSAdmin</code> Felder setzen oder
	3748	verändern:</p>
	3749	<pre><code>postgresqldb.function({where:{field:'value',...}, set:{field:'value',...}})</code></pre>
	3750	<p>Im Modul <code>postgresqldb</code> stehen folgende Felder zur
	3751	Verfügung.</p>
	3752	<dl>
	3753	<dt><code>name</code></dt>
	3754	<dd>
	3755	<p>Datenbankname (z.B. xyz00_abc)</p>
	3756	</dd>
	3757	<dt><code>owner</code></dt>
	3758	<dd>
	3759	<p>Datenbanknutzer (z.B. xyz00_owner)</p>
	3760	</dd>
	3761	<dt><code>encoding</code></dt>
	3762	<dd>
	3763	<p>Zeichensatz der Datenbank (Standard ist UTF-8)</p>
	3764	</dd>
	3765	</dl>
	3766	</section>
	3767	<section id="beispiele" class="level4">
	3768	<h4>Beispiele</h4>
	3769	<p>Im ersten Beispiel erzeugen wir die Datenbank
	3770	<code>xyz00_abc</code> und übergeben ihr als Besitzer den
	3771	Datenbanknutzer <code>xyz00_owner</code>.</p>
	3772	<pre class="console"><code>xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_abc',owner:'xyz00_owner'}})</code></pre>
	3773	<p>Die den beiden folgenden Beispielen lassen wir uns zunächst mit
	3774	<code>postgresqldb.search</code> Informationen zur Datenbank
	3775	<code>xyz00_abc</code> anzeigen. Anschließend löschen wir sie mit
	3776	<code>postgresqldb.remove</code>.</p>
	3777	<pre class="console"><code>xyz00@hsadmin> postgresqldb.search({where:{name:'xyz00_abc'}})
	3778	xyz00@hsadmin> postgresqldb.remove({where:{name:'xyz00_abc'}})</code></pre>
	3779	</section>
	3780	</section>
	3781	<section id="kap-modul-postgresqluser" class="level3">
	3782	<h3>Modul postgresqluser</h3>
	3783	<section id="funktionen" class="level4">
	3784	<h4>Funktionen</h4>
	3785	<dl>
	3786	<dt><code>postgresqluser.search</code></dt>
	3787	<dd>
	3788	<p>Suche Datenbank-Benutzer nach den im Befehlsausdruck angegebenen
	3789	Feldern und Werten</p>
	3790	</dd>
	3791	<dt><code>postgresqluser.add</code></dt>
	3792	<dd>
	3793	<p>Füge einen neuen Datenbank-Benutzer nach den im Befehlsausdruck
	3794	angegebenen Feldern und Werten hinzu.</p>
	3795	</dd>
	3796	<dt><code>postgresqluser.update</code></dt>
	3797	<dd>
	3798	<p>Aktualisiere einen Datenbank-Benutzer nach den im Befehlsausdruck
	3799	angegebenen Feldern und Werten.</p>
	3800	</dd>
	3801	<dt><code>postgresqluser.remove</code></dt>
	3802	<dd>
	3803	<p>Lösche einen Datenbank-Benutzer nach den im Befehlsausdruck
	3804	angegebenen Feldern und Werten.</p>
	3805	</dd>
	3806	</dl>
	3807	</section>
	3808	<section id="editierbare-felder" class="level4">
	3809	<h4>Editierbare Felder</h4>
	3810	<p>Das HSAdmin-Modul <code>postgresqluser</code> kann entsprechend der
	3811	folgenden Befehlssyntax von <code>HSAdmin</code> Felder setzen oder
	3812	verändern:</p>
	3813	<pre><code>postgresqluser.function({where:{field:'value',...}, set:{field:'value',...}})</code></pre>
	3814	<p>Im Modul <code>postgresqluser</code> stehen folgende Felder zur
	3815	Verfügung.</p>
	3816	<dl>
	3817	<dt><code>name</code></dt>
	3818	<dd>
	3819	<p>Name des Datenbank-Benutzers (z.B. <code>xyz00_owner</code>)</p>
	3820	</dd>
	3821	<dt><code>password</code></dt>
	3822	<dd>
	3823	<p>Passwort des Datenbank-Benutzers</p>
	3824	</dd>
	3825	</dl>
	3826	</section>
	3827	<section id="beispiele" class="level4">
	3828	<h4>Beispiele</h4>
	3829	<p>Im ersten Beispiel fügen wir dem System den Datenbank-Benutzer
	3830	<code>xyz00_owner</code> hinzu und geben ihm ein Passwort.</p>
	3831	<pre class="console"><code>xyz00@hsadmin> postgresqluser.add ({set:{name:'xyz00_owner',password:'!1?2-3aBc'}})</code></pre>
	3832	<p>Mit <code>postgresqluser.search</code> können wir die Eigenschaften
	3833	eines Benutzers anzeigen. Der gewünschte Benutzer wird mit
	3834	<code>where</code> ausgewählt.</p>
	3835	<pre class="console"><code>xyz00@hsadmin> postgresqluser.search ({where:{name:'xyz00_owner'}})</code></pre>
	3836	<p>Mit <code>postgresqluser.update</code> können Eigenschaften eines
	3837	Benutzers verändert werden. Der gewünschte Benutzer wird mit