[Troubleshooting tip] - PowerShell - How to isolate server side issues from CLI or ZE

[zFernand0]

1. Slack conversation link (if any)

N/A

2. Choose a title

Troubleshoot your z/OSMF connectivity

3. Symptom

Whenever there is an error which might be related to SAF and/or z/OSMF configuration or connectivity issues, it often surfaces in the Zowe CLI or Zowe Explorer as non-user-friendly error.

4. Solution

Try using an unrelated application (like cURL) to submit the request and see if the same error happens 😋

Here are some details for that the troubleshooting content might look like:

If you have `cURL` I'd love to see the output of this command:

"""
curl -ik 'https://<HOST>:<PORT>/zosmf/restjobs/jobs?owner=*&prefix=izusvr1&exec-data=Y' -H 'X-CSRF-ZOSMF-HEADER: TRUE' -H 'Authorization: Basic <BASE64-CREDENTIALS>'
"""

### Windows users
If you do not have `cURL`, we came up with a series of commands to run in PowerShell. 

"""
$headers=@{}
$headers.Add("X-CSRF-ZOSMF-HEADER", "TRUE")
$headers.Add("Authorization", "<BASE64-CREDENTIALS>")
$response = Invoke-WebRequest -Uri 'https://<HOST>:<PORT>/zosmf/restjobs/jobs?owner=*&prefix=izusvr1&exec-data=Y' -Method GET -Headers $headers

$response.StatusCode
$response.Content
$response.Headers
"""

Please:
-   Replace <HOST> with your hostname or IP address to z/OSMF
- Replace <PORT> with the port number where z/OSMF is configured
- Replace <BASE64-CREDENTIALS> with the base64 encoded credentials
<USER>:<PASSWORD>

In order to get the base64 encoded credentials, you could run the following commands in PowerShell, or go to an online base64 encoder : )

"""
$stringToEncode = "USERID:P4SSW0RD"
$bytes = [System.Text.Encoding]::UTF8.GetBytes($stringToEncode)
$encodedString = [Convert]::ToBase64String($bytes)
$encodedString
"""

[t1m0thyj]

@zFernand0 Is this related to the following article? https://docs.zowe.org/stable/troubleshoot/cli/cli-use-curl-to-troubleshoot/

[zFernand0]

That's perfect!
Ideally we would add some Powershell native methods 🙏

[zFernand0]

On a similar note... there is another torubleshooting item that we could'should add to zowe-docs

• ZOWE CLI/ZosMF CeaTso request failed with REST API HTTP status 500 zowe-cli#699 (comment)

[zFernand0]

If you have `cURL` I'd love to see the output of this command:

"""
curl -ik 'https://<HOST>:<PORT>/zosmf/restjobs/jobs?owner=*&prefix=izusvr1&exec-data=Y' -H 'X-CSRF-ZOSMF-HEADER: TRUE' -H 'Authorization: Basic <BASE64-CREDENTIALS>'
"""

### Windows users
If you do not have `cURL`, we came up with a series of commands to run in PowerShell. 

"""
$headers=@{}
$headers.Add("X-CSRF-ZOSMF-HEADER", "TRUE")
$headers.Add("Authorization", "<BASE64-CREDENTIALS>")
$response = Invoke-WebRequest -Uri 'https://<HOST>:<PORT>/zosmf/restjobs/jobs?owner=*&prefix=izusvr1&exec-data=Y' -Method GET -Headers $headers

$response.StatusCode
$response.Content
$response.Headers
"""

Please:
-   Replace <HOST> with your hostname or IP address to z/OSMF
- Replace <PORT> with the port number where z/OSMF is configured
- Replace <BASE64-CREDENTIALS> with the base64 encoded credentials
<USER>:<PASSWORD>

In order to get the base64 encoded credentials, you could run the following commands in PowerShell, or go to an online base64 encoder : )

"""
$stringToEncode = "USERID:P4SSW0RD"
$bytes = [System.Text.Encoding]::UTF8.GetBytes($stringToEncode)
$encodedString = [Convert]::ToBase64String($bytes)
$encodedString
"""