This Article Applies From:
DeMeter
2.8.1
CVI Net Web
5.0.2.1
CVINet DB
47
Op adapter
5.0.0.5

Note: Older versions of this article exists. Click 'Other Applicable Versions' to see all versions of this document.


Introduction

The following guide details DeMeter software suite installation procedure.
It also details the necessary network requirements. 


TABLE OF CONTENTS

Introduction
1- Pre-requisites  

   1.1- Suggested readings  

   1.2- Pre-requisites  

2- Software and Network requirements  

   2.1- Identifying the required software to install from the DeMeter suite  

   2.2- Network requirements  

      2.2.1- DeMeter network requirements and port settings  

      2.2.2- DeMeter Collector network requirements and port settings  

      2.2.3- Open Protocol adapter network requirements and port settings  

   2.3- Software requirements  

      2.3.1- Supported Web browsers  

      2.3.2- Pre-installed software requirements  

3- DeMeter software suite installation  
   3.1- DeMeter installation and configuration  

      3.1.1- DeMeter installation  

      3.1.2- DeMeter further configuration (optional)  

   3.2- DeMeter Collector installation and configuration (optional)  

      3.2.1- DeMeter Collector installation  

      3.2.2- DeMeter Collector further configuration (optional)  

   3.3- Open Protocol Adapter installation and configuration (optional)  

      3.3.1- Open Protocol Adapter installation procedure  

      3.3.2- Open Protocol Adapter License  

      3.3.3- Open Protocol Adapter setup  

   3.4- Troubleshooting  

4- DeMeter assistant  

   4.1- Supported operating system  

   4.2- Application installation  

5- Further readings  

   5.1- Further system configuration  

   5.2- DeMeter configuration  

   5.3- Controller configuration  



1- Pre-requisites  


1.1- Suggested readings  


1.2- Pre-requisites  

Ensure the server you intend to use for your installation matches the minimum requirements listed in DeMeter Hardware requirements article.


2- Software and Network requirements  

2.1- Identifying the required software to install from the DeMeter suite  

The softwares within the DeMeter suite you need to install depend on the data you want to retrieve, store and analyse.

Use below description as a reference for each software in the suite.

SoftwarePurposeMandatory
DeMeterDeMeter system core software.
It will allow you to:
  • Collect data from the Infinity Client stations and display your preferred key indicators.
  • Collect user information from DeSoutter tightening systems.
  • Retrieve data from an existing CVINet system.
Yes
DeMeter Collector
Mandatory to retrieve tightening results from DeSoutter tightening systems (CVI-II / CVI3 / CONNECT) without the need for an additional CVINet installation.
DeMeter Collector is also mandatory tor retrieve tightening results via Open Protocol from third party controllers.
No
Open Protocol AdaptorIt retrieves the data from third party tightening system via a dedicated Open Protocol connection (numerical results - curves).
  • DeMeter Collector must have been installed.
  • The system s only compatible with version 5.0.0.5 and upward.
No
DeMeter AssistantMobile phone application dedicated to Andon calls: key operators are warned whenever an incident occurs on the line.No

Contact your remote support team to get all the latest software versions required for your setup or to ensure your DeMeter installation covers all your needs.


Note: a database is automatically installed by the DeMeter installer: RavenDB. No further database configuration is therefore required before installing the software suite.


2.2- Network requirements  

The next chapters list all the ports required by the DeMeter software suite to run, alongside a brief description of their respective purpose.


2.2.1- DeMeter network requirements and port settings  

Port NumberTypeDescriptionConfigurableMandatory
80 / 443 (*)TCPDefault communication port for DeMeter API.
  • Port 80: default port for web browser access.
  • Port 443: secured port for TLS communication.
Yes (***)Yes
1664TCP (**)Port used by DeMeterBI for reporting purpose.Yes (***)Yes
1883TCPPort dedicated to communication with all Desoutter devices (tightening systems - PivotWare - ....) via MQTT.Yes (***) Yes
1980TCP (**) Port dedicated to Feature Management communication with your DRIM.Yes (***) Yes
8666TCP (**) Port dedicated to the communication with RavenDB API.Yes (***) Yes
22350TCP (**)Port dedicated to CodeMeter. This particular software handles the communication with the DRIM.NoYes
  • (*) - Default port for connection to DeMeter web interface.
  • (**) - Internal port.
  • (***) - Port number can be changed via a configuration file once DeMeter installation is complete. Please see 3.1- DeMeter installation and configuration .


2.2.2- DeMeter Collector network requirements and port settings  

Port NumberTypeDescriptionConfigurableMandatory
10002TCPPort for communication with:
  • Desoutter tightening systems.
  • Open Protocol Adapter.
Yes (*) Yes (**)
10021TCPPort dedicated to DeMeter Collector monitoring interface.Yes (*) Yes (**) 
  • (*) - Port number can be changed via configuration file once DeMeter Collector installation is complete. Please see 3.2- DeMeter Collector installation and configuration (optional) .
  • (**) - Port is only required when operating with DeMeter Collector. As a result, it is considered mandatory whenever DeMeter Collector is installed, but not when operations only require DeMeter.

2.2.3- Open Protocol adapter network requirements and port settings  

Port NumberTypeDescriptionConfigurableMandatory
8585TCPPort dedicated for monitoring connected devices and configuring the connections.No (*) Yes (**) 
Open ProtocolTCPAll ports dedicated to tightening data retrieval from third party controller systems. These ports must be consistent with third party configuratioYes (*) Yes (**) 


2.3- Software requirements  

DeMeter requires, either to run or to get installed, a number of software to be installed and up-to-date to run.


2.3.1- Supported Web browsers  

The following Web browsers are supported:

  • Chrome: starting from V45.
  • Firefox: starting from V38. 
  • Edge: starting from V12. 
  • Opera: Starting from V30.


2.3.2- Pre-installed software requirements  

The following softwares need to be installed on the server running the DeMeter software:

  • 32 bits C++ Redistributable 2015 Runtime.
  • 64 bits C++ Redistributable 2015 Runtime.


3- DeMeter software suite installation  


This section describes the installation procedure for each software within the DeMeter suite.


3.1- DeMeter installation and configuration  


3.1.1- DeMeter installation  

Pre-requisite a DRIM must be connected to the target DeMeter server.

  1. Copy the DeMeter installer to your server.
  2. Open the installer by double clicking on DeMeter_X.X.X.X_setup.exe.
  3. Click Install then wait for the installation to end.

Notes:

  • All components listed in the snapshot above must be installed for a first time installation.
  • The installer will raise an alarm if it failed to detect a DRIM: see snapshot below.


System state at the end of the installation:

The following services must be started:

  • Desoutter DeMeter.
  • Desoutter DeMeter BI.
  • Desoutter DeMeter DB.
  • Desoutter FMService#.


3.1.2- DeMeter further configuration (optional)  

This section describes DeMeter port configuration procedure. This procedure is optional: DeMeter can operate with its default port settings.

When to use this procedure:

  • When several services use the same default port configuration.
  • If you wish to change the default port settings to match your IT department good practices.


To install the software:

  1. Copy / paste appsettings.json file from C:\Program Files\Desoutter\DeMeter to C:\ProgramData\Desoutter\DeMeter\API.
  2. Edit port settings fields and fill in with your target parameter. Please refer to 2.2.1- DeMeter network requirements and port settings for a list of all ports open to modification.
  3. Restart the DeMeter service.


Reminder: while file copied to C:\ProgramData\Desoutter\DeMeter\API is never modified on upgrade, reference file in C:\Program Files\Desoutter\DeMeter may be updated at any time to add / overwrite any port configuration required for a new feature.


Contact your remote support team for any help or additional information about this step of your installation.


3.2- DeMeter Collector installation and configuration (optional)  

This section describes DeMeter Collector installation procedure.

This installation is optional, and depends on the data you wish to retrieve. Refer to 2.1- Identifying the required software to install from the DeMeter suite .


3.2.1- DeMeter Collector installation  

  1. Copy the installer to the server.
  2. Open the installer by double-clicking on DeMeterCollector_X.X.X.X_setup.exe.
  3. Click Install then wait for the installation to complete.

DeMeter Collector service is started automatically at the end of the installation.


3.2.2- DeMeter Collector further configuration (optional)  

This section describes DeMeter Collector port configuration procedure.

This procedure is optional: DeMeter Collector can operate with its default port settings. The same conditions as for DeMeter apply to decide whether a specific configuration needs to be carried out.


To install DeMeter collector:

  1. Open C:\Program Filess (x86)\Desoutter\DeMeterCollector\appsettings.ini file.
  2. Edit Server_Port_Number and HMI_Server_Port_Number to match your IT requirements then save the file.
  3. Restart DeMeter Collector.


3.3- Open Protocol Adapter installation and configuration (optional)  

This section describes Open Protocol Adapter installation procedure.


3.3.1- Open Protocol Adapter installation procedure  

  1. Copy the Open Protocol Adapter installer to the DeMeter server.
  2. Start the installer by double clicking on CVINet_OpenProtocolAdapter_X.X.X.X_setup.exe.
  3. Start the installation after providing all requested information (we recommend using the default suggested settings). Wait for said installation to complete.

CVINet – Open Protocol Adapter service starts automatically once the installation process is complete.


3.3.2- Open Protocol Adapter License  

Open Protocol Adapter requires specific licenses for DeMeter to retrieve tightening results. This section describes the procedure to fill-in the license details.

  1. Contact your local Desoutter representative to the required license(s). As a reminder:
    - One license is mandatory to retrieve a tightening's numerical results.
    - A second license (optional) is required to retrieve a tightening's curve data
  2. Open DeMeter Collector Monitor via the shortcut installed on your server.
  3. Navigate to the Registration panel.
  4. Installed licenses are listed in the panel. To add a new one, click Add.
  5. The standard Desoutter Registration window opens and requests you to fill in your license details and retrieve your registration code.

After saving the changes, check, using the dedicated web admin page of the Open Protocol Adapter, that the license is properly setup:

  1. Open your favorite web browser on the DeMeter server.
  2. Navigate to http://localhost:8585/Registration: if the license is properly setup, you should see the message Registration Success displayed.



3.3.3- Open Protocol Adapter setup  

While DeMeter Collector is setup for minimum to no configuration change to be done after installation to connect to DeMeter (providing default settings are used), Open Protocol Adapter needs to be setup separately.

The easiest way to achieve this is to use Open Protocol Adapter dedicated web admin page:

  1. Navigate to http://localhost:8585/Settings from the server hosting the service.
  2. Fill in the IP Address and Port Number fields: they must be set to connect to DeMeter Collector. With Open Protocol Adapter installed on the same machine as your DeMeter server and set to its default settings, the values should respectively be set at 127.0.0.1 for the IP Address and 10002 for the Port Number.


Note: the port number must be consistent with the DeMeter Collector port setup for tightening data retrieval.


3.4- Troubleshooting  

This section provides a few troubleshooting tips.

  1. DeMeter service does not start: check that Visual C++ is installed on the server. Refer to 2.3.2- Pre-installed software requirements.
  2. One or more DeMeter related service does not start: check that several services do not share the same port number.


4- DeMeter assistant  


This section describes the installation procedure for mobile phone applications.


4.1- Supported operating system  

The following mobile operating systems are supported:

Android 6 +iOS Not Supported


4.2- Application installation  

  1. Download the DeMeter Assistant application from the Android Play Store:
    https://play.google.com/store/apps/details?id=com.desoutter.demeter.assistant&hl=fr
  2. Use the QR Code here to open the Play Store on your mobile device:

5- Further readings  


This section is a list of recommended articles to further discover DeMeter or to setup additional options.


5.1- Further system configuration  

DeMeter allows you to add you very own certificate to secure connection to DeMeter web server: How to install a certificate for DeMeter.


5.2- DeMeter configuration  

The Desoutter support portal holds a number of articles that can provide you with further insight on the configuration of DeMeter. We recommend in particular the following articles:


5.3- Controller configuration  


The Desoutter support portal provides you with additional information about the controller configuration for operation with DeMeter.