So stellen Sie eine WAR-Datei in Tomcat bereit

Eine kurze und praktische Anleitung zur Installation und Konfiguration von Apache Tomcat.

Read more →

Erfahren Sie, wie Sie eine Spring Boot-Anwendung für die Bereitstellung auf einem Tomcat-Server konfigurieren.

Read more →

Erfahren Sie, wie Sie einen Apache Tomcat-HTTP-Server für die Ausführung auf Port 80 konfigurieren.

Read more →

Wenn Sie schon einmal mit Tomcat gearbeitet haben, sind Ihnen diese sehr vertraut:

$CATALINA_HOME

Diese Variable zeigt auf das Verzeichnis, in dem unser Server installiert ist.

$CATALINA_BASE

Diese Variable verweist auf das Verzeichnis einer bestimmten Instanz von Tomcat. Möglicherweise sind mehrere Instanzen installiert. Wenn diese Variable nicht explizit festgelegt wird, wird ihr der gleiche Wert wie$CATALINA_HOME zugewiesen.

Webanwendungen werden im Verzeichnis$CATALINA_HOME\webappsbereitgestellt.

Document root. Verweist auf das oberste Verzeichnis einer Webanwendung, in dem sich alle Anwendungsressourcen wie JSP-Dateien, HTML-Seiten, Java-Klassen und Bilder befinden.

Context path. Verweist auf den Speicherort, der relativ zur Serveradresse ist und den Namen der Webanwendung darstellt.

Wenn unsere Webanwendung beispielsweise im Verzeichnis$CATALINA_HOME\webapps\myapp abgelegt wird, wird über die URLhttp://localhost/myapp auf sie zugegriffen, und ihr Kontextpfad lautet/myapp.

WAR. Ist die Erweiterung einer Datei, die eine Webanwendungsverzeichnishierarchie im ZIP-Format verpackt und die Abkürzung für Web Archive. Java-Webanwendungen werden normalerweise als WAR-Dateien für die Bereitstellung gepackt. Diese Dateien können über die Befehlszeile oder mit einer IDE wie Eclipse erstellt werden.

Nach der Bereitstellung unserer WAR-Datei entpackt Tomcat sie und speichert alle Projektdateien im Verzeichniswebappsin einem neuen Verzeichnis, das nach dem Projekt benannt ist.

Wir können den Tomcat-Server starten, indem wir einfach das Skriptstartupausführen, das sich bei$CATALINA_HOMEin\startup befindet. In jeder Installation gibt es.bat und.sh.

Wählen Sie die entsprechende Option, je nachdem, ob Sie ein Windows- oder ein Unix-basiertes Betriebssystem verwenden.

Während der Bereitstellungsphase stehen uns einige Optionen zur Verfügung. Eine davon ist die Verwendung des Verwaltungs-Dashboards von Tomcat. Um auf dieses Dashboard zugreifen zu können, muss ein Administrator mit den entsprechenden Rollen konfiguriert sein.

Um auf das Dashboard zugreifen zu können, benötigt der Administrator die Rollemanager-gui. Später müssen wir eine WAR-Datei mit Maven bereitstellen. Dazu benötigen wir auch die Rollemanager-script.

Nehmen wir diese Änderungen in$CATALINA_HOME\conf omcat-users vor:

Weitere Details zu den verschiedenen Tomcat-Rollen finden Sie unterthis official link.

Vergewissern Sie sich abschließend, dass das Tomcat-Installationsverzeichnis Lese- / Schreibrechte besitzt.

Um zu testen, ob Tomcat ordnungsgemäß eingerichtet ist, führen Sie das Startskript (startup.bat /startup.sh) aus. Wenn auf der Konsole keine Fehler angezeigt werden, können Sie dies überprüfen, indem Siehttp://localhost:8080 aufrufen.

Wenn Sie die Tomcat-Startseite sehen, haben wir den Server korrekt installiert.

Standardmäßig ist Tomcat so eingestellt, dass Verbindungen an Port8080 abgehört werden. Wenn bereits eine andere Anwendung an diesen Port gebunden ist, teilt uns die Startkonsole dies mit.

Um den Port zu ändern, können Sie die Serverkonfigurationsdateiserver.xml bearbeiten, die sich bei$CATALINA_HOME\conf\server.xml. befindet. Standardmäßig lautet die Connector-Konfiguration wie folgt:

Wenn wir beispielsweise unseren Port in8081 ändern möchten, müssen wir das Portattribut des Connectors folgendermaßen ändern:

Manchmal ist der von uns gewählte Port nicht standardmäßig geöffnet. In diesem Fall müssen wir diesen Port mit den entsprechenden Befehlen im Unix-Kernel öffnen oder die entsprechenden Firewall-Regeln in Windows erstellen Dieser Beitrag.

In diesem Abschnitt erfahren Sie, wie Sie mit dem Maven-Plugin von Cargo ein WAR für Tomcat bereitstellen. In diesem Fall stellen wir es für eine Instanz der Version 7 bereit.

Um den gesamten Prozess in den Griff zu bekommen, erstellen wir zunächst eine neue Java-Webanwendung über die Befehlszeile:

Dadurch wird eine vollständige Java-Webanwendung im Verzeichniscargo-deployerstellt. Wenn wir diese Anwendung so wie sie ist erstellen, bereitstellen und laden, werdenHello World! im Browser gedruckt.

Im Gegensatz zum Tomcat7-Maven-Plugin erfordert das Cargo Maven-Plugin, dass diese Datei vorhanden ist.

Da unsere Webanwendung keine Servlets enthält, ist die Dateiweb.xmlehr einfach. Navigieren Sie also zum OrdnerWEB-INF unseres neu erstellten Projekts und erstellen Sie eineweb.xml-Datei mit folgendem Inhalt:

Damit Maven die Befehle von Cargo erkennen kann, ohne den vollständig qualifizierten Namen einzugeben, müssen wir das Cargo Maven-Plugin einer Plugin-Gruppe insettings.xml.von Maven hinzufügen

Fügen Sie als unmittelbares untergeordnetes Element des Elements root<settings></settings>Folgendes hinzu:

In diesem Unterabschnitt bearbeiten wir unserepom.xml, um sie an unsere neuen Bereitstellungsanforderungen anzupassen.

Fügen Sie das Plugin wie folgt hinzu:

Die neueste Version zum Zeitpunkt des Schreibens ist1.5.0. Die neueste Version ist jedoch immerhere zu finden.

Beachten Sie, dass wir die Verpackung explizit als WAR definieren. Andernfalls schlägt unser Build fehl. In der Plugins Sektion fügen wir dann das cargo maven2 Plugin hinzu. Zusätzlichwe add a configuration section where we tell Maven that we are using a Tomcat container and also an existing installation.

Indem Sie den Containertyp aufinstalled setzen, teilen wir Maven mit, dass auf dem Computer eine Instanz installiert ist, und geben die absolute URL für diese Installation an.

Indem Sie den Konfigurationstyp aufexisting setzen, teilen wir Tomcat mit, dass ein vorhandenes Setup vorhanden ist und keine weitere Konfiguration erforderlich ist.

Die Alternative wäre, cargo anzuweisen, die angegebene Version herunterzuladen und einzurichten, indem eine URL angegeben wird. Unser Fokus liegt jedoch auf der WAR-Bereitstellung.

Es ist erwähnenswert, dass unabhängig davon, ob wir Maven 2.x oder Maven 3.x verwenden, das Cargo maven2-Plugin für beide funktioniert.

Wir können unsere Anwendung jetzt installieren, indem wir Folgendes ausführen:

und bereitstellen durch:

Wenn alles gut geht, sollten wir in der Lage sein, unsere Webanwendung durch Laden vonhttp://localhost:8080/cargo-deploy. auszuführen

Für eine Remote-Bereitstellung müssen wir nur den Konfigurationsabschnitt unsererpom.xmländern. Remote-Bereitstellung bedeutet, dass wir keine lokale Installation von Tomcat haben, sondern auf das Manager-Dashboard auf einem Remote-Server zugreifen können.

Ändern wir also diepom.xml so, dass der Konfigurationsabschnitt folgendermaßen aussieht:

Dieses Mal ändern wir den Containertyp voninstalled inremote und den Konfigurationstyp vonexisting inruntime. Zuletzt fügen wir der Konfiguration Authentifizierungs- und Remote-URL-Eigenschaften hinzu.

Stellen Sie sicher, dass die Rollen und Benutzer wie zuvor bereits in$CATALINA_HOME/conf/tomcat-users.xml vorhanden sind.

Wenn Sie dasselbe Projekt für die Bereitstellung vonremotebearbeiten, entfernen Sie zuerst die Bereitstellung der vorhandenen WAR:

Bereinigen Sie das Projekt:

es installieren:

Stellen Sie es schließlich bereit:

Das ist es.

Wir können eine Installation in Eclipse einbetten, indem wir den Menüpunktwindow in der Taskleiste und dannpreferences in der Dropdown-Liste auswählen.

Im linken Bereich des angezeigten Fensters finden Sie ein Baumgitter mit Präferenzelementen. Wir können dann zueclipse → servers navigieren oder einfachservers in die Suchleiste eingeben.

Wir wählen dann das Installationsverzeichnis aus, falls es noch nicht für uns geöffnet ist, und wählen die Tomcat-Version aus, die wir heruntergeladen haben.

Auf der rechten Seite des Fensters wird eine Konfigurationsseite angezeigt, auf der wir die Option Aktivieren auswählen, um diese Serverversion zu aktivieren und zum Installationsordner zu navigieren.

Wir übernehmen Änderungen und wenn wir das nächste Mal die Serveransicht über das Untermenüwindows → show viewvon Eclipse öffnen, ist der neu konfigurierte Server vorhanden und wir können Anwendungen darauf starten, stoppen und bereitstellen.

Um eine Webanwendung auf Tomcat bereitzustellen, muss sie in unserem Arbeitsbereich vorhanden sein.

Öffnen Sie die Ansichtservers vonwindow → show view und suchen Sie nach Servern. Wenn es geöffnet ist, können wir einfach mit der rechten Maustaste auf den von uns konfigurierten Server klicken undadd deployment aus dem angezeigten Kontextmenü auswählen.

Öffnen Sie im angezeigten DialogfeldNew Deployment die Dropdown-Listeproject und wählen Sie das Webprojekt aus.

Unter dem KombinationsfeldProject befindet sich ein AbschnittDeploy Type, wenn wirExploded Archive(development mode),our changes in the application will be synced live without having to redeploy auswählen. Dies ist die beste Option während der Entwicklung, da es sehr effizient ist.

Wenn SiePackaged Archive(production mode) auswählen, müssen wir jedes Mal, wenn wir Änderungen vornehmen, diese erneut bereitstellen und im Browser anzeigen. Dies ist nur für die Produktion am besten geeignet, Eclipse macht es jedoch genauso einfach.

Wir entscheiden uns normalerweise für die Bereitstellung einer WAR über Eclipse, um das Debuggen zu vereinfachen. Es kann vorkommen, dass wir möchten, dass es an einem anderen Ort als den von den eingebetteten Servern von Eclipse verwendeten bereitgestellt wird. In den meisten Fällen ist unser Produktionsserver online und wir möchten die Webanwendung aktualisieren.

Wir können dieses Verfahren umgehen, indem wir es im Produktionsmodus bereitstellen, dieDeploy Location im DialogfeldNew Deployment notieren und von dort aus die WAR auswählen.

Während der Bereitstellung können Sie anstelle eines eingebetteten Servers die Option<Externally Launched> in der Ansichtserversneben der Liste der eingebetteten Server auswählen. Wir navigieren zumwebapps-Verzeichnis einer externen Tomcat-Installation.

Öffnen Sie das MenüRunund klicken Sie auf die OptionenEdit Configurations.

Wenn Sie im linken Bereich nachTomcat Server suchen, klicken Sie auf das Pluszeichen im Menü, suchen Sie nachTomcat und wählen SieLocal aus. Geben Sie in das NamensfeldTomcat 7/8 ein (abhängig von Ihrer Version).

Klicken Sie auf die SchaltflächeConfigure… und navigieren Sie im FeldTomcat Home zum Ausgangsort Ihrer Installation und wählen Sie ihn aus.

Stellen Sie die SeiteStartup optional aufhttp://localhost:8080/ undHTTP port: 8080 ein und ändern Sie den Port entsprechend.

Gehen Sie zur RegisterkarteDeployment und klicken Sie auf das Symbol +, wählen Sie das Artefakt aus, das Sie dem Server hinzufügen möchten, und klicken Sie auf OK

Befolgen Sie die gleichen Anweisungen wie für lokale Tomcat-Konfigurationen, aber auf der Registerkarte Server müssen Sie den Remote-Speicherort der Installation eingeben.

Wenn sich die WAR-Datei auf dem Server befindet, auf dem die Tomcat-Instanz ausgeführt wird, können wir das erforderlicheContext Path-Feld ausfüllen, dem ein Schrägstrich „/“ vorangestellt ist.

Angenommen, wir möchten, dass auf unsere Webanwendung über den Browser mit der URLhttp://localhost:8080/myapp zugegriffen wird. Dann enthält unser Kontextpfadfeld/myapp.

Wir überspringen das FeldXML Configuration file URLund gehen zum FeldWAR or Directory URL. Hier geben wir die absolute URL der Web-Archiv-Datei ein, wie sie auf unserem Server angezeigt wird. Angenommen, der Speicherort unserer Datei istC:/apps/myapp.war, dann geben wir diesen Speicherort ein. Vergessen Sie nicht die WAR-Erweiterung.

Danach können wir auf die Schaltflächedeploy klicken. Die Seite wird neu geladen und die folgende Meldung sollte angezeigt werden:

oben auf der Seite.

Darüber hinaus sollte unsere Anwendung auch im AbschnittApplications der Seite angezeigt werden.

Klicken Sie einfach auf die Schaltflächechoose file, navigieren Sie zum Speicherort der WAR-Datei, wählen Sie sie aus und klicken Sie dann auf die Schaltflächedeploy.

In beiden Situationen teilt uns die Tomcat-Konsole mit, dass die Bereitstellung erfolgreich war, und zeigt eine Meldung wie die folgende an: