Wstęp
Katalog domowy jest jednym wspólnym miejscem do trzymania danych/ustawień aplikacji takich jak:
- logi (domyślnie)
- wtyczki
- konfiguracja
- XPDL
- 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.
| Element | Domyślne ustawienia | Własne ustawienia w | Uwagi |
|---|---|---|---|
| Konfiguracja bazy danych | <home-dir>/config/db.properties z nie wypełnionymi wartościami parametrów. W tym przypadku system korzysta z domyślnej wbudowanej bazy danych. | <home-dir>/config/db.properties z podami własnymi ustawieniami parametrów | 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 | |
| Konfiguracja logów | |||
| Pliki logów | <home-dir>/logs | wg ustawień powyższej konfiguracji logów | |
| Zainstalowane wtyczki | <home-dir>/data/plugins | nd. |
Konfiguracja bazy w db.properties
Domyślne ustawienia
# 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 jest wtedy zapewnienie odpowiednio tych samych wartości.
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
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
Ł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.