Install

Before you start

Before Litium Accelerator is installed you need to set up Litium NuGet feed.

Setup Elasticsearch, Redis, and Kibana, setup instructions.

Easy upgrades of Litium Accelerator with help of version control system.

Install the template package

Installation of the template package is only needed the first time the version is created. Only one version of the template package can exist at the same time. The package may get a new name before the final release.

1. Open Powershell command prompt
2. Install the template pack with

   dotnet new --install "Litium.Accelerator.Templates"

   After the template is installed, a list of available templates is shownNote: To update the template to a later version, you should run the installation command again.

Install and run Litium Accelerator

1. Open the Powershell command prompt in the folder where the Accelerator should be installed.
2. Install the Litium Accelerator with the following ​command.

   dotnet new litmvcacc

   
   
   During the creation of Litium Accelerator, the restore of projects and installation of litium-db tool are performed. If this is performed without errors; continue at step 3.
   
   Manually restore the project's dependencies

   dotnet tool restore
   dotnet restore
   

   Manually install litium-db tool

   dotnet new tool-manifest 
   dotnet tool install Litium.Application.Migrations
   

3. Setup the database with help of the litium-db tool. Using the command (Note! A empty database must exist before the command can run)

   dotnet litium-db update --connection "Pooling=true;User Id=user;Password=secret;Database=litium8;Server=127.0.0.1"

   Remember to replace the settings in the connectionstring for your database.

4. Config your Litium Accelerator installation.
   
   See .Net 5 configuration, where you should put common non secret settings for the project (appSettings.json, appSettings.Development.json, and appSettings.Production.json),  user-secrets should be used for development configuration and local secrets.

Optional: Build the client project (only if you are modifying client resource files)

The Litium Accelerator comes with pre-built client resource files, so you do not have to build them yourself.

However, if you have modified client resources under any project, then you need to build the project. Here is how to do it:

1. Make sure that you have NPM and Yarn installed and in the path.
2. Execute BuildClientProjects.bat file.

Note:

• If you are building Litium.Accelerator.FieldTypes, the output folder is Litium.Accelerator.FieldTypes\dist. Build the Litium.Accelerator.FieldTypes.csproj after building client resources to embed the script in the assembly.
• If you are building Litium.Accelerator.Mvc, the output folder is Litium.Accelerator.Mvc\UI. If you update only js, scss or cshtml files, then you do not need to build Litium.Accelerator.Mvc.csproj. Note that you still need to build client resources when you update js files.
• If you are building Litium.Accelerator.Email, the output folder is Litium.Accelerator.Email\dist. By default, ConfirmationEmail.html is copied to Litium.Accelerator.Mvc\Views\Email and renamed with .cshtml as extension. In case you want to automatically copy more files when building the project, modify gulpfile.babel.js file to add more files to be copied in the copy function.

Create your accelerator website

1. In Visual Studio, go to Solution Explorer and select the Litium.Accelerator.Mvc project. Context-click and select Set as StartUp project.
2. Start the accelerator with the Start without debugging option in the Debug menu. This will open a web browser with the port number. Type "litium" after the port number to display the login page for the Litium back office.
3. Log in as a user with System All permissions. Please read more about how to log in here. 
   Example "https://localhost:5001/litium"
4. Open the settings by clicking the cogwheel in the upper right corner. In the left panel, expand the node Deployment where you will find the accelerator. 
   
5. Click on the accelerator to install.
6. Enter a name and a domain name for the Accelerator website.
   
   
   
7. Click the Import button and wait for a message confirming that the installation was successful. Note that an active internet connection is needed to download the installation package.
   
   Your accelerator website has now been created.
   
   This means that the following items are also created:
   • A folder in Media for the Accelerator media files.
   • An assortment for the Accelerator categories and products.
   • A price list.
   • An inventory.
   • The default B2B buyer roles Order approver and Buyer.

Secure connection (SSL)

Every page should use a secure connection. By setting the HSTS (Http Strict Transport Security) for the domain name, we force the website to use HTTPS instead of HTTP. To configure HSTS, navigate to Settings > Globalization > Domain names, select a domain name, click Edit and then choose to edit HSTS max age to a value greater than 0.

From Qualys it is advisable to assign the max-age directive’s value to be greater than 10368000 seconds (120 days) and ideally to 31536000 (one year). Websites should aim to ramp up the max-age value to ensure heightened security for a long duration for the current domain and/or subdomains.