Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions community/docs/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,6 @@
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-node-docker.adoc[create-node-docker]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-node-ssh.adoc[create-node-ssh]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-password-alias.adoc[create-password-alias]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-profiler.adoc[create-profiler]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-protocol-filter.adoc[create-protocol-filter]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-protocol-finder.adoc[create-protocol-finder]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/create-protocol.adoc[create-protocol]
Expand Down Expand Up @@ -210,7 +209,6 @@
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-node-docker.adoc[delete-node-docker]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-node-ssh.adoc[delete-node-ssh]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-password-alias.adoc[delete-password-alias]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-profiler.adoc[delete-profiler]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-protocol-filter.adoc[delete-protocol-filter]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-protocol-finder.adoc[delete-protocol-finder]
*** xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-protocol.adoc[delete-protocol]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -169,17 +169,4 @@ Apache NetBeans Profiler:: Comes bundled with Apache Netbeans, which has native

Async Profiler:: A powerful lightweight profiler that can run locally or remotely and trace CPU cycles, hardware and software performance and do Java Heap allocation analysis. This profiler is currently maintained as an https://github.com/async-profiler/async-profiler[open source project].
+
NOTE: If using IntelliJ IDEA Ultimate, Async profiler is bundled by default and requires no extra installation.

If you wish to configure to Payara Server to automatically run the profiler's agent when the server's JVM starts, you can do so by configuring the profiler as a Java agent by navigating to the Administration Console, heading to the server's instance configuration settings, selecting _JVM Settings_ option and navigate to the _Profiler_ tab. The following configuration attributes are available:

* _Profiler Name_: A name for the profiler's "profile" you wish to configure. Any name will suffice.
* _Status_: Whether the profiler's configuration is enabled or not.
* _Classpath_: Allows the user to customize the classpath of the profiler's agent.
* _Native Library Path_: Path to the native library binaries of the profiler's agent.
* _Options_: Additional options you can use to configure the profiler.
+
For example, the following options can be used to configure Async Profiler:
+
** `event=cpu`
** `file=profile.html`
NOTE: If using IntelliJ IDEA Ultimate, Async profiler is bundled by default and requires no extra installation.
Original file line number Diff line number Diff line change
Expand Up @@ -10,16 +10,13 @@ Create options for the Java application launcher.
----
asadmin [asadmin-options] create-jvm-option [--help]
[--target target]
[--profiler={true|false}]
(assignment=jvm-option)
----

[[description]]
== Description

The `create-jvm-options` subcommand creates a single command-line option that is passed to the Java application launcher when Payara Server is started. The options that this subcommand creates are in addition to the options that are preset with Payara Server. Java application launcher options are stored in the Java configuration `java—config` element or the profiler `profiler` element of the `domain.xml` file. The options are sent to the command line in the order they appear in the `java—config` element or the profiler `profiler` element in the `domain.xml` file.

Profiler options are used to record the settings that are required to start a particular profiler. The profiler must already exist. If necessary, use the xref:Technical Documentation/Payara Server Documentation/Command Reference/create-profiler.adoc#create-profiler[`create-profiler`] subcommand to create the profiler.
The `create-jvm-options` subcommand creates a single command-line option that is passed to the Java application launcher when Payara Server is started. The options that this subcommand creates are in addition to the options that are preset with Payara Server. Java application launcher options are stored in the Java configuration `java—config` element of the `domain.xml` file. The options are sent to the command line in the order they appear in the `java—config` element in the `domain.xml` file.

This subcommand can be used to create the following types of options:

Expand Down Expand Up @@ -75,8 +72,6 @@ cluster-name;;
Specifies a cluster.
configuration-name;;
Specifies a named configuration.
`--profiler`::
Indicates whether the Java application launcher options are for the profiler. The profiler must exist for this option to be true. Default is false.

[[operands]]
== Operands
Expand Down Expand Up @@ -122,17 +117,6 @@ Successfully added JVM option: -Xmx1024m
Command create-jvm-option executed successfully.
----

*Example 3 Setting a JVM Startup Parameter for the Profiler*

This example sets a JVM startup parameter for the profiler.

[source,shell]
----
asadmin> create-jvm-option --profiler=true -XX:MaxPermSize=192m
Successfully create JVM option: -XX:MaxPermSize=192m
Command create-jvm-option executed successfully.
----

[[exit-status]]
== Exit Status

Expand All @@ -145,7 +129,6 @@ error in executing the subcommand

* xref:Technical Documentation/Payara Server Documentation/Command Reference/asadmin.adoc#asadmin-1m[`asadmin`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/create-jvm-options.adoc#create-jvm-options[`create-jvm-options`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/create-profiler.adoc#create-profiler[`create-profiler`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-jvm-options.adoc#delete-jvm-options[`delete-jvm-options`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/list-jvm-options.adoc#list-jvm-options[`list-jvm-options`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/restart-domain.adoc#restart-domain[`restart-domain`]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,14 @@ Create options for the Java application launcher.
[source,shell]
----
asadmin [asadmin-options] create-jvm-options [--help]
[--target target] [--profiler={true|false}]
[--target target]
(jvm-option-name=jvm-option-value) [:jvm-option-name=jvm-option-value*]
----

[[description]]
== Description

The `create-jvm-options` subcommand creates command-line options that are passed to the Java application launcher when Payara Server is started. The options that this subcommand creates are in addition to the options that are preset with Payara Server. Java application launcher options are stored in the Java configuration `java—config` element or the profiler `profiler` element of the `domain.xml` file. The options are sent to the command line in the order they appear in the `java—config` element or the profiler `profiler` element in the `domain.xml` file.

Profiler options are used to record the settings that are required to start a particular profiler. The profiler must already exist. If necessary, use the xref:Technical Documentation/Payara Server Documentation/Command Reference/create-profiler.adoc#create-profiler[`create-profiler`] subcommand to create the profiler.
The `create-jvm-options` subcommand creates command-line options that are passed to the Java application launcher when Payara Server is started. The options that this subcommand creates are in addition to the options that are preset with Payara Server. Java application launcher options are stored in the Java configuration `java—config` element of the `domain.xml` file. The options are sent to the command line in the order they appear in the `java—config` element in the `domain.xml` file.

This subcommand can be used to create the following types of options:

Expand Down Expand Up @@ -74,8 +72,6 @@ asadmin-options::
Specifies a cluster.
configuration-name;;
Specifies a named configuration.
`--profiler`::
Indicates whether the Java application launcher options are for the profiler. The profiler must exist for this option to be true. Default is false.

[[operands]]
== Operands
Expand Down Expand Up @@ -140,17 +136,6 @@ Command create-jvm-options executed successfully.

In this case, one of the two parameters already exists, so the subcommand reports that only one option was set.

*Example 4 Setting a JVM Startup Parameter for the Profiler*

This example sets a JVM startup parameter for the profiler.

[source,shell]
----
asadmin> create-jvm-options --profiler=true -XX\:MaxPermSize=192m
created 1 option(s)
Command create-jvm-options executed successfully.
----

[[exit-status]]
== Exit Status

Expand All @@ -163,7 +148,6 @@ Command create-jvm-options executed successfully.

* xref:Technical Documentation/Payara Server Documentation/Command Reference/asadmin.adoc#asadmin-1m[`asadmin`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/create-jvm-option.adoc#create-jvm-option[`create-jvm-option`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/create-profiler.adoc#create-profiler[`create-profiler`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/delete-jvm-options.adoc#delete-jvm-options[`delete-jvm-options`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/list-jvm-options.adoc#list-jvm-options[`list-jvm-options`],
* xref:Technical Documentation/Payara Server Documentation/Command Reference/restart-domain.adoc#restart-domain[`restart-domain`]
Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,14 @@ Removes one or more options for the Java application launcher.
[source,shell]
----
asadmin [asadmin-options] delete-jvm-options [--help]
[--target target] [--profiler={true|false}]
[--target target]
(jvm-option-name[=jvm-option-value]) [:jvm-option-name[=jvm-option-name]]*
----

[[description]]
== Description

The `delete-jvm-options` subcommand removes one or more command-line options for the Java application launcher. These options are removed from the Java configuration `java—config` element or the profiler `profiler` element of the `domain.xml` file. To see the Java application launcher options that can be deleted, use the xref:Technical Documentation/Payara Server Documentation/Command Reference/list-jvm-options.adoc#list-jvm-options[`list-jvm-options`] subcommand.
The `delete-jvm-options` subcommand removes one or more command-line options for the Java application launcher. These options are removed from the Java configuration `java—config` element of the `domain.xml` file. To see the Java application launcher options that can be deleted, use the xref:Technical Documentation/Payara Server Documentation/Command Reference/list-jvm-options.adoc#list-jvm-options[`list-jvm-options`] subcommand.

The deletion of some options requires a server restart for changes to become effective. Other options are set immediately in the environment of the domain administration server (DAS) and do not require a restart.

Expand Down Expand Up @@ -57,8 +57,6 @@ asadmin-options::
Specifies a cluster.
configuration-name;;
Specifies a named configuration.
`--profiler`::
Indicates whether the Java application launcher options are for the profiler. The option must have been set for a profiler for this option to be true.

[[operands]]
== Operands
Expand All @@ -84,15 +82,6 @@ asadmin> delete-jvm-options -Doption1=value1
Command delete-jvm-options executed successfully
----

*Example 2 Deleting a Java Application Launcher Option From the Profiler*

This example removes a Java application launcher startup parameter for the profiler.

[source,shell]
----
asadmin> delete-jvm-options --profiler=true -XX:MaxPermSize=192m
Command delete-jvm-options executed successfully.
----

[[exit-status]]
== Exit Status
Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ create-lifecycle-module list-file-users
create-message-security-provider list-http-listeners
create-network-listener list-iiop-listeners
create-password-alias list-javamail-resources
create-profiler list-jdbc-connection-pools
list-jdbc-connection-pools
create-protocol list-jdbc-resources
create-resource-adapter-config list-jms-hosts
create-resource-ref list-jms-resources
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,7 @@ Lists options for the Java application launcher.
[source,shell]
----
asadmin [asadmin-options] list-jvm-options [--help]
[--target target]
[--profiler={false|true}]
[--target target]
----

[[description]]
Expand Down Expand Up @@ -41,9 +40,6 @@ asadmin-options::
Specifies a cluster.
configuration-name;;
Specifies a named configuration.
`--profiler`::
Specifies whether the Java application launcher options to list are for the profiler. Set this option to true only if a profiler has been
configured. If this option is set to true and no profiler is configured, an error occurs. The default is false.

[[examples]]
== Examples
Expand Down
Loading