Skip to content

Running

Jump to bottom
ppodsednik edited this page Jan 14, 2026 · 1 revision

Deployment

Tato stránka popisuje, jak spustit Hazelcast Locks Server pro lokální vývoj i produkční prostředí. Před spuštěním doporučujeme zkontrolovat Configuration, aby byly proměnné prostředí nastaveny správně.

Lokální spuštění (standalone JVM)

Pro rychlý start serveru bez Dockeru lze spustit server pomocí Java příkazu:

java -cp ".;hazelcast-all-3.11.2.jar;hazelcast-locks-server-1.0.jar" \
    org.ceskaexpedice.hazelcast.HazelcastServerNodeStarter
  1. Ujistěte se, že máte Javu nainstalovanou (Java 21 doporučeno).
  2. Zkopírujte JAR soubory hazelcast-all-3.11.2.jar a hazelcast-locks-server-1.0.jar do stejného adresáře. Pokud mate novejsi verze , tak upravte cisla verzi jar souboru
  3. Volitelně nastavte environment proměnné:
    • HAZELCAST_CONFIG_FILE – cesta ke konfiguračnímu XML souboru Hazelcastu
    • HAZELCAST_INSTANCE – název Hazelcast instance (default: akubrasync)
    • HAZELCAST_USER – identifikátor uživatele / prostředí (default: dev)
  4. Spusťte Java příkaz k nastartování třídy org.ceskaexpedice.hazelcast.HazelcastServerNodeStarter.
  5. V logu by měla být hláška: "Hazelcast server node started successfully".
  6. Server běží dokud není ukončen pomocí CTRL+C nebo SIGTERM. Při ukončení se Hazelcast node korektně zavře.

Spuštění v Dockeru

Pro produkční nasazení je doporučeno spouštět server v Dockeru nebo Docker Compose, například jako součást Kramerius infrastruktury.

  • Použijte Docker image ceskaexpedice/hazelcast-locks-server:latest.
  • Při startu nastavte proměnné prostředí:
    • HAZELCAST_INSTANCE – název Hazelcast instance (např. akubrasync)
    • HAZELCAST_USER – identifikátor uživatele / prostředí (např. dev)
  • Volitelně namapujte konfigurační soubory pomocí volume mountu (/cesta/ke/configu:/config).
  • Po startu je server dostupný na defaultním Hazelcast portu 5701.

Kontrola běhu

  • Lokálně: kontrola v logu, zda je hláška "Hazelcast server node started successfully".
  • Docker: kontrola logů pomocí docker logs <jmeno-kontejneru>.
  • Připojení klienta (např. Akubra) lze ověřit testovacím lockem nebo kontrolou logů klienta.

Tipy

  • Pro lokální testování není potřeba měnit HAZELCAST_CONFIG_FILE, použije se default.
  • Pokud běží více instancí Hazelcast Locks Server, zajistěte unikátní HAZELCAST_INSTANCE.
  • Při změně konfigurace je třeba server restartovat.
  • V produkci doporučujeme monitorovat logy a health check Hazelcast node.

Clone this wiki locally