Made changes to include FAQs

Author: Donna-Marie Smith

content/en/docs/2025.3/FAQs/check-cluster-health/multi-server-with-ha.md

@@ -7,4 +7,17 @@ weight: 1
 
 # Check Cluster Health
 
-{{< section "/install-application-server/multi-server/check-application-services.md">}}
+## Import Client Certificate
+
+In order to access the [Service Fabric Explorer][] to check the health of the cluster, it is necessary for the client certificate specified during the [installation of {{% ctx %}}][Configure Installation Script] to be imported in to the current user store on the machine it is being accessed from.
+
+Instructions on how to do this can be found [here][Import Client Certificate].
+
+## View Cluster Health
+
+1. Open a web browser.
+1. {{< section "/install-application-server/multi-server/check-application-services.md">}}
+
+[Configure Installation Script]:  {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.ConfigureInstallationScriptNew" >}}
+[Import Client Certificate]: {{< url path="Cortex.Faqs.ImportClientCertificate.MainDoc" >}}
+[Service Fabric Explorer]: {{< url path="Cortex.Reference.Glossary.P-T.ServiceFabricExplorer" >}}

content/en/docs/2025.3/FAQs/check-cluster-health/single-server-without-ha.md

@@ -7,4 +7,17 @@ weight: 2
 
 # Check Cluster Health
 
-{{< section "/install-application-server/single-server/check-application-services.md">}}
+## Import Client Certificate
+
+In order to access the [Service Fabric Explorer][] to check the health of the cluster, it is necessary for the client certificate specified during the [installation of {{% ctx %}}][Configure Installation Script] to be imported in to the current user store on the machine it is being accessed from.
+
+Instructions on how to do this can be found [here][Import Client Certificate].
+
+## View Cluster Health
+
+1. Open a web browser.
+1. {{< section "/install-application-server/single-server/check-application-services.md">}}
+
+[Configure Installation Script]:  {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.ConfigureInstallationScriptNew" >}}
+[Import Client Certificate]: {{< url path="Cortex.Faqs.ImportClientCertificate.MainDoc" >}}
+[Service Fabric Explorer]: {{< url path="Cortex.Reference.Glossary.P-T.ServiceFabricExplorer" >}}

content/en/docs/2025.3/FAQs/import-client-certificate/_index.md renamed to content/en/docs/2025.3/FAQs/import-client-certificate.md

@@ -2,5 +2,9 @@
 title: "How do I import the client certificate used to check cluster health?"
 linkTitle: "How do I import the client certificate used to check cluster health?"
 description: "Instructions on how to import the client certificate used to check the cluster health."
-weight: 150
+weight: 1
 ---
+
+# Import Client Certificate
+
+{{< section "/faqs/import-client-certificate.md">}}

content/en/docs/2025.3/FAQs/import-client-certificate/multi-server-with-ha.md

@@ -0,0 +1,3 @@
+Importing the client certificate can be achieved by double-clicking on the .PFX file and following the wizard.
+
+If the .PFX file is not available on the machine, it will need to be copied to the machine it is to be imported on, exporting it from the certificate store if necessary; the certificate can be retrieved by using the `Manage Computer Certificates` tool in Windows to export the certificate used (`CortexServerCertificate` if using self signed certificates) from the `Personal` store as a pfx file and then importing it to the `Current User` store by double-clicking on it and following the wizard. The certificate must also be imported to `Trusted Root Certification Authorities` in the `Local Computer` store.

content/en/docs/2025.3/FAQs/import-client-certificate/single-server-without-ha.md

@@ -1,7 +1,31 @@
-1. Log on to one of the Application Servers.
-1. Import the client certificate, used in the `ClientCertificatePath` parameter of the [Configure Installation Script][] section, to your Current User certificate store. 
-  {{< section "/install-application-server/multi-server/import-client-certificate.md">}}
-1. Open a web browser.
-1. {{< section "/install-application-server/multi-server/service-fabric-explorer.md">}}
+Navigate to `https://app-server.domain.com:9080/Explorer`, where `app-server.domain.com` is the fully qualified domain name of any Application Server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration.
 
-[Configure Installation Script]:  {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.MultipleServerWithHA.ConfigureInstallationScriptNew" >}}
+The screen should resemble that in the following figure:
+{{< figure src="/images/Service Fabric Explorer.png" >}}
+
+The status circles should be entirely green - this indicates that all nodes, services and instances are healthy. Other status pages can be accessed by expanding items in the leftmost pane. Issues can be tracked down to the failing component by expanding items with warning triangles or error icons on. The next few diagrams show the status pages for a healthy system.
+
+After expanding the application, clicking on any of the services should display a green circle and `Status = Active`:
+
+{{< figure src="/images/Service Fabric Explorer - Service.png" >}}
+
+After expanding either of the services, clicking on any of the instances/partitions should display a green circle and `Status = Ready`:
+
+{{< figure src="/images/Service Fabric Explorer - Instance.png" >}}
+
+Clicking on any of the nodes at the bottom of the leftmost pane should display a green circle and `Status = Up`:
+
+{{< figure src="/images/Service Fabric Explorer - Node.png" >}}
+
+If any warning triangles appear, wait for 5 minutes or so as the cluster may still be starting up. If the cluster looks OK, go to the next section.
+
+If the warnings persist or anything on the screen goes red, expand the items to find the individual services and instances which have errors or warnings. Warnings should not be ignored as they can indicate that the service can’t start but is still in the retry phase. Error and warning messages should be displayed on the status screens and should indicate what is wrong.
+
+If no useful message can be seen here, the service log files may contain more information. These can be found on each Application Server at:
+
+* `%ProgramData%/Cortex/API Gateway Service/Logs`
+* `%ProgramData%/Cortex/Execution Service/Logs`
+
+If no solution can be found, please contact [{{% ctx %}} Service Portal][CORTEX Service Portal] for further assistance.
+
+[CORTEX Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" >}}

content/en/docs/2025.3/_shared/faqs/import-client-certificate.md

@@ -1,7 +1,31 @@
-1. Log on to the server.
-1. Import the client certificate, used in the `ClientCertificatePath` parameter of the [Configure Installation Script][] section, to your Current User certificate store.
-  {{< section "/install-application-server/single-server/import-client-certificate.md">}}
-1. Open a web browser.
-1. {{< section "/install-application-server/single-server/service-fabric-explorer.md">}}
+Navigate to `https://server.domain.com:9080/Explorer`, where `server.domain.com` is the fully qualified domain name of the server. Replace `9080` with new `httpGatewayEndpointPort` value if it was changed during configuration.
 
-[Configure Installation Script]:  {{< url path="Cortex.GettingStarted.OnPremise.InstallInnovationOnly.SingleServerWithoutHA.ConfigureInstallationScriptNew" >}}
+The screen should resemble that in the following figure:
+{{< figure src="/images/Service Fabric Explorer - Single.png" >}}
+
+The status circles should be entirely green - this indicates that the node and all services and instances are healthy. Other status pages can be accessed by expanding items in the leftmost pane. Issues can be tracked down to the failing component by expanding items with warning triangles or error icons on. The next few diagrams show the status pages for a healthy system.
+
+After expanding the application, clicking on any of the services should display a green circle and `Status = Active`:
+
+{{< figure src="/images/Service Fabric Explorer - Service - Single.png" >}}
+
+After expanding either of the services, clicking on any of the instances/partitions should display a green circle and `Status = Ready`:
+
+{{< figure src="/images/Service Fabric Explorer - Instance - Single.png" >}}
+
+Clicking on any of the nodes at the bottom of the leftmost pane should display a green circle and `Status = Up`:
+
+{{< figure src="/images/Service Fabric Explorer - Node - Single.png" >}}
+
+If any warning triangles appear, wait for 5 minutes or so as the cluster may still be starting up. If the cluster looks OK, go to the next section.
+
+If the warnings persist or anything on the screen goes red, expand the items to find the individual services and instances which have errors or warnings. Warnings should not be ignored as they can indicate that the service can’t start but is still in the retry phase. Error and warning messages should be displayed on the status screens and should indicate what is wrong.
+
+If no useful message can be seen here, the service log files may contain more information. These can be found on the server at:
+
+* `%ProgramData%/Cortex/API Gateway Service/Logs`
+* `%ProgramData%/Cortex/Execution Service/Logs`
+
+If no solution can be found, please contact [{{% ctx %}} Service Portal][CORTEX Service Portal] for further assistance.
+
+[CORTEX Service Portal]: {{< url path="Cortex.ServicePortal.MainDoc" >}}