Wprowadzenie

Wymagania systemowe

• Java Development Kit 8.x (zaleca się użycie najnowszej dostępnej wersji)
• Poprawnie ustawione zmienne środowiskowe JAVA_HOME i PATH

Instalacja

WildFly udostępniany jest pod adresem http://www.wildfly.org/downloads w postaci zwykłego archiwum .zip lub .tar.gz skąd należy go pobrać, a następnie rozpakować w preferowanym katalogu.

Uruchamianie serwera

Serwer aplikacji WildFly może działać w dwóch trybach standalone oraz domian. W obu przypadkach oferowane funkcjonalności są takie same. Różnica polega na sposobie konfiguracji i zarządzania - w drugim przypadku istnieje możliwość centralnego administrowania wieloma instancjami serwera.

Uruchomienie serwera odbywa się poprzez wykonanie skryptu startowego standalone.sh lub domain.sh (w zależności od trybu pracy) znajdującego się w katalogu bin.
Po pomyślnym zakończeniu procesu pod adresem http://localhost:8080 serwowana jest strona powitalna.

Istnieje możliwość uruchomienia serwera w trybie administracyjnym - serwer nie akceptuje żądań użytkowników oraz nie uruchamia wszystkich usług, jednak umożliwia na zmiany konfiguracji. W celu włączenia trybu administracyjnego należy użyć przy starcie parametru --admin-only.

Weryfikacja trybu pracy serwera z poziomu konsoli:

:read-attribute(name=running-mode)

Przeładowanie serwera ze zmianą trybu pracy:

reload --admin-only=true

Sprawdzenie trybu w jakim serwer został uruchomiony (nie zależnie od aktualnego stanu):

/core-service=server-environment:read-attribute(name=initial-running-mode)

Tworzenie konta administratora

Wykonywanie czynności administracyjnych wymaga utworzenia konta posiadającego odpowiednie uprawnienia. Konto można stworzyć za pomocą gotowego skryptu.

Nowy użytkownik powinien:

• być typu Management
• mieć możliwość podłączania się do innych procesów serwerów aplikacyjnych
• nie należeć do żadnej grupy

Warto zapamiętać wartość hasła zakodowaną w Base64, przyda się ona do późniejszej konfiguracji.

./add-user.sh

./add-user.sh -m -u admin -p P@ssw0rd

Użycie konsoli CLI

Administracja z poziomu linii poleceń jest możliwa po uruchomieniu konsoli za pomocą skryptu jboss-cli.sh. Po uruchomieniu należy podłączyć się do instancji serwera wydając polecenie connect.

Zatrzymywanie serwera

• użycie kombinacji klawiszy Ctrl-C
• wydanie odpowiedniej komendy z CLI
• zabicie procesu serwera

./jboss-cli.sh
[disconnected /] connect
Connected to localhost:9990
[localhost:9990 /] shutdown

./jboss-cli.sh
[disconnected /] connect 192.168.1.1
Username: nodeadmin
Password:
Connected to 192.168.1.1:9990
[192.168.1.1:9990 /] shutdown --restart=true

./jboss-cli.sh -c --command=shutdown

W nowszych wersjach serwera możliwe jest przejście do trybu suspended - aktualne żądania będą przetwarzane do końca, jednak serwer nie będzie akceptował nowych.

W trybie standalone:

:suspend(timeout=60)

W trybie domenowym:

:suspend-servers(timeout=60)
/host=master/server-config=server-one:suspend(timeout=60)
/server-group=main-server-group:suspend-servers(timeout=60)

Weryfikacja stanu i wznowienie pracy realizowane jest następująco:

:read-attribute(name=suspend-state)
/host=master/server=server-one:read-attribute(name=suspend-state)
:resume

Podobnie przeprowadzić moża również opóźnione wyłączenie serwera - tak, aby zdążył on przetworzyć jeszcze aktualne żądania klientów.

:shutdown(timeout=60)
:stop-servers(timeout=60)
/host=master/server-config=server-one:stop(timeout=60)
/server-group=main-server-group:stop-servers(timeout=60)