You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@geode.apache.org by db...@apache.org on 2020/07/23 16:24:10 UTC
[geode] branch support/1.12 updated (c7b82a5 -> 3fbd2f1)
This is an automated email from the ASF dual-hosted git repository.
dbarnes pushed a change to branch support/1.12
in repository https://gitbox.apache.org/repos/asf/geode.git.
from c7b82a5 GEODE-8347: use same benchmarks branch as geode branch, since that's the way we release (#5361)
new 5b01834 GEODE-8377: User Guide: GFSH GC command should be documented ... (#5396)
new 18bda23 GEODE-8363: Label Micrometer docs as experimental (#5386)
new 4e5c4ce GEODE-7628: Block jmx mbean creation when no security manager is configured (docs) (#5387)
new 3fbd2f1 GEODE-2113: User Guide - p2p.HANDSHAKE_POOL_SIZE is obsolete, remove from docs (#5383)
The 4 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../source/subnavs/geode-subnav.erb | 3 --
.../running/starting_up_shutting_down.html.md.erb | 2 +-
.../management/jmx_manager_node.html.md.erb | 2 ++
.../system_member_performance.html.md.erb | 4 ---
...formance_connection_thread_settings.html.md.erb | 32 ----------------------
.../gfsh/command-pages/gc.html.md.erb | 4 +++
.../gfsh/quick_ref_commands_by_area.html.md.erb | 2 +-
.../micrometer-configuration.html.md.erb | 2 --
.../micrometer/micrometer-overview.html.md.erb | 3 ++
9 files changed, 11 insertions(+), 43 deletions(-)
delete mode 100644 geode-docs/managing/monitor_tune/system_member_performance_connection_thread_settings.html.md.erb
[geode] 02/04: GEODE-8363: Label Micrometer docs as experimental
(#5386)
Posted by db...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
dbarnes pushed a commit to branch support/1.12
in repository https://gitbox.apache.org/repos/asf/geode.git
commit 18bda236a76548a72cb2d959d4ebbdb48cd6f1ff
Author: Karen Miller <ka...@users.noreply.github.com>
AuthorDate: Mon Jul 20 13:20:01 2020 -0700
GEODE-8363: Label Micrometer docs as experimental (#5386)
Co-authored-by: Karen Miller <km...@pivotal.io>
---
.../tools_modules/micrometer/micrometer-configuration.html.md.erb | 2 --
geode-docs/tools_modules/micrometer/micrometer-overview.html.md.erb | 3 +++
2 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/geode-docs/tools_modules/micrometer/micrometer-configuration.html.md.erb b/geode-docs/tools_modules/micrometer/micrometer-configuration.html.md.erb
index 0aaf90c..c80c4d7 100644
--- a/geode-docs/tools_modules/micrometer/micrometer-configuration.html.md.erb
+++ b/geode-docs/tools_modules/micrometer/micrometer-configuration.html.md.erb
@@ -105,8 +105,6 @@ Add a line inside the file indicating the fully qualified class name of your imp
```pre
my.domain.SimpleMetricsPublishingService
```
-Note: The above APIs are considered experimental. Micrometer metrics is a new addition to <%=vars.product_name%> and the API may change.
-
### Add Your jar File to the classpath When You Start a Server or Locator
To add your metrics publishing service to a server or locator, add your jar file to the classpath when you start the server or locator via `GFSH` and specify the `prometheus.metrics.port` listed in SimpleMetricsPublishingService:
diff --git a/geode-docs/tools_modules/micrometer/micrometer-overview.html.md.erb b/geode-docs/tools_modules/micrometer/micrometer-overview.html.md.erb
index c5a95e6..676e9bc 100644
--- a/geode-docs/tools_modules/micrometer/micrometer-overview.html.md.erb
+++ b/geode-docs/tools_modules/micrometer/micrometer-overview.html.md.erb
@@ -21,6 +21,9 @@ limitations under the License.
By default, Micrometer is enabeled and can emit metrics to any meter registry. However, time-based meters are available only when the `time-statistics` property is turned on.
+The API is currently marked experimental.
+The `MetricsSession` and `MetricsPublishingService` interfaces may change.
+
- **[Micrometer configuration and publishing](micrometer-configuration.html)**
Using Micrometer may require configuration, and in order to emit Micrometer metrics to one of the supported APM tools, or to a custom format/tool, a Meter Registry and accompanying publishing service will need to be used.
[geode] 01/04: GEODE-8377: User Guide: GFSH GC command should be
documented ... (#5396)
Posted by db...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
dbarnes pushed a commit to branch support/1.12
in repository https://gitbox.apache.org/repos/asf/geode.git
commit 5b018349c2b82f28854266e68e5f37e5101d9bc2
Author: Dave Barnes <da...@vmware.com>
AuthorDate: Wed Jul 22 14:50:38 2020 -0700
GEODE-8377: User Guide: GFSH GC command should be documented ... (#5396)
* GEODE-8377: User Guide: GFSH GC command should be documented to use only in non-production environments
---
geode-docs/tools_modules/gfsh/command-pages/gc.html.md.erb | 4 ++++
geode-docs/tools_modules/gfsh/quick_ref_commands_by_area.html.md.erb | 2 +-
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/geode-docs/tools_modules/gfsh/command-pages/gc.html.md.erb b/geode-docs/tools_modules/gfsh/command-pages/gc.html.md.erb
index cce12d7..f9ee808 100644
--- a/geode-docs/tools_modules/gfsh/command-pages/gc.html.md.erb
+++ b/geode-docs/tools_modules/gfsh/command-pages/gc.html.md.erb
@@ -23,6 +23,10 @@ Force GC (Garbage Collection) on a member or members.
The default is for garbage collection to occur on all caching members.
+The **gfsh gc** command should be used only in non-production environments.
+This is a forced GC event and not always handled well by the garbage collector outside of normal GC processing.
+This can cause slow-responding members to be perceived as unresponsive and disconnected from the cluster.
+
**Availability:** Online. You must be connected in `gfsh` to a JMX Manager member to use this command.
**Syntax:**
diff --git a/geode-docs/tools_modules/gfsh/quick_ref_commands_by_area.html.md.erb b/geode-docs/tools_modules/gfsh/quick_ref_commands_by_area.html.md.erb
index da088a8..ba4e694 100644
--- a/geode-docs/tools_modules/gfsh/quick_ref_commands_by_area.html.md.erb
+++ b/geode-docs/tools_modules/gfsh/quick_ref_commands_by_area.html.md.erb
@@ -209,7 +209,7 @@ limitations under the License.
| [describe member](command-pages/describe.html#topic_D62F3D42B1D84CF68F03D54D5122806A) | Display details of a member with given name/id. | online |
| [export logs](command-pages/export.html#topic_B80978CC659244AE91E2B8CE56EBDFE3) | Export/dump logs to a given directory. | online |
| [export stack-traces](command-pages/export.html#topic_195D27B8B2B64A4E84CF2256636D54BD) | Export the stack trace for a member or members. | online |
-| [gc](command-pages/gc.html) | Force garbage collection on a member or members. | online |
+| [gc](command-pages/gc.html) | Force garbage collection on a member or members. (Development only, not advised for production systems.) | online |
| [list clients](command-pages/list.html#topic_ts1_qb1_dk) | Displays a list of connected clients. | online |
| [list members](command-pages/list.html#topic_5B5BFB2E5F314210858641BE3A689637) | Display all or a subset of members. | online |
| [netstat](command-pages/netstat.html) | Report network information and statistics via the "netstat" operating system command. | online |
[geode] 03/04: GEODE-7628: Block jmx mbean creation when no
security manager is configured (docs) (#5387)
Posted by db...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
dbarnes pushed a commit to branch support/1.12
in repository https://gitbox.apache.org/repos/asf/geode.git
commit 4e5c4cecb218b25d9330949430b1a3e4873e7496
Author: Dave Barnes <db...@apache.org>
AuthorDate: Mon Jul 20 14:50:33 2020 -0700
GEODE-7628: Block jmx mbean creation when no security manager is configured (docs) (#5387)
---
geode-docs/configuring/running/starting_up_shutting_down.html.md.erb | 2 +-
geode-docs/managing/management/jmx_manager_node.html.md.erb | 2 ++
2 files changed, 3 insertions(+), 1 deletion(-)
diff --git a/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb b/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
index c3eb0eb..4fe1899 100644
--- a/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
+++ b/geode-docs/configuring/running/starting_up_shutting_down.html.md.erb
@@ -60,7 +60,7 @@ gfsh>revoke missing-disk-store --id=60399215-532b-406f-b81f-9b5bd8d1b55a
```
**Note:**
-This `gfsh` commands require that you are connected to the cluster via a JMX Manager node.
+This `gfsh` command requires that you be connected to the cluster via a JMX Manager node.
## <a id="starting_up_shutting_down__section_mnx_4cp_cv" class="no-quick-link"></a>Shutting Down the System
diff --git a/geode-docs/managing/management/jmx_manager_node.html.md.erb b/geode-docs/managing/management/jmx_manager_node.html.md.erb
index 51e45a2..9054e3e 100644
--- a/geode-docs/managing/management/jmx_manager_node.html.md.erb
+++ b/geode-docs/managing/management/jmx_manager_node.html.md.erb
@@ -25,6 +25,8 @@ Any member can host an embedded JMX Manager, which provides a federated view of
You need to have a JMX Manager started in your cluster in order to use <%=vars.product_name%> management and monitoring tools such as [gfsh](../../tools_modules/gfsh/chapter_overview.html) and [<%=vars.product_name%> Pulse](../../tools_modules/pulse/pulse-overview.html).
+To create MBeans, a Security Manager must be enabled. See [Enable Security with Property Definitions](../security/enable_security.html) for more information.
+
**Note:**
Each node that acts as the JMX Manager has additional memory requirements depending on the number of resources that it is managing and monitoring. Being a JMX Manager can increase the memory footprint of any process, including locator processes. See [Memory Requirements for Cached Data](../../reference/topics/memory_requirements_for_cache_data.html#calculating_memory_requirements) for more information on calculating memory overhead on your <%=vars.product_name%> processes.
[geode] 04/04: GEODE-2113: User Guide - p2p.HANDSHAKE_POOL_SIZE is
obsolete, remove from docs (#5383)
Posted by db...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
dbarnes pushed a commit to branch support/1.12
in repository https://gitbox.apache.org/repos/asf/geode.git
commit 3fbd2f1f88ef20d59b99c0dc14df98fac489c023
Author: Dave Barnes <db...@apache.org>
AuthorDate: Fri Jul 17 13:56:32 2020 -0700
GEODE-2113: User Guide - p2p.HANDSHAKE_POOL_SIZE is obsolete, remove from docs (#5383)
---
.../source/subnavs/geode-subnav.erb | 3 --
.../system_member_performance.html.md.erb | 4 ---
...formance_connection_thread_settings.html.md.erb | 32 ----------------------
3 files changed, 39 deletions(-)
diff --git a/geode-book/master_middleman/source/subnavs/geode-subnav.erb b/geode-book/master_middleman/source/subnavs/geode-subnav.erb
index 22f4084..b962728 100644
--- a/geode-book/master_middleman/source/subnavs/geode-subnav.erb
+++ b/geode-book/master_middleman/source/subnavs/geode-subnav.erb
@@ -683,9 +683,6 @@ limitations under the License.
<li>
<a href="/docs/guide/<%=vars.product_version_nodot%>/managing/monitor_tune/system_member_performance_garbage.html">Garbage Collection and System Performance</a>
</li>
- <li>
- <a href="/docs/guide/<%=vars.product_version_nodot%>/managing/monitor_tune/system_member_performance_connection_thread_settings.html">Connection Thread Settings and Performance</a>
- </li>
</ul>
</li>
<li class="has_submenu">
diff --git a/geode-docs/managing/monitor_tune/system_member_performance.html.md.erb b/geode-docs/managing/monitor_tune/system_member_performance.html.md.erb
index a3365ca..5d7ff3c 100644
--- a/geode-docs/managing/monitor_tune/system_member_performance.html.md.erb
+++ b/geode-docs/managing/monitor_tune/system_member_performance.html.md.erb
@@ -35,8 +35,4 @@ Before doing so, you should understand [Basic Configuration and Programming](../
If your application exhibits unacceptably high latencies, you might improve performance by modifying your JVM’s garbage collection behavior.
-- **[Connection Thread Settings and Performance](system_member_performance_connection_thread_settings.html)**
-
- When many peer processes are started concurrently, you can improve the cluster connect time can by setting the p2p.HANDSHAKE\_POOL\_SIZE system property value to the expected number of members.
-
diff --git a/geode-docs/managing/monitor_tune/system_member_performance_connection_thread_settings.html.md.erb b/geode-docs/managing/monitor_tune/system_member_performance_connection_thread_settings.html.md.erb
deleted file mode 100644
index b6aaea7..0000000
--- a/geode-docs/managing/monitor_tune/system_member_performance_connection_thread_settings.html.md.erb
+++ /dev/null
@@ -1,32 +0,0 @@
----
-title: Connection Thread Settings and Performance
----
-
-<!--
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements. See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-
-When many peer processes are started concurrently, you can improve the cluster connect time by setting the p2p.HANDSHAKE\_POOL\_SIZE system property value to the expected number of members.
-
-This property controls the number of threads that can be used to establish new TCP/IP connections between peer caches. The threads are discarded if they are idle for 60 seconds.
-
-The default value for p2p.HANDSHAKE\_POOL\_SIZE is 10. This command-line specification sets the number of threads to 100:
-
-``` pre
--Dp2p.HANDSHAKE_POOL_SIZE=100
-```
-
-