{"id":64175,"date":"2023-11-16T15:21:32","date_gmt":"2023-11-16T07:21:32","guid":{"rendered":"https:\/\/oihelp.corporate.ifs.com\/help\/?page_id=64175"},"modified":"2024-06-21T15:17:52","modified_gmt":"2024-06-21T07:17:52","slug":"proficy-adaptor-features","status":"publish","type":"page","link":"https:\/\/oihelp.corporate.ifs.com\/help\/p2-server\/primers\/datasources\/proficy-adaptor-features\/","title":{"rendered":"Proficy Adaptor Features"},"content":{"rendered":"\n<p class=\"intro-text\">The Proficy Adaptor connects to the the GE\u00ae Proficy\u00ae Historian version 4.5 or 5.5.\u00a0It provides the ability to read and write time series tag data to and from the historian. Note that the adaptor requires as a prerequisite, the Proficy Historian Client Tools that match the version of the historian installed.<\/p>\n<h2 class=\"page-subheading\">Proficy 2022 Adaptor<\/h2>\n<p class=\"intro-text\">The Proficy 2022 Adaptor is a separate adaptor to specifically support the GE Proficy 2022 Historian.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Proficy Adaptor Settings<\/h2>\n<p class=\"intro-text\">The following table lists the adaptor's parameters, along with the <em>name<\/em>\u00a0and\u00a0<em>type<\/em>\u00a0to be used in the Import\/Export spreadsheet.<\/p>\n<table>\n<tbody>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\" width=\"170\"><strong>Parameter<\/strong><\/td>\n<td><strong>Description and example<\/strong><\/td>\n<td><strong>Name<\/strong><\/td>\n<td><strong>Type<\/strong><\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Server<\/span><\/strong><\/td>\n<td>Fully qualified name of the server machine on which the historian is hosted.<\/td>\n<td>SERVER<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">User ID<\/span><\/strong><\/td>\n<td>User ID to use to connect to the historian.<\/td>\n<td>USER_ID<\/td>\n<td>String<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Password<\/span><\/strong><\/td>\n<td>Password for the User ID used to connect to the historian.<\/td>\n<td>PASSWORD<\/td>\n<td>EncryptedString<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Allow Write<\/span><\/strong><\/td>\n<td>Whether this datasource should allow IFS OI Server client applications to write data to tags on the historian. Options: True, False.<\/td>\n<td>AllowWrite<\/td>\n<td>Boolean<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Use Proficy reliable session<\/span><\/strong><\/td>\n<td>Whether to enable reliable sessions.\u00a0Options: True, False.<\/td>\n<td>ReliableSessionEnabled<\/td>\n<td>Boolean<\/td>\n<\/tr>\n<tr style=\"border: 1px solid #cccccc;\">\n<td style=\"padding-left: 5px;\"><strong><span style=\"color: #800080;\">Server certificate validation mode<\/span><\/strong><\/td>\n<td>The method of validating the security certificate on the historian server. Use \u2018Chain Trust\u2019 to denote that a certificate is considered valid if the chain builds to a certification authority in the trusted root store. Use \u2018None\u2019 to connect to a historian server secured by a self-signed certificate. Default: <em>None<\/em>.<\/td>\n<td>ServerCertificateValidationMode<\/td>\n<td>String<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2 class=\"page-subheading\">Installation<\/h2>\n<p class=\"intro-text\">Both Proficy Adaptors are included in the Explorer installer.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Targeting Proficy Client Tools v6.0<\/h2>\n<p class=\"intro-text\">To successfully change the configuration to Proficy 6.0.<\/p>\n<h3>Check the Prerequisites<\/h3>\n<p class=\"intro-text\">1. Ensure that the Proficy Client is properly installed:<\/p>\n<ol class=\"intro-text\" style=\"list-style-type: lower-alpha;\">\n<li>Check Add\/Remove Programs.<br \/>\n<a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c6f3e2.png\" rel=\"lightbox-0\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-64551\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c6f3e2.png\" alt=\"\" width=\"505\" height=\"20\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c6f3e2.png 505w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c6f3e2-150x6.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c6f3e2-48x2.png 48w\" sizes=\"auto, (max-width: 505px) 100vw, 505px\" \/><\/a><\/p>\n<\/li>\n<li>Check the start menu.<br \/>\n<a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c76430.png\" rel=\"lightbox-1\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-64552\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c76430.png\" alt=\"\" width=\"226\" height=\"49\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c76430.png 226w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c76430-150x33.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c76430-48x10.png 48w\" sizes=\"auto, (max-width: 226px) 100vw, 226px\" \/><\/a><\/p>\n<\/li>\n<li>Check the file system.<br \/>\n<a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c80717.png\" rel=\"lightbox-2\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-64553\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c80717.png\" alt=\"\" width=\"446\" height=\"126\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c80717.png 446w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c80717-150x42.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c80717-48x14.png 48w\" sizes=\"auto, (max-width: 446px) 100vw, 446px\" \/><\/a><\/p>\n<\/li>\n<li>Check the global assembly cache.<br \/>\n<a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c86842.png\" rel=\"lightbox-3\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-64554\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c86842.png\" alt=\"\" width=\"561\" height=\"86\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c86842.png 561w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c86842-150x23.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c86842-48x7.png 48w\" sizes=\"auto, (max-width: 561px) 100vw, 561px\" \/><\/a><\/li>\n<\/ol>\n<p class=\"intro-text\">2. Check connectivity with the GE Proficy Historian Administrator.<\/p>\n<p><a href=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9.png\" rel=\"lightbox-4\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-64555\" src=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9.png\" alt=\"\" width=\"806\" height=\"401\" srcset=\"https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9.png 806w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9-768x382.png 768w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9-150x75.png 150w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9-600x299.png 600w, https:\/\/oihelp.corporate.ifs.com\/help\/wp-content\/uploads\/2023\/12\/Snag_c8fba9-48x24.png 48w\" sizes=\"auto, (max-width: 806px) 100vw, 806px\" \/><\/a><\/p>\n<h3>Configure the Redirects<\/h3>\n<p class=\"intro-text\">3. For each of the following files, add the following XML.<\/p>\n<p class=\"note\">Note: If the file does not exist, create it. If the file already exists, such as for pre-existing binding redirects, make sure that the &lt;dependentAssembly&gt; element and children shown below are inserted in the correct place for the XML structure.<\/p>\n<p class=\"intro-text\">Files:<\/p>\n<ul class=\"intro-text\">\n<li>&lt;installpath&gt;\\Data Broker\\P2.Server.AdaptorHosting.Console.exe.config<\/li>\n<li>&lt;installpath&gt;\\Data Broker\\P2.Server.AdaptorHosting.Console.32bit.exe.config<\/li>\n<li>&lt;installpath&gt;\\Data Broker\\P2.Server.DataBroker.Service.exe.config<\/li>\n<li>&lt;installpath&gt;\\Data Broker\\P2.Server.TagDiscovery.Console.exe.config<\/li>\n<li>&lt;installpath&gt;\\Data Broker\\P2.Server.TagDiscovery.Console.32bit.exe.config<\/li>\n<\/ul>\n<p class=\"note\">Note: The default install path is <em>C:\\Program Files\\P2 Energy Solutions\\P2 Server<\/em><\/p>\n<p class=\"intro-text\">Add the following XML:<\/p>\n<p><code>&lt;?xml version=\"1.0\" encoding=\"utf-8\"?&gt;<br \/>\n&lt;configuration&gt;<br \/>\n\u00a0\u00a0 &lt;runtime&gt;<br \/>\n\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;assemblyBinding xmlns=\"urn:schemas-microsoft-com:asm.v1\"&gt;<br \/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;dependentAssembly&gt;<br \/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;assemblyIdentity name=\"Proficy.Historian.ClientAccess.API\" publicKeyToken=\"651cf43ad2e50609\" culture=\"neutral\"\/&gt;<br \/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;bindingRedirect oldVersion=\"1.0.0.0-1.2.0.0\" newVersion=\"1.2.0.0\" \/&gt;<br \/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;\/dependentAssembly&gt;<br \/>\n\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;\/assemblyBinding&gt;<br \/>\n\u00a0\u00a0 &lt;\/runtime&gt;<br \/>\n&lt;\/configuration&gt;<\/code><\/p>\n<h3>Troubleshooting<\/h3>\n<p class=\"intro-text\">You may encounter the following problems:<\/p>\n<p class=\"intro-text\"><strong>Problem: Assembly load error<\/strong><\/p>\n<p class=\"intro-text\">Description: The following Assembly load error appears during tag name fetch:<\/p>\n<p><code>C:\\Windows\\Microsoft.NET\\Framework\\v4.0.30319&gt;RegAsm.exe \"E:\\Program Files (x86)<br \/>\n\\ISS\\BabelFish\\Data Acquisition\\Adaptors\\ProficyAdaptor\\P2.Server.ProficyAdaptor.dll\"<br \/>\nMicrosoft .NET Framework Assembly Registration Utility version 4.0.30319.34209 for Microsoft .NET Framework version 4.0.30319.34209<br \/>\nRegAsm : error RA0000 : Could not load file or assembly 'Proficy.Historian.ClientAccess.API, Version=1.0.0.0, Culture=neutral, PublicKeyToken=651cf43ad2e50609' or one of its dependencies.<br \/>\nThe located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)<\/code><\/p>\n<p class=\"intro-text\"><strong>Resolution<\/strong>: Check the redirect is correctly configured (steps 3 and 4).<\/p>\n<p>&nbsp;<\/p>\n<p class=\"intro-text\"><strong>Problem: Security error<\/strong><\/p>\n<p class=\"intro-text\">Description: The following Security error appears during tag name fetch:<\/p>\n<p><code>Unexpected exception occurred while getting entities.<br \/>\nException: System.ServiceModel.Security.MessageSecurityException:<br \/>\nAn unsecured or incorrectly secured fault was received from the other party.<br \/>\nSee the inner FaultException for the fault code and detail. ---&gt; System.ServiceModel.FaultException: Access denied<br \/>\n\u00a0\u00a0 --- End of inner exception stack trace ---<br \/>\nServer stack trace:<br \/>\n\u00a0\u00a0\u00a0at System.ServiceModel.Channels.SecurityChannelFactory`1.SecurityRequestChannel.ProcessReply(Message reply, SecurityProtocolCorrelationState correlationState, TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.SecurityChannelFactory`1.SecurityRequestChannel.Request(Message message, TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Security.SecuritySessionSecurityTokenProvider.DoOperation(SecuritySessionOperation operation, EndpointAddress target, Uri via, SecurityToken currentToken, TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Security.SecuritySessionSecurityTokenProvider.GetTokenCore(TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.IdentityModel.Selectors.SecurityTokenProvider.GetToken(TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Security.SecuritySessionClientSettings`1.ClientSecuritySessionChannel.OnOpen(TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.CommunicationObject.Open(TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.ServiceChannel.OnOpen(TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.CommunicationObject.Open(TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.ServiceChannel.CallOpenOnce.System.ServiceModel.Channels.ServiceChannel.ICallOnce.Call(ServiceChannel channel, TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.ServiceChannel.CallOnceManager.CallOnce(TimeSpan timeout, CallOnceManager cascade)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.ServiceChannel.EnsureOpened(TimeSpan timeout)<br \/>\n\u00a0 \u00a0at System.ServiceModel.Channels.ServiceChannel.Call(String action, Boolean oneway, ProxyOperationRuntime operation, Object[] ins, Object[] outs, TimeSpan timeout)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.ServiceChannelProxy.InvokeService(IMethodCallMessage methodCall, ProxyOperationRuntime operation)<br \/>\n\u00a0\u00a0 at System.ServiceModel.Channels.ServiceChannelProxy.Invoke(IMessage message)<br \/>\nException rethrown at [0]:<br \/>\n\u00a0\u00a0\u00a0at System.Runtime.Remoting.Proxies.RealProxy.HandleReturnMessage(IMessage reqMsg, IMessage retMsg)<br \/>\n\u00a0\u00a0 at System.Runtime.Remoting.Proxies.RealProxy.PrivateInvoke(MessageData&amp; msgData, Int32 type)<br \/>\n\u00a0\u00a0 at Proficy.Historian.ClientAccess.API.Internal.IHistorian.Connect()<br \/>\n\u00a0\u00a0 at Proficy.Historian.ClientAccess.API.ServerConnection.Connect()<br \/>\n\u00a0\u00a0 at P2.Server.ProficyAdaptor.ConnectionManager.get_Connection()<br \/>\n\u00a0\u00a0 at P2.Server.ProficyAdaptor.GetAvailableEntitiesHandler.FetchTagsWithPaging(String filter, Int32 startIndex, Int32 maxEntities)<br \/>\n\u00a0\u00a0 at P2.Server.ProficyAdaptor.GetAvailableEntitiesHandler.GetEntities(String filter, Int32 startIndex, Int32 maxEntities)<br \/>\n\u00a0\u00a0 at P2.Server.ProficyAdaptor.ProficyAdaptor.OnGetAvailableEntities(String filter, Int32 startIndex, Int32 maxEntities)<\/code><\/p>\n<p class=\"intro-text\"><strong>Resolution<\/strong>: Check that the <strong>Server_Certificate_Validation_Mode<\/strong> datasource property is correctly configured for Proficy v6.0.<\/p>\n<hr \/>\n<h2 class=\"page-subheading\">Release History<\/h2>\n<ul class=\"intro-text\">\n<li>Explorer 4.11.0\n<ul class=\"intro-text\">\n<li>Added the GE Proficy 2022 Adaptor to support Proficy 2022<\/li>\n<\/ul>\n<\/li>\n<li>Explorer 4.3.0\n<ul class=\"intro-text\">\n<li>First release of the Proficy Adaptor<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Proficy Adaptor connects to the the GE\u00ae Proficy\u00ae Historian version 4.5 or 5.5.\u00a0It provides the ability to read and write time series tag data to and from the historian. Note that the adaptor requires as a prerequisite, the Proficy Historian Client Tools that match the version of the historian installed.<\/p>\n<p class=\"continue-reading-button\"> <a class=\"continue-reading-link\" href=\"https:\/\/oihelp.corporate.ifs.com\/help\/p2-server\/primers\/datasources\/proficy-adaptor-features\/\">Read more<i class=\"crycon-right-dir\"><\/i><\/a><\/p>\n","protected":false},"author":1,"featured_media":4352,"parent":3668,"menu_order":18,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[9],"tags":[412],"class_list":["post-64175","page","type-page","status-publish","has-post-thumbnail","hentry","category-tech-ref","tag-proficy","Product-srv"],"_links":{"self":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/64175","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/comments?post=64175"}],"version-history":[{"count":7,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/64175\/revisions"}],"predecessor-version":[{"id":67517,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/64175\/revisions\/67517"}],"up":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/pages\/3668"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media\/4352"}],"wp:attachment":[{"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/media?parent=64175"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/categories?post=64175"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/oihelp.corporate.ifs.com\/help\/wp-json\/wp\/v2\/tags?post=64175"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}