openHistorian v2.8.423 (POSIX) Beta

This is the initial beta release for openHistorian v2.8.423 for POSIX platforms 🎃

openHistorian POSIX Deployment Steps

Notes:

• The following steps tested on Ubuntu 20.04 / Docker
• Updates from v2.8.421: enables IPv4 socket for openHistorian

Prerequisites

1. Make sure Mono is installed (this build tested with v6.12.0)

   https://www.mono-project.com/download/stable/#download-lin-ubuntu

2. Make sure wget is installed, e.g.:

   sudo apt install wget

3. Make sure unzip is installed, e.g.:

   sudo apt install unzip

4. Make sure sqlite3 is installed, e.g.:

   sudo apt install sqlite3

5. Make sure build-essential is installed, e.g.:

   sudo apt install build-essential

6. Make sure PAM libraries, i.e., libpam0g-dev, are installed, e.g.:

   sudo apt install libpam0g-dev

Install Steps

# Download openHistorian POSIX release
wget https://github.com/GridProtectionAlliance/openHistorian/releases/download/v2.8.423-beta/openHistorian-POSIX.zip
# Unzip POSIX release
unzip openHistorian-POSIX.zip
# Find a suitable install location, e.g., /opt/
sudo mv openHistorian /opt
cd /opt/openHistorian
# Generate a service certificate
mono MonoGenCert.exe openHistorian
# Enable local user auth for openHistorian (must run as root):
sudo bash enable-security.sh
# Add current user as initial openHistorian admin (must run as user):
bash add-user.sh
# Register openHistorian service to run as a daemon (must run as root):
sudo bash register-openHistorian.sh

openHistorian Web Management Interface

http://localhost:8180/

Authenticate on openHistorian web login page

Note that user name is in the format of domain\username. If you are running as a local user you can use computer name as the domain name, or simply . for short. For example, if the openHistorian admin user is a local account called john, then enter user name as .\john

Once logged in you can navigate to Settings > Users on the main menu to add other users.

Available openHistorian Web Services

• Primary metadata web service, e.g.:

  http://localhost:6155/historian/metadata/read/xml

• Primary data web service, e.g.:

  http://localhost:6156/historian/timeseriesdata/read/current/12/json

• Statistics metadata web service, e.g.:

  http://localhost:6055/historian/metadata/read/xml

• Statistics data web service, e.g.:

  http://localhost:6056/historian/timeseriesdata/read/current/32/json

• Alarm web service, e.g.:

  http://localhost:5020/alarmservices/raisedalarms/all/json

• Grafana openHistorian data source for primary data source.:

  http://localhost:8180/api/grafana

• Grafana openHistorian data source for statistics, e.g.:

  http://localhost:8180/instance/1.0-STAT/grafana

• Grafana openHistorian data source for other instances (example uses instance named SCADA):

  http://localhost:8180/instance/2.0-SCADA/grafana

Run openHistorian Console

cd ~
mono /opt/openHistorian/openHistorianConsole.exe

Authenticate as requested.

To login as another user, enter login command into console.

Enter command exit to exit console application. openHistorian will continue to run.

Controlling openHistorian Daemon

Stop openHistorian Daemon

sudo /opt/openHistorian/openHistorian stop

Restart openHistorian Daemon

sudo /opt/openHistorian/openHistorian start

Uninstall Steps

# Unregister openHistorian as Daemon
cd /opt/openHistorian
sudo bash register-openHistorian.sh -u
# Remove openHistorian folder
cd /opt
sudo rm -rdf openHistorian
# Remove user cache
cd ~/.config/Grid\ Protection\ Alliance/
rm -rdf openHistorianConsole

---

Asset Filename	SHA256 Hash
openHistorian-POSIX.zip	3A6AFCB3FADBB9E9CC8031AE6788B12F919DDE8B5D9A398010604D43A3BB9970