Foundation

Foundation offers a starting point that is intuitive, well-structured and modular allowing developers to select Episerver products as projects to include or exclude from their solution. Including as of now projects for CMS, Commerce, Personalization, Find and Social, with the rest to follow.

---

Table of Contents

• System requirements
• Pre-installation set-up
• Installation
• Troubleshooting
• Modular set-up
• Contributing

---

System requirements

1. Visual Studio 2017 or higher - Download
2. SQL Server Express or Developer or SQL Azure Server - Download (If using SQL Azure download sqlcmd)
3. Microsoft SQL Server Management Studio - Download
4. Nodejs - Download
5. Microsoft Internet Information Server (IIS) - Download

---

Pre-installation set-up

SQL server

1. In Microsoft SQL Server Management Studio, connect to your SQL server:
2. Right-click on your server and select Properties.
3. Under Security, make sure that SQL Server and Windows Authentication mode is selected:

IIS settings

How to find the IIS settings depends on the system where you are running IIS.

1. Go to your IIS settings. If you are running IIS locally on your Windows machine, you find these under Control Panel > Programs > Programs and Features > Turn Windows features on or off.
2. Check that the following features have been enabled:

• Under Application Development:
  • ASP .NET
  • NET Extensibility
  • ASP
  • ISAPI Extensions
  • ISAPI Filters
• Common HTTP Features (Installed) node (all are required):
  • Static Content (Installed)
  • Default Document (Installed)
  • Directory Browsing (Installed
  • HTTP Errors (Installed) (Installed)
  • HTTP Redirection
• Under the Performance (Installed) node:
  • Static Content Compression (Installed)
  • Dynamic Content Compression (Installed)
• Under the Security (Installed) node:
  • URL Authorization (Installed)

---

Installation

The installation files on GitHub contain a batch file that will install the Foundation project with all products and set up an empty demo site. After the installation, you can fetch demo content from a remote repository to create a Mosey demo site, a fictitious fashion retail company.

1. Download the ZIP file from GitHub containing the project and extract the files, or clone the project from GitHub to a local folder using the command prompt and the git command git clone https://github.com/episerver/Foundation foundation (the foundation part specifies the folder where to put the files):

Download ZIP file

Or clone project using Git

Note: It is recommended that you store the project in a folder directly under C: and in a folder where your user have full access rights:

2. Right-click on the batch file called setup.cmd and select Run as administrator:

3. The installation starts and you are asked to provide the following parameters:

Parameter	Description
Application name:	The name of the application. Note: The application name should contain only letters and numbers as it used as the prefix to create the website and database components.
Public domain name for foundation:	Domain name for the application, for example, foundation.com.
Public domain name for Commerce Manager:	Domain name for the Commerce Manager application, for example, commerce.foundation.com.
License path:	If you have a license file, add the path to it. Otherwise you can add that later.
SQL server name:	SQL server instance name. Add the same server name as the one you connected to in the Pre-installation set-up steps for the SQL server.
sqlcmd command:	SQL command to execute, by default -S . -E . This can generally be left as is.

4. The build process executes a number of steps and logs both to the console and to the log files. The automatic build steps are:

•	Set permissions on the folder to everyone full control
•	Restore NuGet packages
•	npm install
•	gulp Saas task
•	Build solution
•	Install Databases
•	Create two application pools
•	Create two websites
•	Update host file
•	Copy License file
•	Update commerce manager url for access from cms
•	create connectionstrings files
•	Start the site to finish setup in browser

5. When the installation is finished, a setup page is opened in your browser.

6. If the setup page throws an error, open your host file, found under C:\Windows\System32\drivers\etc, and add the two domain names you entered during the installation. Reload the page in your browser.

7. In the setup page under Import Content, select Remote Site File: Mosey and Remote Catalog File: Foundation_Fashion to import the Mosey demo site content.

8. Click Submit and the Mosey demo site is displayed.

9. Log in with user: admin@example.com and password: store to access the Episerver user interface.

Note: A resetup.cmd file has been created in your project which you can run to re-install the database.

Troubleshooting

• Check that you have full access rights to the project folder.
• Check that you meet the system requirements.
• Check your SQL authentication settings as described in SQL Server.
• Check your IIS settings so that they match those specified in IIS settings.
• Check the log files:

  Build\Logs\Build.log
  Build\Logs\Database.log
  Build\Logs\IIS.log
  

Modular set-up

The Foundation project is set up to include all Episerver’s main products. Each product is set up as a project of its own inside the main project, so if you don’t want all products, you can simply remove their projects.

Contributing

As this is an open-source project, we encourage you to contribute to the source code and the documentation. See the Contribution guidelines for this project.

---