Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning

Do not call the new Solution or Project 'Lynicon' (or Lynicon.Base or any other such name) as it will cause assembly linking problems

 


Choose the MVC template

Install Lynicon

To install Lynicon as find it is not currently in the NuGet library, you will need to set up a local Nuget feed which is described here.

Image Removed

Open the NuGet Package Manager and select the Local package source, choose Nuget Gallery on nuget.org

Image Added

Choose Lynicon.Identity package.  This automatically performs all the steps in Manual Installation and Generic ASP.Net Identity.

...

Set the Connection String to the Database

Determine a SQL database locally or remote which will host the content and user data.  In web.config, set the value for the connection string element which has been created by the installation, and also the DefaultConnection connection string which already existed (ensuring user tables are created in the same database as content tables):

Code Block
languagexml
  <connectionStrings>
    <add name="DefaultConnection" connectionString="..."  providerName="System.Data.SqlClient" />
    <!-- Add lynicon database connection string here, or delete if no database being used -->
    <add name="LyniconContent" connectionString="..." />
  </connectionStrings>

Build the Site

Run the SQL script at /Areas/Lynicon/Admin/SQL/LyniconCoreInit.sql against the database to create the initial tables for Lynicon.

Set up an Admin User

Run the site locally. On the home page the template has created, select Register in the top black bar at the right to create a user account which will be the initial admin user.  Fill in the form this takes you to:

Image Removed

This will create a user record, but in order to do this it will also run EF Migrations to create the tables for standard ASP.Net Identity.  If you return to inspect the database you will find these have been created.

Now the final task is to create the Lynicon roles and add them to the user you have created.  Run the SQL script at /Areas/Lynicon/Admin/SQL/SetUpIdentity.sql against the database, which will create the default roles for Lynicon and make all currently existing users Admins in the CMS.

If you now log in a build on the site as the commands you are about to run will load the current site's compiled code in order to enable them to execute, and they won't work without this step.

Run the Initialization Commands

Image Added

Go to the Package Manager console.  Lynicon has installed Powershell commands to set up the CMS.  The commands to run (in this order) are shown in the image.  They are:

  • Initialize-LyniconProject: this inserts commands into the Global.asax.cs to run lynicon initialization, and into FilterConfig.cs to set up Lynicon's MVC script manager
  • Initialize-LyniconDatabase: this builds the core database tables needed for Lynicon
  • Initialize-LyniconAdmin: this creates an admin user for Lynicon with all the admin roles, allowing you to access the CMS editor and back end.  You have to supply a Password parameter ensuring that the admin password is never set to a default value.  The admin user's username is 'administrator' and the default email is 'admin@lynicon-user.com'

First Run

If you now run the site and log in as the administrator you will be able to see the Lynicon pages as described in the the User Manual.  Lynicon is now ready to be used for CMS functions.

Warning

You have to log in via the /lynicon/login page rather than the /account/login page which is part of the startup site template, as the latter assumes that the user name is the same as the email for all users


To now set up a basic content-managed model, route and view, consult the the Hello World page.