NexusCore Installation guide

Installation guide

This page offers installation instructions on how to install and configure NexusCore on your WHM + cPanel server. It offers guidance on the installation, and configuration of the cPanel hosting package features.

Install NexusCore by running the following oneliner command in your shell. The installation will start immediately. Due to the nature of the plugin you will need root shell access to your WHM server!

cd /home && curl -o nexuscore_installer -L https://securedownloads.nexuscore.io/latest && sh nexuscore_installer

This installation package includes the (optional) SQL Server for Linux 2017 Express edition (free). The installation will prompt you halfway through asking whether you need SQL Server for Linux.

Most .NET Core customers will need SQL Server installed, so we recommend to install SQL Server for Linux. It is possible to install SQL Server afterwards without our nexus_core.sh script.

NexusCore will add one or two hosting-package types to WHM depending on whether you installed SQL Server.

  • Dotnet core with SQL Server 2017
  • Dotnet core without SQL Server 2017

After NexusCore has been installed, a number of things will automatically be arranged.

First off, one or two cPanel hosting packages will be created for dotnet core dependent on your choice to install Microsoft SQL Server. These hosting packages have been preconfigured to both run .net core, and to allow the user to use a given number of SQL Server databases.

You can choose a maximum number of SQL Server databases (just like with MySQL / MariaDB) to customize hosting packages for your clients.

It is also possible to create a completely new hosting package. In that case you’ll find the options to enable, disable and configure dotnet and Microsoft SQL Server in the bottom of the package settings. This allows you to set up different kinds of hosting packages with different limits using dotnet core.

Once the dotnet core option has been selected, NexusCore will automatically set up the dotnet runtime for the selected account, and the user will be able to use their package right away.

NexusCore consists of the backend portion of the plugin, but also offers a number of cPanel (customer-facing) plugins for end-users.

For hosting packages with dotnet enabled, the following cPanel plugins become active for the user.

Dotnet plugins:

Application settings
Users can set environment variables for their dotnet application here, and choose their application environment (development or production). These are well-known options and features that dotnet customers expect, and need.

.NET Logs
Users can view the logs their dotnet application returns. This helps with debugging applications (like the well-known error_log file for PHP).

Development tools
This is a page containing information for starting developers with tips on the tools to use for their development. Purely informational and offered as an extra.

Guide: deploy your app
Dotnet applications can’t simply be uploaded like PHP. They need to be compiled, and then deployed through any of the IDEs of the user. Since deployment is different for many systems this guide explains the user how to deploy their app to their new hosting account.

About dotnet
This page lists the version of dotnet the user is running for their application, needed in case the user runs into problems with their application.

Microsoft SQL Server plugins:

The plugins for Microsoft SQL Server have been built to mimic the MySQL User experience. Most of the screens have been tailored to be exactly the same so the end-user experiences the cPanel experience they so love.

SQL Server databases
This leads to the SQL Server main page, containing databases, users, and actions for users to perform. Like with MySQL, the user can add users to databases, create new databases (if their limits allow it), backup databases, restore databases etcetera.

SQL Server database wizard
Like with MySQL, this walks the user to creating a single database with a single user.

Development tools
This page lists information on the different tools they can use to connect to their SQL Server database on your server.

Backup and restore
This page provides the user with options to backup their database, or restore their database. This makes it easy for customers to move from their existing hosting company and simply import their database.

Connection string
This page lists the connection strings your clients need to use when connecting to a local SQL Server from their dotnet application. This is purely informational but helps your users to get started quickly!

Enabling / disabling plugin pages

All end-user features are added through the WHM Features panel. The features can be turned on/off individually through use of the WHM “Feature Manager”. After going to the feature manager and selecting a feature-set you’d like to alter, you’ll be presented with a package that you can use to enable or disable features.

NexusCore is installed with a complementary free license when installed. This free license has a single restriction: you are only able to host five hosting accounts with dotnet core. This is perfect for evaluation purposes, or for small companies only needing to host a few customers. Basic support is available for free licenses, so feel free to contact us if you have any questions.

Premium license

You can purchase a premium license in our license shop which entitles you to unlimited use of the plugin with unlimited accounts. Premium licenses also come with premium support – your tickets will be handled faster than those of free license holders.

Installing a premium license

When you purchase a premium license, you’ll need to activate this license. Download the license file from the license shop, and transfer it to your webhosting server. Place this file in:

/usr/local/nexuscore/nexuscore.lic

After placing the license file in the correct location, run the following shell command as root to update your license:

/usr/local/nexuscore/nexus_core.sh update_license

The shell should respond with a message saying your license details have successfully been updated. If you log into WHM and go to the NexusCore plugin page you’ll see the license details have been updated accordingly as you can see in the screenshot below. Your license has now been activated and you can use the full product without its limits.

NexusCore has a legal obligation to ask for your permission for using cookies and similar digital techniques.NexusCore uses cookies, javascript and similar technologies to reach the following goals: