Installation & Ersteinrichtung

Von der Modulinstallation zum ersten durchsuchbaren Verzeichnis — in einer halben Stunde.

Module können auf zwei Arten installiert werden:

1. Per Mausklick mit dem Module Manager
   Die Installation per Module Manager hat den Vorteil, dass dieser die Kompatibilität prüft und automatisch die neueste kompatible Modulversion installiert. Außerdem werden bei Updates die Einstellungen der Modulkonfiguration beibehalten
   oder
2. manuell per Upload einer Moduldatei

🡆FAQ: Wie werden Updates installiert?

1. Module Manager (empfohlen)

Installation mit Module Manager (empfohlen)

Der Module Manager muß selbst einmalig manuell (gemäß dieser Anleitung) installiert werden. Anschließend können Module über die grafische Benutzeroberfläche per Mausklick installiert und aktualisiert werden.

2. Manuelle Installation

Manuelle Installation

1. Laden Sie die für Ihre STARFACE-Version passende Moduldatei herunter.
   Sie finden diese im Bereich Release Notes / Changelog.
2. Melden Sie sich an Ihrer STARFACE-Installation als Benutzer mit Administratorrechten an.
3. Öffnen Sie den Bereich Admin / Module / Modul-Library.
4. Klicken Sie auf Modul importieren.
5. Wählen Sie Modul mittels Upload installieren und wählen die zuvor heruntergeladene Moduldatei aus. Bestätigen Sie per Klick auf Weiter.
6. Legen Sie unter dem Tab Admin / Module / Modul-Konfiguration durch Klick auf Neue Konfiguration eine neue Modulkonfiguration an. Der neuen Modulkonfiguration muß ein eindeutiger Name (z.B. „DirectoryHub“) gegeben werden. Klicken Sie anschließend auf Speichern.

Das Modul ist nun installiert. Eine Modulkonfiguration kann über die Aktiv-Checkbox aktiviert oder deaktiviert werden. Per Doppelklick auf die Modul-Konfigurationszeile oder Klick auf wird die Modul-Konfiguration geöffnet.

Hinweis: Die Modulkonfiguration von Fluxpunkt-Modulen mit grafischer Oberfläche muß aktiviert sein, um Einstellungen darin vornehmen zu können.

🡆FAQ: Warum ist mein Modulkonfigurationsfenster weiß (ohne Inhalt)?🡆FAQ: Warum erhalte ich die Meldung Die Modullizenz konnte nicht registriert werden?

Drittanbietermodule

Die Option Module mittels Lizenzschlüssel installieren steht nur für Module des Herstellers STARFACE zur Verfügung. Drittanbietermodule müssen immer mittels Datei-Upload oder Module Manager installiert werden!

---

Lizenzierung & Weitere Konfiguration

Öffnen Sie die soeben erstellte Modulkonfiguration per Doppelklick auf die Modul-Konfigurationszeile oder Klick auf und fügen Sie den Modullizenzschlüssel in das dafür vorgesehene Feld im Bereich 1Info2 Lizenzierung ein:

Nach Eingabe eines gültigen Modullizenzschlüssels wechselt die Bedienoberfläche automatisch in denEinstellungen-Bereich für eine weitere Konfiguration des Moduls.

🡆FAQ: Warum wird mein Modullizenzschlüssel nicht akzeptiert?

Für die weitere Konfiguration des Moduls folgen sie bitte der entsprechenden Anleitung.

Ersteinrichtung

Nach der Installation ist DirectoryHub bewusst zurückhaltend: Der LDAP-Server ist deaktiviert, Quellen sind keine angebunden. Die Ersteinrichtung folgt dem Weg der Daten — von der Quelle bis zum Endgerät:

1. Speicherort prüfen — Im Tab Datenbank ist die STARFACE-eigene PostgreSQL-Datenbank als Standard vorausgewählt; für die meisten Installationen ist das die richtige Wahl. Details: Datenbank.
2. Erste Quelle anbinden — Im Tab Quellen per Quelle hinzufügen den Quelltyp wählen, Verbindungsdaten hinterlegen und mit Testen prüfen — das funktioniert schon vor dem Speichern. Details: Quellen.
3. Feldzuordnungen festlegen — Im Unterbereich Feldzuordnungen mindestens den Primärschlüssel sowie Name und Rufnummern zuordnen; die Vorschau zeigt das Ergebnis mit echten Datensätzen. Details: Feldzuordnungen.
4. Ersten Import starten — Jetzt ausführen und die Statuszeile beobachten: Sie meldet, wie viele Datensätze gelesen, geschrieben und zusammengeführt wurden.
5. LDAP-Server aktivieren — Im Tab LDAP-Server den gewünschten Listener (unverschlüsselt und/oder TLS) einschalten und die zugreifenden Netze als Firewall-Freigabe eintragen. Details: LDAP-Server.
6. STARFACE-Adressbuch verbinden — Ein Klick auf STARFACE-Adressbuch konfigurieren richtet die Anlage automatisch als Verzeichnis-Client ein — inklusive Ordnern und Spaltenlayout.
7. Zugriff feinjustieren — Im Tab Zugriffsprofile festlegen, wer welche Teilbäume sehen darf. Details: Zugriffsprofile.

Klein anfangen

Beginnen Sie mit einer Quelle und wenigen Feldzuordnungen und erweitern Sie erst, wenn die Kette bis zum Endgerät steht. Jede weitere Quelle ist danach nur noch eine Wiederholung von Schritt 2–4.

Abschluss-Checkliste

Schritt	Erledigt, wenn…
Quelle angebunden	Testen meldet Erfolg
Feldzuordnungen	Vorschau zeigt Name und Rufnummern korrekt
Erster Import	Statuszeile meldet gelesene/geschriebene Datensätze
LDAP aktiv	Tab zeigt Status Aktiv mit Port
Adressbuch verbunden	Kontaktsuche in der STARFACE findet importierte Kontakte
Zugriff geregelt	Testbenutzer sieht genau die vorgesehenen Teilbäume