...

• start – runs the dLibra server in the service mode,
• stop – stops the running dLibra server,
• restart – restarts the running dLibra server, and
• console – runs the dLibra server in the console mode (see below).

MS Windows

Użytkownik może uruchomić skrypt The user can run the dlibra-server.bat znajdujący się w katalogu głównym serwera z następującymi parametrami:

• start - uruchamia serwer dLibra w trybie usługi,
• stop - zatrzymuje działający serwer dLibra,
• restart - restartuje działający serwer dLibra,
• install - serwer dLibra jako usługę systemu operacyjnego,
• remove - wyrejestrowuje serwer dLibra z listy usług systemu operacyjnego,
• console - uruchamia serwer dLibra w trybie konsolowym (patrz niżej).

...

script in the main directory of the server, with the following parameters:

• start – runs the dLibra server in the service mode,
• stop – stops the running dLibra server,
• restart – restarts the running dLibra server, and
• install – installs the dLibra server as a service of the operating system,
• remove – deregisters the dLibra server from the list of the services of the operating system,
• console – runs the dLibra server in the console mode (see below).

MS Windows 64-bit

W wersji

Since version 5.0 serwer dLibry zyskał możliwość uruchamiania w 64-bitowym środowisku MS Windows. Dodatkowym wymaganiem jest zainstalowana Java w wersji 64-bit. W celu uruchomienia serwera dLibra należy skorzystać ze skryptów zebranych w katalogu bat umieszczonego w katalogu głównym serwera:

• installService.bat - instaluje serwer dLibra jako usługę,
• runConsole.bat - uruchamia serwer dLibra w trybie konsoli,
• startService.bat - uruchamia serwer dLibra w trybie usługi,
• stopService.bat - zatrzymuje usługę serwera dLibra,
• uninstallService.bat - wyrejestrowuje usługę serwera dLibra,
• systemTrayIcon.bat - uruchamia ikonkę systemową dla serwera dLibra (serwer musi być wcześniej uruchomiony); za pomocą odpowiednich pozycji w menu i / lub graficznej konsoli możliwe są operacje uruchamiania, restartowania, itp. serwera dLibra.

Podczas uruchamiania serwera dLibra w środowisku 64-bit częściowo wykorzystywane są inne pliki konfiguracyjne. Są to pliki znajdujące się w podkatalogu conf/wrapper katalogu serwera, których nazwa kończy się ciągiem znaków yajsw. W pliku base-yajsw.conf należy podać parametry niezbędne do uruchomienia Javy analogicznie jak w pliku base.conf.

...

, the dLibra server has been able to run in 64-bit MS Windows. There is an additional requirement that 64-bit Java be installed. In order to run the dLibra system, use the scripts collected in the bat catalog in the root directory of the server:

• installService.bat – installs the dLibra server as a service,
• runConsole.bat – runs the dLibra server in the console mode,
• startServlce.bat – runs the dLibra server in the service mode,
• stopServlce.bat – stops the dLibra server service,
• unlnstallServlce.bat – deregisters the dLibra server service,
• systemTraylcon.bat – runs the system icon for the dLibra server (the server must be running); with the use of appropriate items on the menu and/or in the graphics console, it is possible to run, restart, etc. the dLibra server.

While the dLibra server is being started up in a 64-bit environment, some other configuration files are used.  They are in the “conf/wrapper” subdirectory of the server directory and end with the yajsw string.  In the “base-yajsw.conf” file, the parameters necessary for running Java should be entered, in analogy to the “base.conf” file.

The message to console display mode is for diagnostic running of the server. In order to run the server in that mode in systems from the MS Windows family, command dlibra-server.bat console should be given in the root directory of the server; for UNIX/Linux systems, command ,/dlibra-server.sh console should be used.

A sample effect of running the server in that mode. is illustrated below. 
Image Added

When the server is run correctly, the following message appears in the logs

Przykładowy efekt uruchomienia serwera w tym trybie widoczny jest na poniższym obrazku.
Image Removed

Oznaką poprawnego uruchomienia serwera jest pojawienie się w logach następującego komunikatu:

jvm 1 | INFO: Server startup in..... ms

Przerwanie pracy serwera w trybie konsolowym można uzyskać naciskając kombinację klawiszy While the server is running in the console mode, the user can interrupt it by pressing the Ctrl + C . Przed uruchomieniem serwera w trybie usługi zaleca się sprawdzenie jego działania w trybie konsolowym.

Inicjalizacja bazy danych

key combination. Before starting up the server in the service mode, it is recommended to check how it works in the console mode.

Initiating the Database

When the dLibra server is run for the first time, it tries to initiate the database on its own, based on the previously defined configuration parameters. For the database to be initiated, there must be file “database-init.properties” in the “conf” subdirectory of the root directory of the server, with the “Przy pierwszym uruchomieniu serwer systemu dLibra spróbuje samodzielnie zainicjować bazę danych bazując na podanych wcześniej parametrach konfiguracyjnych. Niezbędnym warunkiem rozpoczęcia inicjalizacji bazy danych jest istnienie w podkatalogu conf katalogu głównego serwera pliku o nazwie database-init.properties z wpisem init-scripts-path=<ścieżka <sciezka do katalogu ze skryptami inicjującymi>. Skrypty te domyślnie znajdują się w podkatalogu install-sql katalogu głównego serwera. Ścieżka może być zapisana w sposób bezwzględny lub względnie w stosunku do katalogu głównego serwera. Po udanej inicjalizacji bazy danych serwer usuwa plik database-init.properties. Jeżeli zajdzie potrzeba ponownej inicjalizacji bazy danych należy taki plik utworzyć samodzielnie i zrestartować serwer.

Gdyby zaszła konieczność samodzielnego inicjowania bazy danych, należy skorzystać ze skryptów znajdujących się we wspomnianym katalogu install-sql. W katalogu tym znajdują się podzielone na podkatalogi:

inicjujacymi>” sequence of characters in it. By default, those scripts are in the “install-sql” subdirectory of the root directory of the server. The path can be saved in an absolute or relative manner with respect to the root directory of the server. After a successful initialization of the database, the server deletes the “database-init.properties” file. If the database has to be initiated again, the user must create such a file on the user’s own and restart the server.

If the user has to initiate the database on the user’s own, the scripts from the “install-sql” directory should be used. In that directory, there are the following files (divided into subdirectories):

• files for creating database structures for particular servicespliki do tworzenia struktury bazy danych dla poszczególnych usług

  No Format
  [id.usługi]/[id.usługi]-[numer.wersji]-[rodzaj.bazy]-schema-create.sql

  
  

• grupa plików do usuwania bazy danych dla poszczególnych usługa group of files for deleting the database for particular services

  No Format
  [id.usługi]/[id.usługi]-[numer.wersji]-[rodzaj.bazy]-schema-drop.sql

  
  

• grupa plików do inicjowania zawartości bazy danych dla tych usług, które tego wymagająa group of files for initiating the content of the database for those services which require that

  No Format
  [id.usługi]/[id.usługi]-[numer.wersji]-[rodzaj.bazy]-data-init.sql

  
  

Pliki te są zapisane w kodowaniu Those files are saved as UTF-8 i niezbędne jest, aby dane w nich zawarte zostały wprowadzone do bazy danych tak, aby nie nastąpiło przekłamanie związane ze zmianą kodowania znaków. Przykładowe oprogramowanie umożliwiające wprowadzenie takich danych do wielu różnych rodzajów baz danych to bezpłatny SQuirreL SQL bazujący na języku Java i protokole JDBC, and the data in them must be entered to the database without defects resulting from a change of the character encoding. One example of software which makes it possible to enter such data into many kinds of databases is the free “SQuirreL SQL” software based on the Java language and on the JDBC protocol.

W celu samodzielnego przygotowania bazy danych dla serwera systemu dLibra, należy najpierw stworzyć struktury bazy danych dla poszczególnych usług (pliki posiadające w nazwie schema-create.sql), a następnie wypełnić je danymi początkowymi (pliki posiadające w nazwie init.sql). Kolejność usług nie jest w tym wypadku istotna. Sposób wykonania opisanych wyżej poleceń zależał będzie od użytej bazy danych oraz od oprogramowania zainstalowanego na komputerze, z którego przeprowadzana będzie ta operacja.