Skip to content

openHistorian v2.8.306 (POSIX) Beta

Pre-release
Pre-release
Compare
Choose a tag to compare
@ritchiecarroll ritchiecarroll released this 03 Jul 21:54
· 474 commits to master since this release
v2.8.306-beta
93c99f7
This commit was signed with the committer’s verified signature.
ritchiecarroll J. Ritchie Carroll
GPG key ID: 941694536F21BAFF
Verified
Learn about vigilant mode.

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

openHistorian POSIX Deployment Steps

Note: The following steps tested on Ubuntu 20.04

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.306-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
# Set Grafana executable file mode (works for x86_64 architecture only **)
sudo chmod u+x Grafana/bin/grafana
sudo chmod u+x Grafana/bin/grafana-server
# 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

** To run Grafana on other architectures, download appropriate Standalone Linux Binaries from here:
https://grafana.com/grafana/download/9.5.5?edition=oss&pg=get&plcmt=selfmanaged-box1-cta1&platform=arm

Uncompress .gz file, then replace binaries in opt/openHistorian/Grafana/bin with those from the uncompressed grafana-9.5.5/bin folder.
Set Grafana executable file mode as per steps above.

openHistorian Web Management Interface

http://localhost:8180/

Note: This includes a Grafana instance attached to the openHistorian, allow a couple of minutes for Grafana to start and synchronize user accounts.

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

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 291DE85F0D400EB9FD879D614A63E6EF4E77542D8B2AD356D9A1B0A0228C98EF
Assets 3
Loading