Table of Contents
IP Historian v3
IP Historian v3 (IP Hist v3) is a new version of the Intelligent Plant Historian which has been updated to use Elastic Search 7.
IP Hist v3 is currently in feature preview which means that it requires manual steps to be installed on your App Store Connect.
Installing the Feature Preview App Store Connect Package
Download and install App Store Connect as normal. Then shutdown the “Intelligent Plant Data Core Service” while we modify the configurations.
You will need to contact support@intelligentplant.com to be sent the package file needed in step 4.
1. Create a folder to act as a local package feed e.g. C:\IPHist3Feed
.
2. Modify the C:\Program Files\Intelligent Plant\Data Core\DataCore.ApplicationHost.exe.config
file and set the applicationHostEngine.appStoreRepositoryPath
setting to the local package feed e.g. C:\IPHist3Feed
.
3. Modify the C:\ProgramData\Intelligent Plant\Data Core Application Host\Service\Data\Data Core Application Host.DataStoreApplicationManager.Applications.data
file and set the AllowPreReleasePackages
setting to true.
4. Copy the package file into the local package feed.
5. Modify the C:\ProgramData\Intelligent Plant\Data Core Application Host\Service\Applications\App Store Connect\DataCore.config
file to add a new data source type definition. Add this definition to the dataSourceTypes
block after the IP Hist definition:
<dataSourceType name=“IP Historian v3” description=“Intelligent Plant Historian v3” type=“DataCore.IPHist3.IPHistDriver, DataCore.IPHist3” />
6. Restart the data core service to prompt an update which should pick up the new package.
Installing and Configuring Elastic Search 7
1. Download the latest version of Elastic Search 7 from the Elastic website.Development and testing was primarily done with verison 7.17.3 but any 7.x version should work. https://www.elastic.co/downloads/past-releases#elastic-search
2. Extract the zip file to where-ever you would like. Open the elastic search config file (“<elastic directory>\config\elasticsearch.yml”) and modify the following settings:
http.max_content_length: 500mb
http.port: 9203
(Optional) This is to prevent a port binding conflict with the Big Data Service used by Alarm Analysis and IP Hist v2.
3. Open an adminsitrator terminal and navigate to the “<elastic directory>\bin” folder. The run `elasticsearch-service.bat install`
4. You will now be able to find the Elasticsearch service in the windows service manager. Change the service start setting to 'Automatic' rather than 'Manual'.
When configuring an IP Hist v3 data source make sure to change the elastic URL setting to match the port number you specified in step 2.
IP Hist Migration Tool
The IP Hist migration tool allows you to migrate IP Hist data from an existing IP Hist v2 instance (Elastic 2.x) to an IP Hist v3 instance (Elastic 7.x).
Setup
You can download the migration tool here: http://downloads.intelligentplant.com/downloads/ip_hist_tool/ip_hist_tool_v0.1.3.zip
- Extract the zip file
- Add the path to the
ip_hist_tool
folder to your PATH environment variable - Open a terminal and type
ip_hist_tool --help
to verify that the tool is working
On windows:
- Extract the contents of
ip_hist_tool.zip
toC:\
- Search for “environment variable” in the start menu search bar and click the “Edit the system enivironment variables” option
- Click the button labeled “Environment Variables…”
- In the dialogue that opens under “User variables for <username>” double click “Path”
- The click “New”
- Add a new entry
C:\ip_hist_tool
(the path to the folder containing ip_hist_tool.exe)
Usage
You can get help using the tool using the command:
ip_hist_tool --help
or ip_hist_tool -h
The tool has several sub-commands. You can get additional help for a specific sub-command using:
ip_hist_tool <sub-command> -h
For example:
ip_hist_tool migrate -h
List (ls)
You can use the list
or ls
sub-command to list indices on an Elastic instance.
For example:
ip_hist_tool ls localhost:9203
This command lists the indices on the local Elastic search 7.x (IP Hist v3/Elastic 7.x is assumed when no version is specified) instance running on port 9203. This is equivalent to:
ip_hist_tool ls localhost:9203 -v 3
To list the inidces on an Elastic 2 instance use:
ip_hist_tool ls localhost:9200 -v 2
You can spefify a name filter using -f
ip_hist_tool ls localhost:9200 -v 2 -f "*edge.iphistorian*"
Delete (rm)
You can delete indices using the delete
or rm
sub-commands.
For example to delete all indices:
ip_hist_tool rm localhost:9203 *
For the delete sub-command a filter is always required. The command will print which indices and ask you to confirm before deleting since this operation is not reversible.
Migrate
The migrate
sub-command is used to migrate tag and data indices from an IP Hist v2 instance to v3. The source Elastic version must be 2.x and the destination 7.x.
By default the migrate command will move the indices that match the naming convention of the default “Edge Historian” data source.
For example the following command would migrate the “Edge Historian” data soruce from IP Hist v2 to v3:
ip_hist_tool migrate localhost:9200 localhost:9203
During migration a record of each data index that is succesfully migrated is recorded to a text file in the working directory. This allows the operation to be resumed if it is cancelled or fails during operation.
To resume migration run the same command again, but add the --skip_tags
parameter (otherwise the tag definitions index will be deleted and re-migrated).
e.g. ip_hist_tool migrate localhost:9200 localhost:9203 --skip_tags
You will be prompted to delete any indices that exist in the target elastic index but were not completed before the operation was stopped (as the migration staus of these indices is unknown). If you agree migration will then resume.
To migrate a data source other than the default Edge Historian you can specify the index names using the -t
(tag index name), -d
(data index name) and -a
(annotation index name) parameters.
The value of -t
should be the value of the “Tag Definitions Index Name” setting in the data source settings.
The value of -d
should be the value of the “Data Index Name Prefix” setting in the data source settings.
The value of -a
should be the value of the “Data Index Name Prefix” setting plus an annotations
suffix. e.g. “edge.iphistorianannotations”
For example if you were migrating a data source called “Example” the command would look something like this:
ip_hist_tool migrate localhost:9200 localhost:9203 -t exampletags -d example -a exampleannotations