26.2 26.1
26.2 26.1

Error Handling Deployments

Errors may occur while working in Scheer PAS. To facilitate troubleshooting, corresponding error and notification messages are displayed in the application. The overview of error messages allows you to identify possible causes and possible solutions. It also refers to documentation pages that contain further details.

Deploying a project is only possible via the projects view. For errors during the deployment process, refer to Error Handling Projects.

General Errors

Problem or Error Message

Possible Reason

Solution

Further Information

Access denied

Your account does not have permission to perform this action.

Ask your administrator for the required permission.


No connection, check your internet connection and try again

The Control Hub could not reach the platform.

Check your connection, then reload the page or apply your change again.


Service temporarily unavailable, try again later

The platform service performing this action is temporarily unavailable.

Wait a moment, then reload the page.


Unexpected error, try again

An unexpected server error occurred.

Try the action again. If the problem continues, contact your administrator.


Configuring Deployments

The following problems can occur while you view or change the configuration of a deployment or a component:

Problem or Error Message

Possible Reason

Solution

Further Information

Changes could not be saved, try again

The platform could not store the configuration.

Apply the change again. Your edits are kept, so nothing is lost. If the problem continues, contact your administrator.

Configuring a Deployment

Conflict detected, reload and try again

Another update changed the deployment while you were editing its configuration.

Copy your text, reload the page, then apply your change again.

Configuring a Deployment

Content not found, may have been removed

The deployment or the component no longer exists.

Return to the Deployments view and reload it.

Working With the Deployments View

Fields contain invalid or missing values

The configuration is valid JSON, but the platform rejected values it contains.

Correct the reported values and apply again. Compare your values with the Initial configuration to see which values the deployment expects.

Configuring a Deployment

Invalid JSON

The text in the Custom Changes panel cannot be read as JSON.

Correct the text. Apply becomes available again as soon as the text is valid. Use Discard to return to the values last stored.

Configuring a Deployment

Invalid request, check your input and try again

The configuration does not match the structure the platform expects. Text that is valid JSON is not necessarily a valid configuration.

Compare your values with the Initial configuration, correct the structure, and apply again.

Configuring a Deployment

Loading took too long, try again

The configuration could not be loaded within the expected time.

Reload the page. If the problem continues, contact your administrator.


Service temporarily unavailable, try again later

The platform service that holds the configuration is temporarily unavailable.

Wait a moment, then reload the page.


Both editors are empty and read-only, and a message is shown below the text.

The configuration could not be loaded.

Resolve the problem the message reports, then reload the page. Nothing can be edited until the configuration loads.

Configuring a Deployment

The Apply button is not offered.

There are no unsaved changes, the text is not valid JSON, or an apply is still running.

Check the status below the text. If it reports Invalid JSON, correct the text. If the button reads Applying …, wait until the apply has finished.

Configuring a Deployment

Discard and Apply are not available and the text cannot be edited.

An apply is in progress.

Wait until the apply has finished. Both actions are available again afterwards, whatever the outcome.

Configuring a Deployment

Could not update configuration of <name> with the cause Secret "<secret>" does not exist on the platform. Create it there, or change the reference at "<path>".

The configuration refers to a secret that does not exist on the platform of the deployment.

Create the secret on the platform, or change the reference at the configuration path that the message names. Then apply the configuration again.

Configuring a Deployment, Using References

Could not update configuration of <name> with the cause Secret "<secret>" has no key "<key>". Add the key to the secret, or change the reference at "<path>".

The secret that the configuration refers to exists, but it does not hold the key that the reference names.

Add the key to the secret, or change the reference at the configuration path that the message names. Then apply the configuration again.

Configuring a Deployment, Using References

Inspecting Deployment Logs

The following problems can occur when you want to open the deployment or component logs:

Problem or Error Message

Possible Reason

Solution

Further Information

The Open Logs action is not displayed.

Grafana is not configured for your installation, or the deployment has no components.

Ask your administrator to configure Grafana.

Inspecting Logs

Monitoring Deployments

The following problems can occur while you monitor your deployments:

Problem or Error Message

Possible Reason

Solution

Further Information

No deployments yet. Go to the Projects view to deploy your first project.

Nothing is deployed yet, or no deployment matches the current search and filters.

Clear the search and the filters. If nothing is deployed yet, click the Projects view link to deploy a project.

Deploying a Project

A deployment or a component you expect is missing from the list.

A search term or a filter is active, or the deployment is listed on another page.

Clear the search and the filters, then move through the pages of the list.

Working With the Control Hub

The Deployments view shows an error message with a recovery action.

The list of deployments could not be loaded.

Select the recovery action to load the view again. If the problem continues, contact your administrator.

Working With the Deployments View

A deployment shows as failed, although its components run.

The configuration of the deployment or of one of its components cannot be applied. A component that runs on its previous configuration is not shown as running.

Open the Configuration tab of the deployment details page, correct the configuration, and apply it again. The cause is shown with the status.

Control Hub Status and Badge Reference

The version of a project deployment is plain text and does not open the Git server.

The repository address of the project is not a web address, for example an SSH address, or the registry no longer holds the build of that version.

No action is needed in the Control Hub. Open the repository in the Git service to find the branch, the tag, or the commit.

Working With the Deployments View

Operating Deployments

The following problems can occur while you start, stop, restart, or delete a deployment or a component:

Problem or Error Message

Possible Reason

Solution

Further Information

Conflict detected, reload and try again

Another update changed the deployment.

Reload the Deployments view, then try the action again.

Working With the Deployments View

Deletion not possible, try again

The delete request did not complete.

Try the deletion again. If the problem continues, contact your administrator.

Deleting a Deployment

Start is not offered for a deployment that shows as failed.

The deployment is shown as failed only because its configuration cannot be applied. Its components run, so there is nothing to start.

Correct the configuration. Use Restart or Stop if you need to act on the running components.

Operating a Deployment

Updating Deployments

The following problems can occur while you update a deployment:

Problem or Error Message

Possible Reason

Solution

Further Information

A notification states an error message and offers Retry and Copy error message.

The Control Hub did not accept the update request. The message states the reason.

Click Retry to send the same request again. Click Copy error message to copy the cause, for example for your administrator or for a support request.

Updating a Deployment

Conflict detected, reload and try again

Another update changed the deployment in the meantime.

Close the dialog and reload the Deployments view. Check which version the deployment runs, then update again if needed.

Updating a Deployment

Content not found, may have been removed

The deployment or the selected project version no longer exists, for example because another user deleted it.

Reload the Deployments view. If the deployment still exists, open the update dialog again and select an available version.

Updating a Deployment

<deployment name> could not be updated to <version>

The Control Hub accepted the update, but the deployment does not run on the new version. The status of the deployment is failed or degraded, for example because a component does not start.

Open the deployment details page and check the status of the components. Open the logs of the component that does not run. Click Copy error message in the notification to copy the cause. Do not repeat the update to the same version. Update the deployment to another version.


Invalid request, check your input and try again or Fields contain invalid or missing values

The platform rejected the update request for the selected version.

Select another version and update again. If the problem continues, contact your administrator.

Updating a Deployment

Request timed out or Loading took too long, try again

The platform did not answer in time.

Reload the Deployments view and check which version the deployment runs before you update again.

Working With the Deployments View

The deployment details page does not show Update.

The deployment was not made from a project version. The Control Hub cannot determine the versions that the deployment can be moved to.

Deploy the project version that you want to run as a new deployment in the Projects view.

Deploying a Project

The Update action is disabled. The message when hovering over it is: A component is not updated or deleted on its own. Act on the whole project deployment. 

You selected a component deployment. A component deployment cannot be updated on its own.

Open the More actions menu in the row of the project deployment and select Update.

Updating a Deployment

The Update action is disabled. The message when hovering over it is: You don't have the right permissions to perform this action.

You do not have the permission to change deployments on the platform that the deployment runs on.

Ask your administrator for the required permission.

Updating a Deployment

The update dialog shows an error message, and Update & Restart is disabled.

The Control Hub could not load the versions of the project. The message states the reason, for example Loading took too long, try again or Content not found, may have been removed.

Close the dialog and open it again. If the problem continues, contact your administrator.

Updating a Deployment

The version selector states No branch builds yet or No tagged builds yet.

The selected list, Branch or Tag, holds no version of the project.

Use the Branch and Tag switch to open the other list. The selector states how many versions the other list holds. If it states No build available, the project has no version that you can select.

Updating a Deployment

This version is already running. is displayed in the update dialog. Update & Restart is disabled.

The target version is the version that the deployment already runs, for example because no newer version exists.

Select another target version in the version selector.

Updating a Deployment

📘

Related Documentation: