Wstęp

Katalog domowy jest jednym wspólnym miejscem do trzymania danych/ustawień aplikacji takich jak:

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

Elementy w katalogu

Ustawienia bazy danych

Ustawienia parametrów Shark'a (PlusWorkflow.conf)

Ustawienia logów

Pliki logów

Wtyczki

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.

Konfiguracja katalogu domowego

Na nowym systemie

Na systemie który działał bez katalogu domowego

Na systemie instalowanym Instalatorem

 

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.