Skip to content

Commit

Permalink
Merge branch 'master' into reboot/docs/v2-attls
Browse files Browse the repository at this point in the history
  • Loading branch information
janan07 authored Oct 21, 2024
2 parents 1f1cae0 + d075db4 commit e56de51
Show file tree
Hide file tree
Showing 5 changed files with 30 additions and 28 deletions.
15 changes: 5 additions & 10 deletions docs/extend/extend-apiml/api-mediation-infinispan.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Configure Infinispan as a storage solution through the Caching service by settin

* **`zowe.components.caching-service.storage.infinispan.jgroups.port`**

(OPTIONAL)The default value is `7600`. The port number used by Infinispan to synchronise data among cahing-service instances.
(OPTIONAL)The default value is `7098`. The port number used by Infinispan to synchronise data among cahing-service instances.

* **`zowe.components.caching-service.storage.infinispan.jgroups.host`**

Expand All @@ -56,36 +56,31 @@ Configure Infinispan as a storage solution through the Caching service by settin

* **`zowe.components.caching-service.storage.infinispan.keyExchange.port`**

(OPTIONAL)The default value is `7601`. The port number used by Infinispan to exchange encryption key among cahing-service instances.
(OPTIONAL)The default value is `7118`. The port number used by Infinispan to exchange encryption key among cahing-service instances.


**Example of Caching service HA configuration using Infinispan:**

```yaml
zowe
haInstances:
lpar1:
components:
caching-service:
storage:
mode: infinispan
infinispan:
initialHosts: lpar2[7099]
jgroups:
port: 7098
initialHosts: lpar2[7098]
persistence:
dataLocation: /global/zowe/workspace/caching-service/data01
indexLocation: global/zowe/workspace/caching-service/index01
indexLocation: /global/zowe/workspace/caching-service/index01
lpar2:
components:
caching-service:
storage:
mode: infinispan
infinispan:
initialHosts: lpar1[7098]
jgroups:
port: 7099
persistence:
dataLocation: /global/zowe/workspace/caching-service/data02
indexLocation: global/zowe/workspace/caching-service/index02
indexLocation: /global/zowe/workspace/caching-service/index02
```
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,7 @@ by other technologies in Zowe (Node.js).
As an alternative to using a keystore and truststore, API ML can read certificates from a _SAF keyring_. The user running the API ML must have rights to access the keyring. From the java perspective, the keyring behaves as the `JCERACFKS` keystore. The path to the keyring is specified as `safkeyring://user_id/key_ring_id`. The content of the SAF keyring is equivalent to the combined contents of the keystore and the truststore.

:::note
When using JCEFACFKS as the keystore type, ensure that you define the class to handle the RACF keyring. Use the `-D` options to specify the `java.protocol.handler.pkgs property`:
When using JCERACFKS as the keystore type, ensure that you define the class to handle the RACF keyring. Use the `-D` options to specify the `java.protocol.handler.pkgs property`:

-Djava.protocol.handler.pkgs=com.ibm.crypto.provider
:::
Expand Down
3 changes: 1 addition & 2 deletions docs/user-guide/configure-sysplex.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,10 @@ Zowe high availability instances require a Sysplex environment that consists of
- Connection to shared DASD
- Shared SAF database, see [Sharing a database with sysplex communication in data sharing mode](https://www.ibm.com/docs/en/zos/2.1.0?topic=sd-sharing-database-sysplex-communication-in-data-sharing-mode)
- Sysplex Distributor with configured Dynamic VIPA TCP/IP address, see [Configuring Sysplex Distributor](#configuring-sysplex-distributor) for instructions
- VSAM record-level sharing (RLS), see [Preparing for VSAM record-level sharing](https://www.ibm.com/docs/en/zos/2.4.0?topic=sharing-preparing-vsam-record-level)
- USS Shared file system, see [How to share file systems in a Sysplex](https://www.ibm.com/docs/en/zos/2.4.0?topic=planning-sharing-file-systems-in-sysplex)
- JESPlex/JES2 Multi-Access Spool (MAS) environment
- z/OSMF high availability, see [Configuring z/OSMF high availability in Sysplex](systemrequirements-zosmf-ha.md)
- Node.js v14.x (except v14.17.2), or v16.x
- Node.js v16.x or higher, required in case you enable Zowe Desktop

:::note
It is highly recommended that Node.js is installed on a shared file system.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Zowe high availability instances require a Sysplex environment that consists of
- USS Shared file system, see [How to share file systems in a Sysplex](https://www.ibm.com/docs/en/zos/2.4.0?topic=planning-sharing-file-systems-in-sysplex)
- JESPlex/JES2 Multi-Access Spool (MAS) environment
- z/OSMF high availability, see [Configuring z/OSMF high availability in Sysplex](systemrequirements-zosmf-ha.md)
- Node.js v14.x (except v14.17.2) or v16.x
- Node.js v16.x or higher, required in case you enable Zowe Desktop

**Note:** It is highly recommended that Node.js installed on a shared file system.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
# Using Infinispan as a storage solution through the Caching service

As an API developer, you can configure Infinispan as a storage solution through the Caching service. This article describes how to configure your storage solution for Infinispan.
You can configure Infinispan for high availability as well as to replicate data to provide data durability and availability.
:::info Required roles: system administrator, security administrator
:::

You can configure Infinispan as a storage solution through the Caching service, as well as configure Infinispan for high availability to replicate data to provide data durability and availability.

- [Using Infinispan as a storage solution through the Caching service](#using-infinispan-as-a-storage-solution-through-the-caching-service)
- [Understanding Infinispan](#understanding-infinispan)
Expand All @@ -28,47 +30,53 @@ Configure Infinispan as a storage solution through the Caching service by settin

* **`zowe.components.caching-service.storage.infinispan.initialHosts`**

This property specifies the list of cluster nodes (members). In case of multiple instances, the value for each Caching Service instance can be
either a list of all the members, separated by a comma, or just the replica. The format is `${haInstance.hostname}[${zowe.components.caching-service.storage.infinispan.jgroups.port}]`.

This property specifies the list of cluster nodes (members). In case of multiple instances, the value for each Caching Service instance can be
either a list of all the members, separated by a comma, or just the replica. The format is `${haInstance.hostname}[${zowe.components.caching-service.storage.infinispan.jgroups.port}]`.

* **`zowe.components.caching-service.storage.infinispan.persistence.dataLocation`**

The path where the Soft-Index store keeps its data files for the Infinispan Soft-Index Cache Store.
The default value is `data`. If you run the Caching Service in HA and the instances use the same filesystem, you have to specify a different value of the `CACHING_STORAGE_INFINISPAN_PERSISTENCE_DATALOCATION` property for each instance. For more information, see the [Soft-Index File Store](https://infinispan.org/blog/2014/10/31/soft-index-file-store).
The path where the service keeps its data files for the Infinispan Soft-Index Cache Store.
The default value is `data`. If you run the Caching Service in HA and the instances use the same filesystem, you have to specify a different value of the data property for each instance. For more information, see the [Soft-Index File Store](https://infinispan.org/blog/2014/10/31/soft-index-file-store).

* **`zowe.components.caching-service.storage.infinispan.persistence.indexLocation`**

The path where the service keeps its index data for the Infinispan Soft-Index Cache Store.
The default value is `index`. If you run the Caching Service in HA and the instances use the same filesystem, you have to specify a different value of the index property for each instance. For more information, see the [Soft-Index File Store](https://infinispan.org/blog/2014/10/31/soft-index-file-store).

* **`zowe.components.caching-service.storage.infinispan.jgroups.port`**

The port number used by Infinispan to synchronise data among cahing-service instances.
(OPTIONAL)The default value is `7098`. The port number used by Infinispan to synchronise data among cahing-service instances.

* **`zowe.components.caching-service.storage.infinispan.jgroups.host`**

(OPTIONAL)The default value is taken from zowe hostname. The hostname used by Infinispan to synchronise data among cahing-service instances.

* **`zowe.components.caching-service.storage.infinispan.keyExchange.port`**

(OPTIONAL)The default value is `7118`. The port number used by Infinispan to exchange encryption key among cahing-service instances.

**Example of Caching service HA configuration using Infinispan:**

```yaml
zowe
haInstances:
lpar1:
components:
caching-service:
storage:
mode: infinispan
infinispan:
initialHosts: lpar2[7099]
jgroups:
port: 7098
initialHosts: lpar2[7098]
persistence:
dataLocation: /global/zowe/workspace/caching-service/data01
indexLocation: /global/zowe/workspace/caching-service/index01
lpar2:
components:
caching-service:
storage:
mode: infinispan
infinispan:
initialHosts: lpar1[7098]
jgroups:
port: 7099
persistence:
dataLocation: /global/zowe/workspace/caching-service/data02
indexLocation: /global/zowe/workspace/caching-service/index02
```

0 comments on commit e56de51

Please sign in to comment.