Aby zainstalować i skonfigurować serwer aplikacji WildFly (JBoss) na Linuksie, należy wykonać poniższe kroki. Poniższy poradnik obejmuje instalację na popularnych dystrybucjach (np. Ubuntu, Debian), przykład konfiguracji użytkowników, uruchomienie serwera i wdrażanie aplikacji Java EE.
1. Wymagania wstępne
- System Linux (np. Ubuntu, Debian)
- Uprawnienia sudo/root
- Dostęp do Internetu
2. Instalacja Java JDK
Serwer WildFly jest aplikacją opartą o Java. Wymagana jest instalacja Java JDK (zalecana najnowsza dostępna wersja OpenJDK).
sudo apt-get update sudo apt-get install default-jdk -y Po instalacji sprawdź wersję Javy:
java --version 3. Stworzenie użytkownika i grupy dla WildFly
Zaleca się utworzenie osobnego użytkownika i grupy do uruchamiania WildFly.
sudo groupadd -r wildfly sudo useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly 4. Pobranie i rozpakowanie WildFly
- Pobierz najnowszą wersję z oficjalnej strony WildFly (lista wersji na download.jboss.org):
VERSION=29.0.1.Final # lub najnowszą, sprawdź na stronie WildFly wget https://download.jboss.org/wildfly/$VERSION/wildfly-$VERSION.tar.gz -P /tmp - Rozpakuj do /opt:
sudo tar xf /tmp/wildfly-$VERSION.tar.gz -C /opt/ sudo ln -s /opt/wildfly-$VERSION /opt/wildfly - Przypisz prawa do katalogu WildFly:
sudo chown -R wildfly:wildfly /opt/wildfly-$VERSION 5. Dodanie zmiennych środowiskowych
Dodaj WildFly do zmiennej PATH w pliku ~/.bashrc lub /etc/profile.d/wildfly.sh:
echo "export WILDFLY_HOME=/opt/wildfly" | sudo tee /etc/profile.d/wildfly.sh echo "export PATH=\$PATH:\$WILDFLY_HOME/bin" | sudo tee -a /etc/profile.d/wildfly.sh source /etc/profile.d/wildfly.sh 6. Uruchomienie serwera WildFly
Aby uruchomić instancję w trybie standalone:
cd /opt/wildfly/bin sudo -u wildfly ./standalone.sh Domyślnie aplikacja nasłuchuje na portach 8080 (HTTP) oraz 9990 (konsola administracyjna).
7. Konfiguracja użytkownika administratora (Management)
Aby zalogować się do konsoli administracyjnej lub użyć CLI, musisz dodać użytkownika administracyjnego:
sudo -u wildfly /opt/wildfly/bin/add-user.sh - Podaj nazwę użytkownika (np. admin)
- Określ typ konta: Management User
- Wprowadź hasło
- Wybierz domenę, jeśli pojawi się pytanie (standardowo ENTER)
Teraz możesz zalogować się do konsoli administracyjnej:
- http://localhost:9990 (domyślnie tylko z localhost)
8. (Opcjonalnie) Konfiguracja systemd (autostart)
Utwórz plik serwisowy /etc/systemd/system/wildfly.service aby umożliwić automatyczny start:
[Unit] Description=WildFly Application Server After=network.target [Service] Type=simple User=wildfly Group=wildfly ExecStart=/opt/wildfly/bin/standalone.sh -b=0.0.0.0 ExecStop=/bin/kill -TERM $MAINPID Restart=always [Install] WantedBy=multi-user.target Załaduj nową jednostkę systemd:
sudo systemctl daemon-reload sudo systemctl enable wildfly sudo systemctl start wildfly sudo systemctl status wildfly 9. Wdrażanie aplikacji
Przy trybie standalone
- Po prostu skopiuj plik .war (np.
moje-aplikacje.war) do katalogu:
/opt/wildfly/standalone/deployments/
WildFly automatycznie wykryje i wdroży aplikację.
Przez CLI
Połącz się CLI:
/opt/wildfly/bin/jboss-cli.sh --connect Następnie:
deploy /ścieżka/do/moje-aplikacje.war 10. Podstawowe polecenia CLI
Przykładowe polecenia:
- help – wyświetla listę dostępnych komend
- shutdown – wyłącza serwer
- undeploy – usuwa aplikację
11. Dodatkowe wskazówki
-
WildFly uruchamia się domyślnie na localhost – jeśli chcesz udostępnić serwer w sieci, zmodyfikuj parametr uruchomieniowy:
bash ./standalone.sh -b=0.0.0.0 -bmanagement=0.0.0.0 -
Konfiguracje przechowywane są w
standalone/configuration/standalone.xml -
Panel administracyjny oraz CLI są domyślnie zabezpieczone hasłem administratora.
12. Dokumentacja
- Oficjalna dokumentacja WildFly: [docs.wildfly.org]
- Szczegółowe przewodniki wdrożeniowe dla konkretnych systemów:
Poradnik uwzględnia najważniejsze zagadnienia pozwalające samodzielnie zainstalować, uruchomić i skonfigurować serwer WildFly (JBoss) do produkcji lub środowiska programistycznego na serwerze z systemem Linux.
