In the table below you can see the installation requirements for execution of BECS dataReading projects depending on usage in cloud or on premise environment:

BECS On Premise Handler is a small piece of a software you can install into your internal infrastructure. On Premise Handler do the interaction between your enterprise systems right in your network and the communication with BECS cloud is done by the secure MQTT protocol. MQTT allows safe communication with no need of exposing any endpoints or opening any ports from your local network.

 

BECS On Premise Package Installation Prerequisites

For correct installation of BECS On Premise Package it is required to installed and set the following prerequisites:

• IIS Server
• Install - Windows Feature - name Web-Server - IncludeManagementTools
• Enable following IIS 'Application Development' features

 ​​​​​​​

• 'Application Initialization' feature is needed for auto start of MQTT client when IIS app pool is restarted
  • this line to web.config under <system.webServer>​​​​​​​
    • <applicationInitialization doAppInitAfterRestart="true" />

1. •  

• .NET Framework 4.8
• .NET 6 Hosting Bundle
• MS SQL Server 2019
• MS SQL Management System​​​​​​​​​​​​​​​​​​​​​​​​​​​​

• HashiCorp Vault
  • Vault by HashiCorp (vaultproject.io)
    • Downloaded exe file with config.hcl template (attached to this wiki) needs to be put in same folder
    • In the root folder create Data folder
  • Needs to be initialized
  • Initialization
    • ​​​​​​​Add environment variable
      • env var - VAULT_ADDR = http://127.0.0.1:8200
  • ​​​​​​​Commands executed in the root folder through cmd
    • vault server -config="C:/BECS/Vault/VaultServer/config.hcl"
      • ​​​​​​​​​​​​​​​​​​​​​change path if needed to vault root path
    • ​​​​​​​vault operator init
      • Store keys on safe place
      • Keys will be needed later for credentials identity service config
    • ​​​​​​​vault operator unseal
    • vault login
    • vault secrets enable -path=BECSSecrets kv-v2​​​​​​​
    • vault secrets enable -path=BECSDefaultConnectors kv-v2
    • vault secrets enable -path=BECSSymptomsCollectionStructures kv-v2
  • ​​​​​​​​​​​​​​Starting the vault
    • ​​​​​​​vault server -config="C:/BECS/Hashicorp/VaultServer/config.hcl"
      • change path if needed to vault root path​​​​​​​

 

BECS On Premise Package Installation

For correct installation of BECS On Premise Package it is required to installed and set the following prerequisites (see above). The BECS On Premise Package installation consists of the next steps (all in the installation package wizard):

• ​​​​​​​Run the BECS On Premise Package installation file as administrator and accept the license terms and conditions
• Install the BECS Credentials Service
  • Use the Root Token and Unseal Keys created during the installation the HashiCorp Vault in prerequisites for BECS Credentials Service configuration fields
• Install the BECS Logger Service
  • Fill the access credentials to logger database created during prerequisites installation
• Install the BECS MQTT API
  • Fill the address of MQTT Cloud Broker (hub), the ID of MQTT Cloud Client (target) and the ID of this MQTT deployment that will subscribe to MQTT Cloud Broker (specific for every installation)
• Install the BECS On Premise Handler
  • Confirm the Host URL
• Install the BECS Configuration Manager
  • Confirm the Host URL
• Finish the installation

 

BECS On Premise Handler Installation Guide

1602.BECS-onPremise-Handler-installation-guide-2023.zip

​​​

BECS On Premise Package Installation Video​​​​​​​

​​​​​​The video below will help you to install BECS On Premise Package step by step.

 

BECS On Premise Package Installation Video Download

BECS On Premise Package Installation Video Download

 

BDPI Installation Package 

BDPI Solution

 

Step by step implementation of BDPI Solution

/Step-by-Step-implementation-of-BDPI.zip