Hostsharing Wiki - Benutzerbeiträge [de]

Stretch

2018-06-22T21:54:39Z

Hsh00-uwe:

== Upgrade auf Debian Stretch ==

In ersten und zweinten Quartal führt das Hostsharing-Team die vorbereitenden Arbeiten für das Upgrade
der Hostsharing-Server auf Debian Stretch (Debian 9.x) durch.

Während der Vorbereitungen werden wir die Mitglieder und Nutzer.innen unserer Plattform
auf dieser Wiki-Seite über unsere Erfahrungen informieren.

Ende Juni wird auf dieser Seite dokumentiert sein, welche Änderungen durch das Upgrade
notwendig werden und welche Vorbereitungen die Nutzer.innen treffen sollten.

Das Upgrade der Webspaces und Managed Server wird im Juni 2018 beginnen.

Folgende Software ist insbesondere betroffen:

== MySQL wird ersetzt durch MariaDB ==

=== Ersatz durch MariaDB ===

Mit dem Upgrade wird der Datenbankserver Mysql durch den MariaDB Server in der Version 10.1 ersetzt. MariaDB ist in Zukunft die Standard-MySQL-Variante in Debian.

Es sind aus der Sicht von Applikationen keine Inkompatibilitäten zwischen MariaDB Server 10.1 und Mysql Server 5.5 bekannt.
Der Ersatz sollte damit keine Probleme bereiten.

=== Sehr alte MySQL Passworte ===

Bereits mit MySQL Version 4.1 wurde ein neues Hashverfahren für die Passworte der MySQL-User eingeführt. Schon seit längerer Zeit verwenden wir bei Hostsharing das neue Hashverfahren. Passworte der MySQL-User werden mit HSAdmin im "neuen" Hashverfahren gespeichert. Es kann jedoch sein, dass in alten Paketen noch MySQL-User mit einem alten 16-Bytes-Password existieren.

Mit dem Upgrade werden neuere MySQL-Client-Bibliothen verwendet, die teilweise das alte Passwort-Format nicht mehr unterstützen. Das kann insbesondere PHP-Anwendungen betreffen. Das Problem wird gelöst, indem das Passwort der MySQL-User mit HSAdmin neu definiert wird.

Unsere Empfehlung ist, das bekannte Passwort '''vor''' dem Upgrade neu zu setzen.

Für Freunde der Konsole mit hsscript:

<pre>
mysqluser.update({where:{name:'xyz00_example'},set:{password:'geheim'}})
</pre>
(Dokumentation zu hsscript: https://doc.hostsharing.net/users/administration/hsadmin/index.html )

oder im Webfrontend unter https://admin.hostsharing.net , unter der Paketkennung xyz00 und MySQL-User.

In seltenen Ausnahmefällen kann es vorkommen, dass mit sehr alten MySQL-Clients auf die Datenbanken zugegriffen werden soll und dass diese MySQL-Clients das aktuelle Passwort-Format nicht unterstützen. In diesem Fall kann die MySQL-Funktion "OLD_PASSWORD" benutzt werden, um ein Passwort im alten Format zu erzeugen. Siehe dazu: https://mariadb.com/kb/en/library/set-password/

== PHP Update auf Version 7.0 ==

Mit dem Upgrade wird die Version von PHP von 5.6 auf 7.0 angehoben. Ohne weitere Aktion werden die PHP-Anwendungen nach dem Upgrade mit PHP 7.0 laufen.

Um für die Anpassung der gehosteten PHP-Anwendungen eine Übergangszeit anzubieten,
werden wir es ermöglichen über eine Domain-Option PHP pro Domain wieder auf PHP 5.6
zurückzusetzen. Die Domain-Optionen erreicht man, wenn man sich als Paket-Administrator (5-stellige Userkennung der Form "xyz00") oder Hostsharing-Mitglied (3-stellige Userkennung der Form "xyz") in HSAdmin unter [https://admin.hostsharing.net] anmeldet. Dort wählt man links den Bereich der Web-Pakete aus und im Bereich das Paket, das die Domain enthält. Im rechten Bereich oben wählt man dann Domains und in der Tabelle die gewünschte Domain. Mit dem "edit"-Icon rechts oben kann dann der Dialog zum Ändern der Domain-Optionen aufgerufen werden.

PHP 5.6 wird maximal bis Ende 2018 zur Verfügung stehen. Danach endet die Unterstützung dieser Version durch die PHP-Entwickler.

== Java Update auf Version 8.0 ==

In Debian 9 ist Java 8 als Java-Virtuelle-Maschine enthalten. Die vorhandenen Java 7-Pakete aus Debian 8 werden mit dem Upgrade deinstalliert.

Nutzer von Java-Anwendugnen auf den Hostsharing-Servern sollten vor dem Upgrade ihre Anwendungen so umstellen, dass die Anwendungen mit dem bereits seit längerem installierten Java 8 aus den Debian Backports laufen.

Ähnlich verhält es sich mit dem Debian-seitig installierten Apache Tomcat: Tomcat in der Version 7 entfällt. Auf unseren Servern ist neben Tomcat 7 auch Tomcat 8 installiert. Bitte alle Webanwendungen, die den zentral installierten Tomcat nutzen auf die Tomcat 8-Installation umstellen. Tomcat 8 wird im Zuge des Upgrades auf Tomcat 8.5 angehoben.

== Perl==

Es scheint mit der neuen Perl Version nicht mehr standardmäßig das aktuelle Verzeichnis für Module ausgelesen zu werden.
Deshalb kann es ggf. notwendig sein in den Perl-Scripten ein

<pre>
use lib '.';
</pre>

einzufügen.

== Update des OpenSSH Servers ==
DSA-Keys sind standardmäßig deaktiviert und werden seitens Hostsharing aus Sicherheitsgründen nicht aktiviert.
DSA-Keys gelten als unsicher und sollten daher nicht verwendet werden.
Ein Login unter der Verwendung von DSA-Keys ist nach dem Upgrade auf Debian Stretch nicht mehr möglich.

Es sollte geprüft werden, ob DSA-Keys verwendet werden. Dies erkennt man z.B. daran, das am Anfang der Datei des öffentlichen Schlüssels "ssh-dsa" steht.

Werden noch DSA-Keys verwendet, muss zwingend ein neuer Schlüssel wie folgt erstellt werden:

'''Für Freunde der Kommandozeile unter Linux'''

Neuen Key erzeugen:
<pre>
ssh-keygen -t rsa -b 4096
</pre>
Kopieren des öffentlichen Schlüssels auf den Server:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00@xyz00.hostsharing.de
</pre>
oder als Domainadmin:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00-ich@xyz00.hostsharing.de
</pre>

'''Für Windows:'''

PuttyGen, das bei der Intallation von Putty in der Regel mit installiert wird:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

erzeugt einen neuen Schlüssel.
Es sollte ein Schlüssel des Typs "SSH2-RSA" generiert werden.

----
[[Kategorie:Upgrade Jessie zu Stretch]]
[[Kategorie:Glossar]]

Stretch

2018-06-19T21:21:48Z

Hsh00-uwe: /* Java Update auf Version 8.0 */

== Upgrade auf Debian Stretch ==

In ersten und zweinten Quartal führt das Hostsharing-Team die vorbereitenden Arbeiten für das Upgrade
der Hostsharing-Server auf Debian Stretch (Debian 9.x) durch.

Während der Vorbereitungen werden wir die Mitglieder und Nutzer.innen unserer Plattform
auf dieser Wiki-Seite über unsere Erfahrungen informieren.

Ende Juni wird auf dieser Seite dokumentiert sein, welche Änderungen durch das Upgrade
notwendig werden und welche Vorbereitungen die Nutzer.innen treffen sollten.

Das Upgrade der Webspaces und Managed Server wird im Juni 2018 beginnen.

Folgende Software ist insbesondere betroffen:

== MySQL wird ersetzt durch MariaDB ==

=== Ersatz durch MariaDB ===

Mit dem Upgrade wird der Datenbankserver Mysql durch den MariaDB Server in der Version 10.1 ersetzt. MariaDB ist in Zukunft die Standard-MySQL-Variante in Debian.

Es sind aus der Sicht von Applikationen keine Inkompatibilitäten zwischen MariaDB Server 10.1 und Mysql Server 5.5 bekannt.
Der Ersatz sollte damit keine Probleme bereiten.

=== Sehr alte MySQL Passworte ===

Bereits mit MySQL Version 4.1 wurde ein neues Hashverfahren für die Passworte der MySQL-User eingeführt. Schon seit längerer Zeit verwenden wir bei Hostsharing das neue Hashverfahren. Passworte der MySQL-User werden mit HSAdmin im "neuen" Hashverfahren gespeichert. Es kann jedoch sein, dass in alten Paketen noch MySQL-User mit einem alten 16-Bytes-Password existieren.

Mit dem Upgrade werden neuere MySQL-Client-Bibliothen verwendet, die teilweise das alte Passwort-Format nicht mehr unterstützen. Das kann insbesondere PHP-Anwendungen betreffen. Das Problem wird gelöst, indem das Passwort der MySQL-User mit HSAdmin neu definiert wird.

Unsere Empfehlung ist, das bekannte Passwort '''vor''' dem Upgrade neu zu setzen.

Für Freunde der Konsole mit hsscript:

<pre>
mysqluser.update({where:{name:'xyz00_example'},set:{password:'geheim'}})
</pre>
(Dokumentation zu hsscript: https://doc.hostsharing.net/users/administration/hsadmin/index.html )

oder im Webfrontend unter https://admin.hostsharing.net , unter der Paketkennung xyz00 und MySQL-User.

In seltenen Ausnahmefällen kann es vorkommen, dass mit sehr alten MySQL-Clients auf die Datenbanken zugegriffen werden soll und dass diese MySQL-Clients das aktuelle Passwort-Format nicht unterstützen. In diesem Fall kann die MySQL-Funktion "OLD_PASSWORD" benutzt werden, um ein Passwort im alten Format zu erzeugen. Siehe dazu: https://mariadb.com/kb/en/library/set-password/

== PHP Update auf Version 7.0 ==

Mit dem Upgrade wird die Version von PHP von 5.6 auf 7.0 angehoben. Ohne weitere Aktion werden die PHP-Anwendungen nach dem Upgrade mit PHP 7.0 laufen.

Um für die Anpassung der gehosteten PHP-Anwendungen eine Übergangszeit anzubieten,
werden wir es ermöglichen über eine Domain-Option PHP pro Domain wieder auf PHP 5.6
zurückzusetzen. Die Domain-Optionen erreicht man, wenn man sich als Paket-Administrator (5-stellige Userkennung der Form "xyz00") oder Hostsharing-Mitglied (3-stellige Userkennung der Form "xyz") in HSAdmin unter [https://admin.hostsharing.net] anmeldet. Dort wählt man links den Bereich der Web-Pakete aus und im Bereich das Paket, das die Domain enthält. Im rechten Bereich oben wählt man dann Domains und in der Tabelle die gewünschte Domain. Mit dem "edit"-Icon rechts oben kann dann der Dialog zum Ändern der Domain-Optionen aufgerufen werden.

PHP 5.6 wird maximal bis Ende 2018 zur Verfügung stehen. Danach endet die Unterstützung dieser Version durch die PHP-Entwickler.

== Java Update auf Version 8.0 ==

In Debian 9 ist Java 8 als Java-Virtuelle-Maschine enthalten. Die vorhandenen Java 7-Pakete aus Debian 8 werden mit dem Upgrade deinstalliert.

Nutzer von Java-Anwendugnen auf den Hostsharing-Servern sollten vor dem Upgrade ihre Anwendungen so umstellen, dass die Anwendungen mit dem bereits seit längerem installierten Java 8 aus den Debian Backports laufen.

Ähnlich verhält es sich mit dem Debian-seitig installierten Apache Tomcat: Tomcat in der Version 7 entfällt. Auf unseren Servern ist neben Tomcat 7 auch Tomcat 8 installiert. Bitte alle Webanwendungen, die den zentral installierten Tomcat nutzen auf die Tomcat 8-Installation umstellen. Tomcat 8 wird im Zuge des Upgrades auf Tomcat 8.5 angehoben.

== Update des OpenSSH Servers ==
DSA-Keys sind standardmäßig deaktiviert und werden seitens Hostsharing aus Sicherheitsgründen nicht aktiviert.
DSA-Keys gelten als unsicher und sollten daher nicht verwendet werden.
Ein Login unter der Verwendung von DSA-Keys ist nach dem Upgrade auf Debian Stretch nicht mehr möglich.

Es sollte geprüft werden, ob DSA-Keys verwendet werden. Dies erkennt man z.B. daran, das am Anfang der Datei des öffentlichen Schlüssels "ssh-dsa" steht.

Werden noch DSA-Keys verwendet, muss zwingend ein neuer Schlüssel wie folgt erstellt werden:

'''Für Freunde der Kommandozeile unter Linux'''

Neuen Key erzeugen:
<pre>
ssh-keygen -t rsa -b 4096
</pre>
Kopieren des öffentlichen Schlüssels auf den Server:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00@xyz00.hostsharing.de
</pre>
oder als Domainadmin:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00-ich@xyz00.hostsharing.de
</pre>

'''Für Windows:'''

PuttyGen, das bei der Intallation von Putty in der Regel mit installiert wird:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

erzeugt einen neuen Schlüssel.
Es sollte ein Schlüssel des Typs "SSH2-RSA" generiert werden.

----
[[Kategorie:Upgrade Jessie zu Stretch]]
[[Kategorie:Glossar]]

Stretch

2018-06-19T21:19:30Z

Hsh00-uwe: /* Sehr alte MySQL Passworte */

== Upgrade auf Debian Stretch ==

In ersten und zweinten Quartal führt das Hostsharing-Team die vorbereitenden Arbeiten für das Upgrade
der Hostsharing-Server auf Debian Stretch (Debian 9.x) durch.

Während der Vorbereitungen werden wir die Mitglieder und Nutzer.innen unserer Plattform
auf dieser Wiki-Seite über unsere Erfahrungen informieren.

Ende Juni wird auf dieser Seite dokumentiert sein, welche Änderungen durch das Upgrade
notwendig werden und welche Vorbereitungen die Nutzer.innen treffen sollten.

Das Upgrade der Webspaces und Managed Server wird im Juni 2018 beginnen.

Folgende Software ist insbesondere betroffen:

== MySQL wird ersetzt durch MariaDB ==

=== Ersatz durch MariaDB ===

Mit dem Upgrade wird der Datenbankserver Mysql durch den MariaDB Server in der Version 10.1 ersetzt. MariaDB ist in Zukunft die Standard-MySQL-Variante in Debian.

Es sind aus der Sicht von Applikationen keine Inkompatibilitäten zwischen MariaDB Server 10.1 und Mysql Server 5.5 bekannt.
Der Ersatz sollte damit keine Probleme bereiten.

=== Sehr alte MySQL Passworte ===

Bereits mit MySQL Version 4.1 wurde ein neues Hashverfahren für die Passworte der MySQL-User eingeführt. Schon seit längerer Zeit verwenden wir bei Hostsharing das neue Hashverfahren. Passworte der MySQL-User werden mit HSAdmin im "neuen" Hashverfahren gespeichert. Es kann jedoch sein, dass in alten Paketen noch MySQL-User mit einem alten 16-Bytes-Password existieren.

Mit dem Upgrade werden neuere MySQL-Client-Bibliothen verwendet, die teilweise das alte Passwort-Format nicht mehr unterstützen. Das kann insbesondere PHP-Anwendungen betreffen. Das Problem wird gelöst, indem das Passwort der MySQL-User mit HSAdmin neu definiert wird.

Unsere Empfehlung ist, das bekannte Passwort '''vor''' dem Upgrade neu zu setzen.

Für Freunde der Konsole mit hsscript:

<pre>
mysqluser.update({where:{name:'xyz00_example'},set:{password:'geheim'}})
</pre>
(Dokumentation zu hsscript: https://doc.hostsharing.net/users/administration/hsadmin/index.html )

oder im Webfrontend unter https://admin.hostsharing.net , unter der Paketkennung xyz00 und MySQL-User.

In seltenen Ausnahmefällen kann es vorkommen, dass mit sehr alten MySQL-Clients auf die Datenbanken zugegriffen werden soll und dass diese MySQL-Clients das aktuelle Passwort-Format nicht unterstützen. In diesem Fall kann die MySQL-Funktion "OLD_PASSWORD" benutzt werden, um ein Passwort im alten Format zu erzeugen. Siehe dazu: https://mariadb.com/kb/en/library/set-password/

== PHP Update auf Version 7.0 ==

Mit dem Upgrade wird die Version von PHP von 5.6 auf 7.0 angehoben. Ohne weitere Aktion werden die PHP-Anwendungen nach dem Upgrade mit PHP 7.0 laufen.

Um für die Anpassung der gehosteten PHP-Anwendungen eine Übergangszeit anzubieten,
werden wir es ermöglichen über eine Domain-Option PHP pro Domain wieder auf PHP 5.6
zurückzusetzen. Die Domain-Optionen erreicht man, wenn man sich als Paket-Administrator (5-stellige Userkennung der Form "xyz00") oder Hostsharing-Mitglied (3-stellige Userkennung der Form "xyz") in HSAdmin unter [https://admin.hostsharing.net] anmeldet. Dort wählt man links den Bereich der Web-Pakete aus und im Bereich das Paket, das die Domain enthält. Im rechten Bereich oben wählt man dann Domains und in der Tabelle die gewünschte Domain. Mit dem "edit"-Icon rechts oben kann dann der Dialog zum Ändern der Domain-Optionen aufgerufen werden.

PHP 5.6 wird maximal bis Ende 2018 zur Verfügung stehen. Danach endet die Unterstützung dieser Version durch die PHP-Entwickler.

== Java Update auf Version 8.0 ==

In Debian 9 ist Java 8 als Java-Virtuelle-Maschine enthalten. Die vorhandenen Java 7-Pakete aus Debian 8 werden mit dem Upgrade deinstalliert.

Nutzer von Java-Anwendugnen auf den Hostsharing-Servern sollten vor dem Upgrade ihr Anwendungen so umstellen, dass die Anwendungen mit dem bereits seit längerem installierten Java 8 aus den Debian Backports laufen.

Ähnlich verhält es sich mit dem Debian-seitig installierten Apache Tomcat: Tomcat in der Version 7 entfällt. Auf unseren Servern ist neben Tomcat 7 auch Tomcat 8 installiert. Bitte alle Webanwendungen, die den zentral installierten Tomcat nutzen auf die Tomcat 8-Installation umstellen. Tomcat 8 wird im Zuge des Upgrades auf Tomcat 8.5 angehoben.

== Update des OpenSSH Servers ==
DSA-Keys sind standardmäßig deaktiviert und werden seitens Hostsharing aus Sicherheitsgründen nicht aktiviert.
DSA-Keys gelten als unsicher und sollten daher nicht verwendet werden.
Ein Login unter der Verwendung von DSA-Keys ist nach dem Upgrade auf Debian Stretch nicht mehr möglich.

Es sollte geprüft werden, ob DSA-Keys verwendet werden. Dies erkennt man z.B. daran, das am Anfang der Datei des öffentlichen Schlüssels "ssh-dsa" steht.

Werden noch DSA-Keys verwendet, muss zwingend ein neuer Schlüssel wie folgt erstellt werden:

'''Für Freunde der Kommandozeile unter Linux'''

Neuen Key erzeugen:
<pre>
ssh-keygen -t rsa -b 4096
</pre>
Kopieren des öffentlichen Schlüssels auf den Server:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00@xyz00.hostsharing.de
</pre>
oder als Domainadmin:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00-ich@xyz00.hostsharing.de
</pre>

'''Für Windows:'''

PuttyGen, das bei der Intallation von Putty in der Regel mit installiert wird:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

erzeugt einen neuen Schlüssel.
Es sollte ein Schlüssel des Typs "SSH2-RSA" generiert werden.

----
[[Kategorie:Upgrade Jessie zu Stretch]]
[[Kategorie:Glossar]]

Stretch

2018-06-19T21:18:42Z

Hsh00-uwe: /* Sehr alte MySQL Passworte */

== Upgrade auf Debian Stretch ==

In ersten und zweinten Quartal führt das Hostsharing-Team die vorbereitenden Arbeiten für das Upgrade
der Hostsharing-Server auf Debian Stretch (Debian 9.x) durch.

Während der Vorbereitungen werden wir die Mitglieder und Nutzer.innen unserer Plattform
auf dieser Wiki-Seite über unsere Erfahrungen informieren.

Ende Juni wird auf dieser Seite dokumentiert sein, welche Änderungen durch das Upgrade
notwendig werden und welche Vorbereitungen die Nutzer.innen treffen sollten.

Das Upgrade der Webspaces und Managed Server wird im Juni 2018 beginnen.

Folgende Software ist insbesondere betroffen:

== MySQL wird ersetzt durch MariaDB ==

=== Ersatz durch MariaDB ===

Mit dem Upgrade wird der Datenbankserver Mysql durch den MariaDB Server in der Version 10.1 ersetzt. MariaDB ist in Zukunft die Standard-MySQL-Variante in Debian.

Es sind aus der Sicht von Applikationen keine Inkompatibilitäten zwischen MariaDB Server 10.1 und Mysql Server 5.5 bekannt.
Der Ersatz sollte damit keine Probleme bereiten.

=== Sehr alte MySQL Passworte ===

Bereits mit MySQL Version 4.1 wurde ein neues Hashverfahren für die Passworte der MySQL-User eingeführt. Schon seit längerer Zeit verwenden wir bei Hostsharing das neue Hashverfahren. Passworte der MySQL-User werden mit HSAdmin im "neuen" Hashverfahren gespeichert. Es kann jedoch sein, dass in alten Paketen noch MySQL-User mit einem alten 16-Bytes-Password existieren.

Mit dem Upgrade werden neuere MySQL-Client-Bibliothen verwendet, die teilweise das alte Passwort-Format nicht mehr unterstützen. Das kann insbesondere PHP-Anwendungen betreffen. Das Problem wird gelöst, indem das Passwort der MySQL-User mit HSAdmin neu definiert wird.

Unsere Empfehlung ist, das bekannte Passwort '''vor''' dem Upgrade neu zu setzen.

Für Freunde der Konsole mit hsscript:

<pre>
mysqluser.update({where:{name:'xyzXY_example'},set:{password:'geheim'}})
</pre>
(Dokumentation zu hsscript: https://doc.hostsharing.net/users/administration/hsadmin/index.html )

oder im Webfrontend unter https://admin.hostsharing.net , unter der Paketkennung xyzXY und MySQL-User.

In seltenen Ausnahmefällen kann es vorkommen, dass mit sehr alten MySQL-Clients auf die Datenbanken zugegriffen werden soll und dass diese MySQL-Clients das aktuelle Passwort-Format nicht unterstützen. In diesem Fall kann die MySQL-Funktion "OLD_PASSWORD" benutzt werden, um ein Passwort im alten Format zu erzeugen. Siehe dazu: https://mariadb.com/kb/en/library/set-password/

== PHP Update auf Version 7.0 ==

Mit dem Upgrade wird die Version von PHP von 5.6 auf 7.0 angehoben. Ohne weitere Aktion werden die PHP-Anwendungen nach dem Upgrade mit PHP 7.0 laufen.

Um für die Anpassung der gehosteten PHP-Anwendungen eine Übergangszeit anzubieten,
werden wir es ermöglichen über eine Domain-Option PHP pro Domain wieder auf PHP 5.6
zurückzusetzen. Die Domain-Optionen erreicht man, wenn man sich als Paket-Administrator (5-stellige Userkennung der Form "xyz00") oder Hostsharing-Mitglied (3-stellige Userkennung der Form "xyz") in HSAdmin unter [https://admin.hostsharing.net] anmeldet. Dort wählt man links den Bereich der Web-Pakete aus und im Bereich das Paket, das die Domain enthält. Im rechten Bereich oben wählt man dann Domains und in der Tabelle die gewünschte Domain. Mit dem "edit"-Icon rechts oben kann dann der Dialog zum Ändern der Domain-Optionen aufgerufen werden.

PHP 5.6 wird maximal bis Ende 2018 zur Verfügung stehen. Danach endet die Unterstützung dieser Version durch die PHP-Entwickler.

== Java Update auf Version 8.0 ==

In Debian 9 ist Java 8 als Java-Virtuelle-Maschine enthalten. Die vorhandenen Java 7-Pakete aus Debian 8 werden mit dem Upgrade deinstalliert.

Nutzer von Java-Anwendugnen auf den Hostsharing-Servern sollten vor dem Upgrade ihr Anwendungen so umstellen, dass die Anwendungen mit dem bereits seit längerem installierten Java 8 aus den Debian Backports laufen.

Ähnlich verhält es sich mit dem Debian-seitig installierten Apache Tomcat: Tomcat in der Version 7 entfällt. Auf unseren Servern ist neben Tomcat 7 auch Tomcat 8 installiert. Bitte alle Webanwendungen, die den zentral installierten Tomcat nutzen auf die Tomcat 8-Installation umstellen. Tomcat 8 wird im Zuge des Upgrades auf Tomcat 8.5 angehoben.

== Update des OpenSSH Servers ==
DSA-Keys sind standardmäßig deaktiviert und werden seitens Hostsharing aus Sicherheitsgründen nicht aktiviert.
DSA-Keys gelten als unsicher und sollten daher nicht verwendet werden.
Ein Login unter der Verwendung von DSA-Keys ist nach dem Upgrade auf Debian Stretch nicht mehr möglich.

Es sollte geprüft werden, ob DSA-Keys verwendet werden. Dies erkennt man z.B. daran, das am Anfang der Datei des öffentlichen Schlüssels "ssh-dsa" steht.

Werden noch DSA-Keys verwendet, muss zwingend ein neuer Schlüssel wie folgt erstellt werden:

'''Für Freunde der Kommandozeile unter Linux'''

Neuen Key erzeugen:
<pre>
ssh-keygen -t rsa -b 4096
</pre>
Kopieren des öffentlichen Schlüssels auf den Server:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00@xyz00.hostsharing.de
</pre>
oder als Domainadmin:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00-ich@xyz00.hostsharing.de
</pre>

'''Für Windows:'''

PuttyGen, das bei der Intallation von Putty in der Regel mit installiert wird:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

erzeugt einen neuen Schlüssel.
Es sollte ein Schlüssel des Typs "SSH2-RSA" generiert werden.

----
[[Kategorie:Upgrade Jessie zu Stretch]]
[[Kategorie:Glossar]]

Stretch

2018-06-19T21:18:19Z

Hsh00-uwe: /* Sehr alte MySQL Passworte */

== Upgrade auf Debian Stretch ==

In ersten und zweinten Quartal führt das Hostsharing-Team die vorbereitenden Arbeiten für das Upgrade
der Hostsharing-Server auf Debian Stretch (Debian 9.x) durch.

Während der Vorbereitungen werden wir die Mitglieder und Nutzer.innen unserer Plattform
auf dieser Wiki-Seite über unsere Erfahrungen informieren.

Ende Juni wird auf dieser Seite dokumentiert sein, welche Änderungen durch das Upgrade
notwendig werden und welche Vorbereitungen die Nutzer.innen treffen sollten.

Das Upgrade der Webspaces und Managed Server wird im Juni 2018 beginnen.

Folgende Software ist insbesondere betroffen:

== MySQL wird ersetzt durch MariaDB ==

=== Ersatz durch MariaDB ===

Mit dem Upgrade wird der Datenbankserver Mysql durch den MariaDB Server in der Version 10.1 ersetzt. MariaDB ist in Zukunft die Standard-MySQL-Variante in Debian.

Es sind aus der Sicht von Applikationen keine Inkompatibilitäten zwischen MariaDB Server 10.1 und Mysql Server 5.5 bekannt.
Der Ersatz sollte damit keine Probleme bereiten.

=== Sehr alte MySQL Passworte ===

Bereits mit MySQL Version 4.1 wurde ein neues Hashverfahren für die Passworte der MySQL-User eingeführt. Schon seit längerer Zeit verwenden wir bei Hostsharing das neue Hashverfahren. Passworte der MySQL-User werden mit HSAdmin im "neuen" Hashverfahren gespeichert. Es kann jedoch sein, dass in alten Paketen noch MySQL-User mit einem alten 16-Bytes-Password existieren.

Mit dem Upgrade werden neuere MySQL-Client-Bibliothen verwendet, die teilweise das alte Passwort-Format nicht mehr unterstützen. Das kann insbesondere PHP-Anwendungen betreffen. Das Problem wird gelöst, indem das Passwort der MySQL-User mit HSAdmin neu definiert wird.
Unsere Empfehlung ist, das bekannte Passwort '''vor''' dem Upgrade neu zu setzen.

Für Freunde der Konsole mit hsscript:

<pre>
mysqluser.update({where:{name:'xyzXY_example'},set:{password:'geheim'}})
</pre>
(Dokumentation zu hsscript: https://doc.hostsharing.net/users/administration/hsadmin/index.html )

oder im Webfrontend unter https://admin.hostsharing.net , unter der Paketkennung xyzXY und MySQL-User.

In seltenen Ausnahmefällen kann es vorkommen, dass mit sehr alten MySQL-Clients auf die Datenbanken zugegriffen werden soll und dass diese MySQL-Clients das aktuelle Passwort-Format nicht unterstützen. In diesem Fall kann die MySQL-Funktion "OLD_PASSWORD" benutzt werden, um ein Passwort im alten Format zu erzeugen. Siehe dazu: https://mariadb.com/kb/en/library/set-password/

== PHP Update auf Version 7.0 ==

Mit dem Upgrade wird die Version von PHP von 5.6 auf 7.0 angehoben. Ohne weitere Aktion werden die PHP-Anwendungen nach dem Upgrade mit PHP 7.0 laufen.

Um für die Anpassung der gehosteten PHP-Anwendungen eine Übergangszeit anzubieten,
werden wir es ermöglichen über eine Domain-Option PHP pro Domain wieder auf PHP 5.6
zurückzusetzen. Die Domain-Optionen erreicht man, wenn man sich als Paket-Administrator (5-stellige Userkennung der Form "xyz00") oder Hostsharing-Mitglied (3-stellige Userkennung der Form "xyz") in HSAdmin unter [https://admin.hostsharing.net] anmeldet. Dort wählt man links den Bereich der Web-Pakete aus und im Bereich das Paket, das die Domain enthält. Im rechten Bereich oben wählt man dann Domains und in der Tabelle die gewünschte Domain. Mit dem "edit"-Icon rechts oben kann dann der Dialog zum Ändern der Domain-Optionen aufgerufen werden.

PHP 5.6 wird maximal bis Ende 2018 zur Verfügung stehen. Danach endet die Unterstützung dieser Version durch die PHP-Entwickler.

== Java Update auf Version 8.0 ==

In Debian 9 ist Java 8 als Java-Virtuelle-Maschine enthalten. Die vorhandenen Java 7-Pakete aus Debian 8 werden mit dem Upgrade deinstalliert.

Nutzer von Java-Anwendugnen auf den Hostsharing-Servern sollten vor dem Upgrade ihr Anwendungen so umstellen, dass die Anwendungen mit dem bereits seit längerem installierten Java 8 aus den Debian Backports laufen.

Ähnlich verhält es sich mit dem Debian-seitig installierten Apache Tomcat: Tomcat in der Version 7 entfällt. Auf unseren Servern ist neben Tomcat 7 auch Tomcat 8 installiert. Bitte alle Webanwendungen, die den zentral installierten Tomcat nutzen auf die Tomcat 8-Installation umstellen. Tomcat 8 wird im Zuge des Upgrades auf Tomcat 8.5 angehoben.

== Update des OpenSSH Servers ==
DSA-Keys sind standardmäßig deaktiviert und werden seitens Hostsharing aus Sicherheitsgründen nicht aktiviert.
DSA-Keys gelten als unsicher und sollten daher nicht verwendet werden.
Ein Login unter der Verwendung von DSA-Keys ist nach dem Upgrade auf Debian Stretch nicht mehr möglich.

Es sollte geprüft werden, ob DSA-Keys verwendet werden. Dies erkennt man z.B. daran, das am Anfang der Datei des öffentlichen Schlüssels "ssh-dsa" steht.

Werden noch DSA-Keys verwendet, muss zwingend ein neuer Schlüssel wie folgt erstellt werden:

'''Für Freunde der Kommandozeile unter Linux'''

Neuen Key erzeugen:
<pre>
ssh-keygen -t rsa -b 4096
</pre>
Kopieren des öffentlichen Schlüssels auf den Server:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00@xyz00.hostsharing.de
</pre>
oder als Domainadmin:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00-ich@xyz00.hostsharing.de
</pre>

'''Für Windows:'''

PuttyGen, das bei der Intallation von Putty in der Regel mit installiert wird:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

erzeugt einen neuen Schlüssel.
Es sollte ein Schlüssel des Typs "SSH2-RSA" generiert werden.

----
[[Kategorie:Upgrade Jessie zu Stretch]]
[[Kategorie:Glossar]]

Stretch

2018-06-19T21:17:14Z

Hsh00-uwe: /* Sehr alte MySQL Passworte */

== Upgrade auf Debian Stretch ==

In ersten und zweinten Quartal führt das Hostsharing-Team die vorbereitenden Arbeiten für das Upgrade
der Hostsharing-Server auf Debian Stretch (Debian 9.x) durch.

Während der Vorbereitungen werden wir die Mitglieder und Nutzer.innen unserer Plattform
auf dieser Wiki-Seite über unsere Erfahrungen informieren.

Ende Juni wird auf dieser Seite dokumentiert sein, welche Änderungen durch das Upgrade
notwendig werden und welche Vorbereitungen die Nutzer.innen treffen sollten.

Das Upgrade der Webspaces und Managed Server wird im Juni 2018 beginnen.

Folgende Software ist insbesondere betroffen:

== MySQL wird ersetzt durch MariaDB ==

=== Ersatz durch MariaDB ===

Mit dem Upgrade wird der Datenbankserver Mysql durch den MariaDB Server in der Version 10.1 ersetzt. MariaDB ist in Zukunft die Standard-MySQL-Variante in Debian.

Es sind aus der Sicht von Applikationen keine Inkompatibilitäten zwischen MariaDB Server 10.1 und Mysql Server 5.5 bekannt.
Der Ersatz sollte damit keine Probleme bereiten.

=== Sehr alte MySQL Passworte ===

Bereits mit MySQL Version 4.1 wurde ein neues Hashverfahren für die Passworte der MySQL-User eingeführt. Schon seit längerer Zeit verwenden wir bei Hostsharing das neue Hashverfahren. Passworte der MySQL-User werden mit HSAdmin im "neuen" Hashverfahren gespeichert. Es kann jedoch sein, dass in alten Paketen noch MySQL-User mit einem alten 16-Bytes-Password existieren.

Mit dem Upgrade werden neuere MySQL-Client-Bibliothen verwendet, die teilweise das alte Passwort-Format nicht mehr unterstützen. Das kann insbesondere PHP-Anwendungen betreffen. Das Problem wird gelöst, indem das Passwort der MySQL-User mit HSAdmin neu definiert wird. Die Empfehlung ist das bekannte Passwort *vor* dem Upgrade neu zu setzen.

Für Freunde der Konsole mit hsscript:

<pre>
mysqluser.update({where:{name:'xyzXY_example'},set:{password:'geheim'}})
</pre>
(Dokumentation zu hsscript: https://doc.hostsharing.net/users/administration/hsadmin/index.html )

oder im Webfrontend unter https://admin.hostsharing.net , unter der Paketkennung xyzXY und MySQL-User.

In seltenen Ausnahmefällen kann es vorkommen, dass mit sehr alten MySQL-Clients auf die Datenbanken zugegriffen werden soll und dass diese MySQL-Clients das aktuelle Passwort-Format nicht unterstützen. In diesem Fall kann die MySQL-Funktion "OLD_PASSWORD" benutzt werden, um ein Passwort im alten Format zu erzeugen. Siehe dazu: https://mariadb.com/kb/en/library/set-password/

== PHP Update auf Version 7.0 ==

Mit dem Upgrade wird die Version von PHP von 5.6 auf 7.0 angehoben. Ohne weitere Aktion werden die PHP-Anwendungen nach dem Upgrade mit PHP 7.0 laufen.

Um für die Anpassung der gehosteten PHP-Anwendungen eine Übergangszeit anzubieten,
werden wir es ermöglichen über eine Domain-Option PHP pro Domain wieder auf PHP 5.6
zurückzusetzen. Die Domain-Optionen erreicht man, wenn man sich als Paket-Administrator (5-stellige Userkennung der Form "xyz00") oder Hostsharing-Mitglied (3-stellige Userkennung der Form "xyz") in HSAdmin unter [https://admin.hostsharing.net] anmeldet. Dort wählt man links den Bereich der Web-Pakete aus und im Bereich das Paket, das die Domain enthält. Im rechten Bereich oben wählt man dann Domains und in der Tabelle die gewünschte Domain. Mit dem "edit"-Icon rechts oben kann dann der Dialog zum Ändern der Domain-Optionen aufgerufen werden.

PHP 5.6 wird maximal bis Ende 2018 zur Verfügung stehen. Danach endet die Unterstützung dieser Version durch die PHP-Entwickler.

== Java Update auf Version 8.0 ==

In Debian 9 ist Java 8 als Java-Virtuelle-Maschine enthalten. Die vorhandenen Java 7-Pakete aus Debian 8 werden mit dem Upgrade deinstalliert.

Nutzer von Java-Anwendugnen auf den Hostsharing-Servern sollten vor dem Upgrade ihr Anwendungen so umstellen, dass die Anwendungen mit dem bereits seit längerem installierten Java 8 aus den Debian Backports laufen.

Ähnlich verhält es sich mit dem Debian-seitig installierten Apache Tomcat: Tomcat in der Version 7 entfällt. Auf unseren Servern ist neben Tomcat 7 auch Tomcat 8 installiert. Bitte alle Webanwendungen, die den zentral installierten Tomcat nutzen auf die Tomcat 8-Installation umstellen. Tomcat 8 wird im Zuge des Upgrades auf Tomcat 8.5 angehoben.

== Update des OpenSSH Servers ==
DSA-Keys sind standardmäßig deaktiviert und werden seitens Hostsharing aus Sicherheitsgründen nicht aktiviert.
DSA-Keys gelten als unsicher und sollten daher nicht verwendet werden.
Ein Login unter der Verwendung von DSA-Keys ist nach dem Upgrade auf Debian Stretch nicht mehr möglich.

Es sollte geprüft werden, ob DSA-Keys verwendet werden. Dies erkennt man z.B. daran, das am Anfang der Datei des öffentlichen Schlüssels "ssh-dsa" steht.

Werden noch DSA-Keys verwendet, muss zwingend ein neuer Schlüssel wie folgt erstellt werden:

'''Für Freunde der Kommandozeile unter Linux'''

Neuen Key erzeugen:
<pre>
ssh-keygen -t rsa -b 4096
</pre>
Kopieren des öffentlichen Schlüssels auf den Server:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00@xyz00.hostsharing.de
</pre>
oder als Domainadmin:
<pre>
ssh-copy-id -i /home/ich/.ssh/id_rsa xyz00-ich@xyz00.hostsharing.de
</pre>

'''Für Windows:'''

PuttyGen, das bei der Intallation von Putty in der Regel mit installiert wird:

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

erzeugt einen neuen Schlüssel.
Es sollte ein Schlüssel des Typs "SSH2-RSA" generiert werden.

----
[[Kategorie:Upgrade Jessie zu Stretch]]
[[Kategorie:Glossar]]

Wagtail installieren

2018-06-06T13:32:32Z

Hsh00-uwe: symlink war falsch

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen des Projekts "mysite":
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(z.B. production.py) zu hinterlegen, z.B. die zu verwendende Datenbank.

Aufruf von migrate und collectstatic, um die Datenbank zu initialisieren und die statischen Dateien bereitzustellen:
<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links zur Auslieferung der statischen Inhalte:
<pre>
cd ~/doms/xyz00.hostsharing.net/htdocs-ssl
ln -s /home/pacs/xyz00/wagtail/mysite/static static
</pre>

In dem Ordner /home/doms/xyz00.hostsharing.net/ eine .htaccess mit folgendem Inhalt anlegen:
<pre>
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>

Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen, um Passenger mit der Anwendung zu verdrahten:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:

<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Wagtail installieren

2018-06-05T19:58:16Z

Hsh00-uwe: rm htdocs-ssl war falsch

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen des Projekts "mysite":
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(z.B. production.py) zu hinterlegen, z.B. die zu verwendende Datenbank.

Aufruf von migrate und collectstatic, um die Datenbank zu initialisieren und die statischen Dateien bereitzustellen:
<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links zur Auslieferung der statischen Inhalte:
<pre>
cd ~/doms/xyz00.hostsharing.net/htdocs-ssl
ln -s /home/pacs/xyz00/wagtail/mysite/mysite/static static
</pre>

In dem Ordner /home/doms/xyz00.hostsharing.net/ eine .htaccess mit folgendem Inhalt anlegen:
<pre>
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>

Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen, um Passenger mit der Anwendung zu verdrahten:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:

<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Wagtail installieren

2018-06-01T08:01:47Z

Hsh00-uwe: muss ein symbolischer link sein

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen des Projekts "mysite":
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(z.B. production.py) zu hinterlegen, z.B. die zu verwendende Datenbank.

Aufruf von migrate und collectstatic, um die Datenbank zu initialisieren und die statischen Dateien bereitzustellen:
<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links zur Auslieferung der statischen Inhalte:
<pre>
cd ~/doms/xyz00.hostsharing.net/
rm -rf htdocs-ssl
ln -s /home/pacs/xyz00/wagtail/mysite/mysite/static htdocs-ssl
</pre>

In dem Ordner /home/doms/xyz00.hostsharing.net/ eine .htaccess mit folgendem Inhalt anlegen:
<pre>
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>

Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen, um Passenger mit der Anwendung zu verdrahten:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:

<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Wagtail installieren

2018-06-01T06:13:54Z

Hsh00-uwe: verzeichniswechsel falsch

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen des Projekts "mysite":
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(z.B. production.py) zu hinterlegen, z.B. die zu verwendende Datenbank.

Aufruf von migrate und collectstatic, um die Datenbank zu initialisieren und die statischen Dateien bereitzustellen:
<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links zur Auslieferung der statischen Inhalte:
<pre>
cd ~/doms/xyz00.hostsharing.net/
rm -rf htdocs-ssl
ln -f /home/pacs/xyz00/wagtail/mysite/mysite/static htdocs-ssl
</pre>

In dem Ordner /home/doms/xyz00.hostsharing.net/ eine .htaccess mit folgendem Inhalt anlegen:
<pre>
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>

Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen, um Passenger mit der Anwendung zu verdrahten:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:

<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Wagtail installieren

2018-05-30T19:53:19Z

Hsh00-uwe:

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen von "mysite"
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Aufruf von migrate und colllectstatic.
Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(production.py) zu hinterlegen, z.B. die zu verwendende Datenbank - und
zwar '''vor''' "migrate".

<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links:
<pre>
cd /home/doms/xyz00.hostsharing.net/
rm -rf htdocs-ssl
ln -f /home/pacs/xyz00/wagtail/mysite/mysite/static htdocs-ssl
</pre>

In dem Ordner htdocs-ssl eine .htaccess mit folgendem Inhalt anlegen:
<pre>
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>
Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:
<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Wagtail installieren

2018-05-30T19:52:31Z

Hsh00-uwe:

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen von "mysite"
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Aufruf von migrate und clllectstatic.
Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(production.py) zu hinterlegen, z.B. die zu verwendende Datenbank - und
zwar '''vor''' "migrate".

<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links:
<pre>
cd /home/doms/xyz00.hostsharing.net/
rm -rf htdocs-ssl
ln -f /home/pacs/xyz00/wagtail/mysite/mysite/static htdocs-ssl
</pre>

In dem Ordner htdocs-ssl eine .htaccess mit folgendem Inhalt anlegen:
<pre>
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>
Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:
<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Wagtail installieren

2018-05-30T19:51:33Z

Hsh00-uwe: Installation von Wagtail

Am Beispiel der Domain xyz00.hostsharing.net des Users xyz00.
Die Installation in diesem Beispiel wird mit dem Paketadmin xyz00 durchgeführt

xyz00 ist durch das tatsächliche Paketkürzel zu ersetzen.

Installation einer eigenen Pythonumgebung und Installation von wagtail:
<pre>
mkdir wagtail
cd wagtail/
virtualenv -p python3 virtualenv
virtualenv/bin/pip install wagtail
</pre>

Anlegen von "mysite"
<pre>
virtualenv/bin/wagtail start mysite
</pre>

Aufruf von migrate und clllectstatic.
Zusätzlich sind individuelle Settings in der Anwendungskonfiguration
(production.py) zu hinterlegen, z.B. die zu verwendende Datenbank - und
zwar '''vor''' "migrate".

<pre>
cd mysite
../virtualenv/bin/python3 ./manage.py migrate
../virtualenv/bin/python3 ./manage.py collectstatic
</pre>

Anlegen eines symbolischen Links:
<pre>
cd /home/doms/xyz00.hostsharing.net/
rm -rf htdocs-ssl
ln -f /home/pacs/xyz00/wagtail/mysite/mysite/static htdocs-ssl
</pre>

In dem Ordner htdocs-ssl eine .htaccess mit folgendem Inhalt anlegen:
<pre>
cat .htaccess
PassengerPython /home/pacs/xyz00/wagtail/virtualenv/bin/python3
SetEnv DJANGO_SETTINGS_MODULE mysite.settings.production
SetEnv PYTHONPATH /home/pacs/xyz00/wagtail/mysite/
</pre>
Unter dem Ordner app-ssl die Datei passenger_wsgi.py anlegen und mit folgendem Inhalt
füllen:
<pre>
from mysite.wsgi import application
</pre>

Unter dem Ordner ein Verzeichnis "tmp" anlegen und eine leere Datei "restart.txt" anlgen.
Ein "touch" startet die Applikation neu:
<pre>
mkdir app-ssl/tmp
touch app-ssl/tmp/restart.txt
</pre>

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Eigene PHP Version

2016-05-01T10:42:40Z

Hsh00-uwe:

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

<pre>
mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz
</pre>

<pre>
./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make
make install
</pre>

Hardlink:
<pre>
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi
</pre>

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

<pre>
php/phpstub
</pre>

in der phpstub.c den folgenden Pfad geändert:

<pre>
execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);
make
</pre>

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die
<pre>
/etc/php5/cgi/php.ini
</pre>

nach ./fastcgi kopiert.

'''ACHTUNG:''' killall php -u $USER wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains
<pre>
AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub
</pre>

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

<pre>
xyz00@h0x:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

</pre>

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

----
[[Kategorie:HSDoku]]
[[Kategorie:Upgrade Wheezy zu Jessie]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Eigene PHP Version

2016-05-01T10:40:34Z

Hsh00-uwe:

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

<pre>
mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz
</pre>

<pre>
./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make
make install
</pre>

Hardlink:
<pre>
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi
</pre>

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

<pre>
php/phpstub
</pre>

in der phpstub.c den folgenden Pfad geändert:

<pre>
execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);

make
</pre>

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die
<pre>
/etc/php5/cgi/php.ini
</pre>

nach ./fastcgi kopiert.

'''ACHTUNG:''' killall php -u $USER wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains
<pre>
AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub
</pre>

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

xyz00@h0x:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

----
[[Kategorie:HSDoku]]
[[Kategorie:Upgrade Wheezy zu Jessie]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Eigene PHP Version

2016-05-01T10:39:03Z

Hsh00-uwe:

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

<pre>
mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz
</pre>

<pre>
./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make
make install
</pre>

Hardlink:
<pre>
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi
</pre>

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

<pre>
php/phpstub
</pre>

in der phpstub.c den folgenden Pfad geändert:

<pre>
execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);

make
</pre>

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die /etc/php5/cgi/php.ini nach ./fastcgi kopiert.
Da es wohl keine default php.in im eignene php5.4.45 gibt

ACHTUNG:
killall php -u $USER
wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains

AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

xyz00@h0x:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

Eigene PHP Version

2016-05-01T10:38:10Z

Hsh00-uwe:

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

<pre>
mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz
</pre>

<pre>
./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make
make install
</pre>

Hardlink:
<pre>
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi
</pre>

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

php/phpstub

in der phpstub.c den folgenden Pfad geändert:

execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);

make

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die /etc/php5/cgi/php.ini nach ./fastcgi kopiert.
Da es wohl keine default php.in im eignene php5.4.45 gibt

ACHTUNG:
killall php -u $USER
wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains

AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

xyz00@h0x:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

Eigene PHP Version

2016-05-01T10:36:51Z

Hsh00-uwe:

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

<pre>
mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz
</pre>

./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make

make install

Hardlink:
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

php/phpstub
in der phpstub.c den folgenden Pfad geändert:

execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);

make

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die /etc/php5/cgi/php.ini nach ./fastcgi kopiert.
Da es wohl keine default php.in im eignene php5.4.45 gibt

ACHTUNG:
killall php -u $USER
wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains

AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

xyz00@h0x:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

Eigene PHP Version

2016-05-01T10:18:43Z

Hsh00-uwe:

Falls Anwendungen nach dem Upgrade auf Jessie übergangsweise eine ältere PHP-Version benötigen, kann im Paket eine
eigene Version compiliert werden.

mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz

./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make

make install

Hardlink:
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

php/phpstub
in der phpstub.c den folgenden Pfad geändert:

execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);

make

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die /etc/php5/cgi/php.ini nach ./fastcgi kopiert.
Da es wohl keine default php.in im eignene php5.4.45 gibt

ACHTUNG:
killall php -u $USER
wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains

AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

chg04@h83:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

Eigene PHP Version

2016-05-01T10:15:14Z

Hsh00-uwe: Die Seite wurde neu angelegt: „ mkdir php54 cd php54 wget http://de1.php.net/distributions/php-5.4.45.tar.gz ./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl --with-opens…“

mkdir php54
cd php54
wget http://de1.php.net/distributions/php-5.4.45.tar.gz

./configure --prefix $HOME/php-5.4.45 --enable-mbstring --with-curl
--with-openssl --with-xmlrpc --enable-soap --enable-zip --with-gd
--with-jpeg-dir --with-png-dir --with-freetype-dir --enable-intl
--with-xsl --with-mysqli=/usr/bin/mysql_config --with-pdo-mysql
--enable-pdo=shared --with-pdo-mysql=shared --with-pdo-sqlite=shared
--with-zlib --with-mysql

make

make install

Hardlink:
ln php-cgi /home/pacs/xyz00/users/xyz/php-5.4.45/bin/php-cgi

oder eine eigenes phpstub, falls ein Hardlink nicht erwünscht ist:

Dazu die Dateien aus /usr/local/src/phpstub in folgendes Verzeichnis
kopieren:

php/phpstub
in der phpstub.c den folgenden Pfad geändert:

execl("/home/pacs/xyz00/php-5.4.45/bin/php-cgi", "php", NULL);

make

Die erzeugte phpstub als myphpstub in die entsprechenden Domain
fastcgi[-ssl] Verzeichnisse kopieren.

Weiter die /etc/php5/cgi/php.ini nach ./fastcgi kopiert.
Da es wohl keine default php.in im eignene php5.4.45 gibt

ACHTUNG:
killall php -u $USER
wirkt nicht, prozesse mit ps aux kontrolliert und kill

Änderung der .htaccess der entsprechenden Domains

AddType application/x-httpd-phpfastcgi .php
Action application/x-httpd-phpfastcgi /fastcgi-bin/myphpstub

Alle hsadmin Passwörter Änderungen in 16 Bit gespeichert:

Umgehung:

chg04@h83:~$ mysql -u xyz00_mysql -p
Enter password:

mysql> SET SESSION old_passwords=0;
mysql> SET PASSWORD FOR 'xyz00_mysql'@'%' = PASSWORD('geheim');

Damit ist es als 41 bit gespeichert.

ACHTUNG: sobald es mit hsadmin geändert wird sind es wieder 16 bit!

Hsadmin

2015-01-27T04:47:23Z

Hsh00-uwe: /* Aktuell freigeschaltete Module */

{{HSDoku-Links}}
{{DISPLAYTITLE:hsadmin}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Werkzeug. Es dient zur Konfiguration für Internet-Server und paßt speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG].
Es ist ein Konfigurationswerkzeug für das eigene Paket. Es kann über einen Webbrowser, von der Kommandozeile der Linux Shell und per Programmierschnittstelle benutzt werden.

== Allgemeines ==
Die Bedienung erfolgt über:
* ein [[WebFrontend]] – auch für die Kunden eines Resellers oder das eigene Personal),
* das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder
* eine [[Hsadmin/API | Programmierschnittstelle]] (für eigene, selbst gestaltete Frontends).
Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Eine Auflistung aktueller Module für Verwaltungsaufgaben findet sich unter:
https://doc.hostsharing.net/users/administration/hsadmin/index.html

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen, in der in der Regel folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen User kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, zum Beispiel durch den Aufruf einer Dummy-Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für [http://de.wikipedia.org/wiki/Unixoides_System UNIX-ähnliche Systeme] als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. Das heißt, das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, zum Beispiel "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User einschließlich ihrer Mailboxen
:emailaddress - für die Verwaltung der e-mail-Addressn
:emailalias - für die MailAlias Verwaltung
:domain - Domainverwaltung (aktuell nur eine Anzeige)
:mysqluser - Datenbank-Benutzerverwaltung auf einem mySQL-Server
:postgresqluser - Datenbank-Benutzerverwaltung auf einem PostgerSQL-Server
:mysqldb - Datenbankverwaltung auf einem mySQL-Server
:postgresqldb - Datenbankverwaltung auf einem PostgerSQL-Server

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt, aber den "-" vergisst, dann werden diese einfach ignoriert. stdin wird aber ggf. auch anderweitig gebraucht, weshalb "-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt. Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (zum Beispiel Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== Status von Änderungen abfragen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!


----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Hsadmin

2015-01-27T04:46:17Z

Hsh00-uwe: /* Aktuell freigeschaltete Module */

{{HSDoku-Links}}
{{DISPLAYTITLE:hsadmin}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Werkzeug. Es dient zur Konfiguration für Internet-Server und paßt speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG].
Es ist ein Konfigurationswerkzeug für das eigene Paket. Es kann über einen Webbrowser, von der Kommandozeile der Linux Shell und per Programmierschnittstelle benutzt werden.

== Allgemeines ==
Die Bedienung erfolgt über:
* ein [[WebFrontend]] – auch für die Kunden eines Resellers oder das eigene Personal),
* das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder
* eine [[Hsadmin/API | Programmierschnittstelle]] (für eigene, selbst gestaltete Frontends).
Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Eine Auflistung aktueller Module für Verwaltungsaufgaben findet sich unter:
[https://doc.hostsharing.net/users/administration/hsadmin/index.html]

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen, in der in der Regel folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen User kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, zum Beispiel durch den Aufruf einer Dummy-Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für [http://de.wikipedia.org/wiki/Unixoides_System UNIX-ähnliche Systeme] als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. Das heißt, das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, zum Beispiel "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User einschließlich ihrer Mailboxen
:emailaddress - für die Verwaltung der e-mail-Addressn
:emailalias - für die MailAlias Verwaltung
:domain - Domainverwaltung (aktuell nur eine Anzeige)
:mysqluser - Datenbank-Benutzerverwaltung auf einem mySQL-Server
:postgresqluser - Datenbank-Benutzerverwaltung auf einem PostgerSQL-Server
:mysqldb - Datenbankverwaltung auf einem mySQL-Server
:postgresqldb - Datenbankverwaltung auf einem PostgerSQL-Server

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt, aber den "-" vergisst, dann werden diese einfach ignoriert. stdin wird aber ggf. auch anderweitig gebraucht, weshalb "-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt. Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (zum Beispiel Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== Status von Änderungen abfragen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!


----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Hsadmin

2015-01-27T04:45:40Z

Hsh00-uwe: /* Aktuell freigeschaltete Module */

{{HSDoku-Links}}
{{DISPLAYTITLE:hsadmin}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Werkzeug. Es dient zur Konfiguration für Internet-Server und paßt speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG].
Es ist ein Konfigurationswerkzeug für das eigene Paket. Es kann über einen Webbrowser, von der Kommandozeile der Linux Shell und per Programmierschnittstelle benutzt werden.

== Allgemeines ==
Die Bedienung erfolgt über:
* ein [[WebFrontend]] – auch für die Kunden eines Resellers oder das eigene Personal),
* das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder
* eine [[Hsadmin/API | Programmierschnittstelle]] (für eigene, selbst gestaltete Frontends).
Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Eine Auflistung aktueller Module für Verwaltungsaufgaben findet sich unter:
[ https://doc.hostsharing.net/users/administration/hsadmin/index.html ]

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen, in der in der Regel folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen User kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, zum Beispiel durch den Aufruf einer Dummy-Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für [http://de.wikipedia.org/wiki/Unixoides_System UNIX-ähnliche Systeme] als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. Das heißt, das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, zum Beispiel "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User einschließlich ihrer Mailboxen
:emailaddress - für die Verwaltung der e-mail-Addressn
:emailalias - für die MailAlias Verwaltung
:domain - Domainverwaltung (aktuell nur eine Anzeige)
:mysqluser - Datenbank-Benutzerverwaltung auf einem mySQL-Server
:postgresqluser - Datenbank-Benutzerverwaltung auf einem PostgerSQL-Server
:mysqldb - Datenbankverwaltung auf einem mySQL-Server
:postgresqldb - Datenbankverwaltung auf einem PostgerSQL-Server

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt, aber den "-" vergisst, dann werden diese einfach ignoriert. stdin wird aber ggf. auch anderweitig gebraucht, weshalb "-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt. Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (zum Beispiel Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== Status von Änderungen abfragen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!


----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Hsadmin

2015-01-27T04:44:55Z

Hsh00-uwe: /* Aktuell freigeschaltete Module */

{{HSDoku-Links}}
{{DISPLAYTITLE:hsadmin}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Werkzeug. Es dient zur Konfiguration für Internet-Server und paßt speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG].
Es ist ein Konfigurationswerkzeug für das eigene Paket. Es kann über einen Webbrowser, von der Kommandozeile der Linux Shell und per Programmierschnittstelle benutzt werden.

== Allgemeines ==
Die Bedienung erfolgt über:
* ein [[WebFrontend]] – auch für die Kunden eines Resellers oder das eigene Personal),
* das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder
* eine [[Hsadmin/API | Programmierschnittstelle]] (für eigene, selbst gestaltete Frontends).
Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Eine Auflistung aktueller Module für Verwaltungsaufgaben findet sich unter:
[https://doc.hostsharing.net/users/administration/hsadmin/index.html]

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen, in der in der Regel folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen User kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, zum Beispiel durch den Aufruf einer Dummy-Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für [http://de.wikipedia.org/wiki/Unixoides_System UNIX-ähnliche Systeme] als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. Das heißt, das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, zum Beispiel "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User einschließlich ihrer Mailboxen
:emailaddress - für die Verwaltung der e-mail-Addressn
:emailalias - für die MailAlias Verwaltung
:domain - Domainverwaltung (aktuell nur eine Anzeige)
:mysqluser - Datenbank-Benutzerverwaltung auf einem mySQL-Server
:postgresqluser - Datenbank-Benutzerverwaltung auf einem PostgerSQL-Server
:mysqldb - Datenbankverwaltung auf einem mySQL-Server
:postgresqldb - Datenbankverwaltung auf einem PostgerSQL-Server

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt, aber den "-" vergisst, dann werden diese einfach ignoriert. stdin wird aber ggf. auch anderweitig gebraucht, weshalb "-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt. Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (zum Beispiel Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== Status von Änderungen abfragen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!


----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Hsadmin

2015-01-27T04:42:27Z

Hsh00-uwe: /* Aktuell freigeschaltete Module */

{{HSDoku-Links}}
{{DISPLAYTITLE:hsadmin}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Werkzeug. Es dient zur Konfiguration für Internet-Server und paßt speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG].
Es ist ein Konfigurationswerkzeug für das eigene Paket. Es kann über einen Webbrowser, von der Kommandozeile der Linux Shell und per Programmierschnittstelle benutzt werden.

== Allgemeines ==
Die Bedienung erfolgt über:
* ein [[WebFrontend]] – auch für die Kunden eines Resellers oder das eigene Personal),
* das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder
* eine [[Hsadmin/API | Programmierschnittstelle]] (für eigene, selbst gestaltete Frontends).
Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Mit hsscript können derzeit folgende Verwaltungsaufgaben erledigt werden:
{{Textkasten|rot|Hinweis:|Inhalt ist nun in der HS Dokumentation.
https://doc.hostsharing.net/users/administration/hsadmin/index.html
}}

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen, in der in der Regel folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen User kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, zum Beispiel durch den Aufruf einer Dummy-Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für [http://de.wikipedia.org/wiki/Unixoides_System UNIX-ähnliche Systeme] als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. Das heißt, das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, zum Beispiel "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User einschließlich ihrer Mailboxen
:emailaddress - für die Verwaltung der e-mail-Addressn
:emailalias - für die MailAlias Verwaltung
:domain - Domainverwaltung (aktuell nur eine Anzeige)
:mysqluser - Datenbank-Benutzerverwaltung auf einem mySQL-Server
:postgresqluser - Datenbank-Benutzerverwaltung auf einem PostgerSQL-Server
:mysqldb - Datenbankverwaltung auf einem mySQL-Server
:postgresqldb - Datenbankverwaltung auf einem PostgerSQL-Server

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt, aber den "-" vergisst, dann werden diese einfach ignoriert. stdin wird aber ggf. auch anderweitig gebraucht, weshalb "-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt. Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (zum Beispiel Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== Status von Änderungen abfragen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!


----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Hsadmin

2015-01-27T04:41:57Z

Hsh00-uwe: /* Aktuell freigeschaltete Module */

{{HSDoku-Links}}
{{DISPLAYTITLE:hsadmin}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Werkzeug. Es dient zur Konfiguration für Internet-Server und paßt speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG].
Es ist ein Konfigurationswerkzeug für das eigene Paket. Es kann über einen Webbrowser, von der Kommandozeile der Linux Shell und per Programmierschnittstelle benutzt werden.

== Allgemeines ==
Die Bedienung erfolgt über:
* ein [[WebFrontend]] – auch für die Kunden eines Resellers oder das eigene Personal),
* das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder
* eine [[Hsadmin/API | Programmierschnittstelle]] (für eigene, selbst gestaltete Frontends).
Das Kernsystem ermöglicht von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration.

hsadmin ist OpenSource (GPL) und basiert im Wesentlichen auf der Java Enterprise Edition. Es besteht aus einem Web-Client (JSP/JSF) und einem Kommandozeilen-Client (C Programming language) einem Server (EJB3) für die Anwendungslogik und einem Queue-Server für die Systemkommandos (JMS-Client). Die Zugangskontrolle erfolgt orientiert an Rollen und den Datensätzen im Server (an der EJB3-Schnittstelle). Direkte root-Rechte werden nur von dem relativ kleinen Queue-Server benötigt.

== Aktuell freigeschaltete Module ==

Mit hsadmin können derzeit folgende Verwaltungsaufgaben erledigt werden:
{{Textkasten|rot|Hinweis:|Inhalt ist nun in der HS Dokumentation.
https://doc.hostsharing.net/users/administration/hsadmin/index.html
}}

== Passwort und Konfiguration des hsadmin Command-Line-Client ==

Das eigene Passwort muss dabei nur einmalig pro Session eingegeben werden. Ein sogenanntes Ticket-Granting-Ticket (TGT) wird dafür in ~/hsadmin.tgt
gespeichert. Zudem kann man eine Konfigurations-Datei ~/.hsadmin.conf anlegen, in der in der Regel folgende Einträge sinnvoll sind:

<pre>
userName=xyz00
passWord=geheim
passWord.xyz00=geheim
passWord.hsh00-xyz=geheim
</pre>

Der Username wird per Default vom Login-User genommen oder kann mit '''-u/--user:''' angegeben werden. Die Reihenfolge ist:
# Username von der Kommandozeile (-u/--user:),
# der UserName aus dem Eintrag userName=... in der .hsadmin.conf,
# der Login-Username.

Das Passwort wird nur benötigt, falls es für den jeweiligen User kein gültiges TGT mehr in der .hsadmin.tgt mehr gibt.
Es wird zunächst in der .hsadmin.conf aus dem konkreten Eintrag (passWord.xyz=...), dann aus dem allgemeinen (passWord=...) genommen,
falls es nicht gefunden wird, wird es erfragt. Bevor Scripte ausgeführt werden, oder die Ein- oder Ausgabe von hsadmin umleitet werden,
sollte also immer für ein gültiges TGT gesorgt werden, zum Beispiel durch den Aufruf einer Dummy-Funktion wie:
<pre>
hsadmin -c modules.version
</pre>

Man kann sich das Programm hsadmin auch lokal installieren. Dazu gehört ein Shell-Startscript und ein jar-File. Es wird Java6 benötigt. Dies sind die benötigten Datein, sie können von einem HS-Server kopiert werden:

:'''/usr/local/bin/hsadmin'''
:'''/usr/local/lib/hostsharing/hsadmin/HSadminCLI.jar'''

Das Startscript steht derzeit leider nur für [http://de.wikipedia.org/wiki/Unixoides_System UNIX-ähnliche Systeme] als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

== Verwendung des hsadmin Command-Line-Client ==
die Optionen des Kommandozeilen-Frontend (CLI) für die Arbeit auf der [[Shell]] erscheinen dem einen oder anderen evtl. etwas umständlich. Das hat folgende Bewandnis:

Eine Anforderung war, dass das hsadmin CLI auch lokal installieren werden kann und es dennoch neue Module bedienen kann. Das heißt, das CLI hat inhaltlich kaum Informationen und leitet alles nach "Schema-F" an den Server weiter und gibt einfach dessen Ausgabe wieder aus - ohne diese großartig zu interpretieren.

Der Grundaufbau für den Aufruf von der [[Shell]] aus ist:

:'''hsadmin LOKALE-OPTIONEN GLOBAL-REMOTE-OPTIONEN MODUL.FUNKTION REMOTE-OPTIONEN OIDS ...'''

Die lokalen (vom hsadmin CLI selbst interpretierten) Optionen sind:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Option !! Bedeutung lokale Option
|-
| -u /--user ||für den UNIX-Usernamen, unter dem das Programm arbeiten soll
|-
| -v /--version|| gibt die Versionsnummer des hsadmin CLI aus
|-
| -V /--verbosity || gibt den Gesprächtigkeits-Level 0-2 an (zum Debuggen)
|-
| - || liest weitere Remote-Parameter von stdin ein
|}

Globalen Optionen siehe weiter unten.

Der eigentliche Funktionsaufruf wird mit -c /--call: eingeleitet. Dann folgt ein Modulname und ein Funktionsname, zum Beispiel "user.search". Derzeit sind die folgenden Module freigegeben:

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User einschließlich ihrer Mailboxen
:emailaddress - für die Verwaltung der e-mail-Addressn
:emailalias - für die MailAlias Verwaltung
:domain - Domainverwaltung (aktuell nur eine Anzeige)
:mysqluser - Datenbank-Benutzerverwaltung auf einem mySQL-Server
:postgresqluser - Datenbank-Benutzerverwaltung auf einem PostgerSQL-Server
:mysqldb - Datenbankverwaltung auf einem mySQL-Server
:postgresqldb - Datenbankverwaltung auf einem PostgerSQL-Server

Dann folgen die Parameter für diesen Funktionsaufruf. Hier gibt es folgende Gruppen:

{| class="wikitable"
|- class="hintergrundfarbe5"
! Parameter !! Bedeutung für den Aufruf der Funktion
|-
| -w /--where:feld=wert || Abfrage nach einem bestimmten Wert eines bestimmten Feldes.
|-
| -s /--set || Setzen des Wertes eines bestimmten Feldes (wird ggf. ignoriert, z.b. bei *.search).
|-
| -d /--display:format || Spezifiziert das Ausgabeformat. (Hat bei Funktionen ohne Daten-Ausgabe keine Wirkung.)
|}

Die OIDS sind direkte Objekt-Identifier wie der Username (xyz00-test), der Paketname (xyz00), die Domain (example.org) oder die E-Mail-Adresse (test@exampl.org). Es können mehrere angegeben werden. Im Prinzip ist das nur eine Kurzform der jeweiligen -w Option, nur dass eben auch mehrere angegeben werden können.

Die globalen Optionen entsprechen den o.g. -w/-s/-d, nur dass sie für alle im selben hsadmin-Aufruf folgenden Funktionen gelten:

:-W /--globalWhere:feld.wert
:-S /--globalSet:feld.wert
:-D /--globalDisplay:format

=== Ein paar Fallen ===

* Wenn man zwar Funktionsaufrufe per stdin in das CLI hineingibt, aber den "-" vergisst, dann werden diese einfach ignoriert. stdin wird aber ggf. auch anderweitig gebraucht, weshalb "-" nicht automatisch angenommen wird.

* Wenn man gleich den ersten Aufruf mit "-" macht, wird dies derzeit noch als Passwort eingelesen, was natürlich dann schon zu einem Login-Fehler führt. Trick:Entweder das Passwort in der ~/.hsadmin.conf hinterlegen oder zunächst irgendeine andere Funktion aufrufen, die das Passwort abfragt und das TGT speichert.

Die Error-Codes ($? in bash-Scripten) sind derzeit noch recht unspezifisch. Geplant ist eine Unterscheidung zwischen wirklich unbekannten Fehlern (zum Beispiel Fehlern in hsadmin), Remote- Kommunikations-Fehlern (wo man es dann einfach nochmal probieren könnte) und fachlichen Fehlern (bei denen man dann wohl hsadmin falsch bedient hat).

== Status von Änderungen abfragen ==

<pre>
hsadmin -c q.search | sort -n -t'|' -k2
</pre>
So werden die letzten Aktion sortiert angezeigt, bitte besonders den "Status" beachten.

'''Hinweis:''' Die Spaltenreihenfolge (und damit auch das "-k2") ist nicht wirklich gesteuert und der default wird sich auch sicherlich nochmal ändern.
Wer zuverlässige Spalten braucht, sollte das Display-Format angeben!


----
[[Kategorie:HSDoku]]
[[Kategorie:hsadmin]]
[[Kategorie:Glossar]]

Kategorie:Installationsanleitungen

2015-01-27T04:28:43Z

Hsh00-uwe: http://al000.hostsharing.net/mailman gibt es nicht mehr

{{HSDoku-Links}}
Manche Software wird von vielen unserer Mitglieder verwendet. Deshalb werden hier Installationen dokumentiert, wie sie bei anderen Mitgliedern funktionieren, um die Sache zu erleichtern.

Es gibt auch eine [[Hostsharing_Wiki:Wunschliste Installationsanleitungen|Wunschliste]], in der du Software eintragen kannst, für die du dir eine Installationsanleitung wünscht.

= Tools =
Liste mit Tools, die von Hostsharing Mitgliedern veröffentlicht wurden.

* http://hs.andreasloesch.de

User

2015-01-26T19:02:47Z

Hsh00-uwe: /* Passwort ändern mit dem Programm passwd */

{{HSDoku-Links}}

{{Textkasten|rot|Hinweis:| Der weitere Inhalt ist in der Hostsharing Dokumentation unter

https://doc.hostsharing.net/users/administration/hsadmin/index.html

zu finden.

}}

== Passwort ändern mit dem Programm passwd ==

Das Passwort eines Users wird nicht in der hsadmin-Datenbank gespeichert, sondern in der Konfiguration des jeweiligen [[Hive]], auf dem das zugehörige [[Paket]] liegt. Daher kann es ''auch'' mit dem gängigen [[Shell]]-Befehl '''passwd''' geändert werden.

<pre><nowiki>
xyz00@hopi:~$ passwd

Changing password for mi
(current) UNIX password: ALTESPASSWORT
Enter new UNIX password: NEUESPASSWORT
Retype new UNIX password: NEUESPASSWORT
passwd: password updated successfully

xyz00@hopi:~$ █
</nowiki></pre>

Die Platzhalter NEUESPASSWORT und ALTESPASSWORT müssen dabei selbstverständlich gegen die entsprechenden Passworte ausgetauscht werden. Dabei sollte jedes Passwort mindestens 6 Zeichen lang sein, besser 8 Zeichen, und aus Buchstaben, Ziffern und ggf. Sonderzeichen bestehen. Auf Umlaute sollte verzichtet werden, da die Verwendung nicht mit allen Zugangswegen kompatibel ist.

Ggf. kommt es zu Fehlermeldungen, z.B. wenn das neue Passwort zu simpel ist, oder bei der Wiederholung nicht identisch mit dem ersten Passwort ist. In dem Fall, den Vorgang einfach wiederholen. Solange das neue Passwort nicht erfolgreich übernommen wurde, bleibt das alte gültig.

Es gibt User, denen der Paket-Admin nur das Recht eingeräumt hat, das eigene Passwort zu ändern, indem er ihnen die "Shell" /usr/bin/passwd zugewiesen hat. Diese User können durch einen Shell-Login nur ihr Passwort ändern, da das Programm passwd an Stelle einer Shell gestartet wird. Sie werden nach dem Einloggen automatisch auf diesen Dialog geführt.

== Identiätswechsel ==

Der Paketadmin kann mit
sudo -u xyz00-user -i
die Rechte eines seiner Paketuser annehmen, ohne dessen Passwort kennen zu müssen. Für Paketuser, die als initiale shell nur /bin/passwd eingetragen haben ist
sudo -u xyz00-user -s
zu verwenden, um in eine reguläre Shell zu kommen. Mit
"su xyz00-user"
ist auch regulären Benutzern ein Identitätswechel (z.B. zum Paketadmin) möglich, wenn sie das aktuelle Passwort des Zielaccounts kennen.

----
[[Kategorie:HSDoku]]
[[Kategorie:User]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]
[[Kategorie:Einstieg bei Hostsharing]]

Domainkündigung

2015-01-21T01:46:00Z

Hsh00-uwe: hsadmin-client gibt es nicht mehr, delete auch nicht

{{HSDoku-DomainLinks}}
Ausgehende Domaintransfers sind unabhängig von den Domaineinrichtungen bei HS möglich. Eine Domainregistrierung kann also über eine andere Registrierungsverwaltung abgerechnet werden und weiter bei HS eingerichtet und betrieben werden. Falls bei einem ausgehenden Transfer eine Domain nicht mehr weiter bei Hostsharing gehostet werden soll, aber eine möglichst durchgehende Erreichbarkeit sichergestellt werden soll, ist es wichtig, dass die neuen (externen) DNS-Konnektierungen und Webserveraufschaltungen in Betrieb sind und alle alten DNS Caches ausgelaufen sind, bevor die Einrichtung bei HS mittels [[hsadmin]] entfernt wird.

== Domainlöschung beauftragen bzw. den Transfer freischalten ==

* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden.

* Die gewünschte Aktion einleiten (Löschung/Transit bzw. Domain für den Transfer freigeben/AuthCode erstellen lassen).

== Domaineinrichtung auf den HS Servern entfernen ==

Wurde die Domain gelöscht, oder wird die Domain künftig an anderer Stelle gehostet, wird die Einrichtung auf den HS-Servern nicht mehr benötigt. Sie wird mit [[hsadmin]] im Webfrontend gelöscht oder auf der Kommandozeile:

https://doc.hostsharing.net/users/administration/hsadmin/index.html

Dies entfernt die Domainverzeichnisse aus dem Webserverpaket und die Domain aus dem DNS- und Mailservern bei Hostsharing. '''Achtung:''' Die Daten im Domainverzeichnis werden dadurch gelöscht!

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

Domainregistrierung

2015-01-21T01:43:26Z

Hsh00-uwe: /* Neuregistrierung oder Transfer zu Hostsharing (KK) */

{{HSDoku-DomainLinks}}
__NOTOC__

Wird eine neue Domain registriert oder von einem anderen Provider zu Hostsharing transferiert, sollte im Normalfall die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

= Einrichten der Domain auf den HS Servern =

https://doc.hostsharing.net/users/administration/hsadmin/domain.html

Der Domainname muss im Punicode Format angelegt werden aus münster.de wird xn--mnster-3ya.de .

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Domain wird auf die Mail, Web- und Nameserver von HS [[Aufschaltung|aufgeschaltet]]. Letzteres (das Nameserver-Update) ist Voraussetzung für den nächsten Schritt.

= Domainregistrierung oder eingehender Transfer ([[KK]]) =

== Bei fremdem Provider registrierte Domain zum Transfer freischalten ==

Falls die Domain bisher bei einem anderen Provider gehostet ist, muss diesem die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Üblicherweise bekommt man dort einen AuthCode für die Domain mitgeteilt. Gibt es kein etabliertes Verfahren, so kann man wie folgt verfahren:

* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
<pre>
Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der
Domain example.com zur Hostsharing eG, vertreten durch den Registrar
Internetwire, an. Ich bitte, dem folgenden Transferantrag zuzustimmen.
</pre>

* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

== Neuregistrierung oder Transfer zu Hostsharing ([[KK]]) ==

Die Vorgehensweise ist unter https://doc.hostsharing.net/users/anleitung/domain.html beschrieben.

* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

= E-Mail-Adressen der neu eingerichteten Domain =

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Die Einrichtung weiterer E-Mail-Adressen ist unter [https://doc.hostsharing.net/users/anleitung/email.html] beschrieben.

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

Domainregistrierung

2015-01-21T01:42:49Z

Hsh00-uwe: /* Einrichten der Domain auf den HS Servern */

{{HSDoku-DomainLinks}}
__NOTOC__

Wird eine neue Domain registriert oder von einem anderen Provider zu Hostsharing transferiert, sollte im Normalfall die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

= Einrichten der Domain auf den HS Servern =

https://doc.hostsharing.net/users/administration/hsadmin/domain.html

Der Domainname muss im Punicode Format angelegt werden aus münster.de wird xn--mnster-3ya.de .

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Domain wird auf die Mail, Web- und Nameserver von HS [[Aufschaltung|aufgeschaltet]]. Letzteres (das Nameserver-Update) ist Voraussetzung für den nächsten Schritt.

= Domainregistrierung oder eingehender Transfer ([[KK]]) =

== Bei fremdem Provider registrierte Domain zum Transfer freischalten ==

Falls die Domain bisher bei einem anderen Provider gehostet ist, muss diesem die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Üblicherweise bekommt man dort einen AuthCode für die Domain mitgeteilt. Gibt es kein etabliertes Verfahren, so kann man wie folgt verfahren:

* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
<pre>
Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der
Domain example.com zur Hostsharing eG, vertreten durch den Registrar
Internetwire, an. Ich bitte, dem folgenden Transferantrag zuzustimmen.
</pre>

* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

== Neuregistrierung oder Transfer zu Hostsharing ([[KK]]) ==

Die Vorgehensweise ist unter [ https://doc.hostsharing.net/users/anleitung/domain.html] beschrieben. ]

* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

= E-Mail-Adressen der neu eingerichteten Domain =

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Die Einrichtung weiterer E-Mail-Adressen ist unter [https://doc.hostsharing.net/users/anleitung/email.html] beschrieben.

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

Domainregistrierung

2015-01-21T01:40:31Z

Hsh00-uwe: /* Neuregistrierung oder Transfer zu Hostsharing (KK) */

{{HSDoku-DomainLinks}}
__NOTOC__

Wird eine neue Domain registriert oder von einem anderen Provider zu Hostsharing transferiert, sollte im Normalfall die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

= Einrichten der Domain auf den HS Servern =

[ https://doc.hostsharing.net/users/administration/hsadmin/domain.html ]

Der Domainname muss im Punicode Format angelegt werden aus münster.de wird xn--mnster-3ya.de .

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Domain wird auf die Mail, Web- und Nameserver von HS [[Aufschaltung|aufgeschaltet]]. Letzteres (das Nameserver-Update) ist Voraussetzung für den nächsten Schritt.

= Domainregistrierung oder eingehender Transfer ([[KK]]) =

== Bei fremdem Provider registrierte Domain zum Transfer freischalten ==

Falls die Domain bisher bei einem anderen Provider gehostet ist, muss diesem die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Üblicherweise bekommt man dort einen AuthCode für die Domain mitgeteilt. Gibt es kein etabliertes Verfahren, so kann man wie folgt verfahren:

* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
<pre>
Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der
Domain example.com zur Hostsharing eG, vertreten durch den Registrar
Internetwire, an. Ich bitte, dem folgenden Transferantrag zuzustimmen.
</pre>

* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

== Neuregistrierung oder Transfer zu Hostsharing ([[KK]]) ==

Die Vorgehensweise ist unter [ https://doc.hostsharing.net/users/anleitung/domain.html] beschrieben. ]

* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

= E-Mail-Adressen der neu eingerichteten Domain =

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Die Einrichtung weiterer E-Mail-Adressen ist unter [https://doc.hostsharing.net/users/anleitung/email.html] beschrieben.

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

Domainregistrierung

2015-01-21T01:39:59Z

Hsh00-uwe: /* Einrichten der Domain auf den HS Servern */

{{HSDoku-DomainLinks}}
__NOTOC__

Wird eine neue Domain registriert oder von einem anderen Provider zu Hostsharing transferiert, sollte im Normalfall die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

= Einrichten der Domain auf den HS Servern =

[ https://doc.hostsharing.net/users/administration/hsadmin/domain.html ]

Der Domainname muss im Punicode Format angelegt werden aus münster.de wird xn--mnster-3ya.de .

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Domain wird auf die Mail, Web- und Nameserver von HS [[Aufschaltung|aufgeschaltet]]. Letzteres (das Nameserver-Update) ist Voraussetzung für den nächsten Schritt.

= Domainregistrierung oder eingehender Transfer ([[KK]]) =

== Bei fremdem Provider registrierte Domain zum Transfer freischalten ==

Falls die Domain bisher bei einem anderen Provider gehostet ist, muss diesem die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Üblicherweise bekommt man dort einen AuthCode für die Domain mitgeteilt. Gibt es kein etabliertes Verfahren, so kann man wie folgt verfahren:

* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
<pre>
Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der
Domain example.com zur Hostsharing eG, vertreten durch den Registrar
Internetwire, an. Ich bitte, dem folgenden Transferantrag zuzustimmen.
</pre>

* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

== Neuregistrierung oder Transfer zu Hostsharing ([[KK]]) ==

Die Vorgehensweise ist unter [https://doc.hostsharing.net/users/anleitung/domain.html] beschrieben.

* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

= E-Mail-Adressen der neu eingerichteten Domain =

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Die Einrichtung weiterer E-Mail-Adressen ist unter [https://doc.hostsharing.net/users/anleitung/email.html] beschrieben.

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

Domainregistrierung

2015-01-21T01:39:41Z

Hsh00-uwe: hsadmin-client gibt es nicht mehr

{{HSDoku-DomainLinks}}
__NOTOC__

Wird eine neue Domain registriert oder von einem anderen Provider zu Hostsharing transferiert, sollte im Normalfall die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

= Einrichten der Domain auf den HS Servern =

[https://doc.hostsharing.net/users/administration/hsadmin/domain.html]

Der Domainname muss im Punicode Format angelegt werden aus münster.de wird xn--mnster-3ya.de .

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Domain wird auf die Mail, Web- und Nameserver von HS [[Aufschaltung|aufgeschaltet]]. Letzteres (das Nameserver-Update) ist Voraussetzung für den nächsten Schritt.

= Domainregistrierung oder eingehender Transfer ([[KK]]) =

== Bei fremdem Provider registrierte Domain zum Transfer freischalten ==

Falls die Domain bisher bei einem anderen Provider gehostet ist, muss diesem die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Üblicherweise bekommt man dort einen AuthCode für die Domain mitgeteilt. Gibt es kein etabliertes Verfahren, so kann man wie folgt verfahren:

* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
<pre>
Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der
Domain example.com zur Hostsharing eG, vertreten durch den Registrar
Internetwire, an. Ich bitte, dem folgenden Transferantrag zuzustimmen.
</pre>

* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

== Neuregistrierung oder Transfer zu Hostsharing ([[KK]]) ==

Die Vorgehensweise ist unter [https://doc.hostsharing.net/users/anleitung/domain.html] beschrieben.

* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

= E-Mail-Adressen der neu eingerichteten Domain =

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Die Einrichtung weiterer E-Mail-Adressen ist unter [https://doc.hostsharing.net/users/anleitung/email.html] beschrieben.

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

User

2015-01-21T01:18:51Z

Hsh00-uwe: hsadmin-client gibt es nicht mehr, weiteres identisch mit der zentralen dokumentation

{{HSDoku-Links}}

{{Textkasten|rot|Hinweis:| Der weitere Inhalt ist in der Hostsharing Dokumentation unter

https://doc.hostsharing.net/users/administration/hsadmin/index.html

zu finden.

}}

== Passwort ändern mit dem Programm passwd ==

Da das Passwort eines Users nicht in der hsadmin-Datenbank gespeichert wird, sondern in der Konfiguration des [[Hive]], auf dem das zugehörige [[Paket]] liegt, kann es auch mit dem gängigen [[Shell]]-Befehl '''passwd''' geändert werden.

<pre><nowiki>
xyz00@hopi:~$ passwd

Changing password for mi
(current) UNIX password: ALTESPASSWORT
Enter new UNIX password: NEUESPASSWORT
Retype new UNIX password: NEUESPASSWORT
passwd: password updated successfully

xyz00@hopi:~$ █
</nowiki></pre>

Die Platzhalter NEUESPASSWORT und ALTESPASSWORT müssen dabei selbstverständlich gegen die entsprechenden Passworte ausgetauscht werden. Dabei sollte jedes Passwort mindestens 6 Zeichen lang sein, besser 8 Zeichen, und aus Buchstaben, Ziffern und ggf. Sonderzeichen bestehen. Allerdings sollte auf Umlaute verzichtet werden, da diese je nach verwendetem Zugangsweg nicht verwendet werden könnten.

Ggf. kommt es zu Fehlermeldungen, z.B. wenn das neue Passwort zu simpel ist, oder bei der Wiederholung nicht identisch mit dem ersten Passwort ist. In dem Fall, den Vorgang einfach wiederholen. Solange das neue Passwort nicht erfolgreich übernommen wurde, bleibt das alte gültig.

Es gibt User, denen der Paket-Admin nur das Recht eingeräumt hat, das eigene Passwort zu ändern, indem er ihnen die "Shell" /usr/bin/passwd zugewiesen hat. Diese User können durch einen Shell-Login nur ihr Passwort ändern, da das Programm passwd an Stelle einer Shell gestartet wird. Sie werden nach dem Einloggen automatisch auf diesen Dialog geführt.Mehr dazu unter [[User-Arten]].

== Identiätswechsel ==

Der Paketadmin kann mit
sudo -u xyz00-user -i
die Rechte eines seiner Paketuser annehmen, ohne dessen Passwort kennen zu müssen. Für Paketuser, die als initiale shell nur /bin/passwd eingetragen haben ist
sudo -u xyz00-user -s
zu verwenden, um in eine reguläre Shell zu kommen. Mit
"su xyz00-user"
ist auch regulären Benutzern ein Identitätswechel (z.B. zum Paketadmin) möglich, wenn sie das aktuelle Passwort des Zielaccounts kennen.

----
[[Kategorie:HSDoku]]
[[Kategorie:User]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]
[[Kategorie:Einstieg bei Hostsharing]]

User-Arten

2015-01-21T01:13:12Z

Hsh00-uwe: Inhalt ist nach doc.hs.net gewandert

{{Textkasten|rot|Hinweis:|Der Inhalt ist der Hostsharing Dokumentation unter

https://doc.hostsharing.net/users/administration/benutzer/index.html

zu finden.
}}

----
[[Kategorie:HSDoku]]
[[Kategorie:User]]

Domains

2015-01-21T01:06:32Z

Hsh00-uwe: Internetwire heißt seit Jahren Partnergate

{{HSDoku-Links}}

= Domains bei Hostsharing =

Die Domainverwaltung bei Hostsharing ist in zwei unabhängige Bereiche aufgeteilt:

* Die '''Domaineinrichtung''' in den HS-Paketen, zur Erstellung des Domainverzeichnisses unter [[~/]]doms im Paket und [[Aufschaltung]] einer Domain auf HS [[DNS|Name]]-, Mail- und Webserver. Dies geschieht mit [[hsadmin]] im Webfrontend oder auf der Kommandozeile.

* Das '''[http://www.domain-bestellsystem.de Domainbestellsystem]''' des HS-Partnerunternehmens Partnergate zur [[Konnektierung]], also der eigentlichen Registrierung von Domains bei einem Registrar, und zur Vergabe weiterer Aufträgen an Registrierungstellen. Jedes Mitglied von Hostsharing erhielt für dieses Domainbestellsystem Zugangsdaten, bestehend aus einem Benutzernamen der Form hs-xyz und einem Passwort.

Bei anderen Hostern ist eine Domainbestellung teilweise eine feste Kopplung der Registrierung einer Domain mit Konnektierung und gleichzeitiger Aufschaltung auf bestimmte Nameserver und Webpakete. HS ist hier wesentlich flexibler. Der über HS angebotene Zugang zum Domain-Bestellsystem erlaubt es, Domains zu registrieren und auf frei wählbare DNS-Server zu konnektieren. Auf den HS Nameservern und Paketen lassen sich gleichzeitig beliebige weltweit registrierbare Domains einrichten. Hostsharing unterstützt damit die Einrichtung und den Betrieb von Domains die von beliebigen (auch sehr exotischen) Registrierungsstellen verwaltet und abgerechnet werden können.

= Aktionen =

Typische Domainaktionen beinhalten also koordinierte Änderungen sowohl in der Domainregistrierung als auch der HS-Einrichtung, wie in folgenden Seiten aufgezeigt:

* Eine Domain einrichten: [[Domainregistrierung]] 
* Eine Domain kündigen: [[Domainkündigung]] 
* Verwalten von Domains, Subdomains, Eigentümer, Nameserver: [[Domainverwaltung]] 

= Weiterführende Links =
Was ist eine [[Domain]] 
Was ist ein [[Handles|Domainhandle]] 
[[FAQ#Domains|Einträge zu Domains in der HS FAQ]]

----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]

MySQL

2013-07-30T22:31:48Z

Hsh00-uwe: Datenbank-User stehen in keiner Beziehung zu Unix-Usern

== Server ==

Wir haben pro Host einen einzelnen MySQL Datenbankserver. Der Zugriff erfolgt über den Hostnamen localhost und den Port 3306 (default). Außerdem kann der Server über den Socket /var/run/mysqld/mysqld.sock erreicht werden.

Die Anzahl der in Hostsharing WEB-Paketen verwendbaren MySQL-Datenbanken ist ist durch die
Anzahl der jeweils gebuchten Multioptionen begrenzt. Der damit verbrauchte Speicherplatz geht in die Quota des Paketes mit ein, sodass hierüber eine zusätzliche Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. xyz00_datenbank.

== MySQL-User ==

{{Textkasten|gruen||Die Namen der Datenbank-Benutzer stehen in keiner Beziehung zu den Unix-Benutzernamen auf den Hostsharing-Systemen stehen, also den Namen, die für den [[shell]]-Zugang verwendet werden.}}

Es gilt jedoch die Regel, dass die Namen aller Datenbank-Benutzer eines Pakets mit dem Paketkürzel beginnen, gefolgt von einem Unterstrich (also '''xyz00_''').
Die weitere Namensgebung ist frei. Beachte die Differenz zu Unix-User-Namen, die nicht mit Unterstrich, sondern mit Bindestrich gebildet werden ('''xyz00_abc''' -> '''xyz00-abc''').

Sinnvoll ist es z.B. für jede Anwendung eine eigene Datenbank und mindestens einen auf die jeweilige Datenbank beschränkten Benutzer anzulegen.

=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte in MySQL und sollte dementsprechend mit Umsicht genutzt werden. Er kann mit seinem Account im Administrationswerkzeug [[hsadmin]] unter anderem:

* Datenbanken anlegen und löschen
* Datenbank-Benutzer anlegen und löschen

Bevor man in seinem Paket eine Datenbank anlegen kann, muss man zunächst einen Datenbank-Benutzer einrichten. Das ist zwingend notwendig, da beim Anlegen einer Datenbank ein Datenbank-Administrator, der Owner (Besitzer) zugewiesen werden muss.

Datenbank-Administrator kann jeder angelegte Datenbank-Benutzer werden. Ein Datenbank-Administrator hat alle Rechte an einer Datenbank und wird wie unter "[[Datenbanken#Verwaltung_von_Datenbanken |Verwaltung von Datenbanken]]" beschrieben eingerichtet.

=== Weitere Benutzer anlegen ===

Du kannst Dir weitere Benutzer für MySQL anlegen. Wir empfehlen Dir das ausdrücklich, weil es eine gute Idee ist, den mächtigen Zugang eines Datenbank-Admins nur für administrative Zwecke zu benutzen. Wenn Skripte z.B. keine ganzen Tabellen löschen dürfen (drop) kann dies auch nicht aus versehen oder böswillig geschehen. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Leserechte an bestimmten Tabellen oder bestimmte Kommandos.

Wir legen noch einen User an:

siehe [[Datenbanken]]

=== Der MySQL-Monitor ===

Mit den neu angelegten User-Accounts können wir nun in den MySQL-Monitor wechseln, in dem die MySQL-Befehle eingegeben und verarbeitet werden. Der Monitor wird mit dem Befehl mysql aufgerufen. Es ist hier übrigens egal, ob wir als Paketadmin oder als Domainadmin eingeloggt sind, denn MySQL-User und UNIX-Accounts haben keinen Zusammenhang. Wir können mit jedem UNIX-Account, also auch als normaler Domainadmin auf jeden Datenbank-Account zugreifen - auch auf den Paketadmin-Account.

Da wir uns mit Benutzernamen und Passwort anmelden müssen, verwenden wir die Optionen -u (und danach den Benutzernamen) und -p. Das Passwort geben wir nicht in dieser Kommandozeile an, denn sonst ist es für andere User sichtbar. Wenn wir nach -p nichts angeben, werden wir von mysql danach gefragt und geben es dann an.

<pre><nowiki>
xyz00@hopi$ mysql -u xyz00_otto -p
Enter password: password
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 1257230 to server version: 3.23.49-log
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
mysql>
</nowiki></pre>

Nun können wir MySQL-Befehle eingeben. Zu beachten ist, dass man nach einem Kommando mit einem ; abschließen muss. Es gibt einige Ausnahmen, wo man das nicht braucht, z.B. beim Befehl QUIT, mit dem man den Monitor wieder verlässt.

=== Datenbank anlegen ===

geht nun auch mit [[hsadmin]] siehe [[Datenbanken]].

Datenbanknamen in MySQL beginnen bei Hostsharing immer mit dem Namen des Pakets, gefolgt von einem Unterstrich; danach folgt der frei wählbare eigentliche Name.

Beispiele gültiger Datenbanken für ein Paket xyz00:
* xyz00_otto
* xyz00_anna
* xyz00_db_fuer_hans

=== Rechte vergeben ===

Allen Benutzern, außer dem Datenbank-Administrator, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl GRANT.

<pre><nowiki>
mysql>GRANT SELECT, INSERT, DELETE, UPDATE ON xyz00_meinedatenbank.* TO xyz00_otto;
</nowiki></pre>

Hinter der Datenbank verwenden wir .*, um alle Tabellen der Datenbank zu inkludieren.

Mit GRANT ALL kann man einem User auch alle Kommandorechte zuweisen.

Alle Aufgaben können wir jetzt in Zukunft vom User xyz00_otto erledigen lassen.

== Verschiedenes ==

* Web-Frontend: [http://www.phpmyadmin.net phpMyAdmin] ist unter https://phpmyadmin.hostsharing.net/current erreichbar.
* Online-Dokumentation: Die Online-Doku zu MySQL gibt es unter http://dev.mysql.com/doc/. Auf dieser Site gibt es auch mehrere Fassungen der kompletten Doku zum Downloaden.

----
[[Kategorie:HSDoku]]
[[Kategorie:Datenbanken]]
[[Kategorie:Glossar]]
[[Kategorie:ToDo-Kerndoku]]

Diskussion:Domains

2010-06-04T08:31:11Z

Hsh00-uwe:

Ein bißchen gärtnern --[[Benutzer:Jgp00-mail|Jgp00-mail]] 12:41, 7. Mär. 2009 (UTC)

== neues Domain Verfahren ==

Einführung des neuen Domain verfahren muss eingearbeitet werden.
--[[Benutzer:Chg00-hsdoku|Chg00-hsdoku]] 13:43, 21. Mär. 2010 (CET)

Meinung von:srv00
* Wer meint kann ja die Liste mit möglichen "Domain-Aktionen" aus https://wiki.hostsharing.net/index.php?title=Domains&oldid=2553 wieder einfügen. Mir erscheint sie redundant und kaum hilfreich zur Lösungsfindung. Alle aktuell möglichen Aktionen sind immer im Menü des Bestellsystems zu finden. Hier brauchten wir mMn nicht zeitraubende Redundanzen aufzubauen. Besser Erklärung und Hilfestellung bieten.

== Formatierung der Absätze in 3. Ebene in FETT ==

Es ist kein schöner Hack, fetten Text als Überschriften einzuführen und Einzüge zu verwenden, nur um das normale Aussehen von Absätzen mit Überschrift in Mediawiki zu simulieren. Nur weil man Zwischenüberschriften vermeiden möchte, weil sie sonst im Inhaltsverzeichnis auftauchen.

Es geht ab von den üblichen Editiervorgängen im Wiki und erschwert ganz wesentlich das Weiterarbeiten. Weil niemand erst mal kapieren will, wie man diese "Formatierungssimulation" bedienen soll, die sonst nirgendwo verwendet wird.

Mediawiki bietet sehr schöne Möglichkeiten zur Textstrukturierung, auch für diesen Fall. Man sollte sie nutzen und nicht hacken.

Diese Seite enthält so viel Information, dass es sich lohnt, sie, wie in [[Guter_Stil]] beschrieben, in mehrere aufzuteilen.
--[[Benutzer:Deg00-m.website|ChristofT]] 20:35, 3. Jun. 2010 (CEST)

Bedenke Uwe hatte auch aus Gründen der Übersicht die Infos von mehreren Seiten hier auf eine Seite gebracht gehabt.
--[[Benutzer:Chg00-hsdoku|Christian Günter]] 10:25, 4. Jun. 2010 (CEST)

Mir ist unklar, warum die Seite gesplittet werden soll. Man kann den Inhalt straffen (so wie das in meiner urspünglichen Version war). Übrigens bekomme ich die Diskussion, trotz "Beobachtung" nicht automatisch mit. Wie kriegt man den Benutzer automatisch hier unter seinem Beitrag? uwe

Missverständnisse über dedizierte root-Server

2010-05-11T00:51:19Z

Hsh00-uwe: /* Auf meinem root Server kann ich installieren was ich will */

__NOTOC__

== Für (z.B.) **,99 Euro im Monat habe ich alles was ich brauche. ==

Leider nicht: Administration, Security-Überwachung, Dienste-Monitoring, Backups, Standby-Server, um nur einige Beispiele zu nennen, sind in dem o.g. Preis nicht enthalten.

== Mein root-Server-Provider garantiert mir 99,9% Uptime. ==

Nicht wirklich: Die Garantie gilt nur für die Internet-Anbindung, für den Server-Betrieb bist du bei einem dedizierten root-Server selbst verantwortlich. Und für Hardware-Ausfälle erhältst du für den Preis auch keine Garantie.

== Über meinen root-Server habe ich die volle Macht. ==

Nicht wirklich: Wenn es Hardware-Probleme oder bestimmte Software-Probleme gibt, wirst du auf den Support deines Providers angewiesen sein. Hier zeigt sich dann der Gegenwert für den billigen Preis, tagelanges Warten auf das Beheben von Hardware-Problemen oder gar einen Hardware-Austausch sind bei Billinganbietern eher die Regel als die Ausnahme. Tagelange Downtime inklusive.

== Auf meinem root Server kann ich installieren was ich will ==

FALSCH: Du kannst installieren, was du willst und vom KnowHow her kannst. Das für die volle Breitseite eines Internet-Servers auch sehr breites KnowHow nötig ist, vergessen die meisten. Viele laufen nach einem Vorfall in ernste Probleme, weil sie das alte System nicht wieder installiert bekommen. Der Teufel steckt im Detail, das man nur mit ausreichender Erfahrung kennt.

== Meinen root-Server kann ich per Web-Interface voll konfigurieren. ==

Leider nicht: Zunächst einmal ist nur das einstellbar, was im Web-Interface vorgesehen ist. Und das ist meist nur ein Bruchteil dessen, was man einstellen können müßte. Und je tiefer ein Webinterface (Confixx oder Plesk) ins System eingreift, umso schwieriger wird es selber in die Konfiguration einzugreifen.

== Ich mache viel Traffic, also brauche ich einen dedizierten Server. ==

Nicht wirklich: Ein leistungsstarker Server (oder gar Cluster) kann locker mehrere Sites verkraften, die jede einzeln einen 49 Euro Server deutlich überlasten würden. Ob man einen dedizierten Server braucht oder nicht, hat eher mit andern Kriterien zu tun als mit Traffic.

== Auf meinem root-Server bin ich alleine, also ist der auch sicher. ==

Leider nein: Für einen sicheren Server ist tägliche verfolgung diverser Security-Mailinglisten notwendig. Es ist zu überprüfen, ob die jeweiligen Security-Probleme einen betreffen oder nicht und ggf. sind Updates einzuspielen. Web-Interfacs helfen hier nur in wenigen Fällen.

== Für meinen root-Server bin ich ganz alleine zuständig, das finde ich toll, ich brauche keine Partner. ==

Nicht wirklich: Willst du 365 Tage a 24 Stunden in Bereitschaft stehen? Was ist wenn du in den Urlaub fahren willst, krank bist, oder einfach schlafen musst? Wer betreut dann sicher deinen root-Server? Keiner!

== Ich brauche unbedingt einen root-Server für meine Anwendungen. ==

Vermutlich nicht: Für die wenigsten Anwendungen benötigt man wirklich einen eigenen root-Server. Durch eine eigenen virtuellen Webserver (mit eigener Konfiguration) auf einem Shared-Server kannst du sehr viele Dinge machen, die du auch auf einem root-Server machen kannst. Änliches gilt auch für andere Dienste, wenn der Shared-Webspace Provider nur flexibel genut ist.

== Die meisten Dinge über Server-Administration kenne ich, den Rest besorge ich mir im Internet ==

Vermutlich funktioniert das nicht: Davon abgesehen, dass man manchmal sehr spezielle Dinge wissen muss, deren Recherche im Internet leicht mehrere Tage dauern kann, übersieht man leicht all die Dinge, nach denen man gar nicht erst fragt, weil man nicht dran denkt. In einer Gemeinschaft kommt man schneller an die gewünschte Information, weil jeder motiviert ist, und es passen auch viele auf, dass man nichts übersieht.

== Schlusswort ==

Sicherlich gibt es Anwendungen, für die ein eigener root-Server notwendig ist. Für die allermeisten Anwendungen ist ein Shared-Server die bessere Alternative, jedenfalls wenn das Hosting-Projekt nicht just for fun gemacht wird.

Für viele unserer Mitglieder, mehrere davon Hostsharing Hostmaster, wäre bei oberflächlicher Betrachtung ein dedizierter root-Server finanziell günstiger. Es spricht sicher für sich, dass gerade Leute mit KnowHow dennoch die stärke der Gemeinschaft (und die Aufteilung der Bereitschaftszeiten) bevorzugen.

Wer sich doch einen eigenen root-Server anschaffen möchte, sollte diese [[Rootserver_Checkliste|Check-Liste]] beachten.

Login mit SSH

2010-05-11T00:47:36Z

Hsh00-uwe: paketadmin kann keine domains mehr bestellen

Um sich einloggen zu können, brauchst Du natürlich die Daten, die Dir von Hostsharing in einer Mail nach der Anmeldung zugeschickt wurden:

Hostname: '''xyz00.hostsharing.net''' (wenn eine eigene Domain konnektiert ist auch <eigene-domain>.<tld>)

Username: '''xyz00'''

Passwort: '''(wie in der automatischen Mail mitgeteilt)'''

Bei xyz00 handelt es sich um den Account des Paket-Admins. Initial ist für jedes neue Paket nur ein Admin-Account eingerichtet, dessen Benutzername die Form '''xyz00''' besitzt.

Da dieser Account sehr viel Macht über das Paket hat, darf er nur über sichere Protokolle wie SSH benutzt werden. Unsichere Protokolle wie direktes FTP dürfen nicht verwendet werden, da diese die Passwörter im Klartext übertragen. Jeder Administrator auf der Übertragungsstrecke könnte mitlesen.

Gleich vorab: Seine Website kann man später freilich über einen separaten Account per ftps, sftp, scp (und zur Not auch ftp) hochladen, doch dazu später mehr.

Linux Systeme haben meist ssh, scp und sftp Clients vorinstalliert. Eine Freie Software zum sicheren Dateitransfer für Windows ist z.B. [http://winscp.net WinSCP] und ein Shell Zugang mit [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY].

Nach der ggf. nötigen Installation eines ssh Clients, die hier nicht beschrieben werden, da sie nicht Hostsharing-spezifisch ist, kann der erste Login erfolgen.

== Login ==

Mit OpenSSH ist der Aufruf auf der Kommandozeile z.B. folgender:

ssh xyz00@xyz00.hostsharing.net

Nach Aufbau der Verbindung wird dann das [[Passwort]] erfragt.
Danach erscheint in etwa folgende Bildschirmausgabe:

<pre><nowiki>
Last login: Fri Apr 19 06:43:45 2002 from p5081f0c7.dip.t-dialin.net on pts/7

Linux hopi 2.4.17 #2 SMP Thu Jan 17 14:35:38 CET 2002 i686 unknown

+----------------------------------------------------------------+
| hopi.hostsharing.net |
| Bei Fragen oder Problemen bitte E-Mail an: |
| support@hostsharing.net (öffentliche Mailingliste) |
+----------------------------------------------------------------+

Last login: Fri Apr 19 09:36:34 2002 from 62.156.160.59

xyz0@hopi:~$ █
</nowiki></pre>

Es macht durchaus Sinn, die ganz oben genannte "Last Login" Zeile zu prüfen, ob man dies auch selbst war (Uhrzeit und Provider), unten die "Last Login" Zeile gibt genau genommen das aktuelle Login aus, weil der Programmteil nach dem eigentlichen Login ausgeführt wird.

Als nächstes ändern wir gleich unser [[Passwort]], da dieses schließlich unverschlüsselt per E-Mail versendet wurde. Dies geschieht unter UNIX mit dem Kommando passwd

== Passwort ändern ==

Eine Änderung des Passwortes geht dem Befehl passwd:

<pre><nowiki>
xyz00@hopi:~$ passwd

Changing password for xyz00

(current) UNIX password: ALTESPASSWORT

Enter new UNIX password: NEUESPASSWORT

Retype new UNIX password: NEUESPASSWORT

passwd: password updated successfully

xyz00@hopi:~$ █

</nowiki></pre>

Die Platzhalter '''NEUESPASSWORT''' und '''ALTESPASSWORT''' müssen dabei selbstverständlich gegen die entsprechenden [[Passworte]] ausgetauscht werden. Dabei sollte jedes Passwort mindestens 6 Zeichen lang sein, besser 8 Zeichen, und aus Buchstaben, Ziffern und ggf. Sonderzeichen bestehen. Allerdings sollte auf Umlaute verzichtet werden, da diese je nach verwendetem Zugangsweg nicht verwendet werden könnten.

Ggf. kommt es zu Fehlermeldungen, z.B. wenn das neue [[Passwort]] zu simpel ist, oder bei der Wiederholung nicht identisch mit dem ersten Passwort ist. In dem Fall, den Vorgang einfach wiederholen. Solange das neue Passwort nicht erfolgreich übernommen wurde, bleibt das alte gültig.

Es gibt User, denen der Paket-Admin nur das Recht eingeräumt hat, das eigene Passwort zu ändern, indem er ihnen die "Shell" /usr/bin/passwd zugewiesen hat. Diese User können durch einen Shell-Login nur ihr Passwort ändern, da das Programm passwd an Stelle einer Shell gestartet wird. Sie werden nach dem Einloggen automatisch auf diesen Dialog geführt.Mehr dazu unter [[User#Rechte]].

==Sitzung beenden==

Um die Sitzung zu beenden, sich also auszuloggen, gibt man exit ein. Das sieht dann so aus:

<pre><nowiki>
xyz00@hopi:~$ exit
logout
Connection to xyz00.hostsharing.net closed.
</nowiki></pre>

== bestimmte Shell Kommandos automatisch ausführen ==

Lege in dem Verzeichnis, in dem Du direkt nach dem Login landest, die Datei .bash_profile mit folgendem Inhalt an:
<pre>
# Get the aliases and functions
if [ -f ~/.bashrc ]; then
. ~/.bashrc
fi
# User specific environment and startup programs
PATH=$PATH:$HOME/bin
BASH_ENV=$HOME/.bashrc
</pre>

Und nun kannst du in der Datei .bashrc shell Kommandos eingeben. z.B.: quota -g

== welcher Editor in der shell ==

1. manuell Einloggen und:
<pre>
VISUAL=emacs
export VISUAL
EDITOR=emacs
export EDITOR
</pre>

2. in der bash geht es auch kürzer:
<pre>export EDITOR=emacs
export VISUAL=emacs

3. automatisch bei jedem Login

Mit obigen Kommandos in der ~/.bash_profile-Datei.
</pre>

==Weiterführende Links==

[[HS-Server:SSH-Hostkeys]]

----
[[Kategorie:HSDoku]]
[[Kategorie:Einstieg bei Hostsharing]]
[[Kategorie:SSH]]

Pakete

2010-05-11T00:40:04Z

Hsh00-uwe: /* Paketarten */

{{HSDoku-Links}}

= Paketarten =

Entsprechend unserer [http://www.hostsharing.net/produkte/pauschalpakete.html Preisliste], gibt es bei Hostsharing verschiedene (aber kombinierbare) Paketarten bzw. -typen.

* [[ Dynamic-Web-Pakete |Dynamic-Web (DW)]]
Paket kann u.a. für Webseiten,Content-Management-Systeme, Web-Shops genutzt werden, die (CPU und I/O intensiv, und dennoch performant) mit Hilfe von Programmen und Datenbanken im Paket dynamisch erzeugt werden.

* [[ Static-Web-Pakete |Static-Web (SW)]]
Paket eignet sich für statische Daten und Webseiten, die aus statischen HTML Dateien bestehen. Insbesondere E-Mail Postfächer, (CVS) Quellcode, Up/Downloads, Bildergalerien und andere wichtige Daten, die ständig verfügbar und auf Backups und Stand-by Servern gesichert sein sollen.

= Kombination von SW und DW =

Wenn man viel Mailtraffic oder Mailspeicherplatz benötigt ist der sinnvolle und empfohlen Weg Domains im SW aufzuschalten
und nur für benötigte Subdomains im DW aufzuschalten. Dann liegen die Mailboxen der Domain standardmäßig im SW. Soll die Indexwebseite dynamisch generiert werden kann man z.B. die Subdomains www genauso wie ggf. lists in einem DW Paket aufschalten. (DW Skripte können per http:// auf SW Daten verweisen und selbst per scp auf diese zugreifen.) Für statische Inhalte schaltet man z.B static.example.org im SW auf.

Der Umzug einer Domain zwischen SW und DW entspricht einem Umzug auf einen anderen Server (mit anderer IP) und kostet entsprechend Aufwand und ggf. Ausfallzeit.

Ist eine Domain bereits im DW aufgeschaltet, ist es dennoch möglich ohne einen Umzug Mailboxen im SW zu nutzen. Man kann z.B. mail.example.org im SW aufschalten und im DW eine Catch-All-Weiterleitung für example.org nach mail.example.org einrichten. Bei solch einer Catch-All-Weiterleitung laufen die betroffenen E-Mails jedoch über einen zusätzlichen Mailserver, den des DW-Hives, bevor sie in der Mailbox landen und verursachen entsprechend DW Traffic und auch Serverlast. Ein MX-Record im DW Paket anzulegen, der direkt auf das SW Paket zeigt, ist nicht möglich, weil vom SW Paket nur mails für mail.example.org angenommen werden und example.org bereits im DW aufgeschaltet ist.

== Weiterführende Links ==
[[Dynamic-Web-Pakete]] 
[[Static-Web-Pakete]] 
[[DomainManagement]] 
[[Pakettraffic]] 
[[Eventhandler]]

= Pakete bei Hostsharing allgemein =

Jedes Paket hat eine Bezeichnung in der Form xyz00. Sie besteht aus dem bei der Paketeinrichtung frei wählbaren Präfix und einem zweistelligen Zähler.

Entsprechend ist

* der Name des Paketadmins xyz00
* das Paketverzeichnis /home/pacs/xyz00/
* die Paketdomain xyz00.hostsharing.net

Die Paketdomain kann für alle Zugriffe auf das Paket benutzt werden, beispielsweise für den Upload von Daten mittels FTP oder SCP und für das Einloggen über ssh.

Im Dateisystem liegen die Domains in einem Unterverzeichnis doms/. Entweder im Paketverzeichnis, und werden dann vom Paketadmin verwaltet, oder im Verzeichnis eines Paketbenutzers unter /home/pacs/xyz00/users/<Benutzername> und werden dann von diesem Benutzer verwaltet.

Unabhängig davon in welchem Paket und von welchem Benutzer eine Domain gegenwärtig verwaltet wird, ist eine Domain jedoch auch immer über einen Symlink unter /home/doms/ zugänglich.

Konkretere Informationen und die Zugangsdaten enthält die Willkommens-E-Mail, die Du Nach der Bestellung eines Paketes erhältst.

----
[[Kategorie:Pakete bei HS]]
[[Kategorie:HSDoku]]
[[Kategorie:Glossar]]

WEB-Paket

2010-05-11T00:37:47Z

Hsh00-uwe: /* Jedes Dynamik-Web Paket */

{{HSDoku-Links}}

== Jedes Dynamik-Web Paket ==

* stellt eine eigene UNIX-User-Gruppe dar
* erlaubt mehrere POP3/IMAP- und (je nach Pakettyp) einen oder mehrere FTP/SSH/Telnet-[[User]]
* enthält vom Pakettyp abhängigen, durch Quota begrenzten Speicherplatz, der für jeden einzelnen Paket-User individuell quotiert werden kann
* beinhaltet je nach Pakettyp einen entsprechenden Frei-[[Traffic]] pro Monat
* kann eine theoretisch unbegrenzte Anzahl [[Domains]] enthalten
* hat ein eigenes login-Prefix für die Usernamen
* kann bei Bedarf, z.B. für anonymous-FTP und HTTPS, eine eigene IP-Nummer erhalten (selbstverständlich in den Grenzen der Vergaberichtlinien der jeweiligen Registrars, z.B. des RIPE)
* unterstützt zur Zeit: E-Mail mit IMAP, SMTP und POP3 sowie [[procmail]], FTP, HTTP mit CGI-bin, [[PHP]], [[MySQL]] und SSI sowie [[cron|cronjobs]]

== Weiterführende Links ==
[[DW-Speicherbelegung]] 
[[DW-Erklärung der Verzeichnisse und Dateien]]

----
[[Kategorie:HSDoku]]
[[Kategorie:Pakete bei HS]]
[[Kategorie:Dynamic-Web Pakete]]
[[Kategorie:Glossar]]

User

2010-05-11T00:17:02Z

Hsh00-uwe: /* User anlegen */ geht auch per webfrontend

{{HSDoku-Links}}

Es gibt bei Hostsharing unterschiedliche Arten von Benutzern siehe Seite [[User-Arten]] .
Die Art eines Users bestimmt welche Rechte ihm auf dem System gewährt werden.

== User bearbeiten mit [[WebFrontend]] ==

User anlegen und bearbeiten ist grundsätzlich auch mit unserem [[WebFrontend]] möglich.

== User bearbeiten mit [[hsadmin]] (CLI) ==

Einen neuen User anlegen oder berabeiten, z.B: Mailaccounts oder Domain-Admins

=== User anlegen ===

Das Kommandozeilen-Programm ist dabei generisch für alle zu verwaltenden Module. Bezüglich der Benutzerverwaltung wird es wie folgt bedient (die meisten Befehle machen nur für die Paket-Administratoren Sinn):

Zunächst hsadmin einmal aufrufen, damit das Passwort abgefragt wird und hsadmin temporär freigeschaltet wird.
hsadmin -c user.search

Dann den User anlegen. Im folgendem wird die Langform der Optionen (--set: statt -s) und ein temporäres Respose-File verwendet. Durch eingabe der Optionen in das Response-File landet das Passwort nicht in der Kommando-Zeile und damit in der Prozessliste - wo es alle einsehen könnten.

hsadmin - <<EOF
--call:user.add
--set:password=...
--set:name=xyz00-test
--set:shell=/bin/bash
EOF

Im Response-File muss exakt ein Parameter je Zeile angegeben werden. In der Kurzform also so:

-c
user.add
-s
password=...
-s
name=xyz00-test
-s
shell=/bin/bash

=== Die Datenfelder aller sichtbaren UNIX-User auflisten ===

hsadmin -c user.search

==== Bedeutung der Datenfelder ====

{|class="wikitable"
|- class="hintergrundfarbe5"
!Feld !!Beschreibung
|-
|name:||Der Login-Name, der derzeit für POP3, FTP und SSH/Telnet verwendet werden kann. Dieser Name muss IMMER mit der Paket-ID + '-' anfangen, also z.B. xyz00-otto. Ein "-" im Namen ist nur direkt hinter dem Paket erlaubt. Als Trenner kann ein Punkt (.) verwendet werden. Der Name kann nachträglich nicht geändert werden.
|-
|id:||Relevant für die interne Verwaltung. Kann nicht geändert werden.
|-
|comment:||Hier kann man den realen Namen des Users eintragen, also z.B. "Otto Meier". (Auf neu aufgeschalteten Domains erscheint dieses Feld bei "Diese neue Website wurde gerade bei der Hostsharing eG für ... eingerichtet".)
|-
|password:||Leer, weil das Passwort nicht angezeigt wird.
|-
|pac:||Dieses Feld nennt den Paketnamen. Kann nicht geändert werden.
|-
|hivename:||Die ID des hives, auf dem sich Paket und User befinden. Kann nicht geändert werden.
|-
|userid:||Relevant für die interne Verwaltung. Kann nicht geändert werden.
|-
|shell:||Dieses Feld enthält den kompletten Pfad der Login-Shell. Es sind nur wenige Shells möglich, i.d.R. wird man hier /usr/bin/passwd (damit kann der Domainuser sein Passwort jederzeit per ssh oder telnet beliebig ändern) /bin/bash (für vollen ssh/telnet-Zugang) oder /bin/badsh (für FTP-only) setzen. Man kann auch z.B. bin/false angeben, dann kann der User selbst gar nichts machen (außer FTP usw. natürlich)
|-
|homedir:||Dies ist das Homedirectory des Users. Es wird immer automatisch gesetzt.
|}

Die Datenfelder name, comment und shell mit ":" getrennt ausgeben:

hsadmin -c user.search -d '${name}:${comment}:${shell}\n'

=== Die Shell eines UNIX-Users ändern ===

hsadmin -c user.update -s shell=/usr/bin/passwd xyz00-test

=== Das Passwort eines UNIX-Users ändern ===

echo '--set:password=...' | hsadmin -c user.update xyz00-test -

=== Einen UNIX-User löschen ===

hsadmin -c user.delete xyz00-test

== Passwort ändern mit dem Programm passwd ==

Da das Passwort eines Users nicht in der hsadmin-Datenbank gespeichert wird, sondern in der Konfiguration des [[Hive]], auf dem das zugehörige [[Paket]] liegt, kann es auch mit dem gängigen [[Shell]]-Befehl '''passwd''' geändert werden.

<pre><nowiki>
xyz00@hopi:~$ passwd

Changing password for mi
(current) UNIX password: ALTESPASSWORT
Enter new UNIX password: NEUESPASSWORT
Retype new UNIX password: NEUESPASSWORT
passwd: password updated successfully

xyz00@hopi:~$ █
</nowiki></pre>

Die Platzhalter NEUESPASSWORT und ALTESPASSWORT müssen dabei selbstverständlich gegen die entsprechenden Passworte ausgetauscht werden. Dabei sollte jedes Passwort mindestens 6 Zeichen lang sein, besser 8 Zeichen, und aus Buchstaben, Ziffern und ggf. Sonderzeichen bestehen. Allerdings sollte auf Umlaute verzichtet werden, da diese je nach verwendetem Zugangsweg nicht verwendet werden könnten.

Ggf. kommt es zu Fehlermeldungen, z.B. wenn das neue Passwort zu simpel ist, oder bei der Wiederholung nicht identisch mit dem ersten Passwort ist. In dem Fall, den Vorgang einfach wiederholen. Solange das neue Passwort nicht erfolgreich übernommen wurde, bleibt das alte gültig.

Es gibt User, denen der Paket-Admin nur das Recht eingeräumt hat, das eigene Passwort zu ändern, indem er ihnen die "Shell" /usr/bin/passwd zugewiesen hat. Diese User können durch einen Shell-Login nur ihr Passwort ändern, da das Programm passwd an Stelle einer Shell gestartet wird. Sie werden nach dem Einloggen automatisch auf diesen Dialog geführt.Mehr dazu unter User Rechte.

== Identiätswechsel ==

Der Paketadmin kann mit
sudo -u xyz00-user -i
die Rechte eines seiner Paketuser annehmen, ohne dessen Passwort kennen zu müssen. Für Paketuser, die als initiale shell nur /bin/passwd eingetragen haben ist
sudo -u xyz00-user -s
zu verwenden, um in eine reguläre Shell zu kommen. Mit
"su xyz00-user"
ist auch regulären Benutzern ein Identitätswechel (z.B. zum Paketadmin) möglich, wenn sie das aktuelle Passwort des Zielaccounts kennen.

----
[[Kategorie:HSDoku]]
[[Kategorie:User]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]

User

2010-05-11T00:15:29Z

Hsh00-uwe: /* User bearbeiten mit WebFrontend */

{{HSDoku-Links}}

Es gibt bei Hostsharing unterschiedliche Arten von Benutzern siehe Seite [[User-Arten]] .
Die Art eines Users bestimmt welche Rechte ihm auf dem System gewährt werden.

== User bearbeiten mit [[WebFrontend]] ==

User anlegen und bearbeiten ist grundsätzlich auch mit unserem [[WebFrontend]] möglich.

== User bearbeiten mit [[hsadmin]] (CLI) ==

Einen neuen User anlegen oder berabeiten, z.B: Mailaccounts oder Domain-Admins

=== User anlegen ===

Damit die Entwickler und Hostmaster, sich auf einen Punkt nach dem anderen konzentrieren können, ist zur Zeit nur die Bedienung per Kommandozeile freigeschaltet. Das Kommandozeilen-Programm ist dabei generisch für alle zu verwaltenden Module. Bezüglich der Benutzerverwaltung wird es wie folgt bedient (die meisten Befehle machen nur für die Paket-Administratoren Sinn):

Zunächst hsadmin einmal aufrufen, damit das Passwort abgefragt wird und hsadmin temporär freigeschaltet wird.
hsadmin -c user.search

Dann den User anlegen. Im folgendem wird die Langform der Optionen (--set: statt -s) und ein temporäres Respose-File verwendet. Durch eingabe der Optionen in das Response-File landet das Passwort nicht in der Kommando-Zeile und damit in der Prozessliste - wo es alle einsehen könnten.

hsadmin - <<EOF
--call:user.add
--set:password=...
--set:name=xyz00-test
--set:shell=/bin/bash
EOF

Im Response-File muss exakt ein Parameter je Zeile angegeben werden. In der Kurzform also so:

-c
user.add
-s
password=...
-s
name=xyz00-test
-s
shell=/bin/bash

=== Die Datenfelder aller sichtbaren UNIX-User auflisten ===

hsadmin -c user.search

==== Bedeutung der Datenfelder ====

{|class="wikitable"
|- class="hintergrundfarbe5"
!Feld !!Beschreibung
|-
|name:||Der Login-Name, der derzeit für POP3, FTP und SSH/Telnet verwendet werden kann. Dieser Name muss IMMER mit der Paket-ID + '-' anfangen, also z.B. xyz00-otto. Ein "-" im Namen ist nur direkt hinter dem Paket erlaubt. Als Trenner kann ein Punkt (.) verwendet werden. Der Name kann nachträglich nicht geändert werden.
|-
|id:||Relevant für die interne Verwaltung. Kann nicht geändert werden.
|-
|comment:||Hier kann man den realen Namen des Users eintragen, also z.B. "Otto Meier". (Auf neu aufgeschalteten Domains erscheint dieses Feld bei "Diese neue Website wurde gerade bei der Hostsharing eG für ... eingerichtet".)
|-
|password:||Leer, weil das Passwort nicht angezeigt wird.
|-
|pac:||Dieses Feld nennt den Paketnamen. Kann nicht geändert werden.
|-
|hivename:||Die ID des hives, auf dem sich Paket und User befinden. Kann nicht geändert werden.
|-
|userid:||Relevant für die interne Verwaltung. Kann nicht geändert werden.
|-
|shell:||Dieses Feld enthält den kompletten Pfad der Login-Shell. Es sind nur wenige Shells möglich, i.d.R. wird man hier /usr/bin/passwd (damit kann der Domainuser sein Passwort jederzeit per ssh oder telnet beliebig ändern) /bin/bash (für vollen ssh/telnet-Zugang) oder /bin/badsh (für FTP-only) setzen. Man kann auch z.B. bin/false angeben, dann kann der User selbst gar nichts machen (außer FTP usw. natürlich)
|-
|homedir:||Dies ist das Homedirectory des Users. Es wird immer automatisch gesetzt.
|}

Die Datenfelder name, comment und shell mit ":" getrennt ausgeben:

hsadmin -c user.search -d '${name}:${comment}:${shell}\n'

=== Die Shell eines UNIX-Users ändern ===

hsadmin -c user.update -s shell=/usr/bin/passwd xyz00-test

=== Das Passwort eines UNIX-Users ändern ===

echo '--set:password=...' | hsadmin -c user.update xyz00-test -

=== Einen UNIX-User löschen ===

hsadmin -c user.delete xyz00-test

== Passwort ändern mit dem Programm passwd ==

Da das Passwort eines Users nicht in der hsadmin-Datenbank gespeichert wird, sondern in der Konfiguration des [[Hive]], auf dem das zugehörige [[Paket]] liegt, kann es auch mit dem gängigen [[Shell]]-Befehl '''passwd''' geändert werden.

<pre><nowiki>
xyz00@hopi:~$ passwd

Changing password for mi
(current) UNIX password: ALTESPASSWORT
Enter new UNIX password: NEUESPASSWORT
Retype new UNIX password: NEUESPASSWORT
passwd: password updated successfully

xyz00@hopi:~$ █
</nowiki></pre>

Die Platzhalter NEUESPASSWORT und ALTESPASSWORT müssen dabei selbstverständlich gegen die entsprechenden Passworte ausgetauscht werden. Dabei sollte jedes Passwort mindestens 6 Zeichen lang sein, besser 8 Zeichen, und aus Buchstaben, Ziffern und ggf. Sonderzeichen bestehen. Allerdings sollte auf Umlaute verzichtet werden, da diese je nach verwendetem Zugangsweg nicht verwendet werden könnten.

Ggf. kommt es zu Fehlermeldungen, z.B. wenn das neue Passwort zu simpel ist, oder bei der Wiederholung nicht identisch mit dem ersten Passwort ist. In dem Fall, den Vorgang einfach wiederholen. Solange das neue Passwort nicht erfolgreich übernommen wurde, bleibt das alte gültig.

Es gibt User, denen der Paket-Admin nur das Recht eingeräumt hat, das eigene Passwort zu ändern, indem er ihnen die "Shell" /usr/bin/passwd zugewiesen hat. Diese User können durch einen Shell-Login nur ihr Passwort ändern, da das Programm passwd an Stelle einer Shell gestartet wird. Sie werden nach dem Einloggen automatisch auf diesen Dialog geführt.Mehr dazu unter User Rechte.

== Identiätswechsel ==

Der Paketadmin kann mit
sudo -u xyz00-user -i
die Rechte eines seiner Paketuser annehmen, ohne dessen Passwort kennen zu müssen. Für Paketuser, die als initiale shell nur /bin/passwd eingetragen haben ist
sudo -u xyz00-user -s
zu verwenden, um in eine reguläre Shell zu kommen. Mit
"su xyz00-user"
ist auch regulären Benutzern ein Identitätswechel (z.B. zum Paketadmin) möglich, wenn sie das aktuelle Passwort des Zielaccounts kennen.

----
[[Kategorie:HSDoku]]
[[Kategorie:User]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]

Diskussion:Verzeichnis-Struktur

2010-05-11T00:13:11Z

Hsh00-uwe: Neuer Abschnitt /* verzeichnis seiten */

Diverse Links funktionieren noch nicht --[[Benutzer:Deg00-m.website|ChristofT]] 09:37, 8. Mär. 2009 (UTC)

== Neues Domain Verfahren ==

Einführung des neuen Domain verfahren muss eingearbeitet werden.
ob es auf diese Seite Auswirkungen hat ?

--[[Benutzer:Chg00-hsdoku|Chg00-hsdoku]] 13:52, 21. Mär. 2010 (CET)

nein, aber die seite ist inhaltlich völlig veraltet (publish gibt es seit jahren nicht mehr, .forward ist optional etc.), die verzeichnis struktur stimmt so nicht mehr, htdocs etc. fehlen komplett.
uwe

== Domain Dir aus User Sicht ==

OK Uwe, ich schaue da mal nach.
Angefangen mit User Sichtweise.
--[[Benutzer:Chg00-hsdoku|Chg00-hsdoku]] 12:14, 28. Mär. 2010 (CEST)

== Seiten zusammen Legung ==

Als Baustelle,

da aus diesen Seiten:

https://wiki.hostsharing.net/index.php?title=Dateien_und_Verzeichnisse

https://wiki.hostsharing.net/index.php?title=Verzeichnis-Struktur-Domains

und
https://wiki.hostsharing.net/index.php?title=DW-Erkl%C3%A4rung_der_Verzeichnisse_und_Dateien

eine werden soll.

z.b. in

https://wiki.hostsharing.net/index.php?title=User-Arten

--[[Benutzer:Chg00-hsdoku|Chg00-hsdoku]] 20:09, 29. Mär. 2010 (CEST)

== verzeichnis seiten ==

ich würde "Dateien und Verzeichnisse" ruhig mal löschen. Das ist dermaßen veraltet, das sich ein durchgehen für sinnvolles Recycling von Inhalt nicht lohnt.
Hier sieht das doch grundsätzlich schon mal gut aus. Ich würde es nur so strukturieren, das das man zu beginn die gemeinsamen Verzeichnisse beschreibt die Paket- und Dom-Admin gemeinsam haben, so spart man sich einiges an Wiederholungen (z.B. unterhalb von doms), schafft Platz und Übersicht. Danach dann nur die konkreten Unterschiede. Und nur die Verzeichnisse/Dateien die Standartmäßig vorhanden sind. Alles was durch individuelle Aktionen/Installationen des Admins geschaffen wird, sollte in der entsprechenden Anleitung/Tips/Tricks-Seite stehen. Dann kann man hier auch das Static-Web abhandeln und alles ist beisammen.

uwe

Dateien und Verzeichnisse

2010-05-10T23:59:55Z

Hsh00-uwe: /* Das /tmp Dateisystem */ gelöscht, weil wir das verboten ist und keinen leichtfertig in versuchung führen wollen

{{Baustelle}}

== Verzeichnis-Strukturen ==

Zum Erforschen der Directory-Struktur des eigenen Paketes lässt sich zunächst das UNIX-Kommando ls benutzen, es listet das Inhaltsverzeichnis auf:

<pre><nowiki>
xyz00@hopi:~$ ls
cgi etc users var web
xyz00@hopi:~$
</nowiki></pre>

Anders als evtl. von einer DOS-Kommandozeile und dem DOS-Kommando dir gewohnt, ist die Ausgabe vom UNIX ls äußerst knapp. Aber den Optionen -la erhalten wir eine lange (l) Ausgabe aller (a) Dateien (wir könnten auch -l -a schreiben, -la ist die Kombination der beiden Optionen):

<pre><nowiki>
xyz00@hopi:~$ ls -la

total 36

drwx--x--x 8 xyz00 xyz00 4096 Apr 18 18:46 .
drwxr-sr-x 90 root staff 4096 Apr 17 14:52 ..
drwxr-x--- 2 root root 4096 Apr 18 02:37 .bak
-rw------- 1 xyz00 xyz00 235 Apr 18 18:46 .bash_history
drwxr-xr-x 2 xyz00 xyz00 4096 Apr 17 16:21 cgi
drwxr-xr-x 2 xyz00 xyz00 4096 Apr 18 02:37 etc
drwxr-xr-x 5 xyz00 xyz00 4096 Apr 18 18:54 users
drwxr-s--- 2 xyz00 xyz00 4096 Apr 19 00:01 var
drwxr-x--- 2 xyz00 httpd 4096 Apr 17 11:24 web
xyz0@hopi:~$ █
</nowiki></pre>

Alle Dateien bedeutet in dem Fall, dass auch unsichtbare Dateien aufgeführt werden. Unter UNIX sind dies Dateien, die mit einem Punkt beginnen. Ein festes Schema der Dateibezeichnung gibt es unter UNIX nicht. Die hier zu sehenden Dateien und Verzeichnisse sind im einzelnen:

<pre><nowiki>
.
..
.bak
.bash_history
cgi
etc
users
var
web
</nowiki></pre>

Des Weiteren sind in dem oben dargestellten Inhaltsverzeichnis vor den Dateinamen viele kryptisch anmutende Informationen. Zur Einzelerläuterung hier nochmals eine dieser Zeilen:

drwxr-xr-x 2 xyz00 xyz00 4096 Apr 17 16:21 cgi

<fixme> Bedeutung erklären

== Dateien des Paketes ==
Haben wir nun die erste Ebene unseres Paketes kennengelernt, nun ein Kommando, mit dem wir auch die tieferen Ebenen sehen können - find:

<pre><nowiki>
xyz00@hopi:~$ find
.
./doms
./doms/deineigenerdomainname.de
./doms/deineigenerdomainname.de/cgi
./doms/deineigenerdomainname.de/etc
./doms/deineigenerdomainname.de/subs
./doms/deineigenerdomainname.de/subs/www
./doms/deineigenerdomainname.de/subs/www/index.html
./doms/deineigenerdomainname.de/var
./etc
./etc/aliases
./etc/passwd
./etc/shadow
./var
./var/web.err
./var/web.log
./var/config.err
./var/ftp.log
./var/config.err.gz
./var/web.err.gz
./var/web-xyz00.hostsharing.net-20020418-0001.log.gz
./var/ftp.log-2002-04-18.gz
./var/web-xyz00.hostsharing.net-20020419-0001.log.gz
./users
./users/doms
./users/hans
./users/linda
./web
./web/index.html
./cgi
./cgi/test.cgi
./.bak
find: ./.bak: Permission denied
./.bash_history

xyz00@hopi:~$ █

</nowiki></pre>

Find ist ein sehr mächtiges Werkzeug und eignet sich besonders gut, in Kombination mit anderen Unix-Werkzeugen wie grep und awk Dateien im System zu finden oder zu verändern.

Für den praktischen Einstieg auf der Linux-Shell wesentlich geeigneter ist allerdings der sehr universelle Dateimanager [[mc]]. Dieses Programm wird mit dem Befehl mc gestartet und kann benutzt werden, um durch das Dateisystem zu "wandern", Dateien anzusehen oder zu editieren, Links und Symlinks zu erstellen und vieles mehr.

----
[[Kategorie:HSDoku]]
[[Kategorie:Einstieg bei Hostsharing]]

User-Arten

2010-05-10T23:38:32Z

Hsh00-uwe: user ohne shell eingefügt, bautelle entfernt

== Einleitung ==

Diese Seite beschreibt Hostsharing spezifische [[User]]

Die Hierarchie gliedert sich in aufsteigender Reihenfolge.

Das Einrichten und Bearbeiten von Usern ist unter [[User]] beschrieben.

== Datenbank-User ==

Die Datenbank-Systeme haben jeweils ihre eigene User-Verwaltung. Siehe [[Datenbanken]]

== User ohne Shell ==

'''Generell:'''

* Wird durch den Paket-Admin angelegt,
* hat keine reguläre Shell
* Sinnvoll z.B. als E-Mail-Account

'''Rechte:'''

* können nur ihr Passwort ändern.

== Shell-User ==

* Haben eine reguläre Shell (z.B. "/bin/bash")
* Können Unix-Kommandos ausführen
* Loggen sich mit ssh ein

== Domain-Admin ==

'''Generell:'''

* Wird durch den Paket-Admin angelegt
* Wird durch aufschalten einer Domain auf den Namen eines Users zum Domain-Admin
* Hat eine reguläre Shell
* Besitzt eine Verzeichnisstruktur unterhalb ~/doms/

'''Rechte:'''

* E-Mail-Adressen für die Domain einrichten,
* Sub-Domains anlegen,
* Zonen-Daten ändern,
* Dateien und Verzeichnisse unter doms/ anlegen oder hochladen, auf die dann per Web-Server zugegriffen werden kann.

== Paket-Admin ==

'''Generell:'''

* Verwaltet ein Webhosting-Paket

* [[User]]-Name des Paket-Admins ist xyz00, xyz ist das individuelle Paket-Präfix, 00 eine fortlaufende Paketnummer des Mitgliedes. Die Zählung beginnt bei 0.

* Wenn ein Paket-Admin weitere User anlegt, beginnen deren Namen mit dem Paket-Präfix xyz00-.

* Jeder Paket-Admin hat die E-Mail-Adressen xyz00@xyz00.hostsharing.net und admin@xyz00.hostsharing.net.

* Der Paket-Admin hat eine reguläre Shell

* Ist Initial vorhanden

'''Rechte'''

Der Paket-Admin hat alle Rechte eines Domain-Admins und folgende zusätzliche Rechte:

* die Domains des Pakets einem User (Domainadmin) des Pakets zuordnen,
* Domains bestellen,
* die Domains des Paketes administrieren,
* User (Domain-Admin, Shell-User, Datenbank-User) einrichten/löschen,
* den Usern des Pakets Shell-Zugang geben/nehmen,
* per "sudo -u xyz00-paketuser -i" die Rechte eines Users seines Paketes annehmen.

'''Achtung:'''

Eine Domain kann auf den Account eines Paketadmins aufgeschaltet werden, aus Sicherheitsgründen empfiehlt es sich Domains auf separate User aufzuschalten siehe [[Domains]].

----
[[Kategorie:HSDoku]]
[[Kategorie:User]]

Domains

2010-05-05T23:06:08Z

Hsh00-uwe:

{{HSDoku-Links}}

Die Domainverwaltung bei Hostsharing ist in zwei unabhängige Bereiche aufgeteilt:
* Das "Domain-Bestellsystem" zur Vergabe von Aufträgen an Registrierungstellen, die über HS abgerechnet werden.
* Die Domaineinrichtung in den HS-Paketen, zur Aufschaltung von Domains auf HS Name-, Mail- und Webserver.

Bei anderen Hostern ist eine Domainbestellung teilweise eine feste Kopplung der Registrierung einer Domain mit Konnektierung und Aufschaltung auf bestimmte Nameserver und Webpakete. HS ist hier wesentlich flexibler. Der über HS angebotene Zugang zur Registrierungsverwaltung "Domain-Bestellsystem" (Domain-Robot Webfrontend) erlaubt es registrierte Domains auf frei wählbare DNS-Server zu konnektieren. Auf den HS Nameservern und Paketen lassen sich gleichzeitig beliebige weltweit registrierbare Domains einrichten. Hostsharing unterstützt damit die Einrichtetung und den Betrieb von Domains die von beliebigen (auch sehr exotischen) Registrierungsstellen verwaltet und abgerechnet werden können.

Typische Domainaktionen beinhalten daher ein paar koordinierte Änderungen in der Domainregistrierung und HS-Einrichtung, wie folgend aufgezeigt.

{{Textkasten|gruen||Der verbreitete Ausdruck KK (Konnektivitätskoordination) ist eigentlich veraltet, neu heißt es CHPROV (change provider).}}

= Domainregistrierung oder eingehender Transfer (KK) =

Soll eine neue Domain registriert oder eingehend transferiert werden, sollte die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

'''1. ggf. bereits registrierte Domain zum Transfer freischalten'''

: Dem vorherigen Provider muss die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Bspw. bekommt man dort eine AuthCode für die Domain mitgeteilt. Gibt es dort kein etabliertes Verfahren, so kann man wie folgt verfahren:

:* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
:::"Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der Domain example.com zur Hostsharing eG, vertreten durch den Registrar Internetwire, an.
::: Ich bitte, dem folgenden Transferantrag zuzustimmen."
:* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
:* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

'''2. Einrichten der Domain auf den HS Servern'''

<pre>
hsadmin -c domain.add --set:user="<xyz00-admin>" --set:name="<example.com>"
</pre>

oder mit dem HSadmin Webfrontend.

'''3. Neuregistrierung oder Transfer (KK) einleiten'''

:* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden.

:* Neuregistrierung/Transfer(KK) einleiten. (Für den Transfer ist hier i.d.R. der zuvor in Erfahrung gebrachte AuthCode notwendig.)

:* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

'''4. E-Mail-Adressen der neu eingerichteten Domain'''

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Weitere Adressen können mit [[Hsadmin-mail]] konfiguriert werden.

= Abgehender Transfer (KK) oder Domainkündigung/-löschung =

Ausgehende Domaintransfers sind unabhängig von den Domaineinrichtungen bei HS möglich. Eine Domainregistrierung kann also über eine andere Registrierungsverwaltung abgerechnet werden und weiter bei HS eingerichtet und betrieben werden. Falls bei einem ausgehendem Transfer eine Domain jedoch auch nicht mehr weiter bei Hostsharing gehostet werden soll aber eine möglichst durchgehende Erreichbarkeit sichergestellt werden soll, ist es wichtig, dass die neuen (externen) DNS-Konnektierungen und Webserveraufschaltungen in Betrieb sind und alle alten DNS Caches ausgelaufen sind, bevor die Einrichtung bei HS entfernt wird.

'''1. Domainlöschung beauftragen bzw. den Transfer freischalten'''

:* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden.

:* Die gewünschte Aktion einleiten (Löschung/Transit bzw. Domain für den Transfer freigeben/AuthCode erstellen lassen).

'''2. ggf. Domaintransfer (KK) im externen Abrechnungssystem beauftragen (mit oder ohne externe DNS/Webserver Aufschaltung)'''

:* Hierfür ist i.d.R. der zuvor erstellte AuthCode notwendig.

'''3. ggf. Domaineinrichtung auf den HS Servern entfernen'''

:::<pre>hsadmin -c domain.delete "<example.com>"</pre> oder mit dem HSadmin Webfrontend. Dies entfernt die Domainverzeichnisse aus dem Webserverpaket und die Domain aus dem DNS- und Mailservern bei Hostsharing.

= "Handles" in der Registrierungsverwaltung =

Die verschiednenen Registrierungstellen vergeben i.d.R. automatisch Registrierschlüssel -die sog. "Handles"- für jeden neuen Kontaktdatensatz (owner, admin-c, tech-c, zone-c Datensätze). Diese kann man bei weiteren Registrierungen verwenden um sich auf die gleichen Kontaktdaten zu beziehen. Die Internetwire-internen Handles im Domain-Bestellsystem beginnen mit einer Buchstaben/Zahlenkombination und enden mit @HANDLES.DE. Sie dienen dazu auch Kontaktdatensätze, die bei verschiedenen Registrierungsstellen hinterlegt sind unter einem Handle im Internetwire-System zu verwalten.

= Weitere Domaineinrichtungs-Aktionen =

== eigene Verwaltung der Zonefiles ==

Siehe [[Verwalten der Zonendaten]]. 

== lokale Subdomains aufschalten ==

Lokale Subdomains können:

* vom Domainadmin selbst unter ~/doms/example.net/subs/ durch das Anlegen eines Verzeichnisses erzeugt werden
* vom Paketadmin einem anderen Domainadmin aufgeschaltet werden, auch in einem anderen Paket

::'''Aufschaltung innerhalb eines Paketes, anderer Domainadmin'''

:::Innerhalb eine Paketes können Subdomains einfach per "setup" Auftrag aufgeschaltet werden (ohne vorherige explizite Delegation im Zonefile).

::'''Aufschaltung in ein anderes Paket'''

:: Es ist empfehlenswert vor Änderungen am Zonefile die Seite [[Verwalten_der_Zonendaten]] aufmerksam zu lesen '''und''' zu verstehen!

:::Die Subdomain muss vom Paket-Admin/Domain-Admin durch folgende Ergänzung im Zonefile der Domain delegiert werden:

:::<pre>
:::[...]
:::pic.example.org. IN NS {HS_DNS1_HOSTNAME}.
:::pic.example.org. IN NS {HS_DNS2_HOSTNAME}.
:::pic.example.org. IN NS {HS_DNS3_HOSTNAME}.
:::</pre>

:::Prüfen, ob die Änderung des Zonefiles erfolgreich war:

:::<pre>xyz00-abc@h01> dig @dns1.hostsharing.net "pic.example.org" NS | grep '^pic.example.org'</pre>

:::Danach kann der "setup"-Auftrag mit

:::<pre>xyz00-abc@h01 touch ~/etc/dom-order.upd</pre>

:::angestoßen werden.

== Domains/Subdomains neu zuordnen (Domain-Admin ändern, Paketzuordnung ändern) ==

::'''Domain-Admin ändern'''

:::Als Paketadmin die Datei ~/etc/dom-users anlegen mit folgendem Inhalt (Beispiel):

:::<pre>
:::example1.com:xyz00
:::example2.com:xyz00-user2
:::subdomain.example3.com:xyz00-user3
:::</pre>

:::Abschließend einen entsprechenden Auftrag an service@hostsharing.net senden, welche Domain an wen verschoben werden soll.

::'''Paketzuordnung ändern'''

:::Eintrag zuerst im Zielpaket erzeugen und danach im Quellpaket. Anschließend eine E-Mail an service@hostsharing.net senden. Nach erfolgreichem Verschieben sollte der Eintrag im Quellpaket gelöscht werden.

'''Achtung:''' Datenbanken und E-Mail Postfächer werden '''nicht''' verschoben! Sind keine Dienste geschaltet (z.B. E-Mail) sind die Umzüge kostenlos. Wenn E-Mail,Webanwendung (Datenbanken) existieren, muss das im Einzelfall vorher besprochen werden und kann evtl. Kostenpflichtig werden. In diesem Fall bitte '''vorher''' eine Anfrage an service@hostsharing.net.

== Status der Domaineinrichtung ==

Der Domaineinrichtungs-Status kann mit unserem hsadmin-[[WebFrontend]] eingesehen werden oder mit [[hsadmin]] auf der Kommandozeile der [[Shell]]:

<pre>
hsadmin -c domain.search
</pre>

= Weiterführende Links =

[[Verzeichnis-Struktur-Domains | Verzeichnis-Struktur]] 

----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]

Domains

2010-05-05T23:03:56Z

Hsh00-uwe: hsadmin ersatz für dom-order an die richtige stelle gepackt

{{HSDoku-Links}}

Die Domainverwaltung bei Hostsharing ist in zwei unabhängige Bereiche aufgeteilt:
* Das "Domain-Bestellsystem" zur Vergabe von Aufträgen an Registrierungstellen, die über HS abgerechnet werden.
* Die Domaineinrichtung in den HS-Paketen, zur Aufschaltung von Domains auf HS Name-, Mail- und Webserver.

Bei anderen Hostern ist eine Domainbestellung teilweise eine feste Kopplung der Registrierung einer Domain mit Konnektierung und Aufschaltung auf bestimmte Nameserver und Webpakete. HS ist hier wesentlich flexibler. Der über HS angebotene Zugang zur Registrierungsverwaltung "Domain-Bestellsystem" (Domain-Robot Webfrontend) erlaubt es registrierte Domains auf frei wählbare DNS-Server zu konnektieren. Auf den HS Nameservern und Paketen lassen sich gleichzeitig beliebige weltweit registrierbare Domains einrichten. Hostsharing unterstützt damit die Einrichtetung und den Betrieb von Domains die von beliebigen (auch sehr exotischen) Registrierungsstellen verwaltet und abgerechnet werden können.

Typische Domainaktionen beinhalten daher ein paar koordinierte Änderungen in der Domainregistrierung und HS-Einrichtung, wie folgend aufgezeigt.

{{Textkasten|gruen||Der verbreitete Ausdruck KK (Konnektivitätskoordination) ist eigentlich veraltet, neu heißt es CHPROV (change provider).}}

= Domainregistrierung oder eingehender Transfer (KK) =

Soll eine neue Domain registriert oder eingehend transferiert werden, sollte die Domain bei Hostsharing eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird.

'''1. ggf. bereits registrierte Domain zum Transfer freischalten'''

: Dem vorherigen Provider muss die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Bspw. bekommt man dort eine AuthCode für die Domain mitgeteilt. Gibt es dort kein etabliertes Verfahren, so kann man wie folgt verfahren:

:* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
:::"Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der Domain example.com zur Hostsharing eG, vertreten durch den Registrar Internetwire, an.
::: Ich bitte, dem folgenden Transferantrag zuzustimmen."
:* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
:* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

'''2. Einrichten der Domain auf den HS Servern'''

<pre>
hsadmin -c domain.add --set:user="<xyz00-admin>" --set:name="<example.com>"
</pre>

oder mit dem HSadmin Webfrontend.

'''3. Neuregistrierung oder Transfer (KK) einleiten'''

:* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden.

:* Neuregistrierung/Transfer(KK) einleiten. (Für den Transfer ist hier i.d.R. der zuvor in Erfahrung gebrachte AuthCode notwendig.)

:* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

'''4. E-Mail-Adressen der neu eingerichteten Domain'''

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Weitere Adressen können mit [[Hsadmin-mail]] konfiguriert werden.

= Abgehender Transfer (KK) oder Domainkündigung/-löschung =

Ausgehende Domaintransfers sind unabhängig von den Domaineinrichtungen bei HS möglich. Eine Domainregistrierung kann also über eine andere Registrierungsverwaltung abgerechnet werden und weiter bei HS eingerichtet und betrieben werden. Falls bei einem ausgehendem Transfer eine Domain jedoch auch nicht mehr weiter bei Hostsharing gehostet werden soll aber eine möglichst durchgehende Erreichbarkeit sichergestellt werden soll, ist es wichtig, dass die neuen (externen) DNS-Konnektierungen und Webserveraufschaltungen in Betrieb sind und alle alten DNS Caches ausgelaufen sind, bevor die Einrichtung bei HS entfernt wird.

'''1. Domainlöschung beauftragen bzw. den Transfer freischalten'''

:* Im [http://www.domain-bestellsystem.de Domainbestellsystem] mit dem über HS vergebenen Account anmelden.

:* Die gewünschte Aktion einleiten (Löschung/Transit bzw. Domain für den Transfer freigeben/AuthCode erstellen lassen).

'''2. ggf. Domaintransfer (KK) im externen Abrechnungssystem beauftragen (mit oder ohne externe DNS/Webserver Aufschaltung)'''

:* Hierfür ist i.d.R. der zuvor erstellte AuthCode notwendig.

'''3. ggf. Domaineinrichtung auf den HS Servern entfernen'''

:* <pre>hsadmin -c domain.delete "<example.com>"</pre> oder mit dem HSadmin Webfrontend. Dies entfernt die Domainverzeichnisse aus dem Webserverpaket und die Domain aus dem DNS- und Mailservern bei Hostsharing.

= "Handles" in der Registrierungsverwaltung =

Die verschiednenen Registrierungstellen vergeben i.d.R. automatisch Registrierschlüssel -die sog. "Handles"- für jeden neuen Kontaktdatensatz (owner, admin-c, tech-c, zone-c Datensätze). Diese kann man bei weiteren Registrierungen verwenden um sich auf die gleichen Kontaktdaten zu beziehen. Die Internetwire-internen Handles im Domain-Bestellsystem beginnen mit einer Buchstaben/Zahlenkombination und enden mit @HANDLES.DE. Sie dienen dazu auch Kontaktdatensätze, die bei verschiedenen Registrierungsstellen hinterlegt sind unter einem Handle im Internetwire-System zu verwalten.

= Weitere Domaineinrichtungs-Aktionen =

== eigene Verwaltung der Zonefiles ==

Siehe [[Verwalten der Zonendaten]]. 

== lokale Subdomains aufschalten ==

Lokale Subdomains können:

* vom Domainadmin selbst unter ~/doms/example.net/subs/ durch das Anlegen eines Verzeichnisses erzeugt werden
* vom Paketadmin einem anderen Domainadmin aufgeschaltet werden, auch in einem anderen Paket

::'''Aufschaltung innerhalb eines Paketes, anderer Domainadmin'''

:::Innerhalb eine Paketes können Subdomains einfach per "setup" Auftrag aufgeschaltet werden (ohne vorherige explizite Delegation im Zonefile).

::'''Aufschaltung in ein anderes Paket'''

:: Es ist empfehlenswert vor Änderungen am Zonefile die Seite [[Verwalten_der_Zonendaten]] aufmerksam zu lesen '''und''' zu verstehen!

:::Die Subdomain muss vom Paket-Admin/Domain-Admin durch folgende Ergänzung im Zonefile der Domain delegiert werden:

:::<pre>
:::[...]
:::pic.example.org. IN NS {HS_DNS1_HOSTNAME}.
:::pic.example.org. IN NS {HS_DNS2_HOSTNAME}.
:::pic.example.org. IN NS {HS_DNS3_HOSTNAME}.
:::</pre>

:::Prüfen, ob die Änderung des Zonefiles erfolgreich war:

:::<pre>xyz00-abc@h01> dig @dns1.hostsharing.net "pic.example.org" NS | grep '^pic.example.org'</pre>

:::Danach kann der "setup"-Auftrag mit

:::<pre>xyz00-abc@h01 touch ~/etc/dom-order.upd</pre>

:::angestoßen werden.

== Domains/Subdomains neu zuordnen (Domain-Admin ändern, Paketzuordnung ändern) ==

::'''Domain-Admin ändern'''

:::Als Paketadmin die Datei ~/etc/dom-users anlegen mit folgendem Inhalt (Beispiel):

:::<pre>
:::example1.com:xyz00
:::example2.com:xyz00-user2
:::subdomain.example3.com:xyz00-user3
:::</pre>

:::Abschließend einen entsprechenden Auftrag an service@hostsharing.net senden, welche Domain an wen verschoben werden soll.

::'''Paketzuordnung ändern'''

:::Eintrag zuerst im Zielpaket erzeugen und danach im Quellpaket. Anschließend eine E-Mail an service@hostsharing.net senden. Nach erfolgreichem Verschieben sollte der Eintrag im Quellpaket gelöscht werden.

'''Achtung:''' Datenbanken und E-Mail Postfächer werden '''nicht''' verschoben! Sind keine Dienste geschaltet (z.B. E-Mail) sind die Umzüge kostenlos. Wenn E-Mail,Webanwendung (Datenbanken) existieren, muss das im Einzelfall vorher besprochen werden und kann evtl. Kostenpflichtig werden. In diesem Fall bitte '''vorher''' eine Anfrage an service@hostsharing.net.

== Status der Domaineinrichtung ==

Der Domaineinrichtungs-Status kann mit unserem hsadmin-[[WebFrontend]] eingesehen werden oder mit [[hsadmin]] auf der Kommandozeile der [[Shell]]:

<pre>
hsadmin -c domain.search
</pre>

= Weiterführende Links =

[[Verzeichnis-Struktur-Domains | Verzeichnis-Struktur]] 

----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]
[[Kategorie:Glossar]]