Onboarding Troubleshooting Guide

this guide addresses common errors that may occur during the apps and solution onboarding process it is structured to quickly identify an issue based on the error message, its cause, and recommended solutions to resolve it using the guide identify the error message from the onboarding api response https //docs getos1 com/reference/onboard item to tenant refer to the corresponding section of this guide based on the error message follow the recommended action(s) to resolve the error error categories verification and tenant fetching errors application service errors onboarding and subscription errors user group updates update subscribed version solution onboarding solution user group and manifest errors user group and tenant management errors tenant subscription management errors user group update errors verification and tenant fetching errors error cause recommended action error in fetching stack details error in fetching stack details verify that the stack id is correct if the error persists, contact support http //developers getos1 com/#/contact us with the error details stack with id ${stackid} is not found the specified stack id does not exist ensure the stack id is correct if you continue to experience issues, contact support http //developers getos1 com/#/contact us for further assistance stack level onboarding is prohibited for development (developer) type stack attempted stack level onboarding for a stack designated as 'developer' type please onboard your application or solution to a single or list of tenants only, rather than at the stack level error in fetching tenants for the stack system failed to fetch tenants for the given stack verify if the stack has associated tenants if the issue persists, contact support http //developers getos1 com/#/contact us with the specific stack id and error message no tenants are mapped to the given stack ${request stackid} no tenants are associated with the specified stack use a valid stack id that has associated tenants or contact support http //developers getos1 com/#/contact us for assistance tenant with id ${tenant} is not found the tenant id provided in the onboarding request does not exist or cannot be found in the system include a valid tenant id in your request application service errors error cause recommended action error in fetching application ${request versionid} call to app service fails please try again with a valid application if the error persists reach out to support onboarding of ${response application listingid} application's ${response application versions\[0] version} version to a customer (production type) tenant not allowed as it is not live request has a prod tenant but the app version is not live update the app the live state and try again onboarding of ${application listingid} application not allowed as the user is not the app developer or developer admin user is not a member of the app's organization verify your role within the application's organization if necessary, request the appropriate permissions from the application's owner team error in downloading permissions file for app ${humanreadableappid} permissions download failed from file service verify the permissions file exists and is accessible contact support http //developers getos1 com/#/contact us if the error persists onboarding and subscription errors error cause recommended action error in creating app ${application id appid} subscription client credentials missing the tenant is a prod type and the app subscription credentials are missing provide valid subscription credentials for the app and retry the onboarding process error in creating app ${application id appid} reason ${error message} call to coreos agent for app creation fails error in app registration if the problem persists, contact support http //developers getos1 com/#/contact us error in uploading permissions for app ${humanreadableappid} reason ${error message} permission file upload fails check the file format and size and try uploading again contact support http //developers getos1 com/#/contact us if the issue persists user group updates error cause recommended action skipping app user group creation no user groups found in permissions file for app ${humanreadableappid} user groups not defined in app yaml define user groups in the app's yaml file and attempt the onboarding process again if you need assistance with the yaml configuration, contact support http //developers getos1 com/#/contact us error in fetching user groups reason ${error message} fetching user groups from app service fails please try again, if the issue persists contact support http //developers getos1 com/#/contact us update subscribed version error cause recommended action error in updating the subscribed version of itemlistingidfor {tenantid} reason ${error message} version update fails check for network issues or service downtimes if the problem persists, contact support http //developers getos1 com/#/contact us with the version and tenant id details solution onboarding error cause recommended action onboarding only available for app based solutions the solution is of api type this error means that the onboarding process is limited to app based solutions if your solution includes api components, ensure it also contains app elements for onboarding for further assistance, contact support http //developers getos1 com/#/contact us the solution currently has no associated applications please add applications to use onboarding there are no apps in the solution add one or more applications to your solution before trying to onboard again if you need help with associating applications, check the solution documentation or contact support http //developers getos1 com/#/contact us solution currently has no applications that can be onboarded add applications created by your organization to use onboarding no self owned apps in the solution applications can be onboarded by the owner teams only the selected solution does not contain any app developed by the team that the user belongs to skipped onboarding of ${application listingid} as the user is not the app developer or developer admin please reach out to the application's owner team an app is not owned by the org please reach out to the application's owner team and organization error in generating apps init sequence a cyclic dependency exists among apps in the solution a cycle is detected among apps of the solution review the dependencies among the apps included in your solution to identify and resolve any cyclic dependencies updating the permissions file to remove these dependencies may resolve the issue if you need assistance identifying or resolving cyclic dependencies, contact support http //developers getos1 com/#/contact us solution user group and manifest errors error cause recommended action skipping solution user group creation no manifest file found for solution ${solution version\[0] listingid || solution id solutionid} no manifest file is associated with the solution ensure that a manifest file exists and properly linked to the solution for further assistance or to verify your solution's configuration, contact support http //developers getos1 com/#/contact us skipping solution user group creation no user group found in manifest file for solution ${solution version\[0] listingid || solution id solutionid} the manifest file for the solution exists but does not define any user groups edit the solution's manifest file to include definitions for one or more user groups if you are unsure how to define user groups in the manifest file, review the solution configuration documentation or contact support http //developers getos1 com/#/contact us user group and tenant management errors error cause recommended action error in fetching user groups reason ${error message} please reach out to support the system encountered an issue while attempting to retrieve user groups if the problem persists, contact support http //developers getos1 com/#/contact us and provide the error message error in fetching tenant user groups reason ${error message} please reach out to support fetching a tenant user groups fails please try again if the issue persists contact support http //developers getos1 com/#/contact us tenant subscription management errors error cause recommended action error in fetching tenant subscriptions reason ${error message} please reach out to support fetching tenant subscription fails please try again if the issue persists contact support http //developers getos1 com/#/contact us user group update errors error cause recommended action error in updating user groups for the tenant reason ${error message} please reach out to support tenant user group update fails please try again if the issue persists contact support http //developers getos1 com/#/contact us