Wstęp

Katalog domowy jest jednym wspólnym miejscem do trzymania następujących elementów PlusWorkflow:

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).
Wystarczy ustawić konfigurację bazy danych (w <home-dir>/config/db.properties), 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>

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

Konfiguracja bazy danych

Lokalizacja : parametry w pliku <home-dir>/config/db.properties

# 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

Jeżeli parametry dot bazy danych (sekcja 'Database connection configuration'), nie są podane to system domyślnie uruchomi się na wbudowanej bazie PostgreSQL.

Jeżeli parametry te zostaną podane aby skorzystać z bazy zewnętrznej, to parametr 'connectionUrl' nie musi być podany.
Jednak jeśli z jakichś względów zostanie on wypełniony to parametry 'name', 'type', 'host', 'port' muszą nadal być wypełnione, pomimo ich podania w 'connectionUrl'.
Ponadto konieczne wtedy jest zapewnienie odpowiednio tych samych wartości.

Konfiguracja parametrów systemu

Lokalizacja : PlusWorkflow w 'Administracja' -> 'Konfiguracja systemu' -> 'Parametry systemowe'

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.

Lokalizacja danych

Jeśli katalog domowy jest włączony to w ustawionym folderze znajdują się następujące dane dotyczące działania PlusWorkflow:

Dane	Lokalizacja	Uwagi
Pliki logów	<home-dir>/logs	to domyślna lokalizacja, którą ewentualnie można zmienić zgodnie z opisem w Konfiguracja logów
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.

Włączenie katalogu domowego na działającym systemie (bez katalogu domowego)

Aby zmigrować do katalogu domowego system (z tą samą bazą, procesami itp), który wcześniej działał bez katalogu domowego, należy wykonać następujące ustawienia w zależności od potrzeb :

	Wymagane	Wymagana dodatkowa czynność
Ustawienie ścieżki katalogu
Ustawienie własnej bazy danych		Należy usunąć konfigurację bazy z pliku context.xml i web.xml (tag 'resource-ref').
Ustawienie własnych wartości wybranych parametrów systemu		Należy usunąć konfigurację parametru 'Shark_Conf' z pliku web.xml Jeśli używany był PlusWorkflow.conf z własnymi ustawieniami parametrów to zalecane jest jego zlikwidowanie i ustawienie tych zmienionych parametrów w Konfiguracji systemu->Parametry systemu. Jeśli jednak ustawienia parametrów zostaną nadpisane poprzez umieszczenie PlusWorkflow.conf w miejscu własnych ustawień (nie zalecane), to trzeba z tego pliku usunąć parametr 'WorkingDirectory'.
Ustawienie własnych logów		Należy usunąć konfigurację dot. parametru o nazwie 'log4jConfigLocation' z pliku web.xml
Migracja zainstalowanych wtyczek		Przekopiować zawartość obecnego katalogu z wtyczkami do nowej lokalizacji (wg info o lokalizacji własnych ustawień).
Migracja zainstalowanych map procesów		Przekopiować zawartość obecnego katalogu z mapami XPDL do nowej lokalizacji (wg info o lokalizacji własnych ustawień).
Migracja logów		Przekopiować zawartość obecnego katalogu z logami do nowej lokalizacji (wg info o lokalizacji własnych ustawień). Jeśli tego nie zrobimy to logi będą powstawały od nowa w nowej lokalizacji.