Jump to main content

Troubleshoot issues while using web dashboard

Session with an Error status

Applies to: Anbox Cloud, Anbox Cloud Appliance

On the Sessions page, you could see a session with an Error status when there are not enough resources to start a streaming session.

Session with an Error status

Try the following actions:

Session does not start

Applies to: Anbox Cloud, Anbox Cloud Appliance

A session does not start and the session details page displays the following error:

Session does not start

Check the instance logs to find reasons for the session failure.

Instances(s) in Error status

Applies to: Anbox Cloud, Anbox Cloud Appliance

The Instances list page shows instances with Error status.

Instance in Error status

An instance can end up with an error status due to various reasons. It may not always be simple and easy to resolve this because of the variable factors involved, for example, the application that the instance is hosting or any installed addons.

Click on the corresponding INSTANCE ID and check the instance details page for any possible error messages. The instance details page has an Error Message field that could be useful.

Instance details page

The Error Message field can give you a starting point for identifying the issue. Some reasons for an instance to go into error status could be:

  • Insufficient resources. Refer Capacity planning.
  • Occasionally, access to Ubuntu archives could be a problem when creating an application. As an immediate workaround, you could disable the security update by running amc config set instance.security_updates false or explicitly set amc config set instance.api_mirror <mirror_address> to configure an instance to use a different APT mirror. See AMS configuration for more details.

If the reason for the instance failure is not obvious from the Error Message, check the Logs tab for more information.

Logs unavailable for an instance

Applies to: Anbox Cloud, Anbox Cloud Appliance

Instance logs unavailable

Logs are unavailable for an instance when:

  • The instance is not in error status.
  • Occasionally, the instance could have ended up with an error status due to insufficient resources but there are no log files because the application bootstrap process succeeded.

Normally, the logs are available if the instance is in an error state. If the instance is in the error state and yet there are no logs available, check if you have enough resources.

Terminal is unavailable for an instance

Applies to: Anbox Cloud, Anbox Cloud Appliance

Terminal unavailable for instance

Terminal is not available if the instance has any other status apart from running and started.

Last updated a month ago. Help improve this document in the forum.