Skip to content

Commit 5cfcc2a

Browse files
authored
Merge pull request #4703 from zowe/Martin-Zeithaml-patch-2
`configmgr-using.md` - new example of merged (unified) configuration
2 parents 3f61a99 + e9d9457 commit 5cfcc2a

File tree

1 file changed

+20
-7
lines changed

1 file changed

+20
-7
lines changed

docs/user-guide/configmgr-using.md

Lines changed: 20 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,24 @@ CONFIG=FILE(/home/me/zowe-customizations.yaml)\
117117
118118
When you use multiple storage types, Zowe constructs the unified configuration by having the storage types listed on the left override the values of storage types to their right in the list. This means the left-most storage type's values take priority, and the right-most storage type should be treated as a set of defaults. Here is an example of splitting configuration into multiple files:
119119
120-
![multi yaml example](../images/configure/multiyaml.png)
120+
```yaml
121+
# /home/me/zowe-customizations.yaml
122+
components:
123+
app-server:
124+
enabled: true
125+
port: 1234
126+
```
127+
```yaml
128+
# /global/zowe/example-zowe.yaml
129+
components:
130+
app-server:
131+
enabled: true
132+
port: 4321
133+
```
134+
| Configuration | Result |
135+
| ------------- | ------ |
136+
| `FILE(/home/me/zowe-customizations.yaml):FILE(/global/zowe/example-zowe.yaml)` | `components.app-server.port=1234` |
137+
| `FILE(/global/zowe/example-zowe.yaml):FILE(/home/me/zowe-customizations.yaml)` | `components.app-server.port=4321` |
121138

122139
## Parmlib support
123140

@@ -168,7 +185,7 @@ zowe:
168185
```
169186

170187
### Template functions
171-
Following examples demonstarates how to define the logging for `zss` component based on the `crossMemoryServerName`. When the default name of `ZWESIS_STD` is used, the general logging is set to `2`. For other names the `logLevels` is set to specific trace level(s) with the highest value of `5`.
188+
Following examples demonstrates how to define the logging for `zss` component based on the `crossMemoryServerName`. When the default name of `ZWESIS_STD` is used, the general logging is set to `2`. For other names the `logLevels` is set to specific trace level(s) with the highest value of `5`.
172189
```yaml
173190
components:
174191
zss:
@@ -246,7 +263,7 @@ java:
246263

247264
## Configuration Manager Unix executable
248265

249-
`configmgr` is a file located within `<zowe.runtimeDirectory>/bin/utils` in the Zowe server component runtime for z/OS. If you run it with no arguments, it prints a help command that details what you can do with it. `configmgr` commands focus on providing input files and schemas, and then providing output such as validation success or printing the configuration.
266+
`configmgr` is an executable file located within `<zowe.runtimeDirectory>/bin/utils` in the Zowe server component runtime for z/OS. If you run it with no arguments, it prints a help command that details what you can do with it. `configmgr` commands focus on providing input files and schemas, and then providing output such as validation success or printing the configuration.
250267

251268
The `configmgr` executable needs the following as input:
252269

@@ -260,7 +277,3 @@ The `configmgr` executable can do the following with the input:
260277
- Validate and then output a specific property of the configuration when given a JSON path to the property desired.
261278

262279
The `configmgr` binary does not need to be used for Zowe configuration and Zowe schemas alone. It can validate any YAML against any json-schema. However, its environment variable output list is in the Zowe format.
263-
264-
265-
266-

0 commit comments

Comments
 (0)