

# Troubleshooting


The following page details some common issues encountered while creating or managing ROSA clusters.

**Topics**
+ [

## Access ROSA cluster debug logs
](#access-rosa-debug-logs)
+ [

## ROSA cluster fails AWS service quota check during cluster creation
](#service-quotas-missing-error)
+ [

## Troubleshoot ROSA CLI expired offline access tokens
](#rosa-cli-expired-token)
+ [

## Failed to create a cluster with an osdCcsAdmin error
](#osdccsadmin-error)
+ [

## Next steps
](#next-steps)
+ [

# Getting ROSA support
](rosa-support.md)

## Access ROSA cluster debug logs


To begin to troubleshoot issues with your application, first review the debug logs. The ROSA CLI debug logs provide details on the error messages that are produced when a cluster fails to create.

To display cluster debug information, run the following ROSA CLI command. In the command, replace `<cluster_name>` with the name of your cluster.

```
rosa describe cluster -c <cluster_name> --debug
```

## ROSA cluster fails AWS service quota check during cluster creation


To use ROSA, the service quotas for your account may need increased. For more information, see [Red Hat OpenShift Service on AWS endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/rosa.html).

1. Run the following command to identify your account’s quotas.

   ```
   rosa verify quota
   ```
**Note**  
Quotas are different in different AWS Regions. Make sure to verify each of the quotas for your Regions.

1. If you need to increase your quota, navigate to the [Service Quotas console](https://console.aws.amazon.com/servicequotas).

1. On the navigation pane, choose ** AWS services**.

1. Choose the service that needs a quota increase.

1. Select the quota that needs to be increased and choose **Request quota increase**.

1. For **Request quota increase**, enter the total amount that you want the quota to be and choose **Request**.

## Troubleshoot ROSA CLI expired offline access tokens


If you use the ROSA CLI and your [api.openshift.com](https://api.openshift.com/) offline access token expires, an error message appears. This happens when [sso.redhat.com](https://sso.redhat.com) invalidates the token.

1. Navigate to the [OpenShift Cluster Manager API Token page](https://console.redhat.com/openshift/token/rosa) and choose **Load Token**.

1. Copy and paste the following authentication command in the terminal.

   ```
   rosa login --token="<api_token>"
   ```

## Failed to create a cluster with an osdCcsAdmin error


**Note**  
This error occurs only when you use the non-STS method of provisioning ROSA clusters. To avoid this issue, provision your ROSA clusters using AWS STS. For more information, see [Create a ROSA classic cluster using the ROSA CLI](getting-started-classic-cli.md).

If your cluster fails to create, you might receive the following error message:

```
Failed to create cluster: Unable to create cluster spec: Failed to get access keys for user 'osdCcsAdmin': NoSuchEntity: The user with name osdCcsAdmin cannot be found.
```

1. Delete the stack.

   ```
   rosa init --delete-stack
   ```

1. Reinitialize your account.

   ```
   rosa init
   ```

## Next steps

+ Visit the [OpenShift documentation](https://docs.openshift.com/container-platform/4.16/welcome/).
+ Open an [Support case](https://console.aws.amazon.com/support) or [Red Hat Support case](https://access.redhat.com/support/).
+ Find answers to [frequently asked questions about Red Hat OpenShift Service on AWS](https://aws.amazon.com/rosa/faqs/).
+ For more information about ROSA’s support model, see [Getting ROSA support](rosa-support.md).

# Getting ROSA support
Getting support

With ROSA, you can receive support from Support and the Red Hat support teams. Support cases can be opened with either organization, and are routed to the correct team to resolve your issue.

## Open an Support case


An AWS Developer Support plan is required to open ROSA technical cases, but an AWS Business, Enterprise, or Enterprise On-Ramp Support plan is recommended for continuous access to ROSA technical support and architectural guidance. Red Hat uses the Support API to open cases for customers when necessary. AWS Business, Enterprise, and Enterprise On-Ramp support plans enable continuous phone, web, and chat access to support engineers. For more information about Support plans, see [Support](https://aws.amazon.com/premiumsupport/).

For steps to enable an Support plan, see [How do I sign up for an Support plan?](https://aws.amazon.com//premiumsupport/knowledge-center/sign-up-support/) 

For information about creating an Support case, see [Creating support cases and case management](https://docs.aws.amazon.com/awssupport/latest/user/case-management.html).

## Open a Red Hat Support case


 ROSA includes Red Hat Premium Support. To receive Red Hat Premium Support, navigate to the [Red Hat Customer Portal](https://access.redhat.com/support/) and use the support case tool to create a support ticket. For more information, see [How to engage with Red Hat support](https://access.redhat.com/start/how-to-engage-red-hat-support).