Skip to content

Commit cf994f8

Browse files
style edits (#1461)
* style edits * Incorporate review comments
1 parent 7b3597c commit cf994f8

File tree

8 files changed

+64
-65
lines changed

8 files changed

+64
-65
lines changed

docs-source/content/faq/boot-identity-not-valid.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Boot Identity Not Valid"
2+
title: "Boot identity not valid"
33
date: 2020-03-02T08:08:19-04:01
44
draft: false
55
weight: 20
@@ -13,6 +13,6 @@ When you see these kinds of errors, it means that the user name and password pro
1313
have also indicated that the WebLogic domain directory's security configuration files have changed in an incompatible way between when the operator scanned
1414
the domain directory, which occurs during the "introspection" phase, and when the server instance attempted to start. There is now a separate validation for that condition described in the [domain secret mismatch FAQ entry](../domain-secret-mismatch/).
1515

16-
Check that the user name and password credentials stored in the Kubernetes secret referenced by `weblogicCredentialsSecret` contain the expected values for an account with administrative privilege for the WebLogic domain.
16+
Check that the user name and password credentials stored in the Kubernetes secret referenced by `weblogicCredentialsSecret` contain the expected values for an account with administrative privilege for the WebLogic domain.
1717
Then [stop all WebLogic server instances](https://oracle.github.io/weblogic-kubernetes-operator/userguide/managing-domains/domain-lifecycle/startup/#starting-and-stopping-servers)
1818
in the domain before restarting so that the operator will repeat its introspection and generate the corrected "boot.properites" files.

docs-source/content/faq/cannot-pull-image.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Cannot Pull Image"
2+
title: "Cannot pull image"
33
date: 2019-03-23T08:08:19-04:00
44
draft: false
55
weight: 10

docs-source/content/faq/domain-secret-mismatch.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: "Domain Secret Mismatch"
2+
title: "Domain secret mismatch"
33
date: 2020-03-02T08:08:19-04:00
44
draft: false
55
weight: 21
66
---
77

88
> One or more WebLogic Server instances in my domain will not start and the domain resource `status` or the pod log report errors like this:
99
>
10-
> ***Domain secret mismatch. The domain secret in 'DOMAIN_HOME/security/SerializedSystemIni.dat' where DOMAIN_HOME='$DOMAIN_HOME' does not match the domain secret found by the introspector job. WebLogic requires that all WebLogic servers in the same domain share the same domain secret.***
10+
> ***Domain secret mismatch. The domain secret in 'DOMAIN_HOME/security/SerializedSystemIni.dat' where DOMAIN_HOME='$DOMAIN_HOME' does not match the domain secret found by the introspector job. WebLogic requires that all WebLogic Servers in the same domain share the same domain secret.***
1111
1212
When you see these kinds of errors, it means that the WebLogic domain directory's security configuration files have changed in an incompatible way between when the operator scanned
1313
the domain directory, which occurs during the "introspection" phase, and when the server instance attempted to start.
@@ -27,13 +27,13 @@ generated during introspection will now be invalid.
2727

2828
This can happen in a variety of ways, depending on the [model selected](https://oracle.github.io/weblogic-kubernetes-operator/userguide/managing-domains/choosing-a-model/):
2929

30-
### Domain in a Docker image
30+
#### Domain in a Docker image
3131

32-
#### 1. Rolling to an image containing new or unrelated domain directory
32+
##### Rolling to an image containing new or unrelated domain directory
3333

3434
The error occurs while rolling pods to have containers based on a new Docker image that contains an entirely new or unrelated domain directory.
3535

36-
The problem is that WebLogic cannot support server instances being part of the same WebLogic domain if the server instances do
36+
The problem is that WebLogic cannot support server instances being part of the same WebLogic domain if the server instances do
3737
not all share the same domain-specific encryption key. Additionally, operator introspection
3838
currently happens only when starting servers following a total shutdown. Therefore, the "boot.properites" files generated from
3939
introspecting the image containing the original domain directory will be invalid when used with a container started with
@@ -43,9 +43,9 @@ The solution is to follow either the recommended [CI/CD guidelines](https://orac
4343
with consistent domain-specific encryption keys and bootstrapping security details, or to [perform a total shutdown](https://oracle.github.io/weblogic-kubernetes-operator/userguide/managing-domains/domain-lifecycle/startup/#starting-and-stopping-servers) of the domain so
4444
that introspection reoccurs as servers are restarted.
4545

46-
#### 2. Full domain shutdown and restart
46+
##### Full domain shutdown and restart
4747

48-
The error occurs while starting servers after a full domain shutdown.
48+
The error occurs while starting servers after a full domain shutdown.
4949

5050
If your development model generates new Docker images
5151
with new and unrelated domain directories and then tags those images with the same tag, then different Kubernetes worker nodes
@@ -54,9 +54,9 @@ may have different images under the same tag in their individual, local Docker r
5454
The simplest solution is to set `imagePullPolicy` to `Always`; however, the better solution would be to design your development
5555
pipeline to generate new Docker image tags on every build and to never reuse an existing tag.
5656

57-
### Domain on a persistent volume
57+
#### Domain on a persistent volume
5858

59-
#### 1. Completely replacing the domain directory
59+
##### Completely replacing the domain directory
6060

6161
The error occurs while starting servers when the domain directory change was made while other servers were still running.
6262

@@ -67,4 +67,3 @@ the previous contents of the domain directory. When starting servers again, the
6767
of the domain directory. However, you may want to preserve the domain directory security configuration including the domain-specific
6868
encryption key and, in that case, you should follow a similar pattern as is described in the [CI/CD guidelines](https://oracle.github.io/weblogic-kubernetes-operator/userguide/cicd/) for the domain
6969
in a Docker image model to preserve the original security-related domain directory files.
70-

0 commit comments

Comments
 (0)