Introduction
Starcounter 3.0.0 Release Candidate is available for general access.
Downloads:
Starcounter.3.0.0-rc-20191212.zip
archive with all required NuGet packages.star-3.0.0-rc-20191212.zip
Starcounter command linestar
tool for Windows.star-3.0.0-rc-20191212.tar.gz
Starcounter command linestar
tool for Linux.
Please make sure to read our End User License Agreement for Starcounter Software.
Starcounter 3.0 release candidate 20191212
main changes
20191212
main changesStarcounter failover setup using Windows Failover Cluster.
The
star
tool is a cross-platform console application with SQL REPL & database import/export features.Starcounter apps can now be distributed as a regular .NET Core app in framework dependent and self contained modes. Read more.
It's now possible to execute DML & DDL SQL statements using the
star
tool.Starcounter namespace has been changed from
Starcounter.Nova.App
toStarcounter.Database
.
Dependency Injection (DI) and Starcounter
Read more about Dependency Injection on the official Microsoft documentation page - Dependency injection in ASP.NET Core.
Checkout ASP.NET Core sample controller with Starcounter database access using Dependency Injection (DI).
Requirements
Ubuntu 18.04.02 x64 or Windows 10 Pro x64 Build 1903.
Windows Subsystem for Linux (WSL) is also supported.
Ubuntu 19.10 x64 is also supported.
.NET Core 3.0.100, SDK for development, runtime for production.
Enough RAM to load database of targeted size.
It's recommended to have at least two CPU cores.
Note: Please let us know if you encounter any issues while working with Starcounter. We monitor our GitHub: Starcounter/Home issue tracker and stand ready to assist.
Installation
Note: This section assumes that you have required operating system and .NET Core 3.0.100
SDK installed.
Binaries
Create a folder for Starcounter binaries, for example
Starcounter.3.0.0-rc-20191212
.Download
Starcounter.3.0.0-rc-20191212.zip
into the folder.Unzip downloaded archive into the folder.
Windows 10
On Windows Starcounter requires x64 version of Visual C++ to be installed. Download and install it from the Microsoft website:
The latest supported Visual C++ downloads.
Make sure to Unblock
the archive after downloading prior to extracting it. See the screenshot below:
Ubuntu 18.04 & 19.10
Install prerequisites.
Starcounter relies on a specific version of SWI-Prolog.
Download and unpack Starcounter binaries.
Application
Create an application folder and initialize a .NET Core console application.
All the following commands shall be executed from the StarcounterConsoleSample
folder.
Setup NuGet to consume Starcounter packages feeds.
Create nuget.config
file and add required package sources:
local
, points to the Starcounter binaries folder.Starcounter
, points tohttps://www.myget.org/F/starcounter/api/v2
.
NuGet tips:
Default
NuGet.config
file can be created withdotnet new nugetconfig
command.For more information on how to work with NuGet configurations, see this post by Microsoft.
End file should look similar to this:
Visual Studio Setup:
Visual Studio requires manual NuGet package sources configuration. For this go to the Tools → Options → NuGet Package Manager → Package Sources
menu then add local
and Starcounter
feeds.
Note: Replace the [Starcounter.3.0.0-rc-20191212]
value with the actual path to the folder with unzipped Starcounter binaries.
Add Starcounter.Database package reference
Add minimal Starcounter database access
Replace content of the Program.cs
file with the following:
For ASP.NET Core applications:
Update Startup.cs
class with the following:
Note: Starcounter works with Kestrel Web Server only. IIS and IIS Express are not yet supported.
Running with Visual Studio Code
Open Visual Studio Code in the application folder (from command line:
code ./
).Restore dependencies Visual Studio Code asks for.
Click
Ctrl + F5
to start the application.
Everything should run out of the box.
Running with Visual Studio 2019
Update Visual Studio 2019 to the latest version using Visual Studio Installer.
We checked version 16.3.0.
Open
StarcounterConsoleSample.csproj
from Visual Studio.Click
Ctrl + F5
to start the application.
Extra information
Before asking questions or reporting issues, please read these few lines, and maybe you will find an answer for your question.
Publishing application in a single file with
dotnet publish /p:PublishSingleFile=true
is not yet supported.
Last updated