Hostsharing Wiki - Benutzerbeiträge [de]

Mattermost Installieren

2024-12-13T19:00:35Z

Peh00-phor: Update auf v10.x, RAM statt DAEMON

== Über Mattermost ==

Mattermost ist ein Chat-Server unter einer freien MIT Lizenz. Der Server ist in der Programmiersprache [https://de.wikipedia.org/wiki/Go_%28Programmiersprache%29 go] implementiert.

Mattermost ist eine selbst-gehostete Alternative zum Cloud-Dienst [https://de.wikipedia.org/wiki/Slack_(Software) Slack] oder zum proprietären [https://en.wikipedia.org/wiki/HipChat HipChat].

== Vorbereitungen ==

Die hier beschriebene Installation benötigt bei Hostsharing die Paket-Option "RAM". Benötigt werden etwa 512 MB. Im Managed Webspace ist diese Option kostenpflichtig: https://www.hostsharing.net/angebote/managed-webspace/

Für den Betrieb des Dienstes legen Sie einen Service-User mit Hilfe von HSAdmin an. Als User-Beispiel nutzen wir im Folgenden "xyz00-chat".

Ebenfalls mit HSAdmin muss eine (Sub-)Domain für den Chat-Dienst aufgeschaltet/angelegt werden. Die Domain muss dem User "xyz00-chat" zugeordnet werden. In dieser Anleitung nutze ich die Domain "beispiel-chat.de".

Weiterhin benötigt Mattermost eine MariaDB- oder eine PostgreSQL-Datenbank. Wir empfehlen PostgreSQL und legen also mit Hilfe von HSAdmin einen PostgreSQL-User ("xyz00_mm_user" mit Passwort "geheim") und eine Datenbank ("xyz00_mm_db" mit dem Eigentümer "xyz00_mm_user") an.

== Installation ==

Als User "xyz00-chat" lade ich die Software herunter (aktuelle Version siehe [https://github.com/mattermost/mattermost-server/releases]):

<syntaxhighlight lang=shell>
wget https://releases.mattermost.com/10.2.1/mattermost-10.2.1-linux-amd64.tar.gz
</syntaxhighlight>
Die tar.gz-Datei wird ausgepackt:

<syntaxhighlight lang=shell>
tar xzf mattermost-10.2.1-linux-amd64.tar.gz
</syntaxhighlight>

Dann finden wir im $HOME des Users "xyz00-chat" ein Unterverzeichnis "$HOME/mattermost"

== Konfiguration ==

Die Konfiguration von Mattermost nehmen wir in der Datei $"HOME/mattermost/config/config.json" vor:

Im Abschnitt "ServiceSettings" definieren wir die Parameter "SiteURL", "WebsocketURL" und "ListenAddress":

<syntaxhighlight lang=json line>
"ServiceSettings": {
"SiteURL": "https://beispiel-chat.de",
"WebsocketURL": "wss://beispiel-chat.de",
"ListenAddress": "127.0.0.1:34567",
...
</syntaxhighlight>

Dabei sei "https://beispiel-chat.de" die Domain, unter der der Chat betrieben werden soll und "34567" der Port,
der vom Hostsharing-Service für den "Eigenen Daemon" zugewiesen wurde.

Im Abschnitt "TeamSettings" kann für den Chat ein Name vergeben werden:

<syntaxhighlight lang=json line>
"TeamSettings": {
"SiteName": "Beispiel-Chat",
...
</syntaxhighlight>

Im Abschnitt "SqlSettings" wird die PostgreSQL Datenbank konfiguriert:

<syntaxhighlight lang=json line>
"SqlSettings": {
"DriverName": "postgres",
"DataSource": "postgres://xyz00_mm_user:geheim@127.0.0.1:5432/xyz00_mm_db?sslmode=disable\u0026connect_timeout=10",
...
</syntaxhighlight>

Weiter noch unter "FileSettings" und "EMailSettings":

<syntaxhighlight lang=json line>
"FileSettings": {
"MaxFileSize": 4096000,
"DriverName": "local",
"Directory": "./data/",
...

"EmailSettings": {
"EnableSignUpWithEmail": true,
"EnableSignInWithEmail": true,
"EnableSignInWithUsername": true,
"SendEmailNotifications": true,
"RequireEmailVerification": true,
"FeedbackName": "Beispiel-Chat",
"FeedbackEmail": "mattermost@beispiel-chat.de",
"FeedbackOrganization": "Beispiel",
"SMTPUsername": "",
"SMTPPassword": "",
"SMTPServer": "localhost",
"SMTPPort": "25",
...
</syntaxhighlight>

Im Verzeichnis "htdocs-ssl" unter "$HOME/doms/beispiel-chat.de" wird eine ".htaccess"-Datei abgelegt,
die dafür sorgt, dass alle Requests an den Mattermost-Server weitergegeben werden. Dabei verwendet Mattermost
auch Websocket-Verbindungen ("ws://"). Inhalt der ".htaccess":

<syntaxhighlight lang=apache line>
DirectoryIndex disabled
RewriteEngine On
RewriteBase /

RewriteCond %{REQUEST_URI} ^/api/v1/websocket [NC,OR]
RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC,OR]
RewriteCond %{HTTP:CONNECTION} ^Upgrade$ [NC]
RewriteRule .* ws://127.0.0.1:34567%{REQUEST_URI} [proxy]

RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteRule .* http://127.0.0.1:34567%{REQUEST_URI} [proxy]
RequestHeader set X-Forwarded-Proto "https"
</syntaxhighlight>

Im Verzeichnis "htdocs" wird eine ".htaccess"-Datei abgelegt, die für eine
Weiterleitung auf das https-Protokoll sorgt:

<syntaxhighlight lang=apache line>
Redirect permanent / https://beispiel-chat.de/
</syntaxhighlight>

== Start des Servers ==

Der Chat-Server lässt sich starten mit:

<syntaxhighlight lang=shell>
cd $HOME/mattermost
./bin/mattermost
</syntaxhighlight>

Zum automatischen Start des Servers bei einem Reboot sollte
man einen systemd service einrichten:

~/.config/systemd/user/mattermost.service
<syntaxhighlight lang=ini>
[Unit]
Description=Mattermost Service

[Service]
WorkingDirectory=%h/mattermost
ExecStart=%h/mattermost/bin/mattermost server -c %h/mattermost/config/config.json
TimeoutStartSec=3600
KillMode=mixed
Restart=always
RestartSec=10

[Install]
WantedBy=default.target
</syntaxhighlight>

Service aktivieren und starten:
<syntaxhighlight lang=shell>
$ systemctl --user enable mattermost.service
$ systemctl --user start mattermost.service
</syntaxhighlight>

== Links ==

*[https://about.mattermost.com/ Mattermost Homepage (Englisch)]
*[https://github.com/mattermost/platform git Repository bei Github]
*[https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/mattermost Ansible Playbook für Hostsharing]
----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Ansible Playbook]]
[[Kategorie:Software]]
[[Kategorie:Messenger]]
[[Kategorie:Eigene Daemons]]

LLDAP

2024-12-11T19:13:21Z

Peh00-phor: Update auf v0.6.1

== LDAP Kontoverwaltung mit LLDAP ==

LLDAP ist ein LDAP Server, der in der Programmiersprache Rust implementiert ist. LLDAP verwendet eine relationale Datenbank zum Speichern der Accounts und Gruppen. LLDAP läßt sich als eigener Daemon betreiben. Er bringt ein einfaches Webfrontend für die Verwaltung der Konten und Gruppen und eine Funktion zum Passwort-Rücksetzen mit.

=== Vorbereitungen in HSAdmin ===

Mit Hilfe von HSAdmin werden im ersten Schritt ein Service-User, eine Domain und ein PostgreSQL-User mit PostgreSQL-Datenbank angelegt. Der Service-User heißt im folgenden "''xyz00-lldap''", die Domain "''account.hs-example.de''", PostgreSQL-User und -Datenbank heißen beide "''xyz00_lldap''". Das PostgreSQL-Passwort sei "''pg_password_99''".

=== Download und entpacken ===

Die aktuelle Version von LLDAP ist v0.6.1.

Ich melde mich als User "''xyz00-lldap''" und lade das Binärpaket mit wget:

<syntaxhighlight lang="bash">
wget https://github.com/lldap/lldap/releases/download/v0.6.1/amd64-lldap.tar.gz
tar xzf amd64-lldap.tar.gz
mv amd64-lldap lldap
</syntaxhighlight>

=== Konfiguration ===

Die Konfiguration erfolgt über eine Datei "''lldap_config.toml''" im Verzeichnis "''~/lldap''". die Datei erstelle ich wie folgt:

<syntaxhighlight lang="bash">
cd ~/lldap
touch lldap_config.toml
vim lldap_config.toml
</syntaxhighlight>

der Inhalt nach dem Bearbeiten ist zum Beispiel:

<syntaxhighlight lang="toml">
verbose=true
ldap_host = "127.0.0.1"
ldap_port = 33891
http_host = "127.0.0.1"
http_port= 33881
http_url = "https://account.hs-example.de"
jwt_secret = "generierte-zufallszeichenkett-als-secret"
ldap_base_dn = "dc=hs-example,dc=de"
ldap_user_dn = "admin"
ldap_user_email = "webmaster@hs-example.de"
ldap_user_pass = "ldap-admin-password-generieren"
force_ldap_user_pass_reset = false
database_url = "postgres://xyz00_lldap:pg_password_99@localhost/xyz00_lldap"
key_seed = "generierte-zufallszeichenkette"

[smtp_options]
enable_password_reset = true
server = "localhost"
port = 4025
smtp_encryption = "NONE"
from="LLDAP Admin <webmaster@hs-example.de>"

[ldaps_options]
enabled = false
</syntaxhighlight>

Bei der Installation sollten folgende Einstellungen angepasst werden:
* die Ports für LDAP und HTTP
* Die Domain "''hs-example.de''" bzw. "''account.hs-example.de''"
* Der Account-Präfix "''xyz00''"
* Die Passworte und Secret-Zeichenketten
* "''verbose''" soltle auf "''false''" geändert werden, wenn alles läuft.

Das Anlegen der Datenbank-Tabellen erfolgt und ein ersten Start des Servers erfolgt mit den Befehlen:

<syntaxhighlight lang="bash">
cd ~/lldap
./lldap create_schema
./lldap run
Ctrl-C
</syntaxhighlight>

=== Proxy-Konfiguration ===

Für den Zugriff auf das Admin-Frontend über den Browser konfiguriere ich die Domain:

<syntaxhighlight lang="bash">
cd ~/doms/account.hs-example.de
rm -rf subs/www subs-ssl/www htdocs-ssl
ln -s $HOME/lldap/app htdocs-ssl
touch htdocs-ssl/.htaccess
vim htdocs-ssl/.htaccess
</syntaxhighlight>

Mit dem Inhalt:

<syntaxhighlight lang="apache">
DirectoryIndex disabled
RewriteEngine On
RewriteBase /

RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteRule .* http://127.0.0.1:33881%{REQUEST_URI} [proxy]
RequestHeader set X-Forwarded-Proto "https"
</syntaxhighlight>

Achtung: Port 33881 wie in der Konfig-Datei anpassen!

=== LLDAP als Service einrichten ===

LLDAP soll als Service unter Kontrolle von SystemD laufen.

<syntaxhighlight lang="bash">
cd ~
mkdir -p .config/systemd/user
mkdir var
vim .config/systemd/user/lldap.service
</syntaxhighlight>

Inhalt der Datei:

<syntaxhighlight lang="toml">
[Unit]
Description=LLDAP Service

[Service]
WorkingDirectory=%h/lldap
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
ExecStart=%h/lldap/lldap run
StandardOutput=append:%h/var/lldap.log
StandardError=inherit
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target
</syntaxhighlight>

Aktivieren und Starten des Dienstes:

<syntaxhighlight lang="bash">
cd ~
systemctl --user daemon-reload
systemctl --user enable lldap.service
systemctl --user start lldap.service
</syntaxhighlight>

Wenn alles gut gegangen ist, kann mann sich als "''admin''" mit dem Passwort aus der Zeile "''ldap_user_pass''" unter https://account.hs-exampel.de anmelden.

=== weitere Verbesserungen ===

Bisher ging es darum, schnell einen LDAP-Dienst aufzusetzen. Leider lädt die fertig kompilierte Distribution, die wir hier benutzt haben, ihre Fonts, das CSS und JavaScript aus CDN-Netzwerken und von Google Servern. Das wollte ihr vermutlich nicht. Ich habe dazu den folgenden Issue im Github-Tracker gefunden: https://github.com/lldap/lldap/issues/93 Wenn ich richtig verstehe, kann man selbst eine Distribution erstellen, die die entsprechenden Ressourcen lokal hostet.

=== Links ===

* [https://github.com/lldap/lldap Github Projekt LLDAP]
* [https://github.com/lldap/lldap/tree/main?tab=readme-ov-file#client-configuration Client-Konfigurationsbeispiele]

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

Discourse installieren

2024-11-25T11:42:46Z

Peh00-phor:

{{Textkasten|gelb|Für Managed Server|Ein funktionierender Discourse-Server erfordert mehrere laufende Server-Dienste. Für den Betrieb ist ein Managed Server sinnvoll.}}

{{Textkasten|rot|Support von der Discourse-Community|Die Discourse-Entwickler haben sich entschieden, nur eine mehr oder weniger genormte Installationsmethode (via docker) zu unterstützen. Dies ist so auf der hostsharing-Architektur aufgrund mehrerer Bedenken und Überlegungen nicht möglich. Die Community ist durchaus hilfreich, geht aber davon aus, dass quasi alle Nutzer* eine "supported"e Installation durchgeführt haben. Wenn man in entsprechenden Kanälen nach Hilfe fragt, sollte man unbedingt erwähnen, dass man discourse selber anhand dieser hier lesbaren Anleitung installiert hat, um bereits entsprechenden Kommentaren und Nachfragen vorzugreifen.}}

== Über ==

In diesem Artikel wird die Installation von discourse, Version 2.1.0 (September 2018) beschrieben.

== Vorbereitungen ==

Mit Hilfe von HSAdmin wird angelegt:
# Ein User als Service-User mit ''/bin/bash'' als Shell, zum Beispiel Beispiel: ''xyz00-discourse''
# Eine Domain mit ''xyz00-discourse' als Domain-Administrator, zum Beispiel ''beispiel.discussion''
# Einen Postgresql-User ''xyz00_discourseuser'' mit Passwort ''meinPasswort''
# Eine Postgresql-Datenbank ''xyz00_discoursedb'' mit Datenbank-Owner ''xyz00_discourseuser''

Verwendete IP-Ports der Server-Dienste:
# Redis: localhost:32002
# Discourse-Web: localhost:13000

== Konfiguration der PostgreSQL Datenbank ==

{{Textkasten|gelb|PostgreSQL Extensions|Die PostgreSQL-Datenbank braucht die extensions <code>hstore</code>, <code>pg_trgm</code> und <code>unaccent</code>. Diese müssen vom hostsharing-support installiert werden.}}

Ansonsten liefe die Erstellung der Datenbank so:
<syntaxhighlight lang=sql line>
# su - postgres -c psql
CREATE DATABASE discourse;
CREATE USER discourse;
ALTER USER discourse WITH ENCRYPTED PASSWORD 'password';
ALTER DATABASE discourse OWNER TO discourse;
\connect discourse
CREATE EXTENSION hstore;
CREATE EXTENSION pg_trgm;
CREATE EXTENSION unaccent;
</syntaxhighlight>

Entsprechende Funktionalität (von den extensions abgesehen) ist auch über den HSAdmin verfügbar.

== Konfiguration des Redis Server ==

{{Textkasten|gelb|Firewall/Redis Port|Leider unterstützt discourse nicht die Kommunikation mit Redis über Unix-Sockets. Dementsprechend muss der für Redis konfigurierte Port von dem hostsharing-Support in der Firewall freigegeben werden.}}

<syntaxhighlight lang=shell>
cd
mkdir redis/etc redis/lib redis/log redis/run
</syntaxhighlight>

Anlegen einer Datei ''/home/pacs/xyz00/users/discourse/redis/etc/redis.conf'' mit folgendem Inhalt:

<syntaxhighlight lang=shell line>
daemonize no
pidfile /home/pacs/xyz00/users/discourse/redis/run/redis-server.pid
port 32002
tcp-backlog 128
bind 127.0.0.1
timeout 300
loglevel notice
logfile /home/pacs/xyz00/users/discourse/redis/log/redis.log
databases 16
save 900 1
save 300 10
save 60 10000
slave-serve-stale-data yes
appendonly no
dbfilename dump.rdb
dir /home/pacs/xyz00/users/discourse/redis/lib
</syntaxhighlight>

Für Discourse 3.x gilt: "Discourse requires Redis 6.2.0 or up"

Für Debian Buster und Bullseye ist daher das Installieren eines neueren Binaries erforderlich. Bei Debian Bookwork ist bereits Redis 7.0 enthalten (siehe https://packages.debian.org/search?keywords=redis-server).

Hier steht ein entsprechendes Binary für Debian Buster zur Verfügung, das mit dem Public Key von Timotheus geprüft werden kann:

* https://download.solidcharity.com/tarballs/tpokorra/hostsharing/redis-server-6.2.12-debian-buster.tar.gz
* Prüfsignatur: https://download.solidcharity.com/tarballs/tpokorra/hostsharing/redis-server-6.2.12-debian-buster.tar.gz.sig

Prüfen der Signatur:

<syntaxhighlight lang=shell>
gpg --verify redis-server-6.2.12-debian-buster.tar.gz.sig redis-server-6.2.12-debian-buster.tar.gz
</syntaxhighlight>

Das Binary muss nach <code>$HOME/bin</code> verschoben werden, und entsprechend beim Starten des Dienstes eingetragen werden.

== Installation von Ruby ==

Als User ''xyz00-discourse'': Installation von Ruby mit ''rbenv'' mit folgenden Befehlen:

Zunächst ''rbenv'' and ''ruby-build'':

<syntaxhighlight lang=shell line>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.profile
echo 'eval "$(rbenv init -)"' >> ~/.profile
</syntaxhighlight>

starte neue Shell:

<syntaxhighlight lang=shell>
exec bash
</syntaxhighlight>

Überprüfe rbenv-Installation

<syntaxhighlight lang=shell>
type rbenv
</syntaxhighlight>

Installiere ruby-build als rbenv-Plugin

<syntaxhighlight lang=shell>
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
</syntaxhighlight>

Nun kann die benötigte Ruby-Version installiert werden:

<syntaxhighlight lang=shell>
rbenv install 2.4
</syntaxhighlight>

== Installation von Discourse selber ==

Weiterhin Als User ''xyz00-discourse'':

<syntaxhighlight lang=shell>
cd ~
git clone https://github.com/discourse/discourse.git discourse
cd ~/discourse
</syntaxhighlight>

Die stabile Version auschecken:

<syntaxhighlight lang=shell>
git checkout stable
</syntaxhighlight>

Ruby Pakete installieren:

<syntaxhighlight lang=shell>
gem install bundler
bundle install -j$(getconf _NPROCESSORS_ONLN) --deployment --without development test
</syntaxhighlight>

== Konfiguration der Discourse Software ==

Anlegen einer Datei ''/home/pacs/xyz00/users/discourse/discourse/config/discourse.conf'' anhand der Beispiel-Datei:

<syntaxhighlight lang=shell>
cd ~/discourse
cp config/discourse_defaults.conf config/discourse.conf
</syntaxhighlight>

Anpassen folgender Inhalte:
<syntaxhighlight lang=ini line>
db_host = 127.0.0.1
db_port = 5432
#db_backup_port = 5432 #(auskommentieren)
db_name = xyz00_discoursedb
db_username = xyz00_discourseuser
db_password = "" #db password
hostname = "discourse.xyz00" # hostname
smtp_address = localhost
smtp_enable_start_tls = false
smtp_openssl_verify_mode = 'none'
developer_emails = # your email-address
redis_host = 127.0.0.1
redis_port = 32002
</syntaxhighlight>
===TODO: Secrets setzen! ===
Die Zufallswerte für die Variablen SECRET_KEY_BASE und OTP_SECRET erzeugt man durch zwei Aufrufe des Kommandos

<syntaxhighlight lang=shell>
RAILS_ENV=production bundle exec rake secret
</syntaxhighlight>

=== Sidekiq für Hintergrund-Aufgaben konfigurieren ===

''config/sidekiq.conf''

Wichtig: development auf production ändern.

Mit diesem Dienst werden z.B. die E-Mails zur Aktivierung oder zum Passwort Reset verschickt.

=== Problem mit Content Security Policy ===

Um ein Problem mit Content Security Policy zu lösen, weil manche Dateien über http nachgeladen werden, muss in der Datei <code>config/site_settings.yml</code> der Default Wert für force_https auf True gesetzt werden:
<syntaxhighlight lang=yaml line>
force_https:
default: true
</syntaxhighlight>
=== Problem beim Aufsetzen der Datenbank vermeiden ===

'''→ Notiz Mai 2024:''' dies scheint aktuell nicht aufzutreten.

Aus irgendeinem Grund wird beim Initialisieren der Datenbank versucht, den TYPE hotlinked_media_status zweimal in der Datenbank anzulegen. Der Grund ist nicht ersichtlich.

Es kann folgende Änderung an der Datei <code>db/migrate/20220428094026_create_post_hotlinked_media.rb</code> vorgenommen werden:
<syntaxhighlight lang=ruby line>
reversible do |dir|
dir.up { execute <<~SQL }
DO $$ BEGIN CREATE TYPE hotlinked_media_status AS ENUM('downloaded', 'too_large', 'download_failed', 'upload_create_failed'); EXCEPTION WHEN duplicate_object THEN null; END $$;
SQL
dir.down { execute <<~SQL }
DROP TYPE hotlinked_media_status
SQL
end
</syntaxhighlight>
=== Initialisieren der Datenbank ===

<syntaxhighlight lang=shell>
export SAFETY_ASSURED=1
# In Version 2.0.4 funktioniert db:migrate noch, ansonsten db:schema:load und seed nutzen!
# In Version 3.0.3 funktioniert db:migrate auch noch, db:schema:load ging nicht weil die Datei structure.sql fehlte
#RAILS_ENV=production bundle exec rails db:schema:load
#RAILS_ENV=production bundle exec rails db:seed
RAILS_ENV=production bundle exec rails db:migrate
</syntaxhighlight>

=== Kompilieren der Assets ===

<syntaxhighlight lang=shell>
RAILS_ENV=production bundle exec rails assets:precompile
</syntaxhighlight>

=== Konfiguration des Web-Servers (am Beispiel Puma) ===

Die Datei ''config/puma.conf'' anpassen (hier nur Änderungen angezeigt):

<syntaxhighlight lang=ini>
APP_ROOT = '/home/pacs/xyz00/users/discourse/discourse'
daemonize false
</syntaxhighlight>

== Starten der Dienste ==

Zum Start aller notwendigen Dienste sollte systemd benutzt werden.

Die folgenden Dateien müssen nach <code>.config/systemd/user/</code> kopiert werden (überlange Zeilen werden hier im Wiki umgebrochen)

redis.service:

<syntaxhighlight lang=ini line>
[Unit]
Description=Redis User Service

[Service]
WorkingDirectory=%h/var/redis
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
ExecStart=%h/bin/redis-server %h/etc/redis.conf
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target
</syntaxhighlight>

sidekiq.service:

<syntaxhighlight lang=ini line>
[Unit]
Description=Discourse Sidekiq Service

[Service]
WorkingDirectory=%h/discourse
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
Environment="RAILS_ENV=production"
Environment="DB_POOL=8"
Environment="MALLOC_ARENA_MAX=2"
ExecStart=%h/.rbenv/shims/bundle exec sidekiq -C %h/discourse/config/sidekiq.yml
StandardOutput=append:%h/var/log/sidekiq.out.log
StandardError=inherit
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target
After=redis.service
</syntaxhighlight>

discourse.service:

<syntaxhighlight lang=ini line>
[Unit]
Description=Discourse Web Service

[Service]
WorkingDirectory=%h/discourse
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
Environment="RAILS_ENV=production"
Environment="WEB_CONCURRENCY=2"
Environment="MAX_THREADS=5"
Environment="MALLOC_ARENA_MAX=2"
ExecStart=%h/.rbenv/shims/bundle exec puma -C config/puma.rb -e production -b tcp://127.0.0.1:13000
StandardOutput=append:%h/var/log/puma.out.log
StandardError=inherit
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target
After=redis.service
</syntaxhighlight>

== Einrichten des Apache VHost ==

<syntaxhighlight lang=shell>
cd ~/doms/beispiel.discuss
rm -rf htdocs-ssl subs/www subs-ssl/www
ln -s ~/live/public htdocs-ssl
touch htdocs-ssl/.htaccess
</syntaxhighlight>

Dann die ''htdocs-ssl/.htaccess'' (durch das gelinkte Verzeichnis entspricht das dem Pfad /home/pacs/xyz00/users/discourse/discourse/public/.htaccess ) mit dem Editor der Wahl öffnen und folgende Konfiguration einfügen:

<syntaxhighlight lang=apache line>
DirectoryIndex disabled

RequestHeader set X-Forwarded-Proto "https"

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* http://127.0.0.1:13000%{REQUEST_URI} [proxy,last]
</syntaxhighlight>
== Wartung ==
=== Backup ===

Discourse macht selbstätig backups und legt diese unter 'public/backups' ab. Enthalten ist ein Datenbank-Dump und die hochgeladenen Dateien.

Im Admin-Bereich lassen sich backups auch manuell antreten.

=== Admin Benutzer einladen ===

Manchmal brauchen wir einen neuen Admin Benutzer, den wir von der Kommandozeile aus einladen möchten.

<syntaxhighlight lang=shell>
cd /discourse
RAILS_ENV=production rake admin:invite[admin@example.org]
</syntaxhighlight>

=== Import aus mbox Archiven ===

Um zum Beispiel ein Mailman2 Archiv zu importieren, wo die Nachrichten als .mbox Datei vorliegen, sind folgende Schritte nötig:

Vorbereitungen an Discourse:

<syntaxhighlight lang=shell>
source .profile
cd discourse
bundle config set frozen false
IMPORT=1 bundle install
bundle config set frozen true
nano script/import_scripts/mbox/settings.yml
# dort ändern:
# data_dir: /home/pacs/xyz00/users/discourse/list-archiv
</syntaxhighlight>

Hochladen der Mailinglisten-Archive:
<syntaxhighlight lang=shell>
mkdir ~/list-archiv
# dort muss es Unterordner mit dem Namen der gewünschten Kategorie geben,
# und die mbox Datei muss auch diesen Namen haben, z.B.:
# ~/list-archiv/beispiel/beispiel.mbox
# ~/list-archiv/example/example.mbox
# um die Beiträge in den entsprechenden Kategorien beispiel und example einzufügen.
</syntaxhighlight>

Durchführen des Imports:
<syntaxhighlight lang=shell>
source .profile
cd discourse
RAILS_ENV=production IMPORT=1 bundle exec rails runner \
script/import_scripts/mbox.rb script/import_scripts/mbox/settings.yml
</syntaxhighlight>

=== Export ===
* Wenn ein Forum beendet wird, möchte man evtl. eine Sicherung als statische HTML Seiten.
** Das wird hier diskutiert: https://meta.discourse.org/t/how-do-i-export-the-complete-forum-as-static-html-pages/71007/3
* Um ein Forum von Discourse zu Flarum umzuziehen, hat Timotheus ein Skript geschrieben.
** Das Migrations-Skript: https://github.com/SolidCharity/discourse_to_flarum
** siehe auch https://discuss.flarum.org/d/4930-discourse-to-flarum-migration-support/29

=== Updates ===

Discourse wird über update via mail informieren (dies kann man m.W. abschalten).

Achtung: bei größeren Updates auch immer Änderungen an der Datei site_settings.yml (https://github.com/discourse/discourse/blob/main/config/site_settings.yml) beachten!

==== Am Beispiel von 3.0.3 auf 3.0.5 ====

# Im Web-Backend unter Administration->Backups-> Read-Only Mouds setzen (oder Web Server so konfigurieren, dass keine Zugriffe mehr stattfinden können)
# Backup
# Die lokalen Änderungen sichern:
# cd discourse
# git diff v3.0.3 > diff-3.0.3.txt
# git fetch
# git checkout -b hostsharing-deployment-v3.0.5 v3.0.5
# evtl. Änderungen aus diff-3.0.3.txt wieder übernehmen und committen
# patch -p1 < diff-3.0.3.txt
# git commit -a -m "spezifische Änderungen für diese Instanz" --no-verify
# Schauen, ob discourse (endlich :) ) eine neue Ruby-Version nutzt (z.B. in https://github.com/discourse/discourse/blob/stable/.ruby-version.sample)
# Dies ist der Fall, also
# rbenv install 3.2.1
# rbenv rehash
# echo "3.2.1" > .ruby-version
# source ~/.profile
# gem update --system
# bundle
# yarn install
# RAILS_ENV=production bundle exec rake db:migrate
# RAILS_ENV=production bundle exec rake assets:precompile
# Services neu starten
<syntaxhighlight lang=shell>
systemctl --user restart puma
systemctl --user restart sidekiq
systemctl --user restart redis
</syntaxhighlight>
* Zuletzt: Read-Only Modus wieder deaktivieren

=== Debugging ===

Es können folgende Einstellungen in der Datei config/environments/production.rb vorgenommen werden. Danach den Puma Dienst neustarten. Fehlermeldungen und Stacktraces werden dann im Browser ausgegeben.

<syntaxhighlight lang="ini" line>
config.log_level = :debug
config.action_dispatch.show_exceptions = :all
config.action_dispatch.debug_exception_log_level = :error

# Full error reports are enabled and caching is turned off
config.consider_all_requests_local = true
config.action_controller.perform_caching = false
</syntaxhighlight>

=== Erforderliche Anpassungen ===
Weil wir bei Debian Bookworm noch mit ImageMagick 6.9 arbeiten, muss dieser [https://github.com/discourse/discourse/commit/17aa831337e352dfd875f1b4ddc4492bd0835119 Patch] rückgängig gemacht werden:

<syntaxhighlight lang="bash" line>
wget https://github.com/discourse/discourse/commit/17aa831337e352dfd875f1b4ddc4492bd0835119.patch -O ~/imagemagick.patch
patch -p1 --reverse < ~/imagemagick.patch
git commit -a -m "revert imagemagick patch" --no-verify
</syntaxhighlight>

== ToDos ==

* Ein Patch, um Discourse auch via Unix-Socket mit Redis sprechen lassen zu können dürfte relativ einfach sein (es wird ein Wrapper um das redis-gem genutzt).
* Konfiguration von discourse, um mit postgresql via Unix-Socket zu kommunizieren (DISCOURSE_DB_SOCKET environment variable)
* Performance-tuning an diversen Stellen, anhand der discourse_docker-Vorgaben (https://github.com/discourse/discourse_docker), z.B.
** thpoff (huge page settings)
** unicorn (hat eine wesentlich ausgefeiltere Konfigurations-Vorlage, wahrscheinlich bereits ordentlich optimiert)

== Links ==

* https://help.skysilk.com/support/solutions/articles/9000120927-how-to-install-discourse-without-docker-using-skysilk-vps-
* https://github.com/discourse/discourse_docker
* https://github.com/discourse/discourse
* https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/discourse

== Historie ==

* 2018, 14 . September: Initiale Fassung
* 2019, Januar: Update-Informationen ergänzt
* 2022, Juni: systemd Dienste, Discourse 3.0

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:RubyOnRails]]
[[Kategorie:Webforen]]
[[Kategorie:Ansible Playbook]]

Tomcat Installieren

2024-11-25T11:41:03Z

Peh00-phor: /* Start des Tomcat Servers */

Apache Tomcat installieren

== Allgemein ==

[http://tomcat.apache.org/ Apache Tomcat] ist ein Webserver (HTTP-Server), der in der Programmiersprache Java entwickelt ist. Er dient in erster Linie dazu, dynamische Web-Anwendungen zu betreiben, die ebenfalls in Java programmiert sind. Basis-Technologien sind [http://de.wikipedia.org/wiki/Servlet Java-Servlets] und [http://de.wikipedia.org/wiki/JSP Java Server Pages (JSP)].

Mit Hilfe von Apache Tomcat ist bei Hostsharing das Hosting von komplexen Java Web-Applikationen problemlos möglich.

== Spezielle Installation bei Hostsharing ==

In jedem dynamischen Webhosting-Paket der Hostsharing eG können einer (oder mehrere) Tomcat-Webserver betrieben werden.

Dazu muss für jede Tomcat-Instanz die Option "Betrieb eines eigenen Serverdienstes" gebucht werden. Im Bereich des Shared Hosting ist die Option kostenpflichtig.

Diese Anleitung dokumentiert die Installation des Apache Tomcat Servers als Service-User in einem WEB-Paket bei Hostsharing. Mit der Einrichtung der Option "eigener Serverdienst" werden für die Paket-IP-Adresse einer oder mehrere IP-Ports reserviert. An diese Ports wird der eigene Serverdienst (also der Tomcat-Server) am Localhost-Interface gebunden.

Geben Sie bei der Bestellung der Option "Eigener Serverdienst" an:

# den Service User, mit dessen Rechten der Tomcat-Dienst laufen soll (also zum Beispiel "xyz00-tomcat")
# wieviele IP-Ports reserviert werden sollen (in der folgenden Anleitung verwenden wir drei nicht-privilegierte Ports:
* 38005 als "Shutdown"-Schnittstelle
* 38006 für eine AJP-Listener

== Installation ==

Vorbemerkung: Mit Debian 12 ('Bookworm') wird Tomcat 10 von der Distribution mitgeliefert.

Auf den Hostsharing-Servern ist das Debian-Paket "tomcat10-user" installiert. Es stellt den
Apache Tomcat Server in der Version 10.1.x für den Betrieb als normaler (nicht privilegierter) User bereit.
Dabei wird die zentral installierte Tomcat-Software benutzt, die über Betriebssystem-Updates mit Sicherheits-Updates versorgt wird.

Für die Installation der Konfigurations-Dateien in Heimat-Verzeichnis des Benutzers wird folgender Befehl
mit den Rechten des Service-Users aufgerufen:

<syntaxhighlight lang="bash">
xyz00-tomcat@h00:~$ tomcat10-instance-create tomcat
</syntaxhighlight>

Ich bevorzuge das catalina.sh-Startskript zum Testen:

<syntaxhighlight lang="bash">
xyz00-tomcat@h00:~$ cp /usr/share/tomcat10/bin/catalina.sh tomcat/bin/
</syntaxhighlight>

Dieser Befehl legt ein Verzeichnis "tomcat" mit der üblichen Dateistruktur für einen Tomcat-Server an:

<syntaxhighlight lang="bash">
bin
bin/catalina.sh
bin/setenv.sh
bin/shutdown.sh
bin/startup.sh
conf
conf/catalina.properties
conf/context.xml
conf/jaspic-providers.xml
conf/logging.properties
conf/server.xml
conf/tomcat-users.xml
conf/web.xml
logs
policy
policy/catalina.policy
temp
webapps
work
</syntaxhighlight>

In der Hauptsache muss die Konfigurationsdatei "server.xml" im Verzeichnis "~/tomcat/conf/" angepasst werden.

Beispiel für eine minimale "server.xml":

<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="UTF-8"?>
<Server port="38005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.startup.VersionLoggerListener" />
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
</GlobalNamingResources>
<Service name="Catalina">
<Connector protocol="AJP/1.3" address="127.0.0.1" port="38006" redirectPort="443" secretRequired="false" />
<Engine name="Catalina" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
</Realm>
<Host name="localhost" appBase="../webapps" unpackWARs="true" autoDeploy="true"></Host>
</Engine>
</Service>
</Server>
</syntaxhighlight>

Angepasst werden müssen:
* die beiden IP-Ports (im Beispiel 38005 und 38006 am Localhost-Interface)

== Deployment einer Anwendung ==

In der Beispiel-Konfiguration wurde das Verzeichnis ''$HOME/webapps/'' für die Anwendungen konfiguriert. Wir legen dieses Verzeichnis an und kopieren eine minimale Anwendung hinein:

<syntaxhighlight lang="bash">
mkdir -p $HOME/webapps/hello/WEB-INF/
</syntaxhighlight>

Dort legen wir die Datei ~/webapps/hello/WEB-INF/web.xml mit folgendem Inhalt an:

<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="UTF-8"?>
<web-app
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
</web-app>
</syntaxhighlight>

Dazu eine einfache JSP-Datei ~/webapps/hello/index.jsp:

<syntaxhighlight lang="html" line>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html lang="de-de">
<body>
<h1>Hallo Welt</h1>
<p>Java Version: <%= System.getProperty("java.version") %></p>
</body>
</html>
</syntaxhighlight>

Nun können wir die HTTP-Requests, die an eine Domain im Paket gesendet werden, an den Tomcat weiterleiten.
Das funktioniert über eine ''.htaccess''-Datei, zum Beispiel im Verzeichnis ''~/doms/hs-example.de/htdocs-ssl'':

<syntaxhighlight lang="apache" line>
DirectoryIndex disabled
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.*) ajp://127.0.0.1:38006/$1 [proxy,last]
</syntaxhighlight>

Achtung der IP-Port 38006 muss hier wieder angepasst werden!

Dadurch ist die Mini-Anwendung unter der URL "https://hs-example.de/hello/" erreichbar.

== Start des Tomcat Servers ==

Der Tomcat kann über die Skripte in "~/tomcat/bin/" gestartet und gestoppt werden.

<syntaxhighlight lang="bash">
cd ~/tomcat
./bin/startup.sh
</syntaxhighlight>

Log-Ausgaben des Servers sind in "~/tomcat/logs/catalina.out" zu finden.

Damit der Tomcat bei einem Reboot der Hostsharing-Server automatisch gestartet wird,
konfigurieren wir den Prozessmonitor ''systemd'' entsprechend.

Wir legen ein Verzeichnis für die Konfiguration des ''systemd'' an und legen eine Unit-Konfiguration für einen Service dort ab:

<syntaxhighlight lang="bash">
mkdir -p ~/.config/systemd/user
</syntaxhighlight>

Die Unit-Datei ''~/.config/systemd/user/tomcat.service''

<syntaxhighlight lang="ini" line>
[Unit]
Description=Tomcat User Service

[Service]
WorkingDirectory=%h/tomcat
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64"
Environment="JAVA_OPTS=-Xms256M -Xmx512M"
ExecStart=%h/tomcat/bin/catalina.sh run
StandardOutput=append:%h/tomcat/logs/catalina.log
StandardError=inherit
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target
</syntaxhighlight>

Auf Wunsch kann ''SystemD'' RAM- und CPU-Ressourcen begrenzen. Dazu wird der Abschnitt ''Service'' ergänzt:

<syntaxhighlight lang="ini" line>
[Service]
...
MemoryAccounting=true
CPUAccounting=true
MemoryHigh=512M
MemoryMax=768M
CPUQuota=50%
</syntaxhighlight>

Die letzte Aufgabe ist das Einrichten der Bereinigung für die Log-Dateien.

Dazu lege ich die Konfigurationsdatei ''.logrotate'' im $HOME-Verzeichnis an:

<syntaxhighlight lang="bash" line>
/home/pacs/xyz00/users/tomcat/tomcat/logs/catalina.log {
copytruncate
compress
rotate 5
daily
missingok
}
</syntaxhighlight>

Für die Bereinigung der Log-Dateien noch eine ''crontab'':

<syntaxhighlight lang="bash" line>
PATH=/usr/local/bin:/usr/bin:/bin
HOME=/home/pacs/xyz00/users/tomcat
MAILTO=ich@meine-domain.de
# m h dom mon dow command
1 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate
14 3 * * * /usr/bin/find $HOME/tomcat/logs -type f -mmin +10080 -delete
</syntaxhighlight>

Dann gehen wir daran unsere Anwendungen im Tomcat zu deployen.

== Links ==

*[http://tomcat.apache.org/ Apache Tomcat Homepage (Englisch)]
*[http://tomcat.apache.org/tomcat-9.0-doc/index.html Apache Tomcat Dokumentation (Version 9.0, Englisch)]
*[http://wiki.apache.org/tomcat/FrontPage Apache Tomcat Wiki (Englisch)]
*[https://github.com/tpokorra/Hostsharing-Ansible-Tomcat Ansible Playbook für Hostsharing]

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Ansible Playbook]]
[[Kategorie:Software]]
[[Kategorie:Java]]
[[Kategorie:Eigene Daemons]]

LLDAP

2024-11-25T11:40:19Z

Peh00-phor: /* LLDAP als Service einrichten */

== LDAP Kontoverwaltung mit LLDAP ==

LLDAP ist ein LDAP Server, der in der Programmiersprache Rust implementiert ist. LLDAP verwendet eine relationale Datenbank zum Speichern der Accounts und Gruppen. LLDAP läßt sich als eigener Daemon betreiben. Er bringt ein einfaches Webfrontend für die Verwaltung der Konten und Gruppen und eine Funktion zum Passwort-Rücksetzen mit.

=== Vorbereitungen in HSAdmin ===

Mit Hilfe von HSAdmin werden im ersten Schritt ein Service-User, eine Domain und ein PostgreSQL-User mit PostgreSQL-Datenbank angelegt. Der Service-User heißt im folgenden "''xyz00-lldap''", die Domain "''account.hs-example.de''", PostgreSQL-User und -Datenbank heißen beide "''xyz00_lldap''". Das PostgreSQL-Passwort sei "''pg_password_99''".

=== Download und entpacken ===

Die aktuelle Version von LLDAP ist v0.5.0.

Ich melde mich als User "''xyz00-lldap''" und lade das Binärpaket mit wget:

<syntaxhighlight lang="bash">
wget https://github.com/lldap/lldap/releases/download/v0.5.0/amd64-lldap.tar.gz
tar xzf amd64-lldap.tar.gz
mv amd64-lldap lldap
</syntaxhighlight>

=== Konfiguration ===

Die Konfiguration erfolgt über eine Datei "''lldap_config.toml''" im Verzeichnis "''~/lldap''". die Datei erstelle ich wie folgt:

<syntaxhighlight lang="bash">
cd ~/lldap
touch lldap_config.toml
vim lldap_config.toml
</syntaxhighlight>

der Inhalt nach dem Bearbeiten ist zum Beispiel:

<syntaxhighlight lang="toml">
verbose=true
ldap_host = "127.0.0.1"
ldap_port = 33891
http_host = "127.0.0.1"
http_port= 33881
http_url = "https://account.hs-example.de"
jwt_secret = "generierte-zufallszeichenkett-als-secret"
ldap_base_dn = "dc=hs-example,dc=de"
ldap_user_dn = "admin"
ldap_user_email = "webmaster@hs-example.de"
ldap_user_pass = "ldap-admin-password-generieren"
force_ldap_user_pass_reset = false
database_url = "postgres://xyz00_lldap:pg_password_99@localhost/xyz00_lldap"
key_seed = "generierte-zufallszeichenkette"

[smtp_options]
enable_password_reset = true
server = "localhost"
port = 4025
smtp_encryption = "NONE"
from="LLDAP Admin <webmaster@hs-example.de>"

[ldaps_options]
enabled = false
</syntaxhighlight>

Bei der Installation sollten folgende Einstellungen angepasst werden:
* die Ports für LDAP und HTTP
* Die Domain "''hs-example.de''" bzw. "''account.hs-example.de''"
* Der Account-Präfix "''xyz00''"
* Die Passworte und Secret-Zeichenketten
* "''verbose''" soltle auf "''false''" geändert werden, wenn alles läuft.

Das Anlegen der Datenbank-Tabellen erfolgt und ein ersten Start des Servers erfolgt mit den Befehlen:

<syntaxhighlight lang="bash">
cd ~/lldap
./lldap create_schema
./lldap run
Ctrl-C
</syntaxhighlight>

=== Proxy-Konfiguration ===

Für den Zugriff auf das Admin-Frontend über den Browser konfiguriere ich die Domain:

<syntaxhighlight lang="bash">
cd ~/doms/account.hs-example.de
rm -rf subs/www subs-ssl/www htdocs-ssl
ln -s $HOME/lldap/app htdocs-ssl
touch htdocs-ssl/.htaccess
vim htdocs-ssl/.htaccess
</syntaxhighlight>

Mit dem Inhalt:

<syntaxhighlight lang="apache">
DirectoryIndex disabled
RewriteEngine On
RewriteBase /

RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
RewriteRule .* http://127.0.0.1:33881%{REQUEST_URI} [proxy]
RequestHeader set X-Forwarded-Proto "https"
</syntaxhighlight>

Achtung: Port 33881 wie in der Konfig-Datei anpassen!

=== LLDAP als Service einrichten ===

LLDAP soll als Service unter Kontrolle von SystemD laufen.

<syntaxhighlight lang="bash">
cd ~
mkdir -p .config/systemd/user
mkdir var
vim .config/systemd/user/lldap.service
</syntaxhighlight>

Inhalt der Datei:

<syntaxhighlight lang="toml">
[Unit]
Description=LLDAP Service

[Service]
WorkingDirectory=%h/lldap
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
ExecStart=%h/lldap/lldap run
StandardOutput=append:%h/var/lldap.log
StandardError=inherit
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target
</syntaxhighlight>

Aktivieren und Starten des Dienstes:

<syntaxhighlight lang="bash">
cd ~
systemctl --user daemon-reload
systemctl --user enable lldap.service
systemctl --user start lldap.service
</syntaxhighlight>

Wenn alles gut gegangen ist, kann mann sich als "''admin''" mit dem Passwort aus der Zeile "''ldap_user_pass''" unter https://account.hs-exampel.de anmelden.

=== weitere Verbesserungen ===

Bisher ging es darum, schnell einen LDAP-Dienst aufzusetzen. Leider lädt die fertig kompilierte Distribution, die wir hier benutzt haben, ihre Fonts, das CSS und JavaScript aus CDN-Netzwerken und von Google Servern. Das wollte ihr vermutlich nicht. Ich habe dazu den folgenden Issue im Github-Tracker gefunden: https://github.com/lldap/lldap/issues/93 Wenn ich richtig verstehe, kann man selbst eine Distribution erstellen, die die entsprechenden Ressourcen lokal hostet.

=== Links ===

* [https://github.com/lldap/lldap Github Projekt LLDAP]
* [https://github.com/lldap/lldap/tree/main?tab=readme-ov-file#client-configuration Client-Konfigurationsbeispiele]

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

PHP FPM

2024-11-25T11:39:32Z

Peh00-phor: /* Start und Autostart des FPM-Prozess */

= PHP als eigener Prozess =

Normalerweise starten PHP-Prozesse im Managed Webspace als FastCGi-Prozess unter Kontrolle des Apache Webserver. Der Apache übernimmt die Skalierung und startet bei Bedarf weitere Prozesse nach.

Nutzer:innen eines Managed Server können alternativ PHP-FPM Nutzen. Sie starten einen FPM-Prozess unter der eigenen Kontrolle. Dieser Hauptprozess übernimmt die Skalierung und Kontrolliert den Lifecycle von PHP-Prozessen nach den wünschen der Webseitenbetreiber:in.

== Konfiguration von FPM ==

Hier nur ein minimales Beispiel. Für die Optimierung sein auf die entsprechende Originaldokumentation verwiesen.

~/php-fpm$ cat ~/php-fpm/php-fpm.conf

[global]
pid = /home/pacs/xyz00/users/username/php-fpm/php-fpm.pid
error_log = /home/pacs/xyz00/users/username/php-fpm/php-fpm.log

[www]
listen = 127.0.0.1:30080
listen.allowed_clients = 127.0.0.1
pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
;pm.process_idle_timeout = 10s;
;pm.max_requests = 500

== Apache Konfiguration ==

Der FPM-Server wird über das Apache Modul "mod_proxy_fcgi" angesteuert. Dazu legt man im Verzeichnis
~/doms/hs-example.de/ eine Datei .htaccess an.

$ cat doms/hs-example.de/.htaccess
RewriteEngine on
RewriteRule ^(.*)\.php(/.*)?$ fcgi://127.0.0.1:30080/home/doms/hs-example.de/htdocs-ssl/$1.php$2 [proxy,last]

== Start und Autostart des FPM-Prozess ==

Der FPM-Prozess wird wie folgt gestartet:

/usr/sbin/php-fpm8.2 --fpm-config php-fpm/php-fpm.conf --php-ini php-fpm/php.ini --nodaemonize

Eine Unit für SystemD könnte wie folgt aussehen:

[Unit]
Description=PHP FPM Service

[Service]
Type=simple
WorkingDirectory=%h
Environment="PATH=/usr/local/sbin:/usr/sbin:/sbin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/usr/sbin/php-fpm8.2 --fpm-config %h/php-fpm/php-fpm.conf --php-ini %h/php-fpm/php.ini --nodaemonize
StandardOutput=append:%h/var/php-fpm.log
StandardError=inherit
Restart=always
PrivateTmp=true

[Install]
WantedBy=default.target

CouchDB

2024-11-25T11:38:41Z

Peh00-phor: /* Start mit SystemD */

= CouchDB =

Mit Debian Buster wird CouchDB nicht mehr als Debian Paket auf allen unseren Managed Servern installiert sein.

Ein paar Notizen zum Selbstbau (unter Bookworm):

wget https://downloads.apache.org/couchdb/source/3.3.3/apache-couchdb-3.3.3.tar.gz
tar xzf apache-couchdb-3.3.3.tar.gz
cd apache-couchdb-3.3.3
./configure --spidermonkey-version 78
make release
mv rel/couchdb ..
cd ..
rm -rf apache-couchdb-3.3.0*

== Konfiguration ==

In der Datei ''~/couchdb/etc/local.ini'':

[chttpd]
port = 35994
bind_address = 127.0.0.1
...
[admins]
admin = mein-couch-admin-password

== Start mit SystemD ==

xyz00-couchdb@h00:~$ cat .config/systemd/user/couchdb.service

[Unit]
Description=CouchDB User Service

[Service]
WorkingDirectory=%h/couchdb
Environment="HOME=%h"
Environment="ERL_EPMD_ADDRESS=127.0.0.1"
Environment="ERL_EPMD_PORT=34369"
Environment="COUCHDB_BASE=%h/couchdb"
ExecStart=%h/couchdb/bin/couchdb
StandardOutput=append:%h/couchdb/var/log/couchdb.log
StandardError=inherit
Restart=always
PrivateTmp=true
NoNewPrivileges=true

[Install]
WantedBy=default.target

Starten und Aktivieren des Service:

systemctl --no-pager --user daemon-reload
systemctl --no-pager --user start couchdb.service
systemctl --no-pager --user status couchdb.service
systemctl --no-pager --user enable couchdb.service

== Dump und Restore ==

Mit dem folgenden Skript kann man einzelne Datenbanken aus einer CouchDB-Instanz sichern und wiederherstellen:

* https://github.com/danielebailo/couchdb-dump

Prozessmanagement mit systemd im Userspace

2024-11-25T11:37:15Z

Peh00-phor: /* systemd Unit */

== Über systemd ==
''systemd'' ist seit einigen Jahren das Init-System aller gängigen Linux-Distributionen. Der ''init''-Prozess ist im laufenden System der Prozess mit der Nummer "1", der alle anderen Prozesse als Kind-Prozesse verwaltet.

Auch ein normaler Account ohne besondere Privilegien kann systemd nutzen, um Prozesse im Userspace zu starten und zu kontrollieren. Auf der Hostsharing Managed Plattform hat jeder Account mit einer gültigen Login-Shell die Möglichkeit Dienste unter Kontrolle von systemd zu starten. In einem Webspace im Shared Hosting ist es zwingend systemd als Prozessmonitor für eigene Serverdienste zu nutzen; auf einem Managed Server ist es die empfohlene Vorgehensweise ("Best practice").

== Eigene Serverdienste mit systemd ==

In diesem Wiki finden sich viele Beispiele für systemd-Units zur Kontrolle eines Serverdienstes. An dieser Stelle folgen Erläuterungen für die wichtigsten Einstellungen.

Voraussetzung: In ''HSAdmin'' wird ein Service-User zur Rechtetrennung dieses Dienstes von anderen Anwendungen angelegt. In diesem Artikel soll der Beispiel-User ''xyz00-service'' im Webspace ''xyz00'' sein. Dieser User bekommt bei der Einrichtung eine gültige Shell zugewiesen, so dass man sich per ''ssh'' oder vom Paketadmin mit einem Befehl ''sudo -i -u xyz00-service'' anmelden kann. Die Umgebungsvariable ''XDG_RUNTIME_DIR'' sollte im Environment des Users gesetzt sein, wenn man erfolgreich angemeldet ist. Das testet man mit

<syntaxhighlight lang="bash">
echo $XDG_RUNTIME_DIR
</syntaxhighlight>

Die Ausgabe sollte sein:

<syntaxhighlight lang="bash">
xyz00-service@h01:~$ echo $XDG_RUNTIME_DIR
/run/user/112345
xyz00-service@h01:~$
</syntaxhighlight>

Dabei wird statt ''112345'' eine andere Zahl erscheinen. Diese Zahl ist die numerische User-Id des Users ''xyz00-service'' im System.

=== systemd Unit ===

Die systemd-Units für einen User werden im Verzeichnis ''$HOME/.config/systemd/user/'' verwaltet. Dieser Pfad ist fest vorgegeben. Für einen neuen User legt man also zuerst dieses Verzeichnis an:

<syntaxhighlight lang="bash">
mkdir -p $HOME/.config/systemd/user
</syntaxhighlight>

In diesem Verzeichnis wird für jeden Service eine Datei mit der Endung ''.service'' angelegt. Ich verwende hier eine Beispielkonfiguration für eine GotoSocial-Instanz. GotoSocial ist ein einfaches Binärprogramm, das in der Programmiersprache ''Go'' programmiert ist.

<syntaxhighlight lang="ini" line>
[Unit]
Description=GotoSocial Service
#After=my-redis.service

[Service]
Type=simple
WorkingDirectory=%h/gotosocial
Environment="PATH=/usr/local/bin:/usr/bin:/bin"
ExecStart=%h/gotosocial/gotosocial --config-path %h/gotosocial/config.yaml server start
StandardOutput=append:%h/var/gotosocial.log
StandardError=inherit
Restart=always
PrivateTmp=true

[Install]
WantedBy=default.target
</syntaxhighlight>

Die meisten Eigenschaften sind selbsterklärend. Folgende Eigenschaften sind einstellbar:

; After: Hier kann eingestellt werden, welcher Dienst vorher starten muss, bevor dieser Dienst gestartet wird. Wenn GotoSocial eine Redis Instanz benötigt, könnte das entsprechend eingestellt werden.
; Type=simple : ''simple'' ist die Voreinstellung und kann weggelassen werden. Evtl. braucht man auch ''forking'', wenn ein Dienst als Daemon im Hintergrund startet. Wenn man die Wahl hat, sollte man den Dienst immer im Vordergrund starten und nicht forken.
; WorkingDirectory : ist das Verzeichnis, in dem der Dienst gestartet wird. %h ist in dieser Datei eine Abkürzung für das Home-Verzeichnis des Users.
; Environment : Hier wird die Variable ''PATH'' definiert. Man kann mehrere Einträge des Namens ''Environment'' eintragen und bei Bedarf eine beliebige Anzahl von Environment-Variablen definieren.
; ExecStart : Das Programm, das als Dienst ausgeführt wird. Man kann eine komplette Kommandozeile angeben.
; StandardOutput : Eine Log-Datei in die die Standardausgabe des laufenden Dienstes geschrieben wird.
; StandardError : Entsprechend zu ''StandardOutput''. Mit ''inherit'' wird der die Datei von ''StandardOutput'' geerbt.
; Restart=always : Der Dienst soll grundsätzlich neu gestartet werden, wenn der Prozess unerwartet beendet wird.
; PrivateTmp=true : ''/tmp'' und ''/var/tmp'' werden temporär im Namespace gemountet, so dass sie nicht mit anderen Prozessen geteilt werden.
; WantedBy : sollte im Usermodus von systemd meistens ''default.target'' sein. Andere Targets sind z.B. ''base.target'' oder ''timers.target''. Für eine komplette Liste: <code>systemctl list-units --user --type=target</code>

==== RAM- und CPU-Limits ====

Auf Wunsch kann man die RAM- und CPU-Ressourcen für den Dienst begrenzen. Dazu trägt man weitere Eigenschaften im Abschnitt ''Service'' ein:

<syntaxhighlight lang="ini" line>
[Service]
...
MemoryAccounting=true
CPUAccounting=true
MemoryHigh=512M
MemoryMax=768M
CPUQuota=50%
</syntaxhighlight>

; MemoryHigh : Weiches RAM-Limit, das ggf. überschritten werden kann, wenn es unvermeidlich ist.
; MemoryMax : Hartes, absolutes RAM-Limit.
; CPUQuota : Maximale Belegung eines CPU-Threads in Prozent. Werte über 100% sind sinnvoll, wenn mehr als ein CPU-Thread verfügbar ist.

==== Ausführliche Dokumentation der Direktiven ====
Eine ausführliche Dokumentation der Direktiven findet sich hier:

https://www.freedesktop.org/software/systemd/man/latest/systemd.directives.html

=== systemd Unit starten und stoppen ===

Nachdem die systemd-Unit definiert ist, soll der Dienst gestartet werden.
Für die Verwaltung des Dienstes stehen die folgenden Kommandos zur Verfügung:

==== Reload ====

<syntaxhighlight lang="bash">
systemctl --user daemon-reload
</syntaxhighlight>

Die Konfigurationsdateien im Verzeichnis ''$HOME/.config/systemd/user/'' werden neu eingelesen. Dieses Kommando ist nach jeder Änderung einer ''.service''-Datei nötig.

==== Start und Stopp ====

<syntaxhighlight lang="bash">
systemctl --user start gotosocial.service
</syntaxhighlight>

bzw.

<syntaxhighlight lang="bash">
systemctl --user stop gotosocial.service
</syntaxhighlight>

sind die Kommandos zum Starten und Beenden des Dienstes.

==== Enable und Disable ====

<syntaxhighlight lang="bash">
systemctl --user enable gotosocial.service
</syntaxhighlight>

bzw.

<syntaxhighlight lang="bash">
systemctl --user disable gotosocial.service
</syntaxhighlight>

sind die Kommandos, die den Dienst für einen Reboot des Servers aktivieren bzw. deaktivieren.

==== Status ====

<syntaxhighlight lang="bash">
systemctl --user status
</syntaxhighlight>

oder

<syntaxhighlight lang="bash">
systemctl --user status gotosocial.service
</syntaxhighlight>

zeigen den Status aller Dienste des Users bzw. eines bestimmten Dienstes an.

== Zeitgesteuerte Ausführung mit systemd ==

Bisher wurden meistens cronjobs eingesetzt, um wiederkehrende Aufgaben zu erledigen.

Auch Cronjobs können durch systemd ersetzt werden. Ergänzend zu einem »service-file« wird eine weitere Unit, nämlich ein »timer-file« mit der Endung ».timer« angelegt und aktiviert.

=== Einrichten des »service-files« ===

<syntaxhighlight lang=bash>
$ cat $HOME/.config/systemd/user/my-cleanup.service

[Unit]
Description=My Cleanup Service

[Service]
Type=oneshot
ExecStart=%h/bin/cleanup-script
</syntaxhighlight>

=== Testen ===

<syntaxhighlight lang=bash>
$ systemctl --user start my-cleanup.service
</syntaxhighlight>

=== Einrichten des »timer-files« ===

<syntaxhighlight lang=bash>
$ cat $HOME/.config/systemd/user/my-cleanup.timer

[Unit]
Description=Daily My Cleanup Timer

[Timer]
OnCalendar=daily

[Install]
WantedBy=timers.target
</syntaxhighlight>

Eine ausführliche Dokumentation der Direktiven findet sich hier:

https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html

=== Aktivieren der zeitgesteuerten Ausführung ===

<syntaxhighlight lang=bash>
$ systemctl --user enable my-cleanup.timer
</syntaxhighlight>

== RAM Kontingent eines Webspace ==

Den aktuell belegten RAM eines Webspace ''xyz00'' kann man sich mit dem Befehl

<syntaxhighlight lang="bash">
systemctl status pacs-xyz00.slice
</syntaxhighlight>

ansehen.

Etwa in der fünften Zeile der Ausgabe findet man eine Angabe der Form:

<syntaxhighlight lang="bash">
Memory: 58.4M (max: 14.8G available: 14.8G)
</syntaxhighlight>

Hier sind aktuell 58,4 Megabyte RAM genutzt, es sind 14,8 Gigabyte RAM für den Webspace verfügbar. Der verfügbare RAM ist das gebuchte Kontingent. Das gebuchte Kontigent wird im Shared Hosting deutlich kleiner sein.

Das RAM Kontingent wird in Schritten von jeweils 128 Ḿegabyte gebucht. Änderungen des RAM Kontingents für einen Webspace nimmt der Service unter [mailto:service@hostsharing.net service@hostsharing.net] entgegen, wie es bei anderen Paketoptionen die Vorgehensweise ist.

= weiterführende Links =

* https://www.freedesktop.org/software/systemd/man/latest/systemd.directives.html
* https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html

----
[[Kategorie:systemd]]
[[Kategorie:Eigene Daemons]]

Redmine in Tomcat installieren

2011-02-17T13:26:43Z

Peh00-phor:

== Redmine im Tomcat installieren ==

[http://redmine.org Redmine] ist ein Werkzeug zur Projektverwaltung - in erster Linie für Software-Entwicklungs-Projekte geeignet.

Redmine ist in [http://www.ruby-lang.org/de/ Ruby] mit dem Framework [http://rubyonrails.org/ Ruby on Rails] programmiert. Es steht unter der [http://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU General Public License v2] (GPL).

Hier soll es als Beispiel dienen, wie man auf der [http://www.hostsharing.net Hostsharing]-Infrastruktur mit der Tomcat-Option Rails-Anwendungen betrieben kann.

=== Vorbereitungen ===

Zunächst baue und teste ich auf meinem lokalen Rechner eine Java-Webapplikation, die ich später bei Hostsharing installiere.

Ich brauche:
# die aktuelle Redmine Version von [http://rubyforge.org/frs/?group_id=1850 RubyForge] (zur Zeit Version 1.1.1)
# die Ruby-/Rails-Infrastruktur mit JRuby auf meinem lokalen Rechner

=== Software-Pakete ===

Zunächst installiere ich als ''root'' die Ruby-Infrastruktur:

aptitude install jruby rubygems

Als Datenbank will ich Postgres nutzen:

aptitude install postgresql

Eine Postgres-Datenbank mit eigenem Datenbank-User lege ich als User ''postgres'' an:

su - postgres
createuser -D -S -R -P redmine
createdb -O redmine -E UTF8 redmine

=== Webapplikation bauen ===

Als ''normaler'' User baue ich dann die Web-Applikation zusammen:

Download und entpacken von redmine in /home/user/redmine-n.n.n

tar xzf redmine-1.1.1.tar.gz
cd /home/user/redmine-1.1.1

Installation einiger Ruby-Gem-Pakete:

mkdir /home/user/.gem
export GEM_HOME=/home/user/.gem
gem install -v=0.4.2 i18n
gem install -v=1.0.1 rack
gem install jruby-openssl
gem install activerecord-jdbcpostgresql-adapter
gem install rake

In ''config/environment.rb'' habe ich folgende Zeilen eingefügt:

Unmittelbar vor Rails::Initializer.run do |config|

if RUBY_PLATFORM =~ /java/
require 'rubygems'
gem 'activerecord-jdbc-adapter'
require 'arjdbc'
end

Direkt hinter Rails::Initializer.run do |config| dann:

config.action_controller.session = { :key => "_myapp_session", :secret => "ueber-30-zeichen-session-key" }

Dann lege ich die Datei ''config/database.yml'' mit folgendem Inhalt an:

production:
adapter: jdbc
driver: org.postgresql.Driver
url: jdbc:postgresql://localhost/redmine
encoding: unicode
username: redmine
password: mein_geheimnis
host: localhost
port: 5432

Jetzt kann ich die Datenbank initialisieren:

export RAILS_ENV=production
jruby ~/.gem/bin/rake db:migrate
jruby ~/.gem/bin/rake redmine:load_default_data

Ein erster Test mit:

jruby ./script/server -e production

Jetzt sollte Redmine im internen ''WEBrick''-Webserver unter ''http://localhost:3000 '' erreichbar sein. Die Anmeldung mit admin/admin kann man schon ausprobieren...

Die letzten Schritte zum Bau der WAR-Datei:

gem install warbler
~/.gem/bin/warble config

Folgendes in der Datei config/warble.rb hinter Warbler::Config.new do |config| anpassen bzw. ergänzen:

config.dirs = %w(app config lib log vendor tmp extra files lang)
config.gems += ["activerecord-jdbcpostgresql-adapter", "i18n", "jruby-openssl", "rack"]
config.gems["i18n"] = "0.4.2"
config.gems["rack"] = "1.0.1"

Der letzte Schritt

~/.gem/bin/warble

erzeugt eine Datei ''redmine-1.1.1.war'', die ich in ''redmine.war'' umbenenne und im Tomcat deploye.

=== Installation bei Hostsharing ===

Voraussetzung: Installierter Tomcat-Webserver

Bei Hostsharing lege ich einen Postgres-Datenbank-Admin und eine Datenbank mit HSAdmin an.

In die Datenbank spiele ich über http://phppgadmin.hostsharing.net einen Dump meiner lokalen Datenbank ein.

Die ''redmine.war''-Datei kopiere ich auf den Hostsharing-Server. Im ''webapps''-Verzeichnis, das für meine gewünschte Domain konfiguriert ist, lege ich ein Verzeichnis ''redmine'' an. In dieses Verzeichnis entpacke ich die ''redmine.war'' mit dem ''jar''-Befehl. Zuletzt passe ich noch die Datenbank-Zugangsparameter in der Datei ''WEB-INF/config/database.yml'' aus dem ausgepackten Archiv an.

Mit einem Neustart des Tomcat (oder der Redmine-Applikation im Tomcat) kann Redmine dann genutzt werden.

--[[Benutzer:Peh00-phor|Peh00-phor]] 14:17, 17. Feb. 2011 (CET) Peter Hormanns

Redmine in Tomcat installieren

2011-02-17T13:22:09Z

Peh00-phor: /* Redmine im Tomcat installieren */

Redmine in Tomcat installieren

2011-02-17T13:17:32Z

Peh00-phor: Neue Installationsanleitung

== Redmine im Tomcat installieren ==

[Redmine|http://redmine.org] ist ein Werkzeug zur Projektverwaltung - in erster Linie für Software-Entwicklungs-Projekte geeignet.

Redmine ist in [http://www.ruby-lang.org/de/ Ruby] mit dem Framework [Ruby on Rails|http://rubyonrails.org/] programmiert. Es steht unter der [GNU General Public License v2|http://www.gnu.org/licenses/old-licenses/gpl-2.0.html] (GPL).

Hier soll es als Beispiel dienen, wie man auf der [Hostsharing|http://www.hostsharing.net]-Infrastruktur mit der Tomcat-Option Rails-Anwendungen betrieben kann.

=== Vorbereitungen ===

Zunächst baue und teste ich auf meinem lokalen Rechner eine Java-Webapplikation, die ich später bei Hostsharing installiere.

Ich brauche:
# die aktuelle Redmine Version von [RubyForge|http://rubyforge.org/frs/?group_id=1850] (zur Zeit Version 1.1.1)
# die Ruby-/Rails-Infrastruktur mit JRuby auf meinem lokalen Rechner

=== Software-Pakete ===

Zunächst installiere ich als ''root'' die Ruby-Infrastruktur:

aptitude install jruby rubygems

Als Datenbank will ich Postgres nutzen:

aptitude install postgresql

Eine Postgres-Datenbank mit eigenem Datenbank-User lege ich als User ''postgres'' an:

su - postgres
createuser -D -S -R -P redmine
createdb -O redmine -E UTF8 redmine

=== Webapplikation bauen ===

Als ''normaler'' User baue ich dann die Web-Applikation zusammen:

Download und entpacken von redmine in /home/user/redmine-n.n.n

tar xzf redmine-1.1.1.tar.gz
cd /home/user/redmine-1.1.1

Installation einiger Ruby-Gem-Pakete:

mkdir /home/user/.gem
export GEM_HOME=/home/user/.gem
gem install -v=0.4.2 i18n
gem install -v=1.0.1 rack
gem install jruby-openssl
gem install activerecord-jdbcpostgresql-adapter
gem install rake

In ''config/environment.rb'' habe ich folgende Zeilen eingefügt:

Unmittelbar vor {{Rails::Initializer.run do |config|}}

if RUBY_PLATFORM =~ /java/
require 'rubygems'
gem 'activerecord-jdbc-adapter'
require 'arjdbc'
end

Direkt hinter {{Rails::Initializer.run do |config|}} dann:

config.action_controller.session = { :key => "_myapp_session", :secret => "ueber-30-zeichen-session-key" }

Dann lege ich die Datei ''config/database.yml'' mit folgendem Inhalt an:

production:
adapter: jdbc
driver: org.postgresql.Driver
url: jdbc:postgresql://localhost/redmine
encoding: unicode
username: redmine
password: mein_geheimnis
host: localhost
port: 5432

Jetzt kann ich die Datenbank initialisieren:

export RAILS_ENV=production
jruby ~/.gem/bin/rake db:migrate
jruby ~/.gem/bin/rake redmine:load_default_data

Ein erster Test mit:

jruby ./script/server -e production

Jetzt sollte Redmine im internen ''WEBrick''-Webserver unter ''http://localhost:3000 '' erreichbar sein. Die Anmeldung mit admin/admin kann man schon ausprobieren...

Die letzten Schritte zum Bau der WAR-Datei:

gem install warbler
~/.gem/bin/warble config

Folgendes in der Datei config/warble.rb hinter {{Warbler::Config.new do |config|}} anpassen bzw. ergänzen:

config.dirs = %w(app config lib log vendor tmp extra files lang)
config.gems += ["activerecord-jdbcpostgresql-adapter", "i18n", "jruby-openssl", "rack"]
config.gems["i18n"] = "0.4.2"
config.gems["rack"] = "1.0.1"

Der letzte Schritt

~/.gem/bin/warble

erzeugt eine Datei ''redmine-1.1.1.war'', die ich in ''redmine.war'' umbenenne und im Tomcat deploye.

=== Installation bei Hostsharing ===

Voraussetzung: Installierter Tomcat-Webserver

Bei Hostsharing lege ich einen Postgres-Datenbank-Admin und eine Datenbank mit HSAdmin an.

In die Datenbank spiele ich über http://phppgadmin.hostsharing.net einen Dump meiner lokalen Datenbank ein.

Die ''redmine.war''-Datei kopiere ich auf den Hostsharing-Server. Im ''webapps''-Verzeichnis, das für meine gewünschte Domain konfiguriert ist, lege ich ein Verzeichnis ''redmine'' an. In dieses Verzeichnis entpacke ich die ''redmine.war'' mit dem ''jar''-Befehl. Zuletzt passe ich noch die Datenbank-Zugangsparameter in der Datei ''WEB-INF/config/database.yml'' aus dem ausgepackten Archiv an.

Mit einem Neustart des Tomcat (oder der Redmine-Applikation im Tomcat) kann Redmine dann genutzt werden.

--[[Benutzer:Peh00-phor|Peh00-phor]] 14:17, 17. Feb. 2011 (CET)Peter Hormanns

Verwalten der Zonendaten

2011-01-19T14:27:33Z

Peh00-phor: SPF Record entfernt, das soll bitte nur der machen, der weiß, was er tut

{{HSDoku-Links}}

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.

{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}

== aktives Zonefile ==

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Es sieht standardmäßig in etwa wie folgt aus:

<pre><nowiki>
$TTL 4H
example.org. IN SOA dns1.hostsharing.net. hostmaster.hostsharing.net. (
1242748945 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

IN NS dns1.hostsharing.net.
IN NS dns2.hostsharing.net.
IN NS dns3.hostsharing.net.

IN MX 30 xyz00.hostsharing.net.
IN MX 80 backupmx.hostsharing.net.

IN A 83.223.95.30

www IN A 83.223.95.30
ftp IN A 83.223.95.30
pop3 IN A 83.223.95.30
mail IN A 83.223.95.30
mysql IN A 83.223.95.30
pgsql IN A 83.223.95.30
*.example.org. IN A 83.223.95.30
</nowiki></pre>

Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} (s. unten) eingetragen wird.

== Änderungen ==

Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis <tt>etc</tt> der Domain abzulegen.

Am besten man beginnt mit der folgenden universellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatisch durch die aktuellen Werte ersetzt werden:

<pre>
$TTL {TTL}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
{SIO} ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)
; please read https://wiki.hostsharing.net/index.php?title=Domains:Verwalten_der_Zonendaten
IN NS {HS_DNS1_HOSTNAME}.
IN NS {HS_DNS2_HOSTNAME}.
IN NS {HS_DNS3_HOSTNAME}.
IN MX 30 mail
IN MX 80 {MX2_HOSTNAME}.
IN A {DOM_IPNUMBER}
www IN A {DOM_IPNUMBER}
ftp IN A {FTP_IPNUMBER}
pop3 IN A {POP3_IPNUMBER}
imap IN A {IMAP_IPNUMBER}
mail IN A {SMTP_IPNUMBER}
mysql IN A {MYSQL_IPNUMBER}
pgsql IN A {PGSQL_IPNUMBER}
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.

Beispiele:
; externe Server per "CNAME Record" eintragen
wackelserver IN CNAME server0815.massenhoster-domain.tld
homeip IN CNAME mein-nick.dyn-ip-service.tld

; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
www IN NS {HS_DNS1_HOSTNAME}.
www IN NS {HS_DNS2_HOSTNAME}.
www IN NS {HS_DNS3_HOSTNAME}.

soll statt www eine subdomain deligiert werden muss dieser Eintrag am Ende der pri.example.com Datei stehen, also nach:
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}

Danach legt man im Zielpaket die Subdomain an:
hsadmin -c domain.add -s name=subdomain.example.tld -s user=xyz12

Nach einer Änderung an einem selbstverwalteten Zonefile dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)

'''Hinweis:'''

Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:

echo -n > /home/doms/example.org/etc/pri.example.org

Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!

== Logfile und Kontrolle==

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN':
AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN':
AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
* Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

<code>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'
</code>

== Platzhalter für eigene Zonenfiles ==

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern von IP-Adressen und Hostnamen, ohne daß jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.

; {PAC_IPNUMBER} : IP-Nummer des [[Hives]] in dem sich das [[Paket]] befindet
; {PAC_HOSTNAME} : Hostname ([[Hive]])
; {DOM_IPNUMBER} : IP-Nummer
; {DOM_HOSTNAME} :

; {MYSQL_IPNUMBER}
; {MYSQL_HOSTNAME}
; {PGSQL_IPNUMBER}
; {PGSQL_HOSTNAME}

; {FTP_IPNUMBER}
; {FTP_HOSTNAME}

; {SMTP_IPNUMBER}
; {SMTP_HOSTNAME}
; {POP3_IPNUMBER}
; {POP3_HOSTNAME}
; {IMAP_IPNUMBER}
; {IMAP_HOSTNAME}

; {PAC_DNS_MASTER}
; {HS_DNS1_IPNUMBER}
; {HS_DNS2_IPNUMBER}
; {HS_DNS3_IPNUMBER}
; {HS_DNS1_HOSTNAME}
; {HS_DNS2_HOSTNAME}
; {HS_DNS3_HOSTNAME}

; {TTL}
; {SIO} : Timestamp (Millisekunden)

; {MX1_IPNUMBER}
; {MX1_HOSTNAME}
; {MX2_IPNUMBER}
; {MX2_HOSTNAME}

Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.

Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.

== Beispiele ==

=== Domain Delegation ===
HowTo: erläutern.

<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>
----
[[Kategorie:HSDoku]]
[[Kategorie:Domains]]

User

2010-09-11T16:43:55Z

Peh00-phor:

{{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 ===

hsadmin - <<EOF
--call:user.update
--where:name=xyz00-user
--set:password=geheim
EOF

=== 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-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]]

Datenbanken

2010-05-04T18:52:12Z

Peh00-phor:

{{HSDoku-Links}}
Hostsharing betreibt Datenbanksever in [http://www.mysql.com - MySQL] und [http://www.postgresql.org PostgreSQL].

== MySQL ==

* Server: Es gibt einen eigenen MySQL-Server auf jedem Host.
* Nutzung bei Hostsharing: siehe separater Artikel [[MySQL]] und [[MySQL-Datenbank anlegen Schritt für Schritt]]
* 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.

== PostgreSQL ==
* Server: Es gibt einen eigenen PostgreSQL-Server auf jedem Host.
* Nutzung bei Hostsharing: siehe separater Artikel [[PostgreSQL]]
* Web-Frontend: [http://www.phppgadmin.net phpPgAdmin] ist unter https://phppgadmin.hostsharing.net/current erreichbar.
* Online-Dokumentation: Die Online-Doku gibt es unter http://www.postgresql.org/docs/manuals/. Eine Liste von Büchern (einige davon zum Download) unter http://www.postgresql.org/docs/books/.

== Verwaltung von Datenbanken ==

Datenbanken können mit [[hsadmin]] auf der Kommandozeile oder im Browser angelegt werden.

In jedem Fall ist die Reihenfolge:
# einen Datenbankbenutzer als DB-Administrator anlegen
# die Datenbank anlegen

Dabei kann nach Belieben ein Administrator für alle Datenbanken eines Pakets oder ein eigener Administrator-Account pro Datenbank angelegt werden.

=== Datenbank-Administrator anlegen ===

hsadmin -c mysqluser.add --set:name=xyz00_dbuser --set:password=geheim

bzw.

hsadmin -c postgresqluser.add --set:name=xyz00_dbuser --set:password=geheim

=== Datenbank anlegen ===

hsadmin -c mysqldb.add --set:name=xyz00_mydatabase --set:owner=xyz00_dbuser [ --set:encoding=latin1 ]

bzw.

hsadmin -c postgresqldb.add --set:name=xyz00_mydatabase --set:owner=xyz00_dbuser [ --set:encoding=LATIN1 ]

Das Encoding kann weggelassen werden, der Default ist dann "UTF-8".

=== Datenbanken auflisten ===

hsadmin -c mysqldb.search

bzw.

hsadmin -c postgresqldb.search

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

Verwalten der Zonendaten

2010-03-04T10:54:10Z

Peh00-phor: /* Logfile */

{{HSDoku-Links}}

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.

{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}

== aktives Zonefile ==

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Es sieht standardmäßig in etwa wie folgt aus:

<pre><nowiki>
$TTL 4H
example.org. IN SOA dns1.hostsharing.net. hostmaster.hostsharing.net. (
1242748945 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

IN NS dns1.hostsharing.net.
IN NS dns2.hostsharing.net.
IN NS dns3.hostsharing.net.

IN MX 30 xyz00.hostsharing.net.
IN MX 80 backupmx.hostsharing.net.

IN A 83.223.95.30

www IN A 83.223.95.30
ftp IN A 83.223.95.30
pop3 IN A 83.223.95.30
mail IN A 83.223.95.30
mysql IN A 83.223.95.30
pgsql IN A 83.223.95.30
*.example.org. IN A 83.223.95.30
</nowiki></pre>

Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} eigetragen wird.

== Änderungen ==

Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis etc der Domain abzulegen.

Am besten man beginnt mit der folgenden unversellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatsch mit den aktuellen werten ersetzt werden:

<pre>
$TTL {TTL}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
{SIO} ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)
; please read https://wiki.hostsharing.net/index.php?title=Domains:Verwalten_der_Zonendaten
IN NS {HS_DNS1_HOSTNAME}.
IN NS {HS_DNS2_HOSTNAME}.
IN NS {HS_DNS3_HOSTNAME}.
IN MX 30 mail
IN MX 80 {MX2_HOSTNAME}.
TXT "v=spf1 +a +mx ~all"
; see http://spf.pobox.com/ for details on spf record
IN A {DOM_IPNUMBER}
www IN A {DOM_IPNUMBER}
ftp IN A {FTP_IPNUMBER}
pop3 IN A {POP3_IPNUMBER}
imap IN A {IMAP_IPNUMBER}
mail IN A {SMTP_IPNUMBER}
mysql IN A {MYSQL_IPNUMBER}
pgsql IN A {PGSQL_IPNUMBER}
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.

Beispiele:
; externe Server per "CNAME Record" eintragen
wackelserver IN CNAME server0815.massenhoster-domain.tld
homeip IN CNAME mein-nick.dyn-ip-service.tld

; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
www IN NS {HS_DNS1_HOSTNAME}.
www IN NS {HS_DNS2_HOSTNAME}.
www IN NS {HS_DNS3_HOSTNAME}.

Nach einer Änderung an einem selbstverwalteten Zonefile muss zur Übernahmer der Konfiguration eine Datei /home/doms/example.com/etc/zonefile.upd angelegt, bzw. deren Zeitstempel aktualisiert werden.

touch /home/doms/example.com/etc/zonefile.upd

Dann dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)

'''Hinweis:'''

Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:

echo -n > /home/doms/example.org/etc/pri.example.org

Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!

== Logfile ==

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN': AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN': AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
* Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

<code>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 hoennig.de | grep '^example.com.*SOA' |
awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'
</code>

== Platzhalter für eigene Zonenfiles ==

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern von IP Adressen und Hostnamen, ohne das jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.

; {PAC_IPNUMBER} : IP NUmmer des [[Hives]] in dem sich das [[Paket]] befindet
; {PAC_HOSTNAME} : Hostname ([[Hive]])
; {DOM_IPNUMBER} : IP-Nummer
; {DOM_HOSTNAME} :

; {MYSQL_IPNUMBER}
; {MYSQL_HOSTNAME}
; {PGSQL_IPNUMBER}
; {PGSQL_HOSTNAME}

; {FTP_IPNUMBER}
; {FTP_HOSTNAME}

; {SMTP_IPNUMBER}
; {SMTP_HOSTNAME}
; {POP3_IPNUMBER}
; {POP3_HOSTNAME}
; {IMAP_IPNUMBER}
; {IMAP_HOSTNAME}

; {PAC_DNS_MASTER}
; {HS_DNS1_IPNUMBER}
; {HS_DNS2_IPNUMBER}
; {HS_DNS3_IPNUMBER}
; {HS_DNS1_HOSTNAME}
; {HS_DNS2_HOSTNAME}
; {HS_DNS3_HOSTNAME}

; {TTL}
; {SIO} : Timestamp (Millisekunden)

; {MX1_IPNUMBER}
; {MX1_HOSTNAME}
; {MX2_IPNUMBER}
; {MX2_HOSTNAME}

Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.

Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.

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

Verwalten der Zonendaten

2010-03-04T10:53:14Z

Peh00-phor: /* Logfile */

{{HSDoku-Links}}

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.

{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}

== aktives Zonefile ==

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Es sieht standardmäßig in etwa wie folgt aus:

<pre><nowiki>
$TTL 4H
example.org. IN SOA dns1.hostsharing.net. hostmaster.hostsharing.net. (
1242748945 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

IN NS dns1.hostsharing.net.
IN NS dns2.hostsharing.net.
IN NS dns3.hostsharing.net.

IN MX 30 xyz00.hostsharing.net.
IN MX 80 backupmx.hostsharing.net.

IN A 83.223.95.30

www IN A 83.223.95.30
ftp IN A 83.223.95.30
pop3 IN A 83.223.95.30
mail IN A 83.223.95.30
mysql IN A 83.223.95.30
pgsql IN A 83.223.95.30
*.example.org. IN A 83.223.95.30
</nowiki></pre>

Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} eigetragen wird.

== Änderungen ==

Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis etc der Domain abzulegen.

Am besten man beginnt mit der folgenden unversellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatsch mit den aktuellen werten ersetzt werden:

<pre>
$TTL {TTL}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
{SIO} ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)
; please read https://wiki.hostsharing.net/index.php?title=Domains:Verwalten_der_Zonendaten
IN NS {HS_DNS1_HOSTNAME}.
IN NS {HS_DNS2_HOSTNAME}.
IN NS {HS_DNS3_HOSTNAME}.
IN MX 30 mail
IN MX 80 {MX2_HOSTNAME}.
TXT "v=spf1 +a +mx ~all"
; see http://spf.pobox.com/ for details on spf record
IN A {DOM_IPNUMBER}
www IN A {DOM_IPNUMBER}
ftp IN A {FTP_IPNUMBER}
pop3 IN A {POP3_IPNUMBER}
imap IN A {IMAP_IPNUMBER}
mail IN A {SMTP_IPNUMBER}
mysql IN A {MYSQL_IPNUMBER}
pgsql IN A {PGSQL_IPNUMBER}
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.

Beispiele:
; externe Server per "CNAME Record" eintragen
wackelserver IN CNAME server0815.massenhoster-domain.tld
homeip IN CNAME mein-nick.dyn-ip-service.tld

; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
www IN NS {HS_DNS1_HOSTNAME}.
www IN NS {HS_DNS2_HOSTNAME}.
www IN NS {HS_DNS3_HOSTNAME}.

Nach einer Änderung an einem selbstverwalteten Zonefile muss zur Übernahmer der Konfiguration eine Datei /home/doms/example.com/etc/zonefile.upd angelegt, bzw. deren Zeitstempel aktualisiert werden.

touch /home/doms/example.com/etc/zonefile.upd

Dann dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)

'''Hinweis:'''

Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:

echo -n > /home/doms/example.org/etc/pri.example.org

Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!

== Logfile ==

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN': AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN': AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
* Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

<code>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 hoennig.de | grep '^example.com.*SOA' |
awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'
</code>

== Platzhalter für eigene Zonenfiles ==

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern von IP Adressen und Hostnamen, ohne das jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.

; {PAC_IPNUMBER} : IP NUmmer des [[Hives]] in dem sich das [[Paket]] befindet
; {PAC_HOSTNAME} : Hostname ([[Hive]])
; {DOM_IPNUMBER} : IP-Nummer
; {DOM_HOSTNAME} :

; {MYSQL_IPNUMBER}
; {MYSQL_HOSTNAME}
; {PGSQL_IPNUMBER}
; {PGSQL_HOSTNAME}

; {FTP_IPNUMBER}
; {FTP_HOSTNAME}

; {SMTP_IPNUMBER}
; {SMTP_HOSTNAME}
; {POP3_IPNUMBER}
; {POP3_HOSTNAME}
; {IMAP_IPNUMBER}
; {IMAP_HOSTNAME}

; {PAC_DNS_MASTER}
; {HS_DNS1_IPNUMBER}
; {HS_DNS2_IPNUMBER}
; {HS_DNS3_IPNUMBER}
; {HS_DNS1_HOSTNAME}
; {HS_DNS2_HOSTNAME}
; {HS_DNS3_HOSTNAME}

; {TTL}
; {SIO} : Timestamp (Millisekunden)

; {MX1_IPNUMBER}
; {MX1_HOSTNAME}
; {MX2_IPNUMBER}
; {MX2_HOSTNAME}

Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.

Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.

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

Verwalten der Zonendaten

2010-03-04T10:48:05Z

Peh00-phor: /* Logfile */

{{HSDoku-Links}}

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.

{{Textkasten|rot|Achtung|Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!}}

== aktives Zonefile ==

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Es sieht standardmäßig in etwa wie folgt aus:

<pre><nowiki>
$TTL 4H
example.org. IN SOA dns1.hostsharing.net. hostmaster.hostsharing.net. (
1242748945 ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)

IN NS dns1.hostsharing.net.
IN NS dns2.hostsharing.net.
IN NS dns3.hostsharing.net.

IN MX 30 xyz00.hostsharing.net.
IN MX 80 backupmx.hostsharing.net.

IN A 83.223.95.30

www IN A 83.223.95.30
ftp IN A 83.223.95.30
pop3 IN A 83.223.95.30
mail IN A 83.223.95.30
mysql IN A 83.223.95.30
pgsql IN A 83.223.95.30
*.example.org. IN A 83.223.95.30
</nowiki></pre>

Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} eigetragen wird.

== Änderungen ==

Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis etc der Domain abzulegen.

Am besten man beginnt mit der folgenden unversellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatsch mit den aktuellen werten ersetzt werden:

<pre>
$TTL {TTL}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
{SIO} ; serial secs since Jan 1 1970
6H ; refresh (>=10000)
1H ; retry (>=1800)
1W ; expire
1H ; minimum
)
; please read https://wiki.hostsharing.net/index.php?title=Domains:Verwalten_der_Zonendaten
IN NS {HS_DNS1_HOSTNAME}.
IN NS {HS_DNS2_HOSTNAME}.
IN NS {HS_DNS3_HOSTNAME}.
IN MX 30 mail
IN MX 80 {MX2_HOSTNAME}.
TXT "v=spf1 +a +mx ~all"
; see http://spf.pobox.com/ for details on spf record
IN A {DOM_IPNUMBER}
www IN A {DOM_IPNUMBER}
ftp IN A {FTP_IPNUMBER}
pop3 IN A {POP3_IPNUMBER}
imap IN A {IMAP_IPNUMBER}
mail IN A {SMTP_IPNUMBER}
mysql IN A {MYSQL_IPNUMBER}
pgsql IN A {PGSQL_IPNUMBER}
*.{DOM_HOSTNAME}. IN A {DOM_IPNUMBER}
</pre>

Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.

Beispiele:
; externe Server per "CNAME Record" eintragen
wackelserver IN CNAME server0815.massenhoster-domain.tld
homeip IN CNAME mein-nick.dyn-ip-service.tld

; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
www IN NS {HS_DNS1_HOSTNAME}.
www IN NS {HS_DNS2_HOSTNAME}.
www IN NS {HS_DNS3_HOSTNAME}.

Nach einer Änderung an einem selbstverwalteten Zonefile muss zur Übernahmer der Konfiguration eine Datei /home/doms/example.com/etc/zonefile.upd angelegt, bzw. deren Zeitstempel aktualisiert werden.

touch /home/doms/example.com/etc/zonefile.upd

Dann dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)

'''Hinweis:'''

Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:

echo -n > /home/doms/example.org/etc/pri.example.org

Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!

== Logfile ==

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN': AXFR-style IXFR started
Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN': AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

* Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
* Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
* Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

<nowiki>
-------- Original-Nachricht --------
Betreff: [Global] DNS Zonenfile Änderungen
Datum: Thu, 4 Mar 2010 08:30:34 +0100

Moin Moin,

aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
später dann sind die Domains nicht mehr erreichbar und es heißt "in den
letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
"mal eben schnell noch ... " ging.

Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!

Was also tun? Zunächst kann man nach einer Änderung in einer
Shell beobachten, ob es zu Fehlermeldungen kommt:

tail -f /var/log/named/named.log

oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
vorkommt:

tail -f /var/log/named/named.log | grep example.com

Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
Server lesbar.

Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
aktuellen in der Zonendatei verglichen werden:

dig -t SOA @dns1 hoennig.de | grep '^example.com.*SOA' |
awk '{ print $7 }'

grep serial /etc/bind/pri.example.com | awk '{ print $1 }'
</nowiki>

== Platzhalter für eigene Zonenfiles ==

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern von IP Adressen und Hostnamen, ohne das jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.

; {PAC_IPNUMBER} : IP NUmmer des [[Hives]] in dem sich das [[Paket]] befindet
; {PAC_HOSTNAME} : Hostname ([[Hive]])
; {DOM_IPNUMBER} : IP-Nummer
; {DOM_HOSTNAME} :

; {MYSQL_IPNUMBER}
; {MYSQL_HOSTNAME}
; {PGSQL_IPNUMBER}
; {PGSQL_HOSTNAME}

; {FTP_IPNUMBER}
; {FTP_HOSTNAME}

; {SMTP_IPNUMBER}
; {SMTP_HOSTNAME}
; {POP3_IPNUMBER}
; {POP3_HOSTNAME}
; {IMAP_IPNUMBER}
; {IMAP_HOSTNAME}

; {PAC_DNS_MASTER}
; {HS_DNS1_IPNUMBER}
; {HS_DNS2_IPNUMBER}
; {HS_DNS3_IPNUMBER}
; {HS_DNS1_HOSTNAME}
; {HS_DNS2_HOSTNAME}
; {HS_DNS3_HOSTNAME}

; {TTL}
; {SIO} : Timestamp (Millisekunden)

; {MX1_IPNUMBER}
; {MX1_HOSTNAME}
; {MX2_IPNUMBER}
; {MX2_HOSTNAME}

Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.

Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.

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

Ecartis Installieren

2010-03-03T14:15:50Z

Peh00-phor:

== Mailinglisten mit ecartis ==

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing EMail-Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

moderated = yes
moderate-include-queue = true
moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

admin-approvepost = true

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

post-password = geheimesPasswort

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die EMail-Adresse und die Einträge in der ''.procmailrc'' zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Diskussion:Ecartis Installieren

2010-03-03T14:15:24Z

Peh00-phor: Der Seiteninhalt wurde durch einen anderen Text ersetzt: „Ich hoffe, das tut's jetzt so.“

Ich hoffe, das tut's jetzt so.

Ecartis Installieren

2010-03-03T14:14:22Z

Peh00-phor: /* Verschiedene Domains */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

moderated = yes
moderate-include-queue = true
moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

admin-approvepost = true

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

post-password = geheimesPasswort

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die EMail-Adresse und die Einträge in der ''.procmailrc'' zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-03T14:13:24Z

Peh00-phor: /* post-password = geheimesPasswort */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

moderated = yes
moderate-include-queue = true
moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

admin-approvepost = true

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

post-password = geheimesPasswort

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-03T14:13:01Z

Peh00-phor: /* admin-approvepost = true */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

moderated = yes
moderate-include-queue = true
moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

admin-approvepost = true

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-03T14:12:30Z

Peh00-phor: /* moderierte Liste */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

moderated = yes
moderate-include-queue = true
moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-03T14:11:51Z

Peh00-phor: /* Konfiguration */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true

Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
*# confirm - Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Anmeldung muss vom Listenadmin erlaubt werden
* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
*# open - Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
*# confirm - Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
*# closed - Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-03T14:09:24Z

Peh00-phor: /* Aliases ersetzen */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste\+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste\+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste\+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste\+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste\+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T15:17:06Z

Peh00-phor: /* Einrichten */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von Aliases.

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T15:11:45Z

Peh00-phor:

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^X-Original-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^X-Original-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^X-Original-To: testmailingliste+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^X-Original-To: testmailingliste+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^X-Original-To: testmailingliste+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^X-Original-To: testmailingliste+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^X-Original-To: testmailingliste+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T14:54:31Z

Peh00-phor: /* Einrichten */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME
mkdir $HOME/ecartis/queue

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^Delivered-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^Delivered-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^Delivered-To: testmailingliste+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^Delivered-To: testmailingliste+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^Delivered-To: testmailingliste+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^Delivered-To: testmailingliste+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^Delivered-To: testmailingliste+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T14:26:17Z

Peh00-phor: /* Einrichten */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -rL /usr/lib/ecartis $HOME

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^Delivered-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^Delivered-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^Delivered-To: testmailingliste+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^Delivered-To: testmailingliste+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^Delivered-To: testmailingliste+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^Delivered-To: testmailingliste+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^Delivered-To: testmailingliste+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T13:23:12Z

Peh00-phor:

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME
rm $HOME/ecartis/ecartis.cfg
cp /etc/ecartis/ecartis.cfg $HOME/ecartis/

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^Delivered-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.

Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

cd $HOME/ecartis
./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

Diese Aliases setze ich nicht in dieser Form um, sondern nutze den ''recipient_delimiter'' von Postfix und die ''.procmailrc'':

==== Aliases ersetzen ====

Durch den Aufruf von ''ecartis -newlist'' wurde eine Konfigurationsdatei für die neue Mailingliste angelegt.
Die Datei heißt ''$HOME/ecartis/lists/testmailingliste/config''.

Hier ändere ich zunächst die folgenden Einträge:

reply-to = testmailingliste@example.com
administrivia-address = testmailingliste+admins@example.com
moderator = testmailingliste+moderators@example.com
send-as = testmailingliste+bounce@example.com

Bitte das "+"-Plus-Zeichen im Localpart der EMail-Adressen beachten!

Mit hsadmin lege ich eine EMail-Adresse an:

hsadmin --call:emailaddress.add --set:localpart=testmailingliste --set:domain=example.com --set:target=xyz00

Statt der Aliases mache die folgenden Einträge in die ''.procmailrc'':

:0
* ^Delivered-To: testmailingliste@example.com
|$HOME/ecartis/ecartis -s testmailingliste
:0
* ^Delivered-To: testmailingliste+request@example.com
|$HOME/ecartis/ecartis -r testmailingliste
:0
* ^Delivered-To: testmailingliste+repost@example.com
|$HOME/ecartis/ecartis -a testmailingliste
:0
* ^Delivered-To: testmailingliste+admins@example.com
|$HOME/ecartis/ecartis -admins testmailingliste
:0
* ^Delivered-To: testmailingliste+moderators@example.com
|$HOME/ecartis/ecartis -moderators testmailingliste
:0
* ^Delivered-To: testmailingliste+bounce@example.com
|$HOME/ecartis/ecartis -bounce testmailingliste

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste+request@example.com mit dem Inhalt subscribe anmelden kann.

Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: [http://www.ecartis.org/variables.html].

=== Konfiguration ===

Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T12:51:17Z

Peh00-phor:

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME
rm $HOME/ecartis/ecartis.cfg
cp /etc/ecartis/ecartis.cfg $HOME/ecartis/

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

In der Datei ''$HOME/.procmailrc'' trage ich ein (siehe auch [[Procmail]]):

:0
* ^Delivered-To: ecartis@example.com
|$HOME/ecartis/ecartis

=== Test ===

Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T12:36:34Z

Peh00-phor: /* E-Mail Adresse */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME
rm $HOME/ecartis/ecartis.cfg
cp /etc/ecartis/ecartis.cfg $HOME/ecartis/

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 --set:localpart=ecartis --set:domain=example.com

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T12:33:30Z

Peh00-phor: /* E-Mail Adresse */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME
rm $HOME/ecartis/ecartis.cfg
cp /etc/ecartis/ecartis.cfg $HOME/ecartis/

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Im Folgenden benutze ich den Paket-User ''xyz00'' als Empfänger für alle E-Mails, die an Ecartis gehen. Die Verteilung erfolgt in der Datei ''.procmailrc''.

Zunächst stelle ich sicher, dass für den Paket-User kein EMail-Alias eingerichtet ist, bzw. ich lösche es:

hsadmin --call:emailalias.search
hsadmin --call:emailalias.delete --where:name=xyz00

Dann richte ich die Adresse des Mailinglisten-Managers selbst ein:

hsadmin --call:emailaddress.add --set:target=xyz00 ecartis@example.com

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T12:25:34Z

Peh00-phor: /* ecartis.cfg */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME
rm $HOME/ecartis/ecartis.cfg
cp /etc/ecartis/ecartis.cfg $HOME/ecartis/

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für den Listenmanager müssen nun in ecartis.cfg mehrere Variablen angepasst werden.
Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Hier die notwendigen Einstellungen in ecartis.cfg:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Entsprechend des Eintrages ecartis-address fügt man [[E-Mail-Adressen]] der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T12:23:41Z

Peh00-phor:

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME
rm $HOME/ecartis/ecartis.cfg
cp /etc/ecartis/ecartis.cfg $HOME/ecartis/

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Im Verzeichnis ''ecartis'' befindet sich die Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: http://www.ecartis.org/variables.html].

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

listserver-address = ecartis@example.com
listserver-admin = postmaster@example.com
listserver-root = /home/pacs/xyz00/ecartis
listserver-conf = /home/pacs/xyz00/ecartis
listserver-data = /home/pacs/xyz00/ecartis
listserver-modules = /home/pacs/xyz00/ecartis/modules

==== E-Mail Adresse ====

Entsprechend des Eintrages ecartis-address fügt man [[E-Mail-Adressen]] der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

== Weitere Möglichkeiten ==

=== Verschiedene Domains ===

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man das Verzeichnis ''ecartis'' als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

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

Ecartis Installieren

2010-03-02T12:08:31Z

Peh00-phor: /* Einrichten */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehmer/innen zu verhindern:

chmod -R o-rwx $HOME/ecartis

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man dieses Verzeichnis als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

Im Verzeichnis ''ecartis'' befindet sich eine Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

ecartis-address = ecartis@example.com
ecartis-admin = postmaster@example.com
ecartis-root = /home/pacs/xyz00/mailinglist

==== E-Mail Adresse ====

Entsprechend des Eintrages ecartis-address fügt man [[E-Mail-Adressen]] der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

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

Ecartis Installieren

2010-03-02T12:04:17Z

Peh00-phor: /* Einrichten */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Zunächst muss eine eigene Installation der Ecartis-Software in das Hostsharing-Paket kopiert werden.

Rufe dazu als Paket-Admin auf:

cp -r /usr/lib/ecartis $HOME

Und um fremde Blicke auf die E-Mail-Adressen der Teilnehemr zu verhindern:

chmod -R o-rwx $HOME/ecartis

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man dieses Verzeichnis als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

Im Verzeichnis des Listenmanagers befindet sich eine Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

ecartis-address = ecartis@example.com
ecartis-admin = postmaster@example.com
ecartis-root = /home/pacs/xyz00/mailinglist

==== E-Mail Adresse ====

Entsprechend des Eintrages ecartis-address fügt man [[E-Mail-Adressen]] der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

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

Ecartis Installieren

2010-03-02T11:56:40Z

Peh00-phor: /* Mailinglisten mit ecartis */

== Mailinglisten mit ecartis ==

{{Baustelle}}

[http://www.ecartis.org/ Ecartis] ist ein Programm, mit dem Bei Hostsharing E-Mail Verteiler realisiert werden können.

Vergleichen Sie dazu auch den Wikipedia-Artikel:
[http://de.wikipedia.org/wiki/Mailingliste Mailingliste]

Alternative: [[Mailman]]

Diese Anleitung beschreibt die Installation von Ecartis in einem Hostsharing DW-Paket für eine Domain.

== ecartis ==

=== Einrichten ===

Initial muss dafür das Skript add-mailinglist aufgerufen werden, welches im Paketverzeichnis ein neues Verzeichnis mailinglist erstellt, in dem sich dann alle Dateien für die Mailinglisten befinden.

(ACHTUNG script geht aktuell noch nicht wieder - Umstellung auf hsadmin erforderlich)

Aufruf:

add-mailinglist

Damit ist der Listenmanager zentral für das Paket vorbereitet, d.h. benötigte Dateien wurden in das Verzeichnis ~/mailinglist kopiert. Außerdem wurden [[Aliases]] zur Ansteuerung des Listenmanagers angelegt.

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man dieses Verzeichnis als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

Im Verzeichnis des Listenmanagers befindet sich eine Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

ecartis-address = ecartis@example.com
ecartis-admin = postmaster@example.com
ecartis-root = /home/pacs/xyz00/mailinglist

==== E-Mail Adresse ====

Entsprechend des Eintrages ecartis-address fügt man [[E-Mail-Adressen]] der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der [[aliases]] eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man mit [[aliases]] mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== aliases ====

Folgende Einträge nun mit hsadmin
[[Aliases]] bzw direkt im [[WebFrontend]]
anlegen:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== E-Mail Adressen ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die [[E-Mail-Adressen]] der Domain (Bsp: für die Domain example.com:)

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

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

Hsadmin

2010-02-24T22:09:49Z

Peh00-phor: /* hsadmin Entwicklung */

{{HSDoku-Links}}

[https://admin.hostsharing.net/ hsadmin] ist ein von HS entwickltes Konfigurations-Werkzeug für Internet-Server, das speziell zu der flexiblen Konfiguration der Webspace-Angebote der [http://www.hostsharing.net Hostsharing eG] passt.

== hsadmin ==
Die Bedienung erfolgt über ein [[WebFrontend]] für die Kunden und Personal, das Kommandozeilen-Frontend [[Hsadmin#Command-Line-Client | hsadmin CLI]] (zum Beispiel für Skripte), oder über eine Programmierschnittstelle (für weitere Frontends). Das Kernsystem wird von der Kundenverwaltung (Kontaktdaten, Rechnungen, gebuchte Pakete und so weiter) über die Paketverwaltung (Unix-Accounts, Datenbanken, Datenbank-User etc.) und der Domainverwaltung (registrieren, aufschalten, E-Mail-Adressen einrichten und so weiter) ein breites Spektrum der Konfiguration ermöglichen. Es wird möglich sein, weitere Module entweder zentral, oder auch für einzelne Reseller hinzuzufügen. Das "Look-and-Feel" des Web-Fronts wird ebenfalls von Resellern anpassbar sein.

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:

{|class="wikitable"
|- class="hintergrundfarbe5"
!Modul !!Beschreibung / Anleitung
|-
|WebFrontend||Die Funktionen der Kommandozeile nun per Browser [[WebFrontend]]
|-
|Benutzerverwaltung||Anleitung für Kommandozeile. Beschreibung steht in [[User]]
|-
|E-Mail Adressen||Anleitung für Kommandozeile. Beschreibung steht in [[hsadmin-mail|E-Mail]]
|-
|E-Mail Alias||Anleitung für Kommandozeile. Beschreibung steht in [[Aliases]]
|-
|Domain Status||Anleitung für Kommandozeile. Beschreibung steht in [[domains|Domain]]
|-
|MySQL User||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|-
|MySQL Datenbanken||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|-
|Postgres User||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|-
|Postgres Datenbanken||Anleitung für Kommandozeile. Beschreibung steht in [[Datenbanken]]
|}

== 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 i.d.R. 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, z.B. durch 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 UNIX-ähnliche Systeme als bash-Script zur Verfügung. Eine Windows-Version sollte sich aber leicht erstellen lassen.

Eine Anmerkung noch: hsadmin läuft derzeit noch mangels besserer Alternativen auf einem sehr leistungsschwachen Server. Wir bitten daher
von großen Experimenten abzusehen und nur wirkliche Aufgaben über die neuen Schnittstelle auszuführen.

== 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. D.h. 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
|}

Für die globalen Optionen siehe weiter unten.

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

:q - für die Auftrags-Queue in den Hives
:user - für die UNIX-User inkl. Mailboxen

{{Textkasten|rot|Anmerkung:|Da die anderen Module teilweise schon im Live-Test sind, gibt es sie schon. Wer sie aber verwendet, wird ggf. mit unwiderruflichem Datenverlust bestraft ;-) }}

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,<br/> aber den "-" vergisst, dann werden diese einfach ignoriert.<br/>stdin wird aber ggf. auch anderweitig gebraucht, weshalb<br/>"-" 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.<br/>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 (z.B. 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).

== hsadmin Status von Änderungen ==

<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!

== hsadmin Entwicklung ==

hsadmin wird ständig weiter entwickelt. Hier finden sich die Details:

http://www.hsadmin.de/

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

Diskussion:Ecartis Installieren

2010-01-24T13:52:27Z

Peh00-phor:

1 zu 1 aus der alten Doku übernommen

Nach HSAdmin-Einfühung nicht angepasst!

E-Mail-Adressen und Aliases können nur noch mit HSAdmin angelegt werden!

Ecartis Installieren

2010-01-24T13:51:02Z

Peh00-phor: Baustelle: nicht nach HSAdmin-Einführung angepasst!

== Mailinglisten mit ecartis ==

{{Baustelle}}

Es ist möglich, in seinem Paket Mailinglisten mit dem Listenmanager ecartis zu benutzen.
Einmalige Einrichtung wahlweise zentral für das Paket bzw. einzelne Domains

== ecartis ==

=== Einrichten ===

Initial muss dafür das Skript add-mailinglist aufgerufen werden, welches im Paketverzeichnis ein neues Verzeichnis mailinglist erstellt, in dem sich dann alle Dateien für die Mailinglisten befinden.

Aufruf:

add-mailinglist

Damit ist der Listenmanager zentral für das Paket vorbereitet, d.h. benötigte Dateien wurden in das Verzeichnis ~/mailinglist kopiert. Außerdem wurden Aliase zur Ansteuerung des Listenmanagers in die ~/etc/aliases eingefügt.

Wenn man für verschiedene seiner Domains eigenständige Mailinglistensysteme betreiben will, so kann man dieses Verzeichnis als Vorlage verwenden und beliebig kopieren. Dann sind natürlich die Aliase zur Steuerung des Listenmanagers per E-Mail ebenfalls zu kopieren und entsprechend anzupassen.

Im Verzeichnis des Listenmanagers befindet sich eine Konfigurationsdatei ecartis.cfg, welche den Listenmanager steuert.

=== Konfiguration ===

==== ecartis.cfg ====

Für jeden Listenmanager müssen nun in ecartis.cfg die Zeilen ecartis-address, ecartis-admin und ecartis-root konfiguriert werden. ecartis-root muss nur dann angepasst werden, wenn man ein anderes Verzeichnis als ~/mailinglist verwendet, weil man beispielsweise mehrere Listenmanager betreibt. Eine detailierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

Man konfiguriert jetzt die Einträge in ecartis.cfg.

Beispiel:

ecartis-address = ecartis@example.com
ecartis-admin = postmaster@example.com
ecartis-root = /home/pacs/xyz00/mailinglist

==== virtusertable ====

Entsprechend des Eintrages ecartis-address fügt man in der virtusertable der Domain example.com folgendes ein:

ecartis@example.com xyz00-ecartis

==== mehrere Listenmanager ====

Verwendet man mehrere Listenmanager, so muss man jedem Listenmanager einen eigenen E-Mail-Alias geben. Dazu müssen diese dann auch in der ~/etc/aliases eingetragen werden. Als Vorlage dienen hierfür die automatisch eingetragenen Aliase, welche auf den Listenmanager in ~/mailinglist verweisen.

=== Test ===
Damit ist das Mailinglistensystem erreichbar und eine E-Mail an ecartis@example.com mit dem Inhalt help schickt uns die Datei ecartis.hlp zurück, die man später natürlich an seine Bedürfnisse anpassen kann.
Einrichten einer Mailingliste

== Mailinglisten ==

=== Einrichten ===

Man fügt nun den einzelnen Listenmanagern Listen hinzu. Dazu wechselt man in das Verzeichnis des jeweiligen Listenmanagers.

Aufruf:

./ecartis -newlist NAMEDERLISTE

Dann wird man nach dem Administrator der einzurichtenden Liste gefragt und nach der Eingabe der E-Mail-Adresse erhält man eine Liste von aliasen, die man in seine ~/etc/aliases mit vorangestelltem Paketlogin einträgt. Das Voranstellen von bspw. xyz00- ist notwendig, weil man nur diese Aliases ändern darf.

Beispiel:

Folgendes gibt uns der Befehl zurück:

Aliases for 'testmailingliste' mailing list.
testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== ~/etc/aliases ====

Wir tragen jetzt in unsere ~/etc/aliases folgendes ein:

# Aliases for 'testmailingliste' mailing list.
xyz00-testmailingliste: "|/home/pacs/xyz00/mailinglist/ecartis -s testmailingliste"
xyz00-testmailingliste-request: "|/home/pacs/xyz00/mailinglist/ecartis -r testmailingliste"
xyz00-testmailingliste-repost: "|/home/pacs/xyz00/mailinglist/ecartis -a testmailingliste"
xyz00-testmailingliste-admins: "|/home/pacs/xyz00/mailinglist/ecartis -admins testmailingliste"
xyz00-testmailingliste-moderators: "|/home/pacs/xyz00/mailinglist/ecartis -moderators testmailingliste"
xyz00-testmailingliste-bounce: "|/home/pacs/xyz00/mailinglist/ecartis -bounce testmailingliste"

==== example.com/etc/virtusertable ====

Bis jetzt haben wir noch nirgendwo festgelegt, unter welcher Domain die Mailingliste läuft. Dafür editieren wir die virtusertable der Domain (Bsp: example.com/etc/virtusertable für die Domain example.com:

testmailingliste@example.com xyz00-testmailingliste
testmailingliste-request@example.com xyz00-testmailingliste-request
testmailingliste-repost@example.com xyz00-testmailingliste-repost
testmailingliste-admins@example.com xyz00-testmailingliste-admins
testmailingliste-moderators@example.com xyz00-testmailingliste-moderators
testmailingliste-bounce@example.com xyz00-testmailingliste-bounce

Jetzt gibt es eine offene Liste mit der Adresse testmailingliste@example.com, an der man sich mit einer E-Mail an testmailingliste-request@example.com mit dem Inhalt subscribe anmelden kann.
Konfigurieren einer Mailingliste

Jeder Listenmanager besitzt ein Unterverzeichnis /lists, in welchem die zugehörigen Listen verwaltet werden. Jeder Mailingliste wird ein Verzeichnis unterhalb dieses Verzeichnisses zugeordnet. Es hat den Namen der Mailingliste. Die Konfigurationsdatei für die einzelnen Listen heißt config und ist dort abgelegt. Eine detaillierte Beschreibung der einzelnen Optionen gibt es unter: ecartis.org/variables.html.

=== Konfiguration ===
Hier nur die wichtigsten Einstellungen, die man konfigurieren sollte:

* list-owner = der Eigentümer der Liste
* subject-tag = eine Zeichenfolge die im Betreff vorangestellt wird (wie [global] bei unserer global(at)hostsharing.net Mailingliste)
* description = eine Beschreibung der Liste
* reply-to = Adresse der Liste (in unserem Beispiel: testmailingliste@example.com)
* administrivia-address = in unserem Beispiel testmailingliste-admins@example.com
* humanize-mime = false
* humanize-quotedprintable = true
Sorgen gemeinsam für eine ordentliche Handhabung von Umlauten, sie werden verstanden und es werden passende Header generiert.

* mbox-archive-path = wenn man möchte, kann man alle Mails, die über die Liste verschickt werden, archivieren
* subscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per subscribe an und wird direkt in die Liste eingetragen
2. confirm
Der Benutzer muss die Anmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Anmeldung muss vom Listenadmin erlaubt werden

* unsubscribe-mode = hier gibt es 3 mögliche Einstellungen:
1. open
Der Benutzer meldet sich per unsubscribe ab und wird direkt aus der Liste ausgetragen
2. confirm
Der Benutzer muss die Abmeldung anhand einer zugeschickten Mail bestätigen
3. closed
Die Abmeldung muss vom Listenadmin erlaubt werden

=== Unterschiedliche Mailinglistentypen ===

==== offene Liste ====

Offene Liste bedeutet, dass jeder an die Liste schreiben kann, die dann an alle eingetragenen E-Mail-Adressen verteilt wird (Beispiel: global(at)hostsharing.net).
Dies ist der Standard bei der Einrichtung einer Liste und benötigt keine besonderen Einstellungen

==== geschlossene Liste ====

bedeutet, dass nur E-Mails von den Eingetragenen verteilt werden. Diese Listenart wird auch als member-only bezeichnet (Beispiel: members(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

closed-post = true

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

==== moderierte Liste ====

bedeutet, dass E-Mails von jemandem authorisiert werden müssen, bevor sie verteilt werden. Wird in den meisten Fällen für Newsletter o.ä. verwendet, wo man als Betreiber den Eingetragenen E-Mails schicken will, aber eine Kommunikation der Eingetragenen untereinander nicht gewollt ist (Beispiel: global-announce(at)hostsharing.net).

Hierfür müssen folgende Optionen gesetzt werden:

* moderated = yes
* moderate-include-queue = true
* moderator = testmailingliste-moderators@example.com

Sinnvoll ist außerdem confirm oder closed bei subscribe-mode und unsubscribe-mode einzutragen.

=== Autorisierung ===
Für die Authorisierung gibt es mehrere Möglichkeiten:

==== admin-approvepost = true ====

Damit werden alle E-Mails der Listenadministratoren direkt verschickt. Es wird nur überprüft, ob die Absender-E-Mail-Adresse übereinstimmt, da diese aber sehr leicht gefälscht werden kann, ist es nur ein sehr schwacher Schutz.

==== post-password = geheimesPasswort ====

Das setzt das Passwort für diese Liste auf geheimesPasswort und nur E-Mails mit der folgenden Zeile im Header der E-Mail werden verteilt: X-posting-pass: geheimesPasswort

Wenn man keine der beiden Optionen benutzt, dann wird die E-Mail zuerst an den Administrator der Liste geschickt, der sie bestätigen muss.

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

MySQL

2009-12-22T14:42:48Z

Peh00-phor: /* Rechte vergeben */

{{Baustelle}}

Datenbanken und Datenbank-User werden ab 20.12.2009 mit mit [[hsadmin]] verwaltet.

== Server ==

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

Die Anzahl der in Hostsharing Dynamic-Web-Paketen verwendbaren MySQL-Datenbanken ist an sich nicht begrenzt. Der damit verbrauchte Speicherplatz geht in aber die Quota des Paketes mit ein, so dass hierüber eine indirekte Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. <code>xyz00_datenbank</code>.
== MySQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte 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 MySQL benutzen kann, muss man als ersten Schritt einen Datenbank-Administrator einrichten. Das ist zwingend notwendig. Es kann ein MySQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) sein. Es können allerdings auch beliebing viele Datenbank-Administratoren nach dem Namensschema <code>xyz00_...</code> angelegt werden. Wir richten den User mit [[Datenbanken]] ein, weil das am einfachsten ist.

Der Benutzername des Paketadmins für MySQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den MySQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für MySQL in keiner Beziehung zu den Benutzernamen für die Server.

=== 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 des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter 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 <code>mysql</code> 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 -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 <code>xyz00</code>:
* <code>xyz00_otto</code>
* <code>xyz00_anna</code>
* <code>xyz00_db_fuer_hans</code>

=== Rechte vergeben ===

Allen Benutzern, außer dem Paketadmin, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl <code>GRANT</code>.

<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. Man kann auch *.* für alle Tabellen in allen Datenbanken verwenden.

Mit <code>GRANT ALL</code> kann man einem User auch alle Kommandorechte zuweisen.

Alle Aufgaben können wir jetzt in Zukunft vom User <code>xyz00_otto</code> 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]]

MySQL

2009-12-22T14:42:04Z

Peh00-phor: /* Datenbank anlegen */

{{Baustelle}}

Datenbanken und Datenbank-User werden ab 20.12.2009 mit mit [[hsadmin]] verwaltet.

== Server ==

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

Die Anzahl der in Hostsharing Dynamic-Web-Paketen verwendbaren MySQL-Datenbanken ist an sich nicht begrenzt. Der damit verbrauchte Speicherplatz geht in aber die Quota des Paketes mit ein, so dass hierüber eine indirekte Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. <code>xyz00_datenbank</code>.
== MySQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte 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 MySQL benutzen kann, muss man als ersten Schritt einen Datenbank-Administrator einrichten. Das ist zwingend notwendig. Es kann ein MySQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) sein. Es können allerdings auch beliebing viele Datenbank-Administratoren nach dem Namensschema <code>xyz00_...</code> angelegt werden. Wir richten den User mit [[Datenbanken]] ein, weil das am einfachsten ist.

Der Benutzername des Paketadmins für MySQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den MySQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für MySQL in keiner Beziehung zu den Benutzernamen für die Server.

=== 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 des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter 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 <code>mysql</code> 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 -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 <code>xyz00</code>:
* <code>xyz00_otto</code>
* <code>xyz00_anna</code>
* <code>xyz00_db_fuer_hans</code>

=== Rechte vergeben ===

Allen Benutzern, außer dem Paketadmin, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl <code>GRANT</code>.

<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. Man kann auch *.* für alle Tabellen in allen Datenbanken verwenden.

Mit <code>GRANT ALL</code> kann man einem User auch alle Kommandorechte zuweisen.

ACHTUNG: <code>GRANT</code> ALL zur Zeit nicht möglich. Man kann aber alle Rechte explizit vergeben:

<pre><nowiki>
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX,
ALTER ON ... TO ...;
</nowiki></pre>

Alle Aufgaben können wir jetzt in Zukunft vom User <code>xyz00_otto</code> 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]]

MySQL

2009-12-22T14:41:09Z

Peh00-phor: /* Passwortänderung */

{{Baustelle}}

Datenbanken und Datenbank-User werden ab 20.12.2009 mit mit [[hsadmin]] verwaltet.

== Server ==

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

Die Anzahl der in Hostsharing Dynamic-Web-Paketen verwendbaren MySQL-Datenbanken ist an sich nicht begrenzt. Der damit verbrauchte Speicherplatz geht in aber die Quota des Paketes mit ein, so dass hierüber eine indirekte Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. <code>xyz00_datenbank</code>.
== MySQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte 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 MySQL benutzen kann, muss man als ersten Schritt einen Datenbank-Administrator einrichten. Das ist zwingend notwendig. Es kann ein MySQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) sein. Es können allerdings auch beliebing viele Datenbank-Administratoren nach dem Namensschema <code>xyz00_...</code> angelegt werden. Wir richten den User mit [[Datenbanken]] ein, weil das am einfachsten ist.

Der Benutzername des Paketadmins für MySQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den MySQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für MySQL in keiner Beziehung zu den Benutzernamen für die Server.

=== 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 des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter 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 <code>mysql</code> 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 -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]] oder auch weiter mit:

<pre><nowiki>
mysql>CREATE DATABASE xyz00_meinedatenbank;
</nowiki></pre>

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 <code>xyz00</code>:
* <code>xyz00_otto</code>
* <code>xyz00_anna</code>
* <code>xyz00_db_fuer_hans</code>

=== Rechte vergeben ===

Allen Benutzern, außer dem Paketadmin, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl <code>GRANT</code>.

<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. Man kann auch *.* für alle Tabellen in allen Datenbanken verwenden.

Mit <code>GRANT ALL</code> kann man einem User auch alle Kommandorechte zuweisen.

ACHTUNG: <code>GRANT</code> ALL zur Zeit nicht möglich. Man kann aber alle Rechte explizit vergeben:

<pre><nowiki>
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX,
ALTER ON ... TO ...;
</nowiki></pre>

Alle Aufgaben können wir jetzt in Zukunft vom User <code>xyz00_otto</code> 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]]

MySQL

2009-12-22T14:39:58Z

Peh00-phor: /* Weitere Benutzer anlegen */

{{Baustelle}}

Datenbanken und Datenbank-User werden ab 20.12.2009 mit mit [[hsadmin]] verwaltet.

== Server ==

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

Die Anzahl der in Hostsharing Dynamic-Web-Paketen verwendbaren MySQL-Datenbanken ist an sich nicht begrenzt. Der damit verbrauchte Speicherplatz geht in aber die Quota des Paketes mit ein, so dass hierüber eine indirekte Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. <code>xyz00_datenbank</code>.
== MySQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte 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 MySQL benutzen kann, muss man als ersten Schritt einen Datenbank-Administrator einrichten. Das ist zwingend notwendig. Es kann ein MySQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) sein. Es können allerdings auch beliebing viele Datenbank-Administratoren nach dem Namensschema <code>xyz00_...</code> angelegt werden. Wir richten den User mit [[Datenbanken]] ein, weil das am einfachsten ist.

Der Benutzername des Paketadmins für MySQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den MySQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für MySQL in keiner Beziehung zu den Benutzernamen für die Server.

=== 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 des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter 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 <code>mysql</code> 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 -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.
=== Passwortänderung ===

<pre><nowiki>
mysql>SET PASSWORD FOR xyz00_otto = PASSWORD('ottosneuespasswort');
</nowiki></pre>

=== Datenbank anlegen ===

geht nun auch mit [[hsadmin]] siehe [[Datenbanken]] oder auch weiter mit:

<pre><nowiki>
mysql>CREATE DATABASE xyz00_meinedatenbank;
</nowiki></pre>

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 <code>xyz00</code>:
* <code>xyz00_otto</code>
* <code>xyz00_anna</code>
* <code>xyz00_db_fuer_hans</code>

=== Rechte vergeben ===

Allen Benutzern, außer dem Paketadmin, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl <code>GRANT</code>.

<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. Man kann auch *.* für alle Tabellen in allen Datenbanken verwenden.

Mit <code>GRANT ALL</code> kann man einem User auch alle Kommandorechte zuweisen.

ACHTUNG: <code>GRANT</code> ALL zur Zeit nicht möglich. Man kann aber alle Rechte explizit vergeben:

<pre><nowiki>
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX,
ALTER ON ... TO ...;
</nowiki></pre>

Alle Aufgaben können wir jetzt in Zukunft vom User <code>xyz00_otto</code> 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]]

MySQL

2009-12-22T14:37:58Z

Peh00-phor: /* Paketadmin */

{{Baustelle}}

Datenbanken und Datenbank-User werden ab 20.12.2009 mit mit [[hsadmin]] verwaltet.

== Server ==

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

Die Anzahl der in Hostsharing Dynamic-Web-Paketen verwendbaren MySQL-Datenbanken ist an sich nicht begrenzt. Der damit verbrauchte Speicherplatz geht in aber die Quota des Paketes mit ein, so dass hierüber eine indirekte Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. <code>xyz00_datenbank</code>.
== MySQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte 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 MySQL benutzen kann, muss man als ersten Schritt einen Datenbank-Administrator einrichten. Das ist zwingend notwendig. Es kann ein MySQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) sein. Es können allerdings auch beliebing viele Datenbank-Administratoren nach dem Namensschema <code>xyz00_...</code> angelegt werden. Wir richten den User mit [[Datenbanken]] ein, weil das am einfachsten ist.

Der Benutzername des Paketadmins für MySQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den MySQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für MySQL in keiner Beziehung zu den Benutzernamen für die Server.

=== 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 des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter 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 <code>mysql</code> 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 -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.
=== Passwortänderung ===

<pre><nowiki>
mysql>SET PASSWORD FOR xyz00_otto = PASSWORD('ottosneuespasswort');
</nowiki></pre>

=== Datenbank anlegen ===

geht nun auch mit [[hsadmin]] siehe [[Datenbanken]] oder auch weiter mit:

<pre><nowiki>
mysql>CREATE DATABASE xyz00_meinedatenbank;
</nowiki></pre>

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 <code>xyz00</code>:
* <code>xyz00_otto</code>
* <code>xyz00_anna</code>
* <code>xyz00_db_fuer_hans</code>

=== Rechte vergeben ===

Allen Benutzern, außer dem Paketadmin, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl <code>GRANT</code>.

<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. Man kann auch *.* für alle Tabellen in allen Datenbanken verwenden.

Mit <code>GRANT ALL</code> kann man einem User auch alle Kommandorechte zuweisen.

ACHTUNG: <code>GRANT</code> ALL zur Zeit nicht möglich. Man kann aber alle Rechte explizit vergeben:

<pre><nowiki>
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX,
ALTER ON ... TO ...;
</nowiki></pre>

Alle Aufgaben können wir jetzt in Zukunft vom User <code>xyz00_otto</code> 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]]

Datenbanken

2009-12-18T15:04:19Z

Peh00-phor: Kurzbeschreibung mit HSAdmin

{{HSDoku-Links}}
Hostsharing betreibt Datenbanksever in [http://www.mysql.com - MySQL] und [http://www.postgresql.org PostgreSQL].

Unser server-übergreifendes Datenbank-Administrations-Tool: [[dbadmin]]

Wir haben ein Command-Line-Tool namens [[dbadmin]], mit dem viele Administrationsaufgaben einheitlich und unabhängig von der jeweiligen Datenbank erledigt werden können, die mit normalen Nutzerrechten anders nicht zugänglich sind.

== MySQL ==

* Server: Es gibt einen eigenen MySQL-Server auf jedem Host.
* Nutzung bei Hostsharing: siehe separater Artikel [[MySQL]] und [[MySQL-Datenbank anlegen Schritt für Schritt]]
* 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.

== PostgreSQL ==
* Server: Es gibt einen eigenen PostgreSQL-Server auf jedem Host.
* Nutzung bei Hostsharing: siehe separater Artikel [[PostgreSQL]]
* Web-Frontend: [http://www.phppgadmin.net phpPgAdmin] ist unter https://phppgadmin.hostsharing.net/current erreichbar.
* Online-Dokumentation: Die Online-Doku gibt es unter http://www.postgresql.org/docs/manuals/. Eine Liste von Büchern (einige davon zum Download) unter http://www.postgresql.org/docs/books/.

== Verwaltung von Datenbanken ==

Datenbanken können mit [[hsadmin]] auf der Kommandozeile oder im Browser angelegt werden.

In jedem Fall ist die Reihenfolge:
# einen Datenbankbenutzer als DB-Administrator anlegen
# die Datenbank anlegen

Dabei kann nach Belieben ein Administrator für alle Datenbanken eines Pakets oder ein eigener Daminisrtator-Account pro Datenbank angelegt werden.

=== Datenbank-Administrator anlegen ===

hsadmin -c mysqluser.add --set:name=xyz00_dbuser --set:password=geheim

bzw.

hsadmin -c postgresqluser.add --set:name=xyz00_dbuser --set:password=geheim

=== Datenbank anlegen ===

hsadmin -c mysqldb.add --set:name=xyz00_mydatabase --set:owner=xyz00_dbuser [ --encoding=latin1 ]

bzw.

hsadmin -c postgresqldb.add --set:name=xyz00_mydatabase --set:owner=xyz00_dbuser [ --encoding=LATIN1 ]

Das Encoding kann weggelassen werden, der Default ist dann "UTF-8".

=== Datenbanken auflisten ===

hsadmin -c mysqldb.search

bzw.

hsadmin -c postgresqldb.search

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

PostgreSQL

2009-12-18T14:49:55Z

Peh00-phor:

{{Baustelle}}

dbadmin wird am 19. Dez. 2009 ausser Betrieb genommen.

Datenbanken und Datenbank-User werden ab diesem Zeitpunkt mit [[hsadmin]] verwaltet.

== Server ==
Wir haben pro Host einen einzelnen PostgreSQL-Datenbankserver. Der Zugriff erfolgt über den Hostnamen localhost und den Port 5432. PostgreSQL unterstützt auch eine Verbindung über einen Socket. Dies wird bei uns für administrative Arbeiten genutzt, da hierüber per Konfiguration eine Verbindung ohne Passwortabfrage zugelassen wird. Dementsprechend steht diese Möglichkeit nicht für normale User zur Verfügung.

Auf dem Server werden per Default keine Accounts oder Datenbanken für ein Paket angelegt. Der Paketadmin muss dies mit dem Tool DBAdmin vornehmen, da das CREATEDB- und CREATEUSER-Recht nicht an normale Useraccounts vergeben wird.

Dabei ist zu beachten, dass sowohl Benutzer- als auch Datenbanknamen mit dem Paketkürzel anfangen müssen, also z.B. <code>xyz00_datenbank</code> und <code>xyz00_datenbankuser</code>. Andere Namen sind nicht möglich.

== PostgreSQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte und sollte dementsprechend mit Umsicht genutzt werden. Er kann mit seinem Account unter anderem:

* Datenbanken anlegen und löschen
* Benutzer anlegen und löschen
* Rechte an Benutzer vergeben

Bevor man in seinem Paket PostgreSQL benutzen kann, muss man als ersten Schritt einen Zugang für den Paketadmin einrichten. Das ist zwingend notwendig. Der PostgreSQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) besitzt automatisch alle Rechte an allen Datenbanken des Paketes, er ist also sehr mächtig. Wir müssen den User mit [[dbadmin]] einrichten.

<pre><nowiki>
xyz00@hopi$ dbadmin -a -i pgsql -u xyz00
Password: password
User 'xyz00' created.
</nowiki></pre>

Der Benutzername des Paketadmins für PostgreSQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den PostgreSQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für PostgreSQL in keiner Beziehung zu den Benutzernamen für die Server.

=== Weitere Benutzer anlegen ===

Du kannst Dir weitere Benutzer für PostgreSQL anlegen. Wir empfehlen Dir das ausdrücklich, weil es eine gute Idee ist, den mächtigen Zugang des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter Kommandos.

Wir legen noch einen User an:

<pre><nowiki>
xyz00@hopi$ dbadmin -a -i pgsql -u xyz00_otto
Password: password
User 'xyz00_otto' created.
</nowiki></pre>

mehr Information zum Anlegen von Nutzern im Artikel [[dbadmin]]

=== Datenbank anlegen ===

Eine neue Datenbank muss in PostgreSQL mit dem Tool [[dbadmin]] angelegt werden.

<pre><nowiki>
xyz00@hopi:~$ dbadmin -c -i pgsql -n xyz00_datenbank
</nowiki></pre>

== Der PostgreSQL-Monitor ==

Für die interaktive Verbindung zu einer Datenbank wird bei PostgreSQL das Programm <code>psql</code> verwendet. Nachdem ein User und eine Datenbank angelegt wurden, kann eine erste Verbindung zu PostgreSQL aufgebaut werden:

<pre><nowiki>
xyz00@hopi$ psql --host localhost --username xyz00 --dbname xyz00_datenbank
Password: passwort
Welcome to psql, the PostgreSQL interactive terminal.

Type: \copyright for distribution terms
\h for help with SQL commands
\? for help on internal slash commands
\g or terminate with semicolon to execute query
\q to quit

SSL connection (cipher: DES-CBC3-SHA, bits: 168)

xyz00_datenbank=>
</nowiki></pre>

Nun können wir PostgreSQL-Befehle eingeben. Zu beachten ist, dass die Zeilen mit <code><nowiki>';'</nowiki></code> abgeschlossen werden müssen.

Von <code>psql</code> und einigen anderen Tools werden eine Reihe von Umgebungsvariablen ausgewertet, so dass für die Anmeldung bei der Datenbank nicht immer alle Verbindungsdaten eingetippt werden müssen. Dazu gehören <code>PGDATABASE</code>, <code>PGHOST</code>, <code>PGPORT</code> und <code>PGUSER</code>. Man kann diese Variablen z.B. in seinem Shell-Profile setzen und damit die Anmeldung vereinfachen. Bei <code>/bin/bash</code> als Shell sieht das so aus:

<pre><nowiki>
PGHOST=localhost
PGUSER=xyz00
PGDATABASE=xyz00_datenbank
export PGHOST PGUSER PGDATABASE
</nowiki></pre>

Benutzer- und Datenbankname sollten natürlich an das eigene Paket angepasst werden. Anschließend reicht der einfache Aufruf von <code>psql</code>, um eine Verbindung zu dieser Datenbank mit dem angegebenen Benutzernamen aufzubauen.

=== Ändern des Passworts ===

Nach dem Anmelden in <code>psql</code> als der jeweilige Benutzer kann das Passwort folgendermaßen geändert werden:

<pre><nowiki>
xyz00_test=> ALTER USER xyz00 WITH PASSWORD 'neuespasswort';
</nowiki></pre>

=== Backups ===

Für Backup und Restore werden die beiden Programme <code>pg_dump</code> und <code>pg_restore</code> verwendet. Damit kann auch der Paketadmin eigene Sicherungen anlegen und zurückspielen oder auch eine Datenbank von seiner Entwicklungsumgebung einspielen.

Von den PostgreSQL-Datenbanken wird einmal pro Nacht eine Sicherung mit pg_dump angefertigt, die im Backup-Verzeichnis des Paketes abgelegt wird. Die Sicherung erfolgt mit dem folgenden Kommando:

<pre><nowiki>
xyz00@hopi:~$ pg_dump --blobs --format=c xyz00_datenbank
</nowiki></pre>

Der Dump wird dann mit <code>gzip</code> komprimiert und unter dem Namen der jeweiligen Datenbank unter <code>[[~/.bak]]</code> angelegt.

=== Vacuum einer Datenbank ===

Das Aufräumen einer PostgreSQL-Datenbank hat zwei Ziele:

* Ermittlung von Tabellenstatistiken (Größe, Anzahl Datensätze, Werteverteilung), damit der SQL-Optimizer einen möglichst guten Ausführungsplan berechnen kann.
* Freigeben von nicht mehr genutzen Blöcken, die durch Löschen und Ändern von Datensätzen entstanden sind.

Zur Durchführung dieser Aktionen kann das SQL-Kommando <code>vacuum</code> oder das Unix-Kommando <code>vacuumdb</code> benutzt werden.

Bei uns läuft einmal pro Nacht ein <code>VACUUM ANALYZE</code> zur Aktualisierung der Statistiken.

Es wird empfohlen, dass nach dem Ändern oder Löschen von größeren Datenmengen ein <code>VACUUM FULL</code> auf der Datenbank ausgeführt wird. Damit wird der benötigte Platz reduziert und im Allgemeinen auch die Zugriffsperformance verbessert. Da dieses Kommando für die Laufzeit eine exklusive Sperre auf den Tabellen hält, kann dies leider nicht regelmäßig und automatisiert laufen, sondern muss vom Anwender selbst ausgeführt werden.
Links

== Verschiedenes ==

* Web-Frontend: [http://www.phppgadmin.net phpPgAdmin] ist unter https://phppgadmin.hostsharing.net/current erreichbar.
* Online-Dokumentation: Die Online-Doku gibt es unter http://www.postgresql.org/docs/manuals/. Eine Liste von Büchern (einige davon zum Download) unter http://www.postgresql.org/docs/books/.

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

MySQL

2009-12-18T14:48:52Z

Peh00-phor:

{{Baustelle}}

dbadmin wird am 19. Dez. 2009 ausser Betrieb genommen.

Datenbanken und Datenbank-User werden ab diesem Zeitpunkt mit [[hsadmin]] verwaltet.

== Server ==

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

Die Anzahl der in Hostsharing Dynamic-Web-Paketen verwendbaren MySQL-Datenbanken ist an sich nicht begrenzt. Der damit verbrauchte Speicherplatz geht in aber die Quota des Paketes mit ein, so dass hierüber eine indirekte Begrenzung vorliegt. Alle Datenbanken eines Paketes müssen mit dem Paketnamen und einem Underscore beginnen, also z.B. <code>xyz00_datenbank</code>.
== MySQL-User ==
=== Paketadmin ===

Der Paketadmin hat mit seinem Account sehr weitgehende administrative Rechte und sollte dementsprechend mit Umsicht genutzt werden. Er kann mit seinem Account unter anderem:

* Datenbanken anlegen und löschen
* Benutzer anlegen und löschen
* Rechte an Benutzer vergeben

Bevor man in seinem Paket MySQL benutzen kann, muss man als ersten Schritt einen Zugang für den Paketadmin einrichten. Das ist zwingend notwendig. Der MySQL-User mit dem Kürzel des Paketadmins (<code>xyz00</code>) besitzt automatisch alle Rechte an allen Datenbanken des Paketes, er ist also sehr mächtig. Wir richten den User mit [[dbadmin]] ein, weil das am einfachsten ist.

<pre><nowiki>
xyz00@hopi$ dbadmin -a -i mysql -u xyz00
Password: password
User 'xyz00' created.
</nowiki></pre>

Der Benutzername des Paketadmins für MySQL entspricht dem Benutzernamen des Paketadmins für den Zugang zum Server. Das ist eine von uns gewählte Konvention, damit Du Dir den Namen für den MySQL-Zugang leichter merken kannst. Grundsätzlich stehen die Benutzernamen für MySQL in keiner Beziehung zu den Benutzernamen für die Server.

=== 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 des Paketadmins nur für administrative Zwecke zu benutzen. Schließlich will man nicht immer den mächtigen Account des Paketadmins in seinen Skripten verwenden. Für einzelne Aufgaben kannst Du verschiedene Benutzer anlegen, denen Du natürlich auch verschiedene Rechte geben kannst, z.B. nur Rechte an bestimmten Datenbanken oder zur Ausführung bestimmter Kommandos.

Wir legen noch einen User an:

<pre><nowiki>
xyz00@hopi$ dbadmin -a -i mysql -u xyz00_otto
Password: password
User 'xyz00_otto' created.
</nowiki></pre>

mehr zum Anlegen neuer User mit [[dbadmin]]

=== 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 <code>mysql</code> 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 -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.
=== Passwortänderung ===

<pre><nowiki>
mysql>SET PASSWORD FOR xyz00_otto = PASSWORD('ottosneuespasswort');
</nowiki></pre>

=== Datenbank anlegen ===

<pre><nowiki>
mysql>CREATE DATABASE xyz00_meinedatenbank;
</nowiki></pre>

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 <code>xyz00</code>:
* <code>xyz00_otto</code>
* <code>xyz00_anna</code>
* <code>xyz00_db_fuer_hans</code>

=== Rechte vergeben ===

Allen Benutzern, außer dem Paketadmin, müssen wir noch Rechte geben, sonst können sie gar nichts machen. Das erledigt man mit dem Befehl <code>GRANT</code>.

<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. Man kann auch *.* für alle Tabellen in allen Datenbanken verwenden.

Mit <code>GRANT ALL</code> kann man einem User auch alle Kommandorechte zuweisen.

ACHTUNG: <code>GRANT</code> ALL zur Zeit nicht möglich. Man kann aber alle Rechte explizit vergeben:

<pre><nowiki>
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, REFERENCES, INDEX,
ALTER ON ... TO ...;
</nowiki></pre>

Alle Aufgaben können wir jetzt in Zukunft vom User <code>xyz00_otto</code> 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]]

Datenbanken

2009-12-18T14:47:42Z

Peh00-phor: /* MySQL */