Setting up a CMS 12 Foundation site

  • Updated
 

Setup instructions for installing a CMS 12.x Foundation site

 

Download the zip file from the git hub:

https://github.com/episerver/Foundation/tree/main

Follow prerequisite instructions regarding:

Downloading the ASP.NET Core Runtime 5.0.11 Windows Hosting Bundle from:

https://dotnet.microsoft.com/en-us/download/dotnet/5.0

And the .msi file for Windows from:

https://nodejs.org/en/download/

And an installation of MSSMS (Microsoft SQL Server Management Studio) and SQL Server Express (if needed locally to set up an initial server)

 

Within MSSMS: (under server properties -> security)

NOTE: If on a VM, you would connect to VM DB Server named: epussupsql2019 for these steps.

Enable "SQL server and Windows Authentication mode"

Also within MSSMS, I would suggest setting the user "sa" password to blank for ease of installation

 

Open a Powershell command prompt as administrator and run:

dotnet tool install Episerver.Net.CLI -g --add-source https://nuget.optimizely.com/feed/packages.svc/

 

After this, close this window.

 

Copy and extract the previously downloaded zip file for Foundation to where you want the site files.

NOTE: for a VM I have seen the use of an area like: C:\inetpub\wwwroot\[your installation folder]

 

Navigate to the directory that contains the setup.cmd file using file explorer, and right-click the setup.cmd file and select "Run as administrator".

It will prompt you for a name: I used "F12"

For the database server I found that I needed to enter an actual name like: EPUSLPTMANEW\SQLEXPRESS

NOTE: you can acquire this name from the MSSMS: right-click the server, select properties, and copy the name field.

And the remainder you can use the default (just hitting enter).

If running the setup.cmd file completes without errors:

 

Open Visual Studio, click the dropdown arrow to the right of the “IIS Express” and select a browser: Chrome tends to not have some of the issues Internet Explorer will.

Then select Debug->Start without debugging

This will take a few moments to spin up the site, after which you can append /episerver/cms to the url.

This will take you to log in: where you can use admin@example.com / Episerver123!

 

IF you encounter issues with the build/start within Visual Studio, you may need to have any of the following installed within VS (unverified):

ASP.NET and web development, Azure development, Node.js development, Desktop Development with C++, as well as Episerver nuget packages (EPiServer.CMS, EPiServer.CMS.AspNetCore.HtmlHelpers, EPiServer.Commerce, EPiServer.ContentManagementApi, EPiServer.Find.Cms, EPiServer.Find.Commerce, EPiServer.Forms, EPiServer.Framework, EPiServer.Framework.AspNetCore, EPiServer.Marketing.Automation.Forms, EPiServer.OpenIDConnet.UI, EPiServer.Personalization.Commerce, EPiServer.Telemetry.UI)