[Feature Request] Add troubleshooting details to

Open
#587 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
58/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Tech stack
java
Domain
documentation

Research direction

Open core/src/main/java/io/temporal/samples/ssl/README.md and start at the Run SslEnabledWorkerCustomCASample instructions. Add the requested troubleshooting guidance for the UNAVAILABLE exception, including the server-sample location and startup requirement; done means the README explains how to diagnose this failure.

Written by the indexing model from the issue text.

Description

enhancement
Is your feature request related to a problem? Please describe.

Running the SslEnabledWorkerCustomCASample and forgetting to start the server-sample results in an exception.

Describe the solution you'd like

In the readme - https://github.com/temporalio/samples-java/blob/main/core/src/main/java/io/temporal/samples/ssl/README.md, it would be nice to add a troubleshooting section in the Run SslEnabledWorkerCustomCASample. Even better, modify the sample to catch this error and return a helpful message, like "Did you start the server-sample?"

Example for a troubleshooting section:

  1. If you receive an error message similar to

Exception in thread "main" io.grpc.StatusRuntimeException: UNAVAILABLE: io exception

This likely means you forgot to run the server-sample, located here: https://github.com/temporalio/samples-server/tree/main/tls/tls-simple

Dominant language
Java
Stars
258
Forks
189
Avg merge
6d 4h
Merged PRs (30d)
4

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from temporalio/samples-java

All issues in temporalio/samples-java

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.