Skip to content

Commit b0abeec

Browse files
dougclaytonDoug Clayton
andauthored
Add note about cert warning (#427)
Co-authored-by: Doug Clayton <[email protected]>
1 parent beae62e commit b0abeec

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

articles/cyclecloud/how-to/ssl-configuration.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,14 +84,23 @@ If you want to import a PFX file, you can do it with the following command in Cy
8484
./cycle_server keystore import_pfx server.pfx --pass PASSWORD
8585
```
8686

87-
Note the PFX file can only contain one entry.
87+
Note the PFX file can only contain one entry. Furthermore, the -pass argument is required, even if there is no password (use `--pass ''` in that case).
8888

8989
Finally, if you make changes to the keystore outside of these commands, you can reload the keystore immediately in CycleCloud 7.9.7 or later:
9090

9191
```bash
9292
./cycle_server keystore reconfig
9393
```
9494

95+
> [!NOTE]
96+
> If you get the following error, it indicates that Java does not have any trusted certificates available to it:
97+
>```
98+
> the trustAnchors parameter must be non-empty
99+
>```
100+
>
101+
> Make sure that your OS certificates are installed in the correct place (for example, `/etc/ssl/certs` for Ubuntu-based distributions). In addition, if you have defined a trust store with the `-Djavax.net.ssl.trustStorePassword` setting (not recommended), make sure it contains at least one certificate.
102+
103+
95104
### Keystore Implementation Details
96105
97106
Certificates for CycleCloud are stored in `/opt/cycle_server/config/private/keystore`, in addition to other certificates needed for operation. The following is a non-exhaustive list of the items stored in the keystore:

0 commit comments

Comments
 (0)