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 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 podany sposób.

ElementLokalizacja domyślnych ustawieńLokalizacja własnych ustawieńUwagi
Konfiguracja bazy danych<home-dir>/config/db.properties z pustymi wartościami parametrów.
W takim przypadku system korzysta z domyślnej wbudowanej bazy danych.
<home-dir>/config/db.properties
z podaniem odpowiednich wartości parametrów dot zewnętrznej bazy
poniżej więcej szczegółów odnośnie konfiguracji bazy w pliku

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

wbudowane w system<home-dir>/config/PlusWorkflow.conf
poza ustawieniami bazy co jest robione jak opisano powyżej
Nie zalecane.
Obecnie zaleca ustawiać własne usatwienia parametrów w
Administracja->Konfiguracja systemu->Parametry systemu.
Konfiguracja logówwbudowane w system<home-dir>/config/Log4j.xml 
Pliki logów<home-dir>/logswg ustawień powyższej konfiguracji logów 
Zainstalowane wtyczki<home-dir>/data/pluginsnd. 

Konfiguracja bazy w db.properties

Ustawienia dot bazy danych z której ma korzystać system można zrobić w <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.

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

 

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

 

PlusWorkflow.conf

 

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

Logi

Należy usunąć konfigurację dot. parametru o nazwie 'log4jConfigLocation' z pliku web.xml

Wtyczki

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