From ed8074663b15d418ee94b3df056fd13269cfeced Mon Sep 17 00:00:00 2001 From: Greg Poulos Date: Tue, 14 Feb 2023 12:29:58 -0800 Subject: [PATCH] remove section on remote debugging, as the information has already been incorporated into the operations and programming guides --- .../asciidoc/old_docs/debugging/chapter.adoc | 17 ---- .../debugging/enable-remote-debugging.adoc | 88 ------------------- .../src/main/asciidoc/old_docs/index.adoc | 1 - 3 files changed, 106 deletions(-) delete mode 100644 documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/chapter.adoc delete mode 100644 documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/enable-remote-debugging.adoc diff --git a/documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/chapter.adoc b/documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/chapter.adoc deleted file mode 100644 index 2852a53b7ad..00000000000 --- a/documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/chapter.adoc +++ /dev/null @@ -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[] diff --git a/documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/enable-remote-debugging.adoc b/documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/enable-remote-debugging.adoc deleted file mode 100644 index 71372aa5375..00000000000 --- a/documentation/jetty-documentation/src/main/asciidoc/old_docs/debugging/enable-remote-debugging.adoc +++ /dev/null @@ -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 - ----- diff --git a/documentation/jetty-documentation/src/main/asciidoc/old_docs/index.adoc b/documentation/jetty-documentation/src/main/asciidoc/old_docs/index.adoc index 1685529e623..4b285912225 100644 --- a/documentation/jetty-documentation/src/main/asciidoc/old_docs/index.adoc +++ b/documentation/jetty-documentation/src/main/asciidoc/old_docs/index.adoc @@ -33,7 +33,6 @@ include::architecture/chapter.adoc[] include::connectors/chapter.adoc[] include::contexts/chapter.adoc[] //include::contributing/chapter.adoc[] -include::debugging/chapter.adoc[] include::deploying/chapter.adoc[] include::embedding/chapter.adoc[] include::extras/chapter.adoc[]