Skip to content

Commit 40b02b8

Browse files
rosemarymaranorjeberhard
authored andcommitted
add note to advise against using console for starting and stopping servers (#1271)
1 parent 3e64ca1 commit 40b02b8

File tree

2 files changed

+11
-5
lines changed

2 files changed

+11
-5
lines changed

docs-source/content/quickstart/create-domain.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,3 +99,6 @@ Depending on where your Kubernetes cluster is running, you may need to open fire
9999
a. Edit the `my-inputs.yaml` file (assuming that you named your copy `my-inputs.yaml`) to set `exposedAdminNodePort: true`.
100100
101101
b. Open a browser to `http://localhost:30701`.
102+
103+
{{% notice note %}} Do not use the WebLogic Server Administration Console to start or stop servers. See [Starting and Stopping Servers]({{< relref "/userguide/managing-domains/domain-lifecycle/startup.md#starting_and_stopping_servers" >}}).
104+
{{% /notice %}}

docs-source/content/userguide/managing-domains/domain-lifecycle/startup.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ will be graceful, the timeout, and if in-flight sessions are given the opportuni
2727
The `serverStartPolicy` property on the domain resource controls which servers should be running.
2828
The operator runtime monitors this property and creates or deletes the corresponding server pods.
2929

30+
{{% notice note %}} Do not use the WebLogic Server Administration Console to start or stop servers.
31+
{{% /notice %}}
32+
3033
#### `serverStartPolicy` rules
3134

3235
You can specify the `serverStartPolicy` property at the domain, cluster, and server levels. Each level supports a different set of values.
@@ -165,12 +168,12 @@ The server will count toward the cluster's `replicas` count. Also, if you confi
165168

166169
### Shutdown options
167170

168-
The domain resource includes the element `serverPod` that is available under `spec`, `adminServer` and each entry of
171+
The domain resource includes the element `serverPod` that is available under `spec`, `adminServer` and each entry of
169172
`clusters` and `managedServers`. The `serverPod` element controls many details of how pods are created for server instances.
170173

171174
The `shutdown` element of `serverPod` controls how servers will be shutdown. This element has three properties:
172-
`shutdownType`, `timeoutSeconds`, and `ignoreSessions`. The `shutdownType` property can be set to either `Graceful`, the default,
173-
or `Forced` specifying the type of shutdown. The `timeoutSeconds` property configures how long the server is given to
175+
`shutdownType`, `timeoutSeconds`, and `ignoreSessions`. The `shutdownType` property can be set to either `Graceful`, the default,
176+
or `Forced` specifying the type of shutdown. The `timeoutSeconds` property configures how long the server is given to
174177
complete shutdown before the server is killed. The `ignoreSessions` property, which is only applicable for graceful shutdown, when `false`,
175178
the default, allows the shutdown process to take longer to give time for any active sessions to complete up to the configured timeout.
176179
The operator runtime monitors this property but will not restart any server pods solely to adjust the shutdown options.
@@ -220,7 +223,7 @@ For instance, given the following domain resource:
220223
...
221224
```
222225

223-
Graceful shutdown is used for all servers in the domain because this is specified at the domain level and is not overridden at
226+
Graceful shutdown is used for all servers in the domain because this is specified at the domain level and is not overridden at
224227
any cluster or server level. The "cluster1" cluster defaults to ignoring sessions; however, the "cluster1_server1" server
225228
instance will not ignore sessions and will have a longer timeout.
226229

@@ -261,7 +264,7 @@ such a label or annotation by modifying the `restartVersion`.
261264
{{% /notice %}}
262265

263266
{{% notice note %}}
264-
Prior to version 2.2, the operator incorrectly restarted servers when the `serverStartState` property was changed. Now,
267+
Prior to version 2.2, the operator incorrectly restarted servers when the `serverStartState` property was changed. Now,
265268
this property has no affect on already running servers.
266269
{{% /notice %}}
267270

0 commit comments

Comments
 (0)