Skip to content

Commit 6010f89

Browse files
Sofie Toft Kristensengitbook-bot
authored andcommitted
GITBOOK-53: Tom's Dec 12 changes
1 parent 528e421 commit 6010f89

File tree

1 file changed

+22
-4
lines changed

1 file changed

+22
-4
lines changed

13/umbraco-engage/getting-started/for-developers/troubleshooting-installations.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,15 @@ description: >-
1010

1111
### Description
1212

13-
After installing Umbraco Engage and booting for the first time the following exception can be thrown. Due to unknown reasons, Umbraco Engage fails to run the necessary migrations on startup, and the Umbraco Engage tables are not created.
13+
After installing Umbraco Engage and booting for the first time, an SQL exception might be thrown. This happens when Umbraco Engage fails to run the necessary migrations on startup, and the Umbraco Engage tables are not created.
1414

15-
### Error message
15+
The most common reasons for this are:
16+
17+
* Database connectivity issues.
18+
* Incompatible SQL Server version.
19+
* No COLUMNS STORE index support on Azure SQL lower than S3.
20+
21+
### Exception
1622

1723
```bash
1824
SqlException: Invalid object name 'umbracoEngageAbTestingAbTest'.
@@ -33,6 +39,18 @@ await app.BootUmbracoAsync();
3339

3440
### Steps to resolve
3541

36-
1. Remove the row with the `Umbraco.Core.Upgrader.State+Umbraco.Engage` key from the `umbracoKeyValue` table in the database. 
37-
2. Remove all existing umbracoEngage\* tables from the database.
42+
#### When having database connectivity issues
43+
44+
1. Remove the row with the `Umbraco.Core.Upgrader.State+Umbraco.Engage` key from the `umbracoKeyValue` table in the database if it exists. 
45+
2. Remove all existing umbracoEngage\* tables from the database if they exist.
3846
3. Restart the site.
47+
48+
#### When running on Azure SQL tier lower than S3
49+
50+
Azure SQL lower than S3 doesn't support creating COLUMN STORE indexes. To work around this follow these steps: 
51+
52+
1. Scale your Azure SQL environment to S3.
53+
2. Restart the site.
54+
3. Scale back to your initial Azure SQL tier.
55+
56+
The COLUMN STORE indexes are created and can be used in a lower tier.

0 commit comments

Comments
 (0)