These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. This installation will take some time. Depending on how tech savvy you are and how many of the prerequisites you have, it can take anywhere from 30 minutes to a couple of hours.
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 directly.
Before installing Uintra you will have to make certain preparations:
- Install MS NET Framework .NET 4.7.1, can be found here.
- Install IIS with advanced settings (as seen in the screenshot below)
- MSSQL Server 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).
- 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:
- Open your DB server
and add a new user for the login to the DB:
Set up the server roles for the user
- Create an empty DB
Give it an appropriate name:
- Add security options for the server authentication, open properties
Then go into "Security" and check the box as shown below:
- Restart your server
- Connect with the user you created in step 1
Now your server is set up and ready for the Uintra installation!
3. Installing Uintra
Open Visual Studio 2017 that you installed earlier
- Create a new project
Choose “WEB” -> “ASP.NET Web Application(.NET Framework)”. Then choose “NET Framework 4.7.1” and add “Name”, “Location” (data storage on local machine), “Solution name”:
In the next step choose the “Empty” template and press "OK":
- Right click on the new project in the "Solution explorer" block then click on "Manage NuGet packages"
- Press "Browse and search for "Uintra"
Install the latest package version:
- Press "OK", "Accept" and “yes to all” in the next popups accept proposals
- You should receive a message about 0 errors/warnings
- Right click on the new project in the “Solution explorer” block and press “Build”
- You should receive a message about a successful installation
- By default Uintra platform is provide installed solution for Search engine - ElasticSearch. You can find it in Web.config file - <elasticConfiguration url="http://22.214.171.124:49200" indexPrefix="uintra_">
In this case, all Your search data would be placed in Uintra server.
For changing Search server You need to install Your own (please use this guide installation of ElasticSearch : https://www.elastic.co/guide/en/elasticsearch/reference/5.2/setup.html - be sure that Your installed version is 5.2.1). And change elasticConfiguration in Web.config file of Your installed project.
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.
- 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.
- Add your new site IP-address and name to the “Hosts” file in the windows folder on your computer
- 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 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.
- 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)
If you run into problems with the search functionality and you are tech savvy please check out this thread on Github on how to fix it: https://github.com/Uintra/Uintra/issues/3
If you are having trouble getting Uintra installed or experience other problems, please contact us at email@example.com, the response time will be very fast within normal business hours, 09-16 CET/CEST.