Instalacja

Instalacja na serwerze PlusWorkflow

PlusDirectoryMonitor może zostać zainstalowany jako zadanie zaplanowane w systemie PlusWorkflow. W tym celu należy zainstalować plik PlusDirectoryMonitor.jar jako wtyczkę w systemie.

Następnie w panelu administracyjnym należy dodać nowe zadanie zaplanowane. Jako nazwę klasy podajemy: com.plusmpm.directorymonitor.DirectoryMonitor, a jako nazwę metody: startup.

Do dyspozycji są 2 zadania zaplanowane:

1. pobierająca konfiguracje PlusDirectoryMonitor z pliku,
2. (od wersji 1.0.13) pobierająca konfiguracje PlusDirectoryMonitor z konfiguracji zapisanych z użyciem wtyczki Plugin Configuration Manager.

Metody te posiadają dwa parametry.

Pierwszy typu String:

• dla zadania nr. 1 określa ścieżkę do pliku konfiguracyjnego modułu PlusDirectoryMonitor,
• (od wersji 1.0.13) dla zadania nr. 2 określa identyfikator konfiguracji zapisanej z użyciem Plugin Configuration Manager.

Drugi parametr jest typu boolean i określa czy ma być wyświetlona ikonka w pasku zadań systemu operacyjnego. W przypadku instalacji na serwerze parametr ten powinien być ustawiony na false.

W dalszej kolejności należy określi pozostałe parametry potrzebne do konfiguracji zadania zaplanowanego takie jak: nazwa, opis zadania, data pierwszego uruchomienia, okres powtórzeń i następnie zakończyć tworzenie zadania.

Instalacja na stacji klienckiej

PlusDirectoryMonitor może zostać zainstalowany na dowolnej stacji klienckiej z zainstalowanym środowiskiem JAVA (JRE). W tym celu należy przegrać biblioteki potrzebne do działania programu oraz plik z samym programem do wybranego katalogu na stacji klienckiej (zalecana ścieżka ../PlusDirectoryMonitor/lib). Do odpowiedniego katalogu należy równie przegrać przygotowany plik konfiguracyjny (zalecany katalog: ../PlusDirectoryMonitor/conf). Zaleca się również utworzenie katalogu ./PlusDirectoryMonitor/logs i skonfigurowanie logów PlusDirectoryMonitor do tego katalogu. W celu uruchomienia programu należy wywołać klasę DirectoryMonitor z podaniem pliku konfiguracyjnego. Przykładowe wywołanie z poziomu katalogu ./PlusDirectoryMonitor:

java -Djava.ext.dirs=lib com.plusmpm.directorymonitor.DirectoryMonitor conf/DirectoryMonitor.ini

Polecenie takie można zapisać w pliku wykonywalnym (bat lub sh).

Instalacja PlusDirectoryMonitor jako usługa MS Windows

PlusDirectoryMonitor może być zainstalowany w systemie MS Windows jako usługa. W tym celu można posłużyć się programem wrapper umieszczonym w projekcie PlusDirectoryMonitor. Przed instalacją należy przegrać pliki wrapper.conf, wrapper.dll, wrapper.exe oraz pliki *.bat do wybranego katalogu na stacji klienckiej (zalecany katalog ./PlusDirectoryMonitor/bin). W plikach DirectoryMonitorService.bat, InstallDirectoryMonitorService-NT.bat oraz UninstallDirectoryMonitorService-NT.bat ustawiamy parametry:

set _REALPATH=c:\PlusWorkflow\PlusDirectoryMonitor\bin\

oraz

set _WRAPPER_CONF="c:\PlusWorkflow\PlusDirectoryMonitor\bin\wrapper.conf"

na odpowiednie ścieżki. W pliku wrapper.conf należy ustawić potrzebne parametry. Z najistotniejszych to:

• wrapper.app.parameter.1=c:\PlusWorkflow\PlusDirectoryMonitor\bin\DirectoryMonitor.ini - parametr określający ścieżkę do pliku konfiguracyjnego

   

• wrapper.ntservice.account=suncode - parametr określający nazwę konta w systemie Windows, na którym będzie uruchomiona usługa.

   

W celu instalacji usługi należy wywołać plik InstallDirectoryMonitorService-NT.bat. Po uruchomieniu tego pliku konieczne będzie podanie hasła na użytkownika, na którym ma być uruchomiona usługa. Po tej operacji usługa jest standardowo instalowana pod nazwą PlusDirectoryMonitor i można nią zarządzać z poziomu narzędzi MS Windows. W celu odinstalowania usługi można posłużyć się dołączonym plikiem UninstallDirectoryMonitorService-NT.bat. Natomiast plik DirectoryMonitorService.bat może być wykorzystany do pojedynczego uruchomienia programu PlusDirectoryMonitor.