Troubleshooting with the rosa CLI

Troubleshooting with the rosa CLI
- whoami
- version
Checking logs with the rosa CLI
- logs install
- logs uninstall
Troubleshooting an expired offline access token

Using rosa commands and accessing log files to troubleshoot issues.

Use the following commands to help troubleshoot Red Hat OpenShift Service on AWS (ROSA).

whoami

Display information about your AWS and Red Hat accounts.

Syntax

$ rosa whoami [arguments]

Table 1. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v level	Log level for V logs.

Example

$ rosa whoami

version

Display the version of your rosa CLI.

Syntax

$ rosa version [arguments]

Table 2. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v level	Log level for V logs.

Example

$ rosa version

Checking logs with the rosa CLI

Use the following commands to check your install and uninstall logs.

logs install

Show the cluster install logs.

Syntax

$ rosa logs install --cluster=<cluster_name> | <cluster_id> [arguments]

Table 3. Arguments
Option	Definition
--cluster	Required: The name or ID (string) of the cluster to get logs for.
--tail	The number (integer) of lines to get from the end of the log. Default: `2000`
--watch	Watches for changes after getting the logs.

Table 4. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v <level>	The log level for V logs.

Examples

Show the last 100 install log lines for a cluster named mycluster:

$ rosa logs install mycluster --tail=100

Show the install logs for a cluster named mycluster:

$ rosa logs install --cluster=mycluster

logs uninstall

Show the cluster uninstall logs.

Syntax

$ rosa logs uninstall --cluster=<cluster_name> | <cluster_id> [arguments]

Table 5. Arguments
Option	Definition
--cluster	The name or ID (string) of the cluster to get logs for.
--tail	The number (integer) of lines to get from the end of the log. Default: `2000`
--watch	Watches for changes after getting the logs.

Table 6. Optional arguments inherited from parent commands
Option	Definition
--help	Shows help for this command.
--debug	Enables debug mode.
--profile	Specifies an AWS profile (string) from your credentials file.
--v <level>	The log level for V logs.

Example

Show the last 100 uninstall logs for a cluster named mycluster:

$ rosa logs uninstall --cluster=mycluster --tail=100

Troubleshooting an expired offline access token

If you use the rosa CLI and your api.openshift.com offline access token expires, an error message appears. This happens when sso.redhat.com invalidates the token.

Example output

Can't get tokens ....
Can't get access tokens ....

Procedure

Generate a new offline access token at the following URL. A new offline access token is generated every time you visit the URL.
- Red Hat OpenShift Service on AWS (ROSA): https://cloud.redhat.com/openshift/token/rosa