remove section on remote debugging, as the information has already been incorporated into the operations and programming guides

This commit is contained in:
Greg Poulos 2023-02-14 12:29:58 -08:00
parent fbcee7ea2d
commit ed8074663b
3 changed files with 0 additions and 106 deletions

View File

@ -1,17 +0,0 @@
//
// ========================================================================
// Copyright (c) 1995-2022 Mort Bay Consulting Pty Ltd and others.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
// which is available at https://www.apache.org/licenses/LICENSE-2.0.
//
// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
// ========================================================================
//
[[advanced-debugging]]
== Debugging
include::enable-remote-debugging.adoc[]

View File

@ -1,88 +0,0 @@
//
// ========================================================================
// Copyright (c) 1995-2022 Mort Bay Consulting Pty Ltd and others.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
// which is available at https://www.apache.org/licenses/LICENSE-2.0.
//
// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
// ========================================================================
//
[[enable-remote-debugging]]
=== Enable remote debugging
[[remote-debugging]]
==== Remote Debugging
If you have a web application deployed into Jetty you can interact with it remotely from a debugging perspective easily.
The basics are that you must start up the remote JVM with additional parameters and then start up a remote debugging session in Eclipse for the webapp in question.
This is easily accomplished.
____
[NOTE]
This example assumes you are deploying your web application into a jetty-base.
____
===== Starting Jetty
Assuming you have your webapp deployed into jetty, there are two different ways to approach this:
Via command line::
Add the required parameters on the commandline like so.
+
[source, screen, subs="{sub-order}"]
....
$ java -Xdebug -agentlib:jdwp=transport=dt_socket,address=9999,server=y,suspend=n -jar start.jar
....
Via `start.ini`::
This approach is best used if you want to debug a particular jetty-base and not have to remember the commandline incantations.
+
1. Edit the `start.ini` and uncomment the --exec line, this is required if you are adding jvm options to the start.ini file as jetty-start must generate the classpath required and fork a new jvm.
2. Add the parameters mentioned above in the Command Line option so your start.ini looks like this:
+
[source, plain, subs="{sub-order}"]
----
#===========================================================
# Configure JVM arguments.
# If JVM args are include in an ini file then --exec is needed
# to start a new JVM from start.jar with the extra args.
# If you wish to avoid an extra JVM running, place JVM args
# on the normal command line and do not use --exec
#-----------------------------------------------------------
--exec
-Xdebug
-agentlib:jdwp=transport=dt_socket,address=9999,server=y,suspend=n
# -Xmx2000m
# -Xmn512m
# -XX:+UseConcMarkSweepGC
# -XX:ParallelCMSThreads=2
# -XX:+CMSClassUnloadingEnabled
# -XX:+UseCMSCompactAtFullCollection
# -XX:CMSInitiatingOccupancyFraction=80
# -verbose:gc
# -XX:+PrintGCDateStamps
# -XX:+PrintGCTimeStamps
# -XX:+PrintGCDetails
# -XX:+PrintTenuringDistribution
# -XX:+PrintCommandLineFlags
# -XX:+DisableExplicitGC
----
+
Uncomment any other jvm environmental options you so desire for your debugging session.
3. Regardless of the option chosen, you should see the following lines at the top of your jetty startup.
+
[source, plain, subs="{sub-order}"]
----
Listening for transport dt_socket at address: 9999
----

View File

@ -33,7 +33,6 @@ include::architecture/chapter.adoc[]
include::connectors/chapter.adoc[] include::connectors/chapter.adoc[]
include::contexts/chapter.adoc[] include::contexts/chapter.adoc[]
//include::contributing/chapter.adoc[] //include::contributing/chapter.adoc[]
include::debugging/chapter.adoc[]
include::deploying/chapter.adoc[] include::deploying/chapter.adoc[]
include::embedding/chapter.adoc[] include::embedding/chapter.adoc[]
include::extras/chapter.adoc[] include::extras/chapter.adoc[]