// Module included in the following assemblies:
//
// * serverless/serverless-support.adoc
// * support/getting-support.adoc
// * service_mesh/v2x/ossm-troubleshooting-istio.adoc
// * osd_architecture/osd-support.adoc

:_mod-docs-content-type: PROCEDURE
[id="support-submitting-a-case_{context}"]
= Submitting a support case

.Prerequisites

ifndef::openshift-dedicated[]
* You have access to the cluster as a user with the `cluster-admin` role.
endif::openshift-dedicated[]
ifdef::openshift-rosa,openshift-dedicated[]
* You have access to the cluster as a user with the `dedicated-admin` role.
endif::openshift-rosa,openshift-dedicated[]
* You have installed the OpenShift CLI (`oc`).
ifdef::openshift-dedicated[]
* You have access to the {cluster-manager-first}.
endif::openshift-dedicated[]
* You have a Red Hat Customer Portal account.
ifndef::openshift-dedicated[]
* You have a Red Hat Standard or Premium subscription.
endif::openshift-dedicated[]

.Procedure

. Log in to link:https://access.redhat.com/support/cases/#/case/list[the *Customer Support* page] of the Red Hat Customer Portal.

. Click *Get support*.

. On the *Cases* tab of the *Customer Support* page:

.. Optional: Change the pre-filled account and owner details if needed.

.. Select the appropriate category for your issue, such as *Bug or Defect*, and click *Continue*.

. Enter the following information:

.. In the *Summary* field, enter a concise but descriptive problem summary and further details about the symptoms being experienced, as well as your expectations.

.. Select *{product-title}* from the *Product* drop-down menu.

ifndef::openshift-rosa,openshift-dedicated[]
.. Select *{product-version}* from the *Version* drop-down.
endif::openshift-rosa,openshift-dedicated[]

. Review the list of suggested Red Hat Knowledgebase solutions for a potential match against the problem that is being reported. If the suggested articles do not address the issue, click *Continue*.

. Review the updated list of suggested Red Hat Knowledgebase solutions for a potential match against the problem that is being reported. The list is refined as you provide more information during the case creation process. If the suggested articles do not address the issue, click *Continue*.

. Ensure that the account information presented is as expected, and if not, amend accordingly.

. Check that the autofilled {product-title} Cluster ID is correct. If it is not, manually obtain your cluster ID.
ifdef::openshift-dedicated[]
+
* To manually obtain your cluster ID using {cluster-manager-url}:
.. Navigate to *Clusters*.
.. Click on the name of the cluster you need to open a support case for.
.. Find the value in the *Cluster ID* field of the *Details* section of the *Overview* tab.
endif::openshift-dedicated[]
ifndef::openshift-dedicated[]
+
* To manually obtain your cluster ID using the {product-title} web console:
.. Navigate to *Home* -> *Overview*.
.. Find the value in the *Cluster ID* field of the *Details* section.
+
* Alternatively, it is possible to open a new support case through the {product-title} web console and have your cluster ID autofilled.
.. From the toolbar, navigate to *(?) Help* -> *Open Support Case*.
.. The *Cluster ID* value is autofilled.
+
* To obtain your cluster ID using the OpenShift CLI (`oc`), run the following command:
+
[source,terminal]
----
$ oc get clusterversion -o jsonpath='{.items[].spec.clusterID}{"\n"}'
----
endif::openshift-dedicated[]

. Complete the following questions where prompted and then click *Continue*:
+
* What are you experiencing? What are you expecting to happen?
* Define the value or impact to you or the business.
* Where are you experiencing this behavior? What environment?
* When does this behavior occur? Frequency? Repeatedly? At certain times?

. Upload relevant diagnostic data files and click *Continue*.
ifndef::openshift-dedicated[]
It is recommended to include data gathered using the `oc adm must-gather` command as a starting point, plus any issue specific data that is not collected by that command.
endif::openshift-dedicated[]

. Input relevant case management details and click *Continue*.

. Preview the case details and click *Submit*.
