konfiguracja
-bazy danych
-parametrów systemu
-logów
dane
-pliki logów
-zainstalowane wtyczki
-katalog tymczasowy
-mapy procesów

Włączenie katalogu domowego na nowym systemie

Na nowych systemach katalog domowy domyślnie jest włączony (parametrem 'plusworkflow.home' w web.xml.

Elementy katalogu domowego

Podczas pierwszego uruchomienia systemu z ustawionym katalogiem domowym, powstaną poniższe jego elementy z domyślnymi ustawieniami.
Jednak jest możliwość podania także własnych ustawień w podanym miejscu.

Elementy konfiguracyjne

To elementy umieszczone w katalogu domowym, które służą do ustawień działania PlusWorkflow.

...

)

...

.

...

Wystarczy ustawić konfigurację bazy danych (w <home-dir>/config/db.properties

...

Konfiguracja parametrów systemu

...

Pozostałe elementy

To elementy umieszczone w katalogu domowym, które nie służą do ustawień działania, ale zawierają już konkretne elementy potrzebne do działania albo efekty działania PlusWorkflow.

Element	Lokalizacja	Uwagi
Pliki logów	<home-dir>/logs	ale w powyższej konfiguracji logów można zmienić lokalizację gdzie będą trafiały logi
Zainstalowane wtyczki	<home-dir>/data/plugins
Katalog tymczasowy	<home-dir>/temp
Mapy procesów	<home-dir>/XPDL

Kompatybilność wstecz

Jeżeli w pliku web.xml nie został skonfigurowany katalog domowy, to:

wczytywana jest konfiguracja z PlusWorkflow.conf po staremu (parametr w web.xml)
baza danych pobierana jest z context.xml
wtyczki przechowywane są w starym katalogu (skonfigurowanym w suncode-plugins.xml)

Katalog domowy jest mimo wszystko ustawiany (domyślnie ../PlusWorkflow Home) – dlatego mogą tam trafić logi (jeżeli plik nie został nadpisany), będzie tam temp, katalog użytkownika (user.dir) etc.

Konfiguracja katalogu domowego

Aby ustawić/zmienić katalog domowy trzeba ustawić jego elementy konfiguracyjne we wskazanym w 'Elementy konfiguracyjne' lokalizacji własnych ustawień :

Konfiguracja ścieżki katalogu

Ustawienie ścieżki katalogu ), a pozostałe ustawienia najlepiej pozostawić domyślne. Dla systemów tymczasowych (np.demonstracyjnych) także ustawienie bazy danych nie jest potrzebne, wtedy PlusWorkflow uruchomi się na wbudowanej bazie.

Z kolei w przypadku instalowania nowego systemu instalatorem wystarczy podać ścieżkę katalogu domowego oraz konfigurację bazy danych w oknie instalator'a,.

Zmiana ustawień katalogu domowego

Domyślne lub obecne ustawienia katalogu domowego można ustawić poprzez konfigurację jego następujących elementów. Aczkolwiek poza konfiguracją bazy danych, zalecane jest pozostawienie domyślnych ustawień.

Konfiguracja ścieżki katalogu

Lokalizacja : parametr plusworkflow.home w web.xml

Ustawienie ścieżki katalogu jest obligatoryjne, bo decyduje o włączeniu katalogu domowego. Ustawiona tu ścieżka jest dalej w instrukcji określana jako <home-dir>

Code Block

title	Przykładowe ustawienie

	<context-param>
		<param-name>plusworkflow.home</param-name>
		<param-value>../PlusWorkflow Home</param-value>
	</context-param>

Konfiguracja bazy danych

Ustawienia dot bazy danych można zrobić poprzez ustawienie parametrów w pliku.Lokalizacja : parametry w pliku <home-dir>/config/db.properties

Code Block

title	Domyślne ustawienia

# Database connection configuration
# [Connection]
# Database name
db.name=
# Database server type [postgresql, oracle, mssql, db2, db2as400]
db.type=
# Database server host (without port)
db.host=
# Port on which database server accepts connections
db.port=
# Database user
db.username=
# Database user password
db.password=
# [Optional] JDBC connection URL (if empty, connection URL will be build based on properties above)
db.connectionUrl=

# [Connection pool configuration]
# Maximum pool size (default 30)
db.pool.size=30
# Minimum number of idle connections in pool (default 5)
db.pool.idle=5
# Timeout for acquiring connection from the pool (defaults to 5 minutes)
db.pool.connectionTimeout=300000

...

Konfiguracja parametrów systemu

Zalecanym sposobem ustawiania parametrów jest ich ustawianie z GUI PlusWorkflow tj. Lokalizacja : PlusWorkflow w 'Administracja' -> 'Konfiguracja systemu' -> 'Parametry systemowe'

Status

title	v3.2.22+

Plik z parametrami w ogóle nie powinien być podłączony.

Konfiguracja logów

Od wersji 3.2.22 zalecanym sposobem zmiany parametrów jest ich zmiana bezpośrednio w PlusWorkflow.
Natomiast w starszych wersjach można to zrobić poprzez własne ustawienia wartości parametrów w <home-dir>/config/PlusWorkflow.conf

Konfiguracja logów

Lokalizacja : parametry w pliku <home-dir>/config/Log4j.xml

Polega na podpięciu własnego pliku ustawień log4j, w miejscu wskazanym w 'Elementy konfiguracyjne' lokalizacja własnych ustawień.

Włączenie katalogu domowego

Aby po raz pierwszy włączyć katalog domowy, nie wszystkie ustawienia są konieczne. Potrzebne są z kolei dodatkowe kroki, jeśli chcemy włączyć katalog domowy na działającym już systemie.
Poniższy opis pokazuje co trzeba zrobić, a co jest opcjonalne w zależności od sytuacji.
Natomiast bardziej szczegółowy sposób ustawiania elementów konfigurowalnych jest opisany w 'Konfiguracja katalogu domowego', a informacje o miejscu ich wykonania znajduje się w opisie elementów tj. w 'Elementy konfiguracyjne'.