Learn365 installation: possible issues and solutions

Errors may occur while installing Learn365.

This article goes through some of these errors, the reasons why they occur, and how to resolve them. 

 

In this article

• "Unfortunately, we cannot find a SharePoint App Catalog on your Office 365 Tenant."
• "The SharePoint App Catalog is unavailable. Ensure that it has been created and the account you are using has at least 'Visitor' permissions."
• "We were unable to verify your Office 365 setup, please try again later. If the issue persists, please contact your LMS365 Administrator."
• "The SharePoint App Catalog is unavailable. Ensure that the account you are using has at least 'Owner' permissions."
• "Oops, something went wrong"
• "Unfortunately, we could not complete the Region confirmation."

 

"Unfortunately, we cannot find a SharePoint App Catalog on your Office 365 Tenant."

The full text of the error is:

"Unfortunately, we cannot find a SharePoint App Catalog on your Office 365 Tenant. Please follow the Microsoft instructions on how to create a SharePoint App Catalog. Once you've created it, you can return to this page, refresh it, then continue the setup process. Note: If it was recently created SharePoint might needs some time to make it available for us, please try again a little later."

Reason: This error can occur during the installation process when the SharePoint App Catalog isn't created in the SharePoint admin center. 

Solution: Select View Microsoft instructions to see how to create an App Catalog site in SharePoint Online. The process may take up to 20 minutes. 

 

 

"The SharePoint App Catalog is unavailable. Ensure that it has been created and the account you are using has at least 'Visitor' permissions." 

The full text of the error is:

"The SharePoint App Catalog is unavailable. Ensure that it has been created and the account you are using has at least 'Visitor' permissions. If the App Catalog was created recently, SharePoint might need some time to make it available for LMS365."

Reason: This error can appear during the installation process when SharePoint hasn't yet finished creating the SharePoint App Catalog. 

Solution: Ensure the App Catalog is created and available. The process may take up to 20 minutes. Wait a short time and try again. Select View Microsoft instructions to find more information about creating an App Catalog site in SharePoint Online. 

 

"We were unable to verify your Office 365 setup, please try again later. If the issue persists, please contact your LMS365 Administrator."

There are two reasons for this issue.

Reason 1: The account's permissions to access the SharePoint root site are configured incorrectly.

Solution: A Microsoft 365 global admin or SharePoint admin needs to navigate to the SharePoint root site and configure the site permissions for the account you use.

The root site is the site that ends with _.sharepoint.com_, without _sites_ at the end. To go to the root site, go to the SharePoint admin center > Active Sites > expand the menu of the Site name column and order by A to Z. The root site should be displayed first in the list of sites. If the root site isn't displayed first in the list of sites, you can paste the URL https://YOUR-TENANT-NAME.sharepoint.com to go to the root site. 

Find more information about what a root site is and how to set or replace the relevant root site in this article.

 

 

Reason 2: The account you use hasn't got enough permissions to install Learn365.

Solution: Assign the relevant permissions to the account you use so you can install Learn365.

To assign the necessary permissions, go to SharePoint admin center as a Microsoft 365 global admin or SharePoint admin > Active Sites > select the relevant root site > in the top bar, select Permissions > Manage admins.

 

 

The Manage admins panel opens. Here, you need to assign permissions to the account you want to use to install Learn365. Add a new account and grant this account the relevant permissions or configure the permissions of an existing account.

Alternatively, ask someone who has an account with the relevant permissions to grant your account the necessary permissions or use another account with the relevant permissions to install Learn365.

 

"The SharePoint App Catalog is unavailable. Ensure that the account you are using has at least 'Owner' permissions."

Reason: The permissions of the account you use are insufficient to access the App Catalog. You need permission to the App Catalog site. Microsoft 365 global admins often don't have permissions to the root site if there are several administrators. By default, only the user who created a site will have permissions to it.

Solution: Ensure the account you use to access the SharePoint App Catalog is granted the necessary permissions to access it.

To configure the permissions of the account you use to access the SharePoint App Catalog, as a Microsoft 365 global admin or SharePoint admin, go to SharePoint admin center > Active Sites > select Apps in the list of sites > in the top bar, select Permissions > Manage admins.

 

 

The Manage admins panel opens. Here, you need to assign permissions to the account you want to use to access the SharePoint App Catalog. Add a new account and grant this account the relevant permissions or configure the permissions of an existing account.

Alternatively, ask someone who has an account with the relevant permissions to grant your account the necessary permissions or use another account with the relevant permissions to access the SharePoint App Catalog.

 

"Oops, something went wrong" 

Reason: The account you use doesn't have the necessary permissions, even after updating the permissions to the appropriate level in Microsoft Entra ID (Azure Active Directory).

Solution: It takes some time for Microsoft Entra ID to update account permissions. Wait for a while and update the page.

 

"Unfortunately, we could not complete the Region confirmation."

Reason: This error is displayed after a tenant region has been selected and is usually caused by missing provisioning of the SharePoint App Catalog or due to missing permissions of the account.

Solution: The process of creating the SharePoint App Catalog may take up to 20 minutes. If the installation of Learn365 started before the SharePoint App Catalog was created, wait for a while and reload the installation page.

If the issue occurs because of insufficient permissions in the account that's used to perform the installation, go to the following sections of this article to see how you can configure permissions:

• "We were unable to verify your Office 365 setup, please try again later. If the issue persists, please contact your LMS365 Administrator."
  
  
• "The SharePoint App Catalog is unavailable. Ensure that the account you are using has at least 'Owner' permissions."