From 3b22e78892424af1b6239171ea24d1de2a7aed0e Mon Sep 17 00:00:00 2001 From: Vera Date: Mon, 21 Mar 2022 12:17:17 +0800 Subject: [PATCH 1/2] update troubleshooting and redirect to cics doc Signed-off-by: Vera --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 574a561..3e7262d 100644 --- a/README.md +++ b/README.md @@ -248,12 +248,12 @@ If you already have a Gradle module and want to add extra configuration to it fo ## Troubleshooting ### `unable to find valid certification path to requested target` during deployment -**Why does it happen?** You may run into this error when deploying your CICS bundle. ``` sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target ``` +**Why does it happen?** It indicates an issue with establishing a trusted connection over TLS/SSL to the remote server (CICS bundle deployment API). It may happen when you are using a self-signed certificate or a certificate that's issued by an internal certificate authority, or that the certificate is not added to the trusted certificate list of your JVM. **How to resolve it?** @@ -268,6 +268,28 @@ For security consideration, you may still want the TLS/SSL checking to be enable Add `insecure = true` to the `deploy` configuration of your bundle's `build.gradle` (See snippet in Step 1 of [Deploy a CICS bundle](#deploy-a-cics-bundle)). **Note:** Trusting all certificates can pose a security issue for your environment. +### `internal server error` during deployment +You might see this error in the Gradle log when you deploy a CICS bundle: +``` +com.ibm.cics.bundle.deploy.BundleDeployException: An internal server error occurred. Please contact your system administrator +``` +**Why does it happen?** +It indicates errors on the CMCI JVM server side. +**How to resolve it?** +Contact your system administrator to check the `messages.log` file of the CMCI JVM server. More information about how to resolve CMCI JVM server errors, see [Troubleshooting CMCI JVM server](https://www.ibm.com/docs/en/cics-ts/5.6?topic=troubleshooting-cmci-jvm-server) in CICS documentation. + +### `Error creating directory` during deployment +You might see this message in the Gradle log when deploying a CICS bundle: +``` +[ERROR] - Error creating directory ''. +``` +**Why does it happen?** +The error occurs because the user ID that deploys the bundle doesn't have right access. +**How to resolve it?** +Contact your system administrator to make sure the `deploy_userid` configured for the CICS bundle deployment API has WRITE access to the bundles directory. The bundles directory is specified on the `com.ibm.cics.jvmserver.cmci.bundles.dir` option in the JVM profile of the CMCI JVM server. +For instructions on how to specify the bundles directory and grant access to `deploy_userid`, see [Configuring the CMCI JVM server for the CICS bundle deployment API](https://www.ibm.com/docs/en/cics-ts/5.6?topic=suc-configuring-cmci-jvm-server-cics-bundle-deployment-api) in CICS documentation. + + ## Contributing We welcome contributions! Find out how in our [contribution guide](CONTRIBUTING.md). From eb39f606aa617bcf34365d815da697a7b001e473 Mon Sep 17 00:00:00 2001 From: Vera Date: Mon, 21 Mar 2022 20:40:48 +0800 Subject: [PATCH 2/2] address comments Signed-off-by: Vera --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3e7262d..f25c6a8 100644 --- a/README.md +++ b/README.md @@ -276,7 +276,7 @@ com.ibm.cics.bundle.deploy.BundleDeployException: An internal server error occur **Why does it happen?** It indicates errors on the CMCI JVM server side. **How to resolve it?** -Contact your system administrator to check the `messages.log` file of the CMCI JVM server. More information about how to resolve CMCI JVM server errors, see [Troubleshooting CMCI JVM server](https://www.ibm.com/docs/en/cics-ts/5.6?topic=troubleshooting-cmci-jvm-server) in CICS documentation. +Contact your system administrator to check the `messages.log` file of the CMCI JVM server. For more information about how to resolve CMCI JVM server errors, see [Troubleshooting CMCI JVM server](https://www.ibm.com/docs/en/cics-ts/5.6?topic=troubleshooting-cmci-jvm-server) in CICS documentation. ### `Error creating directory` during deployment You might see this message in the Gradle log when deploying a CICS bundle: @@ -284,7 +284,7 @@ You might see this message in the Gradle log when deploying a CICS bundle: [ERROR] - Error creating directory ''. ``` **Why does it happen?** -The error occurs because the user ID that deploys the bundle doesn't have right access. +The error occurs because the user ID that deploys the bundle doesn't have access to the bundles directory. **How to resolve it?** Contact your system administrator to make sure the `deploy_userid` configured for the CICS bundle deployment API has WRITE access to the bundles directory. The bundles directory is specified on the `com.ibm.cics.jvmserver.cmci.bundles.dir` option in the JVM profile of the CMCI JVM server. For instructions on how to specify the bundles directory and grant access to `deploy_userid`, see [Configuring the CMCI JVM server for the CICS bundle deployment API](https://www.ibm.com/docs/en/cics-ts/5.6?topic=suc-configuring-cmci-jvm-server-cics-bundle-deployment-api) in CICS documentation.