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

O włączeniu katalogu domowego dla PlusWorkflow decyduje parametr '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.

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.

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 jest obligatoryjne, bo decyduje o włączeniu katalogu domowego.

	<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.

# 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. w 'Administracja' -> 'Konfiguracja systemu' -> 'Parametry systemowe'
Plik z parametrami w ogóle nie powinien być podłączony.

Konfiguracja logów

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'.

Włączenie katalogu domowego na nowym systemie

Na nowych systemach katalog domowy jest domyślnie włączony.

Wystarczy ustawić konfigurację bazy danych, a pozostałe ustawienia są domyślne (preferowane). Dla systemów tymczasowych (np.demonstracyjnych) także ustawienie bazy danych nie jest konieczne, wtedy PlusWorkflow uruchomi się na wbudowanej bazie.
W przypadku potrzeby można ew. zmienić domyślne ustawienia na własne.

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

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.