Merge pull request #113 from vera-chan/troubleshooting-update

update troubleshooting and redirect to cics doc

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. 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:  
+```
+[ERROR]  - Error creating directory '<directory>'.
+```
+**Why does it happen?**  
+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.
+
+
 ## Contributing
 
 We welcome contributions! Find out how in our [contribution guide](CONTRIBUTING.md).