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 --&gt; Konto-Einstellungen</code>, um zu den
1565   Konto-Einstellungen zu gelangen. Anschließend klicken Sie auf das Menü
1566   <code>Konto-Aktionen --&gt; 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&#39;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 &lt;Mitglied&gt;</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/&lt;path&gt;</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/&lt;path&gt;</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 (&gt;=10000)
2932         1H              ; retry (&gt;=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     &quot;v=spf1 include:spf.hostsharing.net ?all&quot;
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     &quot;v=spf1 include:spf.hostsharing.net ?all&quot;</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 (&gt;=10000)
2985                                 {RETRY}     ; retry (&gt;=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  &quot;v=spf1 include:spf.hostsharing.net -all&quot;
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  &quot;v=spf1 include:spf.hostsharing.net ?all&quot;
3024
3025 {DKIM_RR}               default._domainkey  IN      TXT  &quot;v=DKIM1; h=sha256; k=rsa; s=email; p=MIIB...&quot;
3026
3027 {TTL}                   6H
3028 {SOA_HOSTNAME}          &lt;HIVE&gt;.hostsharing.net
3029 {SOA_EMAIL}             hostmaster.hostsharing.net
3030 {SIO}                   &lt;SEKUNDEN&gt;
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>&lt;SEKUNDEN&gt;</code> für die Anzahl der Sekunden, welche
3037   seit dem 01.01.1970 vergangen sind</p>
3038   <p><code>&lt;FQDN&gt;</code> für den vollständigen, qualifizierten
3039   Domainnamen der Domain, z.B. <code>example.com</code></p>
3040   <p><code>&lt;IPv4&gt;</code> für die der Domain zugewiesene
3041   IPv4-Adresse</p>
3042   <p><code>&lt;IPv6&gt;</code> für die der Domain zugewiesene
3043   IPv6-Adresse</p>
3044   <p><code>&lt;HIVE&gt;</code> für den Server, auf dem die Domain
3045   gehostet ist, z.B. <code>h20</code></p>
3046   <p><code>&lt;PAC&gt;</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 (&gt;=10000)
3057         {RETRY}     ; retry (&gt;=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 &quot;v=spf1 include:spf.hostsharing.net ?all&quot;
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 &quot;v=spf1 include:spf.hostsharing.net ?all&quot;</code></pre>
3092   <p>Anschließend werden die atomaren Platzhalter ersetzt. :</p>
3093   <pre><code>$TTL 6H
3094
3095 &lt;FQDN&gt;. IN SOA &lt;HIVE&gt;.hostsharing.net. hostmaster.hostsharing.net. (
3096         &lt;SEKUNDEN&gt;  ; serial secs since Jan 1 1970
3097         6H      ; refresh (&gt;=10000)
3098         1H      ; retry (&gt;=1800)
3099         1W      ; expire
3100         1H      ; minimum
3101         )
3102
3103 &lt;FQDN&gt;.     IN  NS  dns1.hostsharing.net.
3104 &lt;FQDN&gt;.     IN  NS  dns2.hostsharing.net.
3105 &lt;FQDN&gt;.     IN  NS  dns3.hostsharing.net.
3106
3107 &lt;FQDN&gt;.     IN  MX  30 mail1.hostsharing.net.
3108 &lt;FQDN&gt;.     IN  MX  30 mail2.hostsharing.net.
3109 &lt;FQDN&gt;.     IN  MX  30 mail3.hostsharing.net.
3110
3111 _imap._tcp.&lt;FQDN&gt;.          IN  SRV 1 0 143 &lt;PAC&gt;.hostsharing.net.
3112 _imaps._tcp.&lt;FQDN&gt;.         IN  SRV 2 0 993 &lt;PAC&gt;.hostsharing.net.
3113 _pop3._tcp.&lt;FQDN&gt;.          IN  SRV 3 0 110 &lt;PAC&gt;.hostsharing.net.
3114 _pop3s._tcp.&lt;FQDN&gt;.         IN  SRV 4 0 995 &lt;PAC&gt;.hostsharing.net.
3115 _submission._tcp.&lt;FQDN&gt;.    IN  SRV 0 0 587 &lt;PAC&gt;.hostsharing.net.
3116
3117 _autodiscover._tcp.&lt;FQDN&gt;.  IN  SRV 0 0 443 &lt;FQDN&gt;.
3118 autodiscover.&lt;FQDN&gt;.        IN  A   0.0.0.0
3119 autodiscover.&lt;FQDN&gt;.        IN  AAAA    \:\:
3120
3121 &lt;FQDN&gt;.     IN  A   &lt;IPv4&gt;
3122 &lt;FQDN&gt;.     IN  AAAA    &lt;IPv6&gt;
3123
3124 &lt;FQDN&gt;.     IN  TXT &quot;v=spf1 include:spf.hostsharing.net ?all&quot;
3125
3126 *.&lt;FQDN&gt;.   IN  MX  30 mail1.hostsharing.net.
3127 *.&lt;FQDN&gt;.   IN  MX  30 mail2.hostsharing.net.
3128 *.&lt;FQDN&gt;.   IN  MX  30 mail3.hostsharing.net.
3129
3130 *.&lt;FQDN&gt;.   IN  A   &lt;IPv4&gt;
3131 *.&lt;FQDN&gt;.   IN  AAAA    &lt;IPv6&gt;
3132
3133 *.&lt;FQDN&gt;.   IN  TXT &quot;v=spf1 include:spf.hostsharing.net ?all&quot;</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 &#39;example.com/IN&#39;: 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 &#39;example.com/IN&#39;: AXFR-style IXFR ended
3172 18-Dec-2019 12:06:28.517 info: client 83.223.78.230#37959 (example.com): transfer of &#39;example.com/IN&#39;: 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 &#39;example.com/IN&#39;: AXFR-style IXFR ended
3174 18-Dec-2019 12:06:28.568 info: client 176.9.242.51#40371 (example.com): transfer of &#39;example.com/IN&#39;: 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 &#39;example.com/IN&#39;: 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 &lt;Benutzer&gt; -e &lt;Befehl&gt;...</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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}}) </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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}})</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&gt; user.add ({set:{name:&#39;xyz00-mustermann&#39;,comment:&#39;Max Mustermann&#39;,password:&#39;!1?2-3aBc&#39;,shell:&#39;/bin/bash&#39;}})</code></pre>
3437   <p>Man kann alle Informationen zu einem Nutzer abfragen:</p>
3438   <pre class="console"><code>xyz00@hsadmin&gt; user.search ({where:{name:&#39;xyz00-mustermann&#39;}})</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&gt; user.update ({where:{name:&#39;xyz00-mustermann&#39;},set:{password:&#39;neues-passwort&#39;}})
3447 xyz00@hsadmin&gt; user.update ({where:{name:&#39;xyz00-mustermann&#39;},set:{shell:&#39;/bin/zsh&#39;}})
3448 xyz00@hsadmin&gt; user.update ({where:{name:&#39;xyz00-mustermann&#39;},set:{quota_softlimit:&#39;50&#39;,quota_hardlimit:&#39;75&#39;}})</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&gt; user.remove ({where:{name:&#39;xyz00-mustermann&#39;}})</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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}})</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&lt;../zonefile/index&gt;</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&gt; domain.add({set:{name:&#39;hs-example.de&#39;,user:&#39;xyz00-hsexample&#39;}})</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&gt; domain.search({where:{name:&#39;hs-example.de&#39;}})</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&gt; domain.remove({where:{name:&#39;hs-example.de&#39;}})</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&gt; domain.update({where:{name:&#39;hs-example.de&#39;},set:{domainoptions:[&#39;htdocsfallback&#39;,&#39;indexes&#39;,&#39;greylisting&#39;,&#39;letsencrypt&#39;,&#39;autoconfig&#39;]}})</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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}})</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&gt; mysqldb.add ({set:{name:&#39;xyz00_abc&#39;,owner:&#39;xyz00_owner&#39;}})</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&gt; mysqldb.search ({where:{name:&#39;xyz00_abc&#39;}})</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&gt; mysqldb.remove ({where:{name:&#39;xyz00_abc&#39;}})</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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}})</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&gt; mysqluser.add({set:{name:&#39;xyz00_owner&#39;,password:&#39;!1?2-3aBc&#39;}})</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&gt; mysqluser.search({where:{name:&#39;xyz00_owner&#39;}})
3709 xyz00@hsadmin&gt; mysqluser.remove({where:{name:&#39;xyz00_owner&#39;}})</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&gt; mysqluser.update({where:{name:&#39;xyz00_owner&#39;},set:{password:&#39;neues-passwort&#39;}})</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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}})</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&gt; postgresqldb.add({set:{name:&#39;xyz00_abc&#39;,owner:&#39;xyz00_owner&#39;}})</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&gt; postgresqldb.search({where:{name:&#39;xyz00_abc&#39;}})
3778 xyz00@hsadmin&gt; postgresqldb.remove({where:{name:&#39;xyz00_abc&#39;}})</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:&#39;value&#39;,...}, set:{field:&#39;value&#39;,...}})</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&gt; postgresqluser.add ({set:{name:&#39;xyz00_owner&#39;,password:&#39;!1?2-3aBc&#39;}})</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&gt; postgresqluser.search ({where:{name:&#39;xyz00_owner&#39;}})</code></pre>
3836   <p>Mit <code>postgresqluser.update</code> können Eigenschaften eines
3837   Benutzers verändert werden. Der gewünschte Benutzer wird mit
3838   <code>where</code> ausgewählt. Anschliend wird in unserem Beispiel mit
3839<