Page Comparison

Installation Professional ERP myFinder

Für die Installation von Professional ERP myFinder muss die Installationsdatei „Professional ERP myFinder.msi“ ausgeführt werden, welche sich im Verzeichnis „myFinder“ des Professional ERP Installationsmediums befindet. Die Installation wird nicht automatisch gestartet.

Installation Professional ERP myFinder

Nach dem Start der Installationsdatei werden Sie schrittweise durch die Installation geführt.

1. Beginn der Installation mit der Willkommensseite und anschließendem Akzeptieren der Lizenzbedingungen
   

   Include Page
   screen myFinder Installation Willkommen screen myFinder Installation Willkommen

   Include Page
   screen myFinder Installation Lizenzabkommen screen myFinder Installation Lizenzabkommen

   
   
   

2. Auswahl des Installationspfades
   

   Include Page
   screen myFinder Installation Installationspfad screen myFinder Installation Installationspfad

   
   Hier kann ein lokales Verzeichnis des Servers gewählt werden, auf dem die Professional ERP myFinder Dienste bereitgestellt werden sollen. Die Installationsroutine erzeugt in diesem Verzeichnis eine Konfigurationsdatei (config.xml) für den Professional ERP myFinder Dienst.
   

   Note
   Sofern Sie eine Professional ERP Installation mit dem Erweiterungsmodul „Mandantenverwaltung“ betreiben und die Datenbestände der Mandanten sollen im Professional ERP myFinder ebenfalls zur Verfügung stehen, muss die erzeugte Konfigurationsdatei nach der Installation manuell erweitert werden. Wenden Sie sich hierfür bitte an unsere Support-Mitarbeiter.

   
   

3. Beginn der eigentlichen Installation
   

   Include Page
   screen myFinder Installation Beginn screen myFinder Installation Beginn

   
   Wird während der Installation keine kompatible Java-Laufzeitumgebung gefunden, erfolgt eine Hinweismeldung, die dazu auffordert, die Java-Installation später manuell nachzuholen. Das Installationsprogramm einer kompatiblen Java-Version befindet sich im Verzeichnis „java“ des „SUPPORT“-Verzeichnisses ihres Installationsmediums.
   
   
4. Schließen Sie die Installation über die Schaltfläche „Fertig stellen“ ab.
   

   Include Page
   screen myFinder Installation Fertig screen myFinder Installation Fertig

   
   

   Falls die Option „Konfigurationsordner öffnen“ ausgewählt wurde, öffnet sich der Konfigurationsordner, welcher standardmäßig unter C:\ProgramData\Software-Schmiede\myFinder liegt. Der „C:\ProgramData“-Ordner ist auf den meisten Systemen versteckt und kann über die Ordneroptionen sichtbar gemacht werden.
   In der passenden config.xml-Datei im Konfigurationsordner muss, wie später beschrieben, das Datenlaufwerk aus Professional ERP eingetragen werden.
   
   

5. Sofern in Schritt „1“ keine kompatible Java-Version gefunden wurde, holen sie deren Installation nun nach.

Nach Abschluss der Komplettinstallation erscheinen in der Windows Dienstverwaltung folgende, neue Systemdienste:

Windows Benutzerkonto für die Professional ERP myFinder Windowsdienste anpassen

Nach der Installation und Registrierung der neuen Dienste ist diesen jeweils das Benutzerkonto „lokales System“ zugeordnet. Rufen Sie in der Windows Dienstverwaltung die Eigenschaften der einzelnen Dienste auf und ändern Sie diese Zuordnung auf dem Register „Anmelden“. Verwenden Sie das im Rahmen der Vorbereitungsmaßnahmen bereitgestellte Domänenbenutzerkonto.

Anpassung der Konfigurationsdatei

In Schritt [4] der Installation wurde im Verzeichnis „C:\ProgramData\Software-Schmiede\myFinder“ die Konfigurationsdatei
„config.xml“ erstellt. Diese Konfigurationsdatei steuert welche Datenquellen der Professional ERP myFinder Indexdienst im Rahmen seiner Indizierungsläufe indiziert. In Abhängigkeit des verwendeten Datenbanksystems für die Datenhaltung der Professional ERP Serverinstallation müssen Änderungen am Inhalt dieser Datei vorgenommen werden.

Anpassungen für Datenhaltung mit Microsoft Visual FoxPro

In der Datei sollten in den nachfolgen beschriebenen Dateibereichen kontrolliert und ggf. geändert werden:

1. Standardmäßig wird die Indexierung nach Aufnahme einer Datei in den Index ohne Wartezeit mit der nächsten Datei fortgesetzt. Je nach Umgebung kann es notwendig werden, den Dienst zwischen der Indexierung von Dateien eine kurze Pause einlegen zu lassen. Das Attribut „delayIndex“ des XML-Tags „IndexingConfig“ gibt die Wartezeit in Millisekunden an und ist zunächst mit dem Wert „0“ vorbelegt.
2. Das Attribut „weekendDir“ des XML-Tags „IndexingConfig“ gibt den (Netzwerk-)Pfad zum Datenverzeichnis der
   Professional ERP Serverinstallation an. Nach der Installation ist diese in aller Regel in Windowsnotation mit Laufwerksbuchstabe des (Netz-)Laufwerkes angegeben. Diese Angabe sollte in eine UNC-Pfadangabe überführt werden.
3. Das Attribut „profDir“ des XML-Tags „IndexingConfig“ gibt den (Netzwerk-)Pfad zum Programmverzeichnis der
   Professional ERP Serverinstallation an. Nach der Installation ist diese in aller Regel in Windowsnotation mit Laufwerksbuchstabe eines (Netz-)Laufwerkes) angegeben. Auch diese Angabe sollte in eine UNC-Pfadangabe überführt werden.
4. Der XML-Tag „StartTime“ legt den täglichen Startzeitpunkt für Indexierungsläufe fest.
5. Der XML-Tag „MaxDuration“ steuert, wie viele Stunden ein einzelner Indexierungslauf dauern darf, bevor er pausiert und zum nächsten Startzeitpunkt fortgeführt wird. Da Indexierungsläufe je nach Datenmengen der eingebundenen Datenquellen – insbesondere bei der Erstindexierung – sehr lange dauern können und eine hohe Systemlast auf dem Rechnersystem erzeugen, das den Professional ERP myFinder bereitstellt, sollte hier eine Dauer vorgegeben werden, die dafür sorgt, dass die Indexierung während der Arbeitsstunden pausiert wird.

6. Der XML-Tag „Folders“ enthält unmittelbar nach der Installation einen einzelnen Eintrag des Tag-Typs „IndexingEntry“. Dieser Eintrag verweist auf das Verzeichnis „dateien“, welches sich normalerweise als Unterverzeichnis im Datenverzeichnis einer Professional ERP Serverinstallation befindet. Jeder Eintrag besitzt seinerseits die folgenden, untergeordneten Tags:

Watch: Der myFinder Indexdienst kann zusätzlich zur täglichen Indizierung einer Datenquelle auch versuchen, den Inhalt einer Datenquelle im laufenden Betrieb anhand des Windowsbenachrichtigungsdienstes zu überwachen und so Änderung oder Löschung von Dateien unabhängig von Indexierungsläufen festzustellen. Soll dies für eine Datenquelle versucht werden, so ist in diesem Tag der Wert „true“ anzugeben. Ist eine derartige Überwachung unerwünscht, dann ist hier „false“ anzugeben. Ohne diese Überwachung können neu hinzugefügte Dateien erst nach dem nächsten Indexierungslauf mit Professional ERP myFinder gefunden werden; typischerweise also erst am nächsten Tag.

Include: Hier können – durch Kommata getrennt – Dateiendungen angegeben werden, die als Whitelist bei der Indexierung statt der standardmäßig unterstützten Dateiformate einbezogen werden sollen. Wird hier keine Angabe gemacht, indiziert der myFinder Indexdienst entsprechend der Vorgabewerte der verwendeten Indexierungsengine.

Exclude: In diesem XML-Tag können – ebenfalls durch Kommata getrennt – die Dateiendungen angegeben werden, die als Blacklist bei einem Indexierungslauf nicht berücksichtigt werden sollen, auch wenn die Indexierungsengine das betreffende Dateiformat unterstützt. Bei Verwendung einer expliziten Whitelist haben Dateiendungen, die auch in der Blacklist enthalten sind, keine Ausschlusswirkung.

Anpassungen für Datenhaltung mit Microsoft SQL-Server

Die Konfiguration des myFinder Indexdienstes in Verbindung mit der Datenhaltung auf einem Microsoft SQL Server befolgt zunächst dieselben Schritte wie für die Datenhaltung mit Microsoft Visual FoxPro (siehe vorheriger Abschnitt). Zusätzlich muss der XML-Tag „IndexingConfig“ um das Attribut „dataSource“ erweitert werden.

Das hinzugefügte Attribut muss den SQL-Connection String der Professional ERP Serverinstallation erhalten, deren Daten im Professional ERP myFinder enthalten sein sollen.

Konfiguration in Professional ERP

Damit Professional ERP den Professional ERP myFinder verwenden kann, sind in Professional ERP bis zu zwei Konfigurationsvariablen zu belegen. Rufen Sie hierfür die Anwendung „Konfigurationsvariablen“ ihrer Professional ERP Serverinstallation auf.

Belegung Konfigurationsvariable «PROFSEARCHURL»

Über diese Konfigurationsvariable wird Professional ERP mitgeteilt, auf welchem Rechnersystem der Professional ERP myFinder – konkret der Dienst myFinder Webserver, welcher die Suchanfragen bearbeitet – zu erreichen ist. Die Belegung der Konfigurationsvariablen sieht wie folgt aus:

PROFSEARCHURL=http://[SERVERNAME]:1780 /asari8/core-1

Belegung Konfigurationsvariable «PROFSEARCHCONFIG» (optional)

Dem administrativen Professional ERP-Benutzer „SUPERUSER“ kann die Möglichkeit eingeräumt werden, Änderungen an der Konfiguration des Indexierungsdienstes auch über die Pflegemaske „myFinder Indexierungsverwaltung“ vorzunehmen, welche über die Anwendung „Firmenparameter“ durch Betätigung der Schaltfläche „myFinder Verwaltung“ auf dem Ribbon „Extras“ aufgerufen werden kann. In der Pflegemaske können Verzeichnisse als neue Datenquellen hinzugefügt oder entfernt, deren White- bzw. Blacklist vorgegeben und die Überwachung aktiviert/deaktiviert werden. Auch die Startzeit und maximale Dauer der Indexierungsläufe kann hier geändert werden.

Über die Konfigurationsvariable „PROFSEARCHCONFIG“ wird Professional ERP mitgeteilt, wo sich die zu bearbeitende „config.xml“ befindet. Die Belegung der Konfigurationsvariablen sieht dann wie folgt aus:

PROFSEARCHCONFIG=\\[SERVERNAME]\[FREIGABENAME+GGF.NOTWENDIGE_PFADANGABE]\config.xml

Erster Indexierungslauf und Test der Professional ERP myFinder Installation

Für einen ersten Funktionstest des Professional ERP myFinder stehen im Installationsverzeichnis (standardmäßig
„C:\Program Files (x86)\Software-Schmiede\Professional ERP myFinder\“) im Verzeichnis „tools“ die Anwendungen „myFinderMonitor.exe“ und „SWSServiceMonitor.exe“ bereit.

Zunächst wird die Anwendung „SWSServiceMonitor.exe“ aufgerufen. Es öffnet sich eine Monitoranwendung, in der einige der Windowsdienstkomponenten der Professional ERP Mehrwertdienste per Schaltfläche für eine Überwachung mit Ausgabe von Statusinformationen ausgewählt werden können.

Nach Auswahl des myFinder Indexdienstes öffnet sich ein neues Fenster in dem der gewählte Dienst im weiteren Verlauf seine Prozessinformationen ausgibt.

Als nächstes wird die Anwendung „myFinderMonitor.exe“ gestartet. Diese öffnet eine speziell auf den Professional ERP myFinder ausgelegte Überwachungsanwendung.

Beim Start dieser Anwendung wird eine Reihe interner Tests der installierten Professional ERP myFinder Dienstkomponenten durchgeführt. Sofern hierbei Fehler auftreten, öffnet sich parallel der installierte Texteditor und zeigt den Inhalt einer Logdatei zu diesen Tests, die es ermöglicht Fehlerursachen schneller zu erkennen. Öffnet sich die Überwachungsanwendung ohne Anzeige der Logdatei, wurden alle internen Tests erfolgreich durchgeführt. Dies ist ein erster Indikator dafür, dass der Professional ERP myFinder korrekt konfiguriert wurde und nach Abschluss der Erstindexierung im Hauptmenü von Professional ERP für Suchanfragen verwendet werden kann.

Die Anwendungsmaske enthält eine Reihe von runden Anzeigeelementen, die durch Ampelfarben den aktuellen Betriebszustand der Dienstkomponenten anzeigen. Zudem erhält man eine Information darüber, wie viele Dokumente aktuell in der Professional ERP myFinder Datenbank enthalten sind und wann die letzte Aktualisierung durch den Indexierungsdienst stattgefunden hat.

Über die Schaltfläche „Neuen Indexlauf anfordern“ kann eine Indexierung auch ohne Beachtung der eingestellten Startzeit sofort ausgelöst werden. Sie können die Erstindexierung auf diesem Weg starten und nach wenigen Sekunden wird der myFinder Indexdienst Statusmeldungen im noch immer geöffneten Monitorfenster der „SWSServiceMonitor.exe“ ausgeben.

Konfigurationsmaßnahmen für Professional ERP myFinder in Mehrmandatenversionen

Anpassungen in der Konfigurationsdatei «swsmyfinder.ini»

Öffnen Sie die Datei „swsmyfinder.ini“, welche sich im Programmverzeichnis der Professional ERP myFinder Installation befindet, in einem Texteditor. Entfernen Sie das Kommentarzeichen „#“ in der letzten Zeile vor dem Eintrag „MANDANT-COUNT“ und ersetzen Sie den Wert „1“ hinter dem Gleichheitszeichen derselben Zeile durch die Anzahl der zu unterstützenden Mandanten ihrer Professional ERP Serverinstallation.

Speichern sie die geänderte Datei „swsmyfinder.ini“.

Duplizieren der vorhandenen Konfigurationsdatei «config.xml»

Zunächst muss eine Anzahl an Kopien der bereits vorhandenen Konfigurationsdatei „config.xml“ erstellt werden, die der Anzahl der zu unterstützenden Mandanten entspricht, die sie zuvor in der Datei „swsmyfinder.ini“ angegeben haben. Anschließend müssen die kopierten Dateien entsprechend folgender Namenskonvention umbenannt werden:

1. „config-1.xml“ für den Hauptmandanten
2. „config-2.xml“ für den ersten Folgemandanten

…

      n. „config-n.xml“ für den n-ten Folgemandanten

Anpassungen in den Konfigurationsdateien «config-1.xml» bis «config-n.xml»

Bearbeiten Sie nun der Reihe nach die neu erzeugten Konfigurationsdateien und ändern Sie deren Inhalt entsprechend der Mandateninformationen hinsichtlich des Datenverzeichnisses im Attribut „weekendDir“, den ggf. verwendeten SQL-Connection-String im Attribut „dataSource“, sowie die Einträge für die Indexierung von Datenverzeichnissen. Speichern sie die geänderten Konfigurationsdateien und starten Sie die Professional ERP myFinder Dienste – insbesondere den myFinder Indexdienst – neu und veranlassen Sie optional durch erneuten Aufruf der Anwendung „myFinderMonitor.exe“ eine Neuindexierung.

Konfiguration in Professional ERP

Belegung Konfigurationsvariable «PROFSEARCHURL» auf Mandatenebene

Die Belegung der Konfigurationsvariable „PROFSEARCHURL“ entspricht nun folgendem Muster:

PROFSEARCHURL=http://[SERVERNAME]:1780 /asari8/core-n

Der Buchstabe „n“ ist in jedem Mandanten entsprechend der Nummer zu ersetzen, die dem gewählten Mandanten entspricht.

Belegung Konfigurationsvariable «PROFSEARCHCONFIG» auf Mandatenebene (optional)

Analog zur Konfigurationsvariable „PROFSEARCHURL“ ist „PROFSEARCHCONFIG“ für den jeweils gewählten Mandaten auf Mandanteneben mit dem UNC-Dateipfad zur jeweiligen Konfigurationsdatei „config-n.xml“ zu belegen.

Sonstige Hinweise zu Professional ERP myFinder

Die Installation und Verwendung des Professional ERP myFinder besitzt sicherheitsrelevante und datenschutzrechtlich rele-vante Eigenschaften, deren grundsätzliche Risiken gut abgeschätzt werden müssen.

Sicherheitshinweis zum Oracle Java Runtime Environment

In letzter Zeit sind immer wieder kritische Lücken in den Java-Laufzeitumgebungen aufgedeckt worden, über die es Angreifern möglich wurde, unerlaubten Zugriff auf Rechnersysteme zu erlangen. Um das Risiko derartiger Angriffe zu minimieren, sollte bei Verwendung des Professional ERP myFinder zwingend auf folgendes geachtet werden:

1. Die installierte Java Laufzeitumgebung auf dem System, das den Professional ERP myFinder Dienst bereitstellt, sollte regelmäßig auf Updates geprüft und eventuell bereitstehende Fixes sollten zeitnah installiert werden.
2. Das Java Plug-In für Web-Browser sollte – soweit möglich – auf dem System, das den Professional ERP myFinder Dienst bereitstellt, grundsätzlich deaktiviert Ab Java Version 7 Update 12 steht hierfür im Java Control Panel ein Klickfeld zur Verfügung

Unabhängig von dieser Einstellung sollte das Java Plug-In soweit möglich auch innerhalb der verwendeten Web-Browser deaktiviert werden. Wie dies zu bewerkstelligen ist, entnehmen Sie bitte der Hilfefunktion / Dokumentation des jeweils verwendeten Web-Browsers.

Datenschutz