Installing the Hub

The Hub ensures the connection between the on premise network and the Cloud. The Hub needs to be installed inside your network. Before installing, please make sure, the machine meets the Prerequisites.

The Hub install file can be downloaded from the "Get started" section on one.sitrion.com.

Installing the Sitrion ONE Hub Service

The following screen shows the Setup program of the Sitrion ONE Hub Service

Click Next to continue.

 

Destination Folder

Choose the folder for the Hub Service to be installed in.

Click Next to continue.

Encryption Certificate

The hub requires an encyption ceritificate to keep confidential information stored in the Hub secure.  The certificate to use for encryption is identified by the certificate's thumbprint. Once you know the thumbprint of the certificate, enter it in the Certificate Thumbprint field. You can use a self-signed certificate or a domain certificate, which ever is preferred.

The account the Hub will run under will need permissions to access the private key of the certificate you specify. Here are instructions for modifying the private key permissions:  https://technet.microsoft.com/en-us/library/ee662329(v=vs.85).aspx

Self-signed certificates can be generated easily using PowerShell 4.0.  PowerShell 4.0 can be downloaded at the following:
https://www.microsoft.com/en-ca/download/details.aspx?id=40855

In an Admin level PowerShell window, once PowerShell 4.0 is installed, use this command to generate a self signed certificate:

$cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my  -Subject HubConfigEncryption -FriendlyName "Encryption Certificate for Hub Config Settings"  -notAfter 2039-12-31 -KeyLength 2048 -KeySpec KeyExchange;
$cert.Thumbprint


**NOTE: the instructions above apply to Windows 10 or Windows 8.1.

For Windows 7, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012 or Windows Server 2012 R2  please refer to https://technet.microsoft.com/en-ca/library/cc753127(v=ws.10).aspx


Click Next to continue

SQL Server Database

The Hub requires a SQL server database, you can now connect to a SQL server instance. Also, you can configure your SQL User and create a SQL Server Database.

Note:  If you are reinstalling the Hub during an upgrade, uncheck the "Check to create database / uncheck to update" check box.  If you do forget to uncheck the check box, no user data will be lost.

NoteIf you want the setup to create the database, please make sure that the user which runs the install has permissions to create the databases on the specified SQL server.


Click Next to continue

 

User Settings

Configure the user for the Windows Service. If not changed, it will install with the Local System account on the installed machine.

Note: If you choose a custom user please make sure that the user has the appropriate rights to run a Windows service.

Click Next to continue.

Company Id / Shared Key / Environment Name

The Company Id and Shared Key are the identifieres of your tenant. You can retrieve your own company Id on one.sitrion.com.

The environment name should by default target to https://one.sitrion.com.

Service Bus Connection Settings

Configure the datacenter which should be used by the Hub to connect with. The switch "Use HTTP Relay" binding defines, which protocol should be used for the communication. More info about this can be found in the section Connectivity in the Prerequisites.

Ready to install

Click Install to start the installation of the Hub Service on your machine

 

Finish

The Sitrion Hub Service is now installed and the Windows service has automatically been started on your machine.

Note: To check if the Windows service has been started, see Start > Control Panel > Administrative Tools > Services.

Click Finish to exit the setup.

Upgrading the Sitrion Hub Service
  1. Stop the Hub service using the Windows Services Console
  2. Go to "Programs and Features" windows console
  3. Remove/Uninstall Sitrion Hub Service
  4. Follow Install instructions
  5. **Note: If you wish to maintain existing Hub database please uncheck the "check to create database" option in the SQL Server Database step. If you do however, forget to uncheck it, you will not lose data.
Troubleshooting

The Hub is installed as a Windows Service and also created a sepearate section to the Windows Event Viewer called "Sitrion HUB". In order your Hub isn't showing as online on one.sitrion.com, you can check the following things:

- Check if the Windows Service "Sitrion One HUB" is started
- Check the Windows Event Viewer for any errors, especially the folder "Applications and Services Logs" -> "Sitrion HUB" and "Windows Logs" -> "Application"
- Make sure, that the user which is running the Windows Service "Sitrion One HUB" has permissions to access the database, which has been created during the setup

In most cases, the Hub isn't able to start based on blocked firewall ports. In this case you should double check, if the ports which are defined in the Prerequisites are open
 

Proxy Configuration

If you are forced to use a proxy instead of a direct connection to communicate to the cloud, you have to use the mentioned HTTP Relay instead of TCP.

The proxy configuration itself needs to be configured manually in the config file of the Hub. The config file is by default located in the folder "C:\Program Files\Sitrion\Sitrion ONE Service\Sitrion.One.Hub.Service.exe.config". The file itself is a default .NET configuration file where a proxy can be configured with .NET defaults, like described in this MSDN article.

Share this page
X
Tell your colleagues and friends about Sitrion. Choose a social channel below to share this page.