Test and fix Jira connections

After you set up a Jira instance as a request provider, you can test and fix connections to Jira.

Test Jira connections using dmcli

You can test connections to Jira using the Dimensions CM command-line client, dmcli.

To test Jira connections using dmcli:

  1. Log in to dmcli.

  2. Specify the working Jira issue for a stream or project using the SCWS command.

    For example, for the stream MY_PRODUCT:MY_STREAM, specify the working issue JIRA1:DEV-17, where JIRA1 is the Jira instance ID and DEV-17 is the Jira issue ID.

    SCWS "MY_PRODUCT:MY_STREAM" /CHANGE=JIRA1:DEV-17

  3. Check for errors in the command output.

Back to top

Test Jira connections using the desktop client

You can test connections to Jira using the Dimensions CM desktop client.

To test Jira connections using the desktop client:

  1. Log in to the desktop client.
  2. In the menu bar, select View > User Inbox.
  3. Select Requests. Requests from mapped request providers are displayed in the content window.
  4. For a Jira request provider, check for errors in the content or console windows.

Back to top

Fix SSL certificates

A Jira connection can have one of the following errors, the most likely cause is a missing Jira site certificate on your Dimensions CM server:

  • 60: SSL peer certificate or SSH remote key was not OK.
  • 35 SSL connect error.

To fix SSL on Windows:

  • Log in to Jira in a web browser.
  • Export a Jira site certificate from the browser when you are logged in. Import the certificate to the Windows Server host.

To fix SSL on UNIX or Windows:

  1. Log in to a Jira account in a web browser.
  2. Click the View site information icon on the left side of the browser address bar.
  3. Navigate to the folder where certificates are saved. See your browser's user help for instructions.
  4. Select *.atlassian.net and save it as X.509 Certificate with chain (PEM).
  5. Copy the certificate to your host machine.
  6. Open the Dimensions CM server configuration file, dm.cfg, and add the certificate's path to the following variable:

    Copy code
    DM_SSL_TRUST_CERTS_FILE <certificate path>

    Tip: You can group multiple certificates in a single certificate file referenced by this variable.

Back to top