Skip to content

Commit 48bd451

Browse files
alitokmenalitokmen
committed
CARGO-1663: Explicit Jetty 12.x deployer support details
1 parent 8296e69 commit 48bd451

2 files changed

Lines changed: 59 additions & 23 deletions

File tree

‎cargo/Downloads.html‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -792,8 +792,7 @@ <h3 id="Downloads-Lateststablerelease:version1.10.29">Latest stable release: ver
792792
</tr>
793793
<tr>
794794
<td class="confluenceTd">
795-
<p>Anchor link</p>
796-
<p>​
795+
<p><span class="confluence-anchor-link conf-macro output-inline" id="Downloads-licensedDTDs"><span class="confluence-anchor-link" id="licensedDTDs"> </span></span>
797796
<br></p>
798797
</td>
799798
<td class="confluenceTd">

‎cargo/Jetty+Remote+Deployer.html‎

Lines changed: 58 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -592,25 +592,47 @@ <h3 id="JettyRemoteDeployer-Overview">Overview</h3>
592592
<h3 id="JettyRemoteDeployer-Downloadingtheremotedeployer">Downloading the remote deployer</h3>
593593
<p>Two versions of the Jetty remote deployer WAR are available on the <a href="Downloads.html">Cargo downloads</a> page (scroll down to the <strong>Tools</strong> section):</p>
594594
<ul>
595-
<li><code>cargo-jetty-11-onwards-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the CARGO remote deployer. Designed to work with Jetty 11.x onwards (Jetty from Eclipse.org, implementing Jakarta EE)</li>
596-
<li><code>cargo-jetty-10-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the CARGO remote deployer. Designed to work with Jetty 10.x (Jetty from Eclipse.org)</li>
597-
<li><code>cargo-jetty-7-to-jetty-9-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the CARGO remote deployer. Designed to work with Jetty 7.x to Jetty 9.x (Jetty from Eclipse.org)</li>
598-
<li><code>cargo-jetty-6-and-earlier-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the CARGO remote deployer. Designed to work with Jetty 6.x and earlier (Jetty from Mortbay.org)</li>
595+
<li>
596+
<p><code>cargo-jetty-12-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the Codehaus Cargo remote deployer. Designed to work with Jetty 12.1.x (Jetty from Eclipse.org, implementing Java EE and various Jakarta EE versions at the same time), it is sadly <u>not compatible with Jetty 12.0.x</u>.</p>
597+
</li>
598+
<li>
599+
<p><code>cargo-jetty-11-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the Codehaus Cargo remote deployer. Designed to work with Jetty 11.x (Jetty from Eclipse.org, implementing Jakarta EE)</p>
600+
</li>
601+
<li>
602+
<p><code>cargo-jetty-10-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the Codehaus Cargo remote deployer. Designed to work with Jetty 10.x (Jetty from Eclipse.org)</p>
603+
</li>
604+
<li>
605+
<p><code>cargo-jetty-7-to-jetty-9-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the Codehaus Cargo remote deployer. Designed to work with Jetty 7.x to Jetty 9.x (Jetty from Eclipse.org)</p>
606+
</li>
607+
<li>
608+
<p><code>cargo-jetty-6-and-earlier-deployer</code>: The Deployer Web application for the Jetty remote containers, which must have been deployed to Jetty before using the Codehaus Cargo remote deployer. Designed to work with Jetty 6.x and earlier (Jetty from Mortbay.org)</p>
609+
</li>
599610
</ul>
600611
<p>Please make sure to download and install the correct flavour for your Jetty version.</p>
601612
<h3 id="JettyRemoteDeployer-Security">Security</h3>
602613
<p>By default, the Cargo Jetty remote deployer comes with no security.</p>
603614
<p>In order to activate security, follow these steps:</p>
604615
<ol>
605-
<li>Open the <code>WEB-INF/web.xml</code> file of the Cargo Jetty remote deployer WAR</li>
606-
<li>Uncomment the part that says <code>Uncomment in order to activate security</code>. By default, that configuration is as follows:
616+
<li>
617+
<p>Open the <code>WEB-INF/web.xml</code> file of the Cargo Jetty remote deployer WAR</p>
618+
</li>
619+
<li>
620+
<p>Uncomment the part that says <code>Uncomment in order to activate security</code>. By default, that configuration is as follows:</p>
607621
<ul>
608-
<li>Authentication is done using standard HTTP headers: <code>login-config</code> set to <code>BASIC</code>.</li>
609-
<li>Authorization is done using Jetty role: <code>security-constraint</code> has a <code>auth-constraint</code> with <code>role-name</code>.</li>
610-
</ul></li>
611-
<li>Create a user with the Jetty role <code>manager</code>:
622+
<li>
623+
<p>Authentication is done using standard HTTP headers: <code>login-config</code> set to <code>BASIC</code>.</p>
624+
</li>
625+
<li>
626+
<p>Authorization is done using Jetty role: <code>security-constraint</code> has a <code>auth-constraint</code> with <code>role-name</code>.</p>
627+
</li>
628+
</ul>
629+
</li>
630+
<li>
631+
<p>Create a user with the Jetty role <code>manager</code>:</p>
612632
<ol>
613-
<li>Open the Jetty <code>realm.properties</code> file</li>
633+
<li>
634+
<p>Open the Jetty <code>realm.properties</code> file</p>
635+
</li>
614636
<li>
615637
<p>Add, for example, the following definition</p>
616638
<div class="code panel pdl conf-macro output-block" style="border-width: 1px;">
@@ -620,16 +642,23 @@ <h3 id="JettyRemoteDeployer-Security">Security</h3>
620642
</div>
621643
</div>
622644
</li>
623-
</ol></li>
645+
</ol>
646+
</li>
624647
<li>
625648
<p>Define a security realm, which can be per-webapp (i.e., by adding a <code>jetty-web.xml</code> file to the WAR) or global (i.e., for all applications deployed on that Jetty server). You can learn more about both methods on the Jetty documentation: <a href="http://www.eclipse.org/jetty/documentation/current/configuring-security-authentication.html#d0e5513">http://www.eclipse.org/jetty/documentation/current/configuring-security-authentication.html#d0e5513</a></p>
626649
</li>
627650
</ol>
628-
<p>To try the security settings, you can try to visit the <code>/cargo-jetty-deployer</code> context on your server, for example <a href="http://production27:8080/cargo-jetty-deployer">http://production27:8080/cargo-jetty-deployer</a>, using any Web browser. If security is configured well, it should:</p>
651+
<p>To try the security settings, you can try to visit the <code>/cargo-jetty-deployer</code> context (on Jetty 12.x, the <code>/cargo-jetty-deployer-eeXX</code> context where XX is the Jetty EE version and multiple EE versions being active at the same time is supported) on your server, for example <a href="http://production27:8080/cargo-jetty-deployer">http://production27:8080/cargo-jetty-deployer</a>, using any Web browser. If security is configured well, it should:</p>
629652
<ul>
630-
<li>Ask for a login and password</li>
631-
<li>Ask again if the login is not valid</li>
632-
<li>If the login is valid, show a page saying: <code>Command / is unknown</code></li>
653+
<li>
654+
<p>Ask for a login and password</p>
655+
</li>
656+
<li>
657+
<p>Ask again if the login is not valid</p>
658+
</li>
659+
<li>
660+
<p>If the login is valid, show a page saying: <code>Command / is unknown</code></p>
661+
</li>
633662
</ul>
634663
<div class="confluence-information-macro confluence-information-macro-tip conf-macro output-block">
635664
<span class="aui-icon aui-icon-small aui-iconfont-approve confluence-information-macro-icon"> </span>
@@ -640,10 +669,18 @@ <h3 id="JettyRemoteDeployer-Security">Security</h3>
640669
<h3 id="JettyRemoteDeployer-Examples">Examples</h3>
641670
<p>Here is an example <a href="Maven+3+Plugin+Reference+Guide.html">Maven 3 plugin configuration</a> that:</p>
642671
<ul>
643-
<li>Deploys on a remote Jetty 6.x server</li>
644-
<li>The server is on <code>production17</code>, port <code>8080</code></li>
645-
<li>The Jetty remote deployer WAR is secured using the Jetty role <code>manager</code></li>
646-
<li>A user called <code>someusername</code> with password <code>somepassword</code> is defined as <code>manager</code></li>
672+
<li>
673+
<p>Deploys on a remote Jetty 6.x server</p>
674+
</li>
675+
<li>
676+
<p>The server is on <code>production17</code>, port <code>8080</code></p>
677+
</li>
678+
<li>
679+
<p>The Jetty remote deployer WAR is secured using the Jetty role <code>manager</code></p>
680+
</li>
681+
<li>
682+
<p>A user called <code>someusername</code> with password <code>somepassword</code> is defined as <code>manager</code></p>
683+
</li>
647684
</ul>
648685
<div class="code panel pdl conf-macro output-block" style="border-width: 1px;">
649686
<div class="codeContent panelContent pdl">
@@ -709,9 +746,9 @@ <h3 id="JettyRemoteDeployer-Examples">Examples</h3>
709746
</div>
710747
<h3 id="JettyRemoteDeployer-Knownissues">Known issues</h3>
711748
<div class="confluence-information-macro confluence-information-macro-note conf-macro output-block">
712-
<p class="title">Unexpected end of file from server and maxIdleTime parameter</p>
713749
<span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"> </span>
714750
<div class="confluence-information-macro-body">
751+
<p><strong>Unexpected end of file from server and maxIdleTime parameter</strong></p>
715752
<p>By default, Jetty sets the <code>maxIdleTime</code> parameter in the <code>etc/jetty.xml</code> file 30 seconds. This means that if the actual deployment takes more than 30 seconds, you might get error messages like:</p>
716753
<div class="code panel pdl conf-macro output-block" style="border-width: 1px;">
717754
<div class="codeContent panelContent pdl">

0 commit comments

Comments
 (0)