Hledáme levný počítač pro hrátky s Linuxem i domácí server | Kapitola 5

Pro pokusy s nastavením potřebuji funkční server Apache Tomcat. Rozhodl jsem se instalaci testovací instance provést na tento mini PC. Začneme instalací Javy. Zvolil jsem 17, protože tuto verzi potřebuji zkoušet. Zvolte podle své situace. Pokud nevíte, zvolte poslední verzi 21. 

sudo apt install openjdk-17-jdk -y

Pro uživatele připravíme jeho skupinu.

sudo groupadd tomcat

Dalším krokem bude založení uživatele tomcat s domovským adresářem/opt/tomcat. Na toto umístění nahraji i samotný Tomcat server.

sudo useradd -r -g tomcat -d /opt/tomcat -s /bin/bash tomcat

Dále stáhneme samotný Apache Tomcat. Příkaz je platný pro poslední verzi v době psaní tohoto článku. Upravte si podle potřeby. V případě, že nevíte, jakou vybrat verzi, použijte poslední aktuální.

wget –O https://dlcdn.apache.org/tomcat/tomcat-/v11.0.18/bin/apache-tomcat-11.0.18.tar.gz

Vytvoříme adresář tomcat.

sudo mkdir /opt/tomcat 

Rozbalíme do nového adresáře.

sudo tar -xvzf apache-tomcat-11.0.18.tar.gz -C /opt/tomcat --strip-components=1 

Vlastnictví adresáře a jeho obsahu nastavíme pro uživatele Tomcat.

 sudo chown -R tomcat:tomcat /opt/tomcat 
 sudo chmod g+x /opt/tomcat/conf

Provedeme nastavení uživatelů Tomcatu. Nastavení provedeme pod uživatelem tomcat.

sudo -i -u tomcat
cd /opt/tomcat/conf
nano tomcat-users.xml

Přidáme definici dvou uživatelů na konec oddílu tomcat-users.

<role rolename="manager-gui"/>
<user username="manager" password="manager_password" roles="manager-gui"/>

<role rolename="admin-gui"/>
<user username="admin" password="admin_password" roles="manager-gui,admin-gui"/>

Položky upravíme dle svých potřeb. 

Následuje uvolnění přístupu k aplikačním portálům. Jde prakticky o aplikace pro Tomcat napsané v Javě. Proto je najdeme v adresáři webapps. V základu se na webové rozhraní dá dostat jedině z lokálního počítače, na kterém je instalace Tomcatu. To nechceme, pokud Tomcat běží na serveru.  Pro testovaní stačí pouze zakomentovat nadefinovaná omezení. Tím omezení zrušíme úplně. Pro produkci doporučuji omezení upravit.

První otevřeme konfiguraci portálu Manager. Nachází se zde:

/opt/tomcat/webapps/manager/META-INF/context.xml

Zakomentujeme podle ukázky.

<Context antiResourceLocking="false" privileged="true" ignoreAnnotations="true">
  <CookieProcessor className="org.apache.tomcat.util.http.Rfc6265CookieProcessor"
                   sameSiteCookies="strict" />
  <!--<Valve className="org.apache.catalina.valves.RemoteCIDRValve"
         allow="127.0.0.0/8,::1/128" /> -->
  <Manager sessionAttributeValueClassNameFilter="java\.lang\.(?:Boolean|Integer|Long|Number|String)|org\.apache\.catalina\.filters\.CsrfPreventionFilter\$LruCache(?:\$1)?|java\.util\.(?:Linked)?HashMap"/>
</Context>

Stejnou část musíme zakomentovat i v tomto souboru. Zpřístupní portál Host-manager.

/opt/tomcat/webapps/manager/META-INF/context.xml

Tak a máme nainstalováno. Nyní vytvoříme systémovou službu.

sudo update-java-alternatives -l

Tímhle příkazem zjistíme, v jaké cestě máme nainstalovanou Javu. Potom si připravíme systémový soubor služby.

sudo vim /etc/systemd/system/tomcat.service

Do souboru vložíme tento obsah, upravíme umístění Javy podle výstupu předchozího příkazu.

[Unit]  
Description=Tomcat  
After=network.target  

[Service]  
Type=forking  

User=tomcat  
Group=tomcat  

Environment="JAVA_HOME=/usr/lib/jvm/java-1.17.0-openjdk-amd64"  
Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom"  
Environment="CATALINA_BASE=/opt/tomcat"  
Environment="CATALINA_HOME=/opt/tomcat"  
Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"  
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"  

ExecStart=/opt/tomcat/bin/startup.sh  
ExecStop=/opt/tomcat/bin/shutdown.sh  

RestartSec=10  
Restart=always  

[Install]  
WantedBy=multi-user.target

Po vytvoření služby musíme provést reload. V příkazovém řádku použijeme tento příkaz.

sudo systemctl daemon-reload

Nakonec ověříme, zda služba Tomcat běží. V případě potřeby povolíme a službu nastartujeme.

sudo systemctl status tomcat

Tomcat nainstalovaný v počítači

Máme hotovo, nyní zkontrolujeme, zda se dostaneme na webové rozhraní Tomcatu. Do webového prohlížeče zadejte adresu serveru, kde je Tomcat nainstalován. Potom se dostanete na tyto stránky.

i Zdroj: PCTuning.cz

Pro přihlášení na portály použijte tlačítka vpravo nahoře. Vyzkoušíme Manager_app. Po přihlášení se dostaneme do prostředí managera.

i Zdroj: PCTuning.cz

Tímto máme aplikační server Tomcat nainstalován. Pro koho je tato instalace vhodná? Hodí se pro toho, kdo experimentuje s programováním v Javě, a pro každého, kdo se snaží porozumět správě Java aplikací pod Tomcatem. Má široké využití a tato znalost vám může být užitečná v profesní dráze. Některé aplikace pro testování:

• https://tomcat.apache.org/tomcat-9.0-doc/appdev/sample/ – oficiální testovací aplikace přímo od tvůrců Tomcatu.
• https://www.jenkins.io/doc/book/installing/war-file/#:~:text=Container%20Support%20Policy-,Run%20the%20WAR%20file,the%20command%20java%20%2Djar%20jenkins. - ci/cd systém Jenkins

Pozor, některé aplikace požadují součinnost s databází. Může být potřeba driver. Z originálních stránek PostgreSQL JDBC je možno stáhnou driver pro Postgress databázi, tento driver umístíme do

/opt/tomcat/lib/

Nastavení pro spojení k databázi se provádí v aplikaci v souboru context.xml. Vzorový příklad může vypadat takto.

 <Resource name="jdbc/TestDB"
          auth="Container"
          type="javax.sql.DataSource"
          driverClassName="org.postgresql.Driver"
          url="jdbc:postgresql://localhost:5432/moje_databaze"
          username="postgres"
          password="heslo"
          maxTotal="20"
          maxIdle="10"
          maxWaitMillis="-1"/>

Zde se držte pokynů k Java aplikaci, pro kterou nastavujete přístup k databázi.