Katalog domowy ma być jednym miejscem do trzymania danych aplikacji takich jak:

  1. logi (domyślnie)
  2. wtyczki
  3. konfiguracja
  4. XPDL
  5. katalog tymczasowy

 

Konfiguracja

Konfiguracja katalogu ogranicza się do ustawienia tego katalogu w pliku web.xml:

 

 

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

 

Baza danych

Baza danych konfigurowana jest w pliku <home-dir>/config/db.properties (plik ten powinien się stworzyć po 1 uruchomieniu systemu)

Jeżeli nie podamy konfiguracji bazy danych - system uruchomi się na wbudowanej bazie PostgreSQL.
Parametry 'name', 'type', 'host', 'port' muszą być wypełnione nawet wtedy, gdy są one już podane w 'connectionUrl'.
Konieczne jest użycie tych samych wartości co w 'connectionUrl', poza wyjątkiem gdy 'connectionUrl' jest zostawiony pusty.

Należy usunąć konfigurację bazy z pliku context.xml i web.xml (tag 'resource-ref').

# 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

PlusWorkflow.conf

Ładowany jest domyślny plik PlusWorkfow.conf – jeżeli istnieje potrzeba zmiany parametrów można w katalogu domowym w <home-dir>/config/PlusWorkflow.conf nadpisać domyślne wartości.

Nie można tak zmienić ustawień dostępu do bazy – to jest robione poprzez plik <home-dir>/config/db.properties

Należy usunąć konfigurację parametru 'Shark_Conf' z pliku web.xml

Logi

Domyślnie logi będą trafiać do katalogu <home-dir>/logs (jeżeli nikt nie podał własnego pliku Log4j.xml)

 

Wtyczki

Wtyczki zapisywane będa w <home-dir>/data/plugins

W przypadku konieczności wykonania migracji, wystarczy przekopiować katalog do nowego położenia.

 

 

Kompatybilność wstecz

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

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.