Attach local database using .NET Core and CMS 12
In my CMS 11 solution I used the variable |DataDirectory| to point out the App_Data folder where my database file is placed and that workd just fine. Is Net Core I tried to use the same:
"ConnectionStrings": {
"EPiServerDB": "Data Source=(LocalDb)\\MSSQLLocalDB;AttachDbFilename=|DataDirectory|\\EPiServerDB_f6c7a112.mdf;Initial Catalog=EPiServerDB_f6c7a112;Connection Timeout=60;Integrated Security=True;MultipleActiveResultSets=True"
}
In CMS 12 using Net Core, the |DataDictionary| does not work anymore and need to be replaced in some way. I found this that I thought was my solution:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
string baseDir = env.ContentRootPath;
AppDomain.CurrentDomain.SetData("DataDirectory", System.IO.Path.Combine(baseDir, "App_Data"));
}
What happend was that when calling ConfigureCmsDefaults() which is done in Program.cs, Episerver tries to connect to the database but the connectionstring is not modified so that fails. A strange behavior was that the code then never reached the Configure(...) method and I could never understand why until I set the real physical path to the database in the connectionstring.
"ConnectionStrings": {
"EPiServerDB": "Data Source=(LocalDb)\\MSSQLLocalDB;AttachDbFilename=D:\\Projekt\\Web\\App_Data\\EPiServerDB_f6c7a112.mdf;Initial Catalog=EPiServerDB_f6c7a112;Connection Timeout=60;Integrated Security=True;MultipleActiveResultSets=True"
}
Then everything worked just fine, but is doesn't look to good and finally I found a solution using PostConfigure.
Connectionstring looks like this:
"ConnectionStrings": {
"EPiServerDB": "Data Source=(LocalDb)\\MSSQLLocalDB;AttachDbFilename=App_Data\\EPiServerDB_f6c7a112.mdf;Initial Catalog=EPiServerDB_f6c7a112;Connection Timeout=60;Integrated Security=True;MultipleActiveResultSets=True",
}
And ConfigureServices like this:
public void ConfigureServices(IServiceCollection services)
{
services.PostConfigure<DataAccessOptions>(o =>
{
o.SetConnectionString(_configuration.GetConnectionString("EPiServerDB").Replace("App_Data", Path.GetFullPath("App_Data")));
});
services.PostConfigure<ApplicationOptions>(o =>
{
o.ConnectionStringOptions.ConnectionString = _configuration.GetConnectionString("EPiServerDB").Replace("App_Data", Path.GetFullPath("App_Data"));
});
}
In this way the connectionstring is modified before Episerver is initiated and the database will be attached correctly.
Hi Kristoffer
Thanks for sharing.
It's a bit strange you need to use PostConfigure for this. I don't find any issue by using Configure to replace the token. In addition, if your solution is CMS only, I found out there is DefaultConnectStringName property you can use instead of hard-coded EPiServerDB. The following snippet is my solution that I'm planning to post in my blog :)
My connectionstring in appsettings.Development.json
My startup ConfigureService class changes
Hi Vincent,
Thanks for the update. I have actually not tried the Configure, the solution I found used PostConfigure so that is the only option I have tried. I will try with Configure and let you know.
You can also remove
MultipleActiveResultSets=True
from the connection string if you're running latest version of CMS Core. You should see a warning in the logs if MARS is enabled but not needed.Hi Johan
Interesting suggestion. Do you mean remove MAR setting for LocalDb scenario or any type of dbs? Any side effect with this?
Thanks
Hi Johan
In fact, the MARS setting seems required in this article Initial configuration | Optimizely Developer Community
The documentation needs to be updated. We only support SQL Server, so not any type of database. MARS causes issues on SQL Server on Linux. There's no issues having it enabled on Windows.