Uintra - A social framework

A flexible and lightweight Umbraco based framework, for making an Intranet, Extranet or social platform based on known conventions.

Why Open Source?

We are trying to create a flexible and robust social framework. We think the best way to achieve this is through an online community, that can share and iterate through ideas. In order to create a solution that has valuable functionality validated by the users.

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Note: Currently Uintra will not function properly out of the box as a Web application, if you wish guidance to use Uintra as a web application, please contact us.

1. Prerequisites

Before installing Uintra you will have to make certain preparations.

1. Install MS NET Framework .NET 4.7.2, can be found here.

2. Install IIS with advanced settings (as seen in the screenshot below)

3. MSSQLServer with Management Studio. Remember that the version of MSSQL server depends on your Windows version - 32-bit or 64-bit:

   • for latest version MSSQL server you need Windows 64-bit.
   • if you have Windows 32-bit we recommend you to install MSSQL server 2014. Here you can find all files to download and
     install (Express 32BIT WoW64\SQLEXPR32_x86 _ENU and MgmtStudio 32BIT\SQLManagementStudio_x86_ENU).

4. Visual Studio 2017 with update 15.8.8 or later, can be found here. While installing Visual Studio 2017 you need to choose “ASP.NET and web development” on the Workloads tab:

   and fill in checkboxes “.NET Framework 4.7 SDK”, “.NET Framework 4.7 targeting pack” on the Individual components tab:
   

That is it for the prerequisites now we need to setup the server.

2. Setting up the database server

Using MSSQL Server Management Studio(in administrator mode) we will set up the database(DB) server:

1. Open your DB server
   

   And add a new user for the login to the DB:

   Set up the server roles for the user:

2. Create an empty DB
   

   Give it an appropriate name:

3. Add security options for the server authentication, open properties

   Then go into "Security" and check the box as shown below:

4. Restart your server
   

5. Connect with the user you created in step 1

Now your server is set up and ready for the Uintra installation!

3. Installing Uintra

Installing Uintra Open Visual Studio 2017 that you installed earlier

1. Create a new project

   Choose “WEB” -> “ASP.NET Web Application(.NET Framework)”. Then choose “NET Framework 4.7.2” and add “Name”, “Location” (data storage on local machine), “Solution name”:

   In the next step choose the “Empty” template and press "OK":

2. Right click on the new project in the "Solution explorer" block then click on "Manage NuGet packages"

3. Press "Browse and search for "Uintra" NB! "Microsoft.CodeDom.Providers.DotNetCompilerPlatform" package should be version 2.0.1 (its compatible with UmbracoCMS 8.8.0)

   Install the latest package version:

4. Press "OK", "Accept" and “yes to all” in the next popups accept proposals

5. You should receive a message about 0 errors/warnings

Remove redundant items from Solution:

   - App_Start folder
   - Controllers folder
   - Models folder
       - UmbracoIdentityAccount folder
   - In Views folder:
       - Account.cshtml file
       - AccountLayout.cshtml file

Open Web.config file and make several corrections:

     1. The index name should be rewritten  <add key="Search.IndexName" value="[your index name]" /> for the correct work of the Elastic search     
     2. Replace row <add key="linkPreviewServiceUri" value="linkpreview.uintra.com" /> with <add key="linkPreviewServiceUri" value="https://linkpreview.uintra.com" /> for the correct work of the LinkPreview 

     3. Comment out the block for sitemap (unnecessary in some cases) 

6. Right click on the new project in the “Solution explorer” block and press “Build”

7. You should receive a message about a successful installation

With that Uintra is installed, the next and final step is setting up Uintra in IIS and continue the browser configuration.

4. Setting up Uintra

Using the Internet Information Services (IIS) Manager, we are going to add the new website.

1. Adding the website
   

   Fill in the required fields and create the website:

   NB! The “Physical path” address should be the folder location for the Uintra project you made in Visual Studio 2017(data storage on local machine). In the "Applications Pools" set .NET Framework version 4.0.30319 for your new site.

2. Add your new site IP-address and name to the “Hosts” file in the windows folder on your computer.

3. Open your new site in the browser. You’ll be redirected to the “Install Umbraco” page. Fill in all the fields and choose "Customize"

   In the “Database type” dropdown choose Microsoft SQL Server:

   Fill in all the fields. Ensure that the "Server name" and "Database name" is identical with the labels in the MSSQL Server database. Use the credentials for the new user that was created earlier and press "Continue":

   Press "I don't want a custom Machine Key":

   Press the "No thanks, I do not want ...":

   Wait while Umbraco is installed and when it is done you should see the welcoming message:

Now Umbraco is installed.

4. Configure Your Umbraco before start working with Uintra:

a. Specify a valid domain in "Culture and Hostnames" (Content section -> Home node), such as "mysite.local" and deploy through IIS, not through IISExpress

b. Start the uSync import (Settings section -> uSync node) and wait until everything is restored, it may take several minutes.

Success import will look like:

c. In some cases for correct Search working need to Rebuild index (Settings section -> Search tab):

5. To administrate your new site, open it in a new tab

   The first login uses the following data: Login - admin, password - qwerty1234 (P.S. We strongly recommend to change this later)

That's all! Now you can open new site based on Uintra and enjoy!

If you are having trouble getting Uintra installed or experience other problems, please contact us at vma@compent.net, the response time will be very fast within normal business hours, 09-16 CET/CEST.

Elastic Search

If Elastic Search is giving you trouble, please check out the issue #3 that will guide you to setup your elastic search with the proper version. Huge credit to user ChrisAngel447 for spotting this!

Running tests

We have created some simple examples of how to manually test Uintra here.

Contributing to Uintra?

A good way to contribute to Uintra is by providing issue reports. For information on how to submit an issue report refer to our guide to contributing for details on our code of conduct, and information regarding the process for submitting pull requests to us.

Contact

We have several managers and a full team working on Uintra, if you have any questions please send them to our contact person, Vadym at vma@compent.net

License

This project is licensed under the MIT License - see the file for details.