OPC Service Manual-V1.7

Foxboro I/A Series OPC Solutions Installation, Configuration, Troubleshooting Maintained by [email protected] [email protected] and [email protected] [email protected] Revision .! A"ril #, $%%# This document is & Co"yright $%%$'$%%( $%%$'$%%( Invensys. )o*boro, I+A Series are trademars of Invensys, its subsidiaries and affiliates. All other brand names may be trademars of their res"ective o-ners.

Foxboro I/A Series OPC Solutions Installation, Configuration, Troubleshooting

Page 2 of of 106


Page 2 of of 106


Contents  Introduction........................................................... .............................................. .............................................. .. ! . Disclaimer.......................................................................... .............................................. ............................ ! .$ Conventions..................................................................... .............................................. ............................. ! . Revision history..................................................... .............................................. ....................................... / .( Related documents.................................................................................. .............................................. ... / .# Introducing 01C...................................................... .............................................. .................................... 2 .3 A T-o 4o* A""roach............................................................ .............................................. ..................... 2 $ The )o*boro )o*boro 01C I+0 5ate 5ate client 6to )o*boro )o*boro AIM01C Server7..........................................................  $. Re8uirements.............................................. Re8uirements.............................................. .............................................. .............................................. .  $.. 5eneral hard-are and system soft-are................................................................. .................. $ $..$ 01C I+0 5ate licensing................................................................. .............................................. .. $ $.$ Installation..................................................................... .............................................. ............................. $ $.$. Installing the 01C I+0 5ate.................................................................. ....................................... $ $.$.$ DC0M and Server side configuration........................................................... ............................  $.$. Registering the 01C Server........................................................ .............................................. ... ( $.$.. 0n the the A9!% A9!% machine: machine: Registering Registering the Server................................................. ............ ( $.$..$ ;oading the the 01C Server reg ey on on the 01C client host........................................... 3 $.$.( Creating the )o*boro account on the Server................................................... ...................... 3 $.$.# DC0M Settings............................................................ .............................................. ..................... ! $.$.#. 0n the 01C Server side............................................ .............................................. ............ ! $.$.#.$ 0n the 01C Client side................................................. .............................................. ........ 2 $.$.3 Alias files........................................... .............................................. .............................................. ... 2 $.$.! Start 01C I+0 5ate at system startu"............................................................. .......................... $ $.$./ 01C I+0 5ate ;og files............................................. .............................................. ...................... $ $. Creating a Control Database................................................................................. ............................... $$ $.. The Server T............................................... .........................................  . Re8uirements.............................................. Re8uirements.............................................. .............................................. .............................................. .  .. AIM=01C AIM=01C Server licensing......................................................... .............................................. ....  .$ Installation instructions........................................................ .............................................. ...................  .$. Installing the AIM=AT ?tilities............................................................. .......................................  . Initial A1I Admin configuration............................................................... ............................................ $ .. >e- AIMR<5.DAT file................................................. .............................................. .................... $ ( The )o*boro AIM=01C Server .$ on 9indo-s 1........................................ ......................................... ! (. Re8uirements.............................................. Re8uirements.............................................. .............................................. .............................................. . ! (.$ Installation instructions........................................................ .............................................. ................... ! (.$. Installing the AIM=AT ?tilities............................................................. ....................................... ! (. Initial A1I Admin configuration............................................................... ............................................ / (.( 1acage licensing.................................................... .............................................. .................................. 2 # AIM=istorian and the AIM 01C 01C I+0 5ate client........................................................ .............................. ( #. Setting u" the AIM=istorian .$......................................................... .............................................. . (

of 106 Page 3 of


3 )o*boro 01C I+0 5ate 6to T Server:.......................................................... .............. (# 3. Installing the
Page  of of 106


2.(. 4acu" )4M in redundant configuration............................................................. ................. /2 2.(.$ Master+Tracer Role s-itching in redundant configuration............................................. 2 2.# 01C Diagnostic Client............................................................ .............................................. .................. 2 2.#. Connecting the client to the )4M..................................................... ........................................ 2 2.#.$ Diagnostic vie-.............................................................. .............................................. .................. 2$ 2.#. ;og )iles..................................................... .............................................. ........................................ 2$ 2.#.( 01C 4ro-ser functionality.................................................................... ...................................... 2$ % Troubleshooting + )AE.............................................. .............................................. ..................................... 2( %. 5eneral ti"s for troubleshooting 01C............................................... .............................................. 2( %.$ ;ocal Clients connect but remote clients cant....................................................... ...................... 2# %.$. ?nable to add grou"s....................................................... .............................................. ........... 2# %.$.$ Tags in 01C clients sho- bad status, even though the blocs on the server are healthy in I+A:............................................... .............................................. .............................................. . 2# %.$. 9hile attem"ting connection: R1C server not found......................................................... 23 %. )o*boro 01C I+0 5ate....................................................................... .............................................. ... 23 %.. The I+0 5ate -indo-s stays em"ty....................................................................... .................. 23 %..$ 5et error message: FInterface not registeredF..................................................................... 23 %.. Registering the 01C1ro*y.dll....................................................... ............................................. 2! %..( CanGt get one of the configured items -or........................................................ ............................... 2! %..! 01C Items do not -or and grou" scan rate sho-s H% msec......................................... 2! %../ 01C I+0 5ate crashes after installing E)%%2%/........................................................ ....... 2! %..2 4locs in the 01C I+0 5ate a""ear, but slo-ly........................................................... ......... 2/ %..% 0nly read of 01C items "ossible, >o -ritesJ.............................................................. ....... 2/ %.. 9hen -riting 01C items, all o "acages at all in the list -hen trying to enter the license........................................ 2/ %.(. 01C Server does not start 6does not sho- in systray7....................................................... 22 %.(.( ot Su""orted.................................................................... ......... 22 %.(.# o Servers found -hen invoing A1IAdmin...................................................... ................ %% %.3 0nly read of 01C items "ossible, >o -ritesJ......................................................... ...................... %% %.! >et-or connection setting not available after installing 01C.............................................. %% %.!. >ot all items become active.................................................................... ............................... %% %.!.$ Analog values sho-n in the 01C I+0 5ate sho- H.%%%%................................................ %% %.!. Cannot start the 01C Server Configurator.............................................................. ........... % %.!.( Initial connection fails, retry al-ays -ors............................................................. ............ % %./ )DSI )4M K 01C Driver 69or In 1rogress7........................................................ ........................ % %./. ey... It doesnt -or.......................................................... .............................................. ....... % %./.. Chec the "ort configuration........................................................... ............................ % %./..$ Are the correct files do-nloaded....................................... ....................................... %$

of 106 Page ! of


%./.$ )4M >ot res"onding to commands, Rebooting the )4M............................................... %./. Diagnostic 4locs and "arameters............................................................................ ............ %./..
Page 6 of of 106

% %( %( %(


1 Introduction. 4ased on a true story this "iece of documentation -as intended to hel" setting u" a Foxboro OPC Server and+or Foxboro OPC I/O Gate Client in combination -ith each other or a third "arty 01C client or server. Please note that this is NOT an official Foxboro ocu!ent" neither is it meant to be a re"lacement of the official manuals that come -ith any of the "roducts described in here. This is a H8uic Ln dirty manual. 4ased on the authorGs "ersonal e*"erience -ith the "roducts in this document. The official documentation overrules the information contained here unless e*"licitly stated other-ise'7 I did not attem"t to invent anything more than the bare minimum myself -hich is -hy "arts of this document are e*tracted from any other resource available for both the AI#$OPC Server and the OPC I/O Gate 6The )o*boro 01C Client7 "roduct. )eel free to share this document as much as you do see fit. Remars, additions etc. are al-ays -elcomed.

1.1 isclai!er. Due to the inherently com"le* nature of com"uter soft-are and the fact that third "arty soft-are is involved, the author does not -arrant that the soft-are described in this document or this documentation is com"letely error free, -ill o"erate -ithout interru"tion, is com"atible -ith all e8ui"ment and soft-are configurations, or -ill other-ise meet your needs. Accordingly, this documentation is "rovided as'is, and you assume all riss associated -ith its use. The author maes no -arranties e*"ressed or im"lied, -ith res"ect to this document. In no event -ill the author be liable for indirect, incidental or conse8uential damages, including, -ithout limitation, loss of income, use, or information.

1.% Conventions. The conventions used in this document are listed belo-. &hen 'ou see this( It !eans this( [Filename] This ty"eface indicates a filename of -hich the contents are "rinted starting on the ne*t line. This line is >0T "art of the file contents. STATION# some command Te*t "rinted lie this is ASCII te*t as it a""ears in a file or on screen. ?ser data that has to be entered is "rinted in bold. Also used to dis"lay a "athname or filename in normal te*t. 9hen used to indicate a command, ty"e the bold "rinted command until NCRO -hich means to hit the <>T
Intro#u$tion% Page & of of 106


&hen 'ou see this(

It !eans this( Te*t dis"layed lie this means: "ress the eys mentioned bet-een bracets simultaneously. In this case "ress the HA;T ey on your eyboard together -ith the function'ey H)( Indicates a menu se8uence. ere it reads 1ress the Start button and on the ne*t menu select )unP

Start/)unP

1.* )evision histor' )evision nu!ber( Bersion %.$ Revision %. Revision %.(

escri+tion( 1reliminary learned more and -rote it do-n. ,+-raded to 0"en0ffice for doc maintentance. ;ost my -or Qust once too often -ith standard soft-are. Some additions to the manual Initial .% release 6sort off7 Ado"ted Invensys standards for Documents. Added feedbac from readers, ti"s and hints from Roel 0lieman and 4ram Marsman, thans guysJ ?"dates -ith 9indo-s 1 stuff Added AIM=istorian -ith 01C I+0 5ate collectors. Added AIM 01C on 9indo-s1. Roel 0lieman, 4ram Marsman and >iels 1eerdeman again "rovided much feedbac about their 01C <*"erience. Thans for thatJ Small changes to the eed to enlarge the AIM=istorian and AIM 01C I+0 5ate Client section. Added cha"ter about the )DSI 01C Driver for )4M$$ and )4M$. S"ecial thans to 4ram MarsmanJ

• • •

•

Revision .% Revision . Revision .$

• •

•

Revision .

•

•

Revision .(

•

•

Revision .#

•

•

•

Revision .3

•

Revision .!

•

1. )elated docu!ents. As far as the )o*boro "roducts are involved the related documentation is found here: The OPC I/O Gate( After installation some info is found aftrer installation on the A9!% under: D:\opt\diw\iogates\reference gide\inde!"t$ and: D:\opt\diw\iogates\opc\elp\O%& 'sers (ide"t$

Page ' of of 106 Intro#u$tion%


this in addition to the "rinted manual that comes -ith it. The OPC Server( A manual is "rovided -ith the "roduct: 000G rev A or higher -hich is also available in 1D) format. The AI#OPC Server version .$ is "rovided on the AIM=AT .$ CDR0M accom"anied by the documentation in 1D) format. Other brands( )or the other brand 01C "roducts "lease refer to the manuals "rovided.

1. Introducin- OPC. 01C is originally short for OLE for Process Control and version .% -as released in 223. During time the 0;< -as re"laced by Active and the current 01C version is $.%( for DA and .% for DA. 4oth the )o*boro 01C I+0 5ate and the AIM=01C Server com"ly to these DA standards. The )o*boro 01C I+0 5ate does >0T su""ort DA functionality.

1.2 A T3o ox A++roach. This manual deals -ith 6and I use Ale* ohnsonGs -ords7 a T3o ox  01C a""roach only. This means that the 01C Client and 01C Server both run on different 1CGs. I thought I had good reasons for that too. Although the su""ort de"artment -ill al-ay suggest to tae the One ox a""roach 6This is -hen both 01C Client en 01C Server reside in the same bo*7 this is not al-ays "ossible. The situations I have come across turned out to re8uire that the 01C Server be in one bo* and the Client in another. My advise -ould be: If you can "ut them both in one machine, "lease do so. It -ill save you the trouble of introducing the Client and Server to each other and as a bonus you can si" the entire "rocess related to Microsoft DC0M user accounts and the lies. Th is last bit can be a real "ain. o-ever: This manual deals -ith the T3o ox im"lementations only. Things tend to be a little harder to setu", -hich gives me a reason to maintain this manual and gives me something to do.

Intro#u$tion% Page ( of of 106


Page 10 of of 106 Intro#u$tion%


% The Foxboro OPC I/O Gate client 4to Foxboro AI#OPC Server5. This )o*boro solution for the 01C im"lementation on I+A Series is based on the )o*boro I+A !% Series Integrator -ith an additional I+0 5ate "roviding the 01C functionality. This I+A !% Series integrator A9 can, being "art of the I+A Series system, "rovides the 01C functionality to the rest of the I+A Series 9indo-s+?>I "latform. 0nce the 01C data is available on the A9!% Server it is available in the entire I+A Series system. Currently Invens's is develo"ing a hard-are solution for the 01C Client. This solution -ill be based on a fieldbus module -hich runs 9indo-s C< in R0M. This ne- 01C Client is coming available in I+A Series Bersion /.%.

%.1 )e6uire!ents. The basic re8uirements as described in the documentation su""lied -ith the 01C I+0 5ate: •

•

•

An I+A A9!% Integrator "rocessor version 3.$, !.% or higher 6>0T version /.%7. The Integrator function is currently not available on I+A Series Bersion /.%. A )o*boro 01C I+0 5ate 6E%%T7. An 01C Server to connect to -ould be nice.

This cha"ter is -ritten and verified using: 1roduct: OPC I/O Gate 1artnumber: 70*018T Bersion: *.0.1 Date 6?S7: 09/0%/%00% )or this e*am"le -e used an A9 01C Client -ith letterbug A9>T% connecting to an A9 01C Server -ith letterbug /A9%(. The 0STS table reflects this:



The Integrator is an A9!% -ith Control. The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 11 of of 106

Foxboro I/A Series OPC Solutions Installation, Configuration, Troubleshooting #***************************************************** # Start of I/A hosts # created Wed Jan 30 14:28:01 2002 #***************************************************** # # The foo!"n host entr"es !ere created $% the I/A # Soft!are Insta s&$'s%stem( An% add"t"ona entr"es # sho&d $e )aced o&ts"de the Start and nd de"m"ters( # 1+1(128(8(,+ AW-T01 ohost ocahost # #***************************************************** # nd of I/A hosts #***************************************************** 10(31(1.(22 AW-T01 10(31(1.(22, 81AW04 10(31(1.(22+ 81AW01

%.1.1 General hard3are and s'ste! soft3are. This "roduct re8uires a )o*boro I/A 70 Series integrator to function. 6this is the A9!% and A9!%C1 in SysDef de"ending on the I+A Series version7. Although it is not very -ell defined in any of the documentation, the Integrator function is a re8uirement. I+A Series soft-are version must be 3.$ or higher. Internet <*"lorer # or higher is recommended to vie- the online documentation.

%.1.% OPC I/O Gate licensin-. The OPC I/O Gate re8uires a license -hich is not "art of the shi"ment. The license ey must be obtained se"arately. )or a license instructions or form you may have a loo at: D:\opt\diw\iogates\opc\elp\O%& )icense"t$ on your A9!% after the I+0 5ate -as installed. ou -ill need at least the follo-ing information: The ?S order number 6also "laced on the documentation su""lied -ith the soft-are7. The
•

•

•

)or-ard this information according the instructions in the form or e'mail directly to dmartini@fo*boro.com. ou -ill receive "recise instructions about installing the license on your system.

%.% Installation. Some installation notes regarding the 01C I+0 5ate installation.

%.%.1 Installin- the OPC I/O Gate. The I+0 5ate is su""lied on a single CD'R0M containing the installation soft-are. After loading the CD in the CD'R0M drive you -ill get the screen as sho-n belo-:

Page 12 of of 106 The Foxboro OPC OPC I/O )ate $lient $lient *to *to Foxboro AI+OPC AI+OPC Serer-% Serer-%


)igure 01C I+0 5ate installShield -iard .

To install the gate clic Next : .The installation -ill tae a fe- seconds and -ill inform the user of a successful installation:

)igure $I+0 5ate is installed.

The I+0 5ate is no- installed on your I+A Station and can be started via the Start menu -ith: Start/Pro-ra!s/IOGates/OPC/OPCIOGate. The 5ate re8uires a license to o"erate. If you havenGt done so, obtain a license as this -ould be a great moment to get it in "lace. )ollo- the instructions that come -ith the license ey that you receive from )o*boro.

%.%.% CO# and Server side confi-uration. This is the tricy "art but lets give it a try any-ay.... 01C is based on Microsoft DC0M and Active technology. DC0M layer does not start -oring all by itself and thus needs some configuration. These are basic ste"s -e must go through to have at least a little chance things -ill start to -or:

The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 13 of of 106


. $. . (.

Register the 01C Server on the A9!% "latform 6Section: $.$. 7. Create the HFox  user account on the Server.6 Section: $.$.( 7. Set the DC0M security levels.6 Section: $.$.# 7. 0"tionally configure alias files if -e run into configuration constraints in the I+0 5ate side 6 Section: $.$.3 7. #. Setu" automatic startu" of the I+0 5ate after system startu" 6 Section: $.$.! 7. ;etGs start -ith the first one:

%.%.* )e-isterin- the OPC Server. 01C is a client+server based solution. )or the Client to be able to connect to a given Server, this Server must be no-n to that Client. This "rocess is no-n as Hregistering the Server. 6Remarks like “Is the server registered yet in my client” make you stand out in a crowd. ou seem to !e very “on to" of things” and "eo"le will listen to you !etter#$% 7. There are several levels of doing this and they range from HPiece of Cake  to H&here Is Einstein &hen ou 'eed (im) . The "rocedures are very de"endent on the manufacturer of the server+client. In this little e*am"le -e tae the )o*boro AIM 01C server. The "rocedure is some-here bet-een HCake and HEinstein so it -ill be fun. Since the I+0 5ate is no- in "lace and -e are able to start it, its time for a H *erver to !e registered .

$.$.. 0n the A9!% machine: Registering the Server. This "rocedure de"ends on the instructions "rovided -ith the 01C Server you are -oring -ith. In this e*am"le -e chose the Foxboro AI#$OPC Server -hich is installed on another host 6A9!% or 0))'1latform machine7 6ItGs no fun -hen it is on the same machine as the Client as registering is done automatically in that case7. )or the Foxboro AI#$OPC Server to Register on the Client side -e need the H registry key  from this server as it is found in the ServerGs 9indo-s registry. ou should "erform this "rocedure on the AIM 01C Server machine. )or the )o*boro 01C Server this H registry key  contains the letters H01C 6but this is not al-ays true for other brands though7 and the re8uired ey can be obtained using the re-edit "rogram. Invoe the re-edit "rogram from Start/)un; and ty"e regedit in the dialog:

)igure envoing regedit.

The resulting screen sho-s the )e-istr' ?C@ASS
Page 1 of of 106 The Foxboro OPC OPC I/O )ate $lient $lient *to *to Foxboro AI+OPC AI+OPC Serer-% Serer-%


)igure (The desired ey is in U<VC;ASS
And scroll do-n until you locate the AI#.OPC ey 6sho-n e*"anded here...7

)igure #;ocated the AIM.01C ey.

)rom the Menu choose )e-istr'/
)igure 3<*"ort ey to flo""y.

The name given in the screenshot is Qust an e*am"le. 0n the flo""y you no- have a registry ey 6ai$opcser*er"reg 7 -hich must be loaded on the 01C client machine. Close the re-edit a""lication and remove the disette from the drive. >ote: Sometimes co"ying the registry ey as described above does not -or. In that case it may be an idea to install the 01C Server soft-are on the machine -here the 01C Client is i nstalled. Sometimes additional D;; and other files are re8uired on that "latform. Installing the 01C Server

The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 1! of of 106


-ill solve those de"endencies automatically.

$.$..$ ;oading the 01C Server reg ey on the 01C client host. >e*t ste" is to tae the disette -ith the registration ey that -as Qust created on the 01C Server "latorm and tae that to the 01C Client machine and enter the registration ey there. This is done by inserting the disette in the drive of the A9!% and run a:\ai$opcser*er"reg in the run dialog as sho-n here: Start/)unP

)igure ! ;oading the registry file

After entering the data you -ill be informed of this:

)igure / Registry data entered successfully

At this "oint the 01C Server is Registered on the A9!% 01C Client 1C. >ote: 9hen you are -oring -ith an 01C Server from any brand and this does not solve the communication "roblems, choose the easy -ay and install the OPC *erver on the client machine . This -ill mae sure that all the re8uired D;; and e*ecutables re8uired to establish a lin bet-een the t-o are available on the 01C Client machine.

%.%. Creatin- the Foxboro account on the Server. )or DC0M to function "ro"erly the )o*boro standard user 6 +o, 7 must be available on the Server side so this account for the user FFox F must be added on the remote Server using the NT ,ser !ana-er. 6Start/Pro-ra!s/Ad!inistrative Tass 4Co!!on5/,ser #ana-er7. Choose ,ser/Ne3 ,ser from the menu bar and enter the data as in the e*am"le:



)igure 2 Setting u" the )o* account.

)ull name and descri"tion can differ from this but the ?sername HFox  must be ty"ed as in the e*am"le and the "ass-ord must be H-no!es 6-ithout the 8uotes7. The "ass-ord must never e*"ire.

%.%. CO# Settin-s. DC0M is the underlying "rotocol used by 01C to e*change the "rocess data bet-een the different systems. Since it re8uires interaction bet-een these systems things lie authentication and "rivileges must be configured accordingly. The tool to "erform this tas is the HCO# confi-urator. DC0M must be configured on both Client and Server side.

$.$.#. 0n the 01C Server side. Start the DC0M configurator from Start/)un... and enter dco!cnf- in the dialog: 9hen selecting O= this is the screen you get:

The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 1& of of 106


)igure % DC0M initial screen: A""lications tab.

If the default settings for the selected server do not result in a -oring setu" try matching the DC0M settings as indicated belo-. Select the efault Pro+erties TA4 and mae the modifications as indicated: The
•

•

Note for &indo3s %000 Fa!il' 4and +ossibl' BP hosts5( Setting the Default Im"ersonation to Anonymous may cause net-or and Dialu" connections "reviously defined are no longer visible. 9indo-s <*"lorer uses the Default Im"ersonation level settings to access these obQects. Anonymous access does not give the correct "rivileges to dis"lay these. See also Microsoft no-ledge base Article $!(3.

Page 1' of of 106 The Foxboro OPC OPC I/O )ate $lient $lient *to *to Foxboro AI+OPC AI+OPC Serer-% Serer-%


)igure DC0M: The Default 1ro"erties tab.

Select the efault Securit' tab and mae the modifications as indicated: )or the efault Access Per!issions section clic the
•

These ste"s should be sufficient to enable the )o*boro 01C Server to acce"t the )o*boro 01C Client.

$.$.#.$ 0n the 01C Client side. The DC0M settings for the 01C I+0 5ate are found in the documentation and come do-n to maing a fe- changes to the efault Pro+erties tab. efault Pro+erties tab Select the bo*:
•

•

%.%.2 Alias files. Since the I+0 5ate acts as an interface bet-een the Hreal -orld and the 6much older7 H)o*boro -orld -e can run into some constraints that ha""en to be a "art of our environment. ou should thin of these limitations -hen configuring the I+0 Control database: Port EC- EC-/0 1 //% "arameters2 SBRA11 "arameter 601C 1rogID string7 is limited to 2 chars. •

The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 1( of of 106


•

•

•

STADDR 6server I1 address or machine name string7 limited to 2 characters. 3evice EC- EC-455% "arameters2 I0MVID This name should be the same name as the ame. D
To alleviate this "roblem the 01C I+0 5ate "rovides the o"tion to use alias files that -ill alloavoiding such "roblems should they arise. These alias files are al-ays consulted during the retrieval of any 01C related communication and the files are located in the D:\opt\diw\iogates\opc\cfg\ directory. T-o files in here are of concern: aliasna$es"ini and opciogate"ini 9here opciogate"ini holds configuration info on the 01C version that -ill be used to translate any info stored in there bet-een )o*boro I+A and the outside -orld. aliasna$es"ini holds information related to the s"ecific 01C data such as: The Server aliases, The 5rou" aliases and last The 01C item aliases. •

•

•

The files have a ty"ical layout lie this: The opciogate"ini file e*am"le -here the 01C server from IC0>ICS is forced as a Bersion .% com"atible 01C Server: I-IS ers"onom)at"$""t% 5 1 6719S ers"onom)at"$""t% 5 1 6;I- 6;T=950 )igure $An e*am"le opciogate"ini file

The file -ill give you the o"tion to force the I+0 5ate to assume a version .% com"atible server -hen connecting to it. The default behavior is to assume version $.% and if that fails fall bac to version .%. Sometimes this a""roach fails and communication breas. In that case enter the server in this configuration file. The aliasna$es"ini file:


Foxboro I/A Series OPC Solutions Installation, Configuration, Troubleshooting S S6I- 5 ?S6"n@ 9 emote SererB CD9 5 ?Cm@(aeSerer0B ;E9 ITD S6ITD1 5 ?6"$ert%1(T1(F1B S6ITD2 5 ?6"$ert%1(T1(F2B )igure An e*am"le aliasna$es"ini file

This file serves as a translator bet-een items in the file on the left -hich are the )o*boro ICC com"atible ty"es and the items on the right that are the HReal -orld names. This is to overcome the incom"atibilities bet-een the t-o as indicated in the start of this cha"ter. The e*am"le above allo-s to use the 01C Server references RS;I> or M01C in your 01C Client Control Database 6in the
%.%. Start OPC I/O Gate at s'ste! startu+. The 01C I+0 5ate can be started from the Start menu found in 9indo-s but it -ould be better if it -ould be started in due time after the A9!% is fully on'line. A 9indo-s Hcmd scri"t is "rovided for this "ur"ose. )or the "rocedure to enable automatic startu" for the 01C I+0 5ate: An item must be added to the startu" grou". )ollo- these ste"s to mae the modification: . Select the Start menu button in the 9indo-s Tas 4ar. Then select Settin-s and Tasbar $. In the Tasbar Pro+erties dialog bo*, select Start #enu Pro-ra!s then select the Add button. . In the Create Shortcut dialog bo*, select the ro3se button. (. In the ro3se dialog bo*, locate the F D:\opt\diw\IO(ates\O%&\+in\O%&Start"c$d F file. Select the O%&start"c$d file so that its name a""ears in the File na!e( field then select the O+en button. #. Select Next in the Create Shortcut dialog bo*. 3. In the Select Pro-ra! Folder dialog bo*, locate and select the Startu+ folder. !. Select Next then Finish. After this the 01C I+0 5ate -ill be started automatically -hen the A9!% is running. 6This -ill not -or -hen the >T shell -as disabled at boot time7.

%.%.9 OPC I/O Gate @o- files. The communication can be hard to set u". Some hel" may be found i n the log files found in the system. 0ne "lace to loo may be the

%.* Creatin- a Control atabase. At this "oint a control database can be made. The ste"s include creating the
)igure ( 01C I+0 5ate u" and running

The Server


)igure #Internal affairs

So the first ste" to tae is create the
%.*.1 The Server R$ STA): This is the ServerGs I1 address or name as it is in the Hhosts table. SE)APP: The 01C a""lication name as found in the Registry ey or alias file. •

•

•

$ R re8uires E)%%2%/ or 9indo-s 1 to be installed on the 01C I+0 5ate integrator A9.  Aliases for are set for the I+0 5ate is set in the a""ro"riate configuration file. D:\opt\diw\iogates\opc\cfg\aliasna$es"ini . The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 23 of of 106


)igure 3An e*am"le of
)orce a chec"oint and after this -e should be able to see the
%.*.% Creatin- the Grou+
•

•

Page 2 of of 106 The Foxboro OPC OPC I/O )ate $lient $lient *to *to Foxboro AI+OPC AI+OPC Serer-% Serer-%


)igure !An
)ollo-ing this logic -e can create
)igure /All re8uired
The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 2! of of 106


9hen the 01C I+0 5ate "rocess is u" and running, -e must be able to get A;;
)igure 2
Similar blocs can be built for the four ty"es of I+0 -e -ere dealing -ith. After -e have done this, it is time to start the 01C I+0 5ate a""lication I 6if it is not already running that is7. The "icture belo- -ill sho- you the initial screen of the 01C I+0 5ate in action.

)igure $%I0 gate -indo- initial state, no Servers found yet.

After some time 6and this can be u" to one minute, so be "atient7, the 01C Server -ill sho- in Page 26 of of 106 The Foxboro OPC OPC I/O )ate $lient $lient *to *to Foxboro AI+OPC AI+OPC Serer-% Serer-%


the tree -hen it -as found.

)igure $AIM.01C Server -as contacted successfully

1lease note that for this to ha""en, there must be a "ath 68uite "hysical actually7 from the 01C Client to the 01C Server machine.

The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 2& of of 106


)igure $$ All
9hen you "ut the ;I>< state, they should also 6a"art from being -hite in the System Monitor7 sho- u" in the tree on the 01C I+0 5ate -indo-.

)igure $9hen
ou are no- ready to "roceed -ith your Control Database. These )'blocs are e*"lained in detail

Page 2' of of 106 The Foxboro OPC OPC I/O )ate $lient $lient *to *to Foxboro AI+OPC AI+OPC Serer-% Serer-%


in the on'line manuals after installing the 01C I+0 5ate a""lication. Refer to the beginning of this cha"ter on -here to find it.

The Foxboro OPC I/O )ate $lient *to Foxboro AI+OPC Serer-% Page 2( of of 106




* The Foxboro AI#$OPC Server on &indo3s NT. The AI#$OPC Server is the a""lication that "rovides the )o*boro 01C Server im"lementation. The name may give the im"ression that AIM=AT must be "resent on the system but this is not the case. Some tools as found on the AIM=AT installation CD are ho-ever re8uired to allo- setu" and im"lementation of this 01C Server. The AIM=01C Server is fully 01C DA .%a and $.%.( com"liant and fully com"liant -ith the 01C DA version .% standard.

*.1 )e6uire!ents. The hard' and soft-are re8uirements for the 01C Server as indicated in the accom"anying documents: A 1entium Class "rocessor, Recommended #%%M or higher. 9indo-s >T (.% S1# or higher, 9indo-s $%%% S1$ for the off'"latform server. $/Mb of RAM $#Mb dis s"ace. •

•

•

•

Additional re8uirement >0T in the manual: Internet <*"lorer #.% or higher for HM; su""ort re8uired by 01C Server. •

Reference Documents: The I/A Series AI#$AT OPC Server ,sers Guide  000G. AI#$API ,sers Guide  01D*>N. AI#$AT Installation Guide  01D*>#. •

•

•

*.1.1 AI#$OPC Server licensin-. The 01C Server is a "roduct that re8uires licensing from Invensys. The license is >0T shi""ed -ith the "roduct but must be ac8uired later. ;icensing involves the systemGs H hostid  -hich can be generated on the actual system after the I+A or A1I admin utility installation. This is the main reason -e -ant some of the AIM=AT utilities installed on the system -here the 01C Server -ill reside. This a""lies for both 0>' and 0)) "latform configurations. Data re8uired for licensing: The 8ostid of the station -here AIM=01C is installed. The Ty"e of 01C Server desired: A for ata Access only 8A version -hich su""orts 8istorical ata Access in addition to DA. •

•

*.% Installation instructions. To obtain the hostid for this station you are setting u" it is best to install the AIM=AT utilities from the AIM=AT cd 'rom. )or this e*am"le I have chosen version . of this CD.

*.%.1 Installin- the AI#$AT ,tilities. In order to allo- convenient configuration of the AIM=01C Server it i s best to install the AIM=AT The Foxboro AI+.OPC Serer on in#os T% Page 31 of of 106


?tilities and AIM=istorian from the AIM=AT installation CD'R0M. To install these utilities insert the CD'R0M in the drive and run the setu" "rogram on the CD. It may be best to install the AIM=AT suite com"letely not to miss anything. The utilities are the only thing -e -ill be using but they may re8uire more than the obvious to function.

*.* Initial API Ad!in confi-uration. If this is the first time you installed an AIM= "roduct on your system, some initial configuration -or needs to be done. This consists of e*ecuting the ste"s outlined ne*t. Start the APIAd!in tool from Start/Pro-ra!s/AI#$AT/API Ad!in. ou -ill be "rom"ted for a Server 6in a dro" do-n bo*7 and if no server is listed you -ill have to configure one. )or that clic on the button the reads
)igure $(Admin tool dialog

Create a Server alias 6
*.*.1 Ne3 AI#)

)igure $#Admin tool dialog

Assuming a Server must be created -e choose
)igure $3Create a Server connection

After com"letion of this ste" you must e*it the APIAd!in "rogram and re'o"en it. In the dro" do-n bo* 6Server7 you no- should have an entry for the A9 that -as Qust configured.

The Foxboro AI+.OPC Serer on in#os T% Page 33 of of 106


)igure $!;ogin to the a"i admin tool

)igure $/A successful connection

In the e*am"le above an 7uthori8ation code -as entered for the OPCAO "acage. A user W!achine na!eH must be added and this is sho-n here:69he PC was named 047&5: in this e,am"le7.

Page 3 of of 106 The Foxboro AI+.OPC Serer on on in#os T% T%


)igure $2Adding the Machine name as user

1ress Add -hen the name -as com"leted -hich -ill bring you this result:

)igure %Machine /a-%( is no- added as user

A note for OFF Platfor! OPC Server installations( The Machine name of the OPC *erver 1C M?ST be added as a ;ser name on the I+A station that -ill accommodate the AIMA1I lin into the I+A Series system. >ote that only A1s and A9s are su""orted AIMA1I hosts -ithin I+A Series systems. •

The Foxboro AI+.OPC Serer on in#os T% Page 3! of of 106

Foxboro I/A Series OPC Solutions Installation, Configuration, Troubleshooting •

•

If you are using an I/A 0 Series machine to communicate -ith the 01C Server you must add the 01C ServerGs hostname as an AIMA1I user on the I+A #% Series station using the a+iad!in utility on that station. ou must then get an 01C license for the ?>I machine as this is -here the access to the I+A Series system is "rovided. Mae sure that on the 01C Server side the AIMA1I configuration sho-s the "ath to the ?>I machine. This ?>I machine -ill hold the license information for your 01C Server a""lication.

A ty"ical e*am"le -ith t-o machines -here: A9RD% is a 9indo-s >T 1C -ith 01CDA installed and A9#RD is an A9#4 -here the 01C Server is communicating -ith i.e. 9here AIMA1I is configured. Assigning the soft-are: To assign the soft-are installed to the s"ecific users select the +aca-es tab, add the "acages: AI#$API and OPCA 6or OPC8A5 as sho-n and assign them to the ne-ly created user account 6machine name7: •

•

)igure  Assigned "acages to this ne- user 6machine name7

9hen you scroll do-n you must have a chec mar ne*t to the OPCA or OPC8A "acages. Do not select them both, I have seen strange behavior -hen you do that.

Page 36 of of 106 The Foxboro AI+.OPC Serer on on in#os T% T%


 The Foxboro AI#$OPC Server *.% on &indo3s BP. The AI#$OPC Server is the a""lication that "rovides the )o*boro 01C Server im"lementation. ou do not need the AIM=AT istorian installed on your system. Some tools as found on the AIM=AT installation CD are ho-ever re8uired to allo- setu" and im"lementation of this 01C Server. The AIM=01C Server is fully 01C DA .%a and $.%.( com"liant and fully com"liant -ith the 01C DA version .% standard.

.1 )e6uire!ents. The hard' and soft-are re8uirements for the 01C Server as indicated in the accom"anying documents: A 1entium Class "rocessor, Recommended #%%M or higher. 9indo-s 1 S1 or higher, 9indo-s >T (.%S1# or higher, o"tionally 9indo-s $%%% S1$ for the off'"latform server. $/Mb of RAM $#Mb dis s"ace. •

•

•

•

The setu" used in this cha"ter: A 1entium III 5 based "rocessor. 9indo-s 1 S1. AIM=AT ?tilities version .$. AIM=01C Server version .$. •

•

•

•

The 01C Server is a "roduct that re8uires licensing from Invens's. The license is >0T shi""ed -ith the "roduct but must be ac8uired later. ;icensing involves the systemGs Hhostid  -hich can be generated on the actual system after the I+A or A1I admin utility installation. This is the main reason -e -ant some of the AIM=AT utilities installed on the system -here the 01C Server -ill reside. This a""lies for both 0>' and 0)) "latform configurations. Data re8uired for licensing: The 8ostid of the station -here AIM=01C is installed. The Ty"e of 01C Server desired: OPCA for ata Access only OPC8A version -hich su""orts 8istorical ata Access in addition to DA. •

•

.% Installation instructions. To obtain the hostid for this station you are setting u" you -ill need to install the A IM=AT utilities from the AIM=AT cd 'rom. )or this e*am"le -e chose version .$ of this CD.

.%.1 Installin- the AI#$AT ,tilities. In order to allo- convenient configuration of the AIM=01C Server it i s best to install the AIM=AT ?tilities and AIM=istorian from the AIM=AT installation CD'R0M.

The Foxboro AI+.OPC Serer 3%2 on in#os P% Page 3& of of 106


To install these utilities insert the CD'R0M in the drive and run the setu" "rogram on de CD. It may be best to install the AIM=AT suite com"letely not to miss anything. The utilities are the only thing -e -ill be using but they re8uire more than the obvious.

.* Initial API Ad!in confi-uration. If this is the first time you installed an AIM= "roduct on your system, some initial configuration -or needs to be done. This consists of e*ecuting the ste"s outlined ne*t. Start the APIAd!in tool from Start/Pro-ra!s/AI#$AT/API Ad!in. ou -ill be "rom"ted for a Server 6in a dro" do-n bo*7 and if no server is listed you -ill have to configure one. )or that clic on the button the reads
)igure $Admin tool dialog

Create a Server alias 6
Page 3' of of 106 The Foxboro AI+.OPC AI+.OPC Serer Serer 3%2 on on in#os P%


)igure Create a Server connection

After com"letion of this ste" you must e*it the APIAd!in "rogram and re'o"en it. In the dro" do-n bo* 6Server7 you no- should have an entry for the A9 that -as Qust configured. 9hen connection for the first time you -ill be "rom"ted to set the "ass-ord for this server. The ne*t time you connect you -ill get a dialog as sho-n here:

)igure (;ogin to the a"i admin tool

. Paca-e licensin-. The APIAd!in tool is mainly used to enter the licenses for your a""lications in addition to setting the "ro"er user accounts and "rivileges. There is some -or for you here as -ell.

The Foxboro AI+.OPC Serer 3%2 on in#os P% Page 3( of of 106


)igure #A successful connection

In the e*am"le above an 7uthori8ation code -as entered for the OPCAO "acage. A user W!achine na!eH must be added and this is sho-n here:69he PC was named 047&5: in this e,am"le7

)igure 3Adding the Machine name as user

1ress Add -hen the name -as com"leted -hich -ill bring you this result:

Page 0 of of 106 The Foxboro AI+.OPC AI+.OPC Serer Serer 3%2 on on in#os P%


)igure !Machine /a-%( is no- added as user

A note for 0)) 1latform 01C Server installations: The Machine name of the OPC *erver 1C M?ST be added as a ;ser name on the I+A station that -ill accommodate the AIMA1I lin into the I+A Series system. >ote that only A1s and A9s are su""orted AIMA1I hosts -ithin I+A Series systems. If you are using an I/A 0 Series machine to communicate -ith the 01C Server you must add the 01C ServerGs hostname as an AIMA1I user on the I+A #% Series station using the a+iad!in utility on that station. ou must then get an 01C license for the ?>I machine as this is -here the access to the I+A Series system is "rovided. Mae sure that on the 01C Server side the AIMA 1I configuration sho-s the "ath to the ?>I machine. This ?>I machine -ill hold the license information for your 01 C Server a""lication. •

•

•

A ty"ical e*am"le -ith t-o machines -here: A&)01 is the 9indo-s 1 1C -ith 01CDA in stalled and A&1) is an A9#4 -here the 01CServer is communicating -ith i.e. 9here AIMA1I in configured. Assigning the soft-are: To assign the soft-are installed to the s"ecific users select the +aca-es tab, add the "acages: AI#$API and OPCA 6or OPC8A5 as sho-n and assign them to the ne-ly created user account 6machine name7: •

•

The Foxboro AI+.OPC Serer 3%2 on in#os P% Page 1 of of 106


)igure / Assigned "acages to this ne- user 6machine name7

9hen you scroll do-n you must have a chec mar ne*t to the OPCA or OPC8A "acages.

Page 2 of of 106 The Foxboro AI+.OPC AI+.OPC Serer Serer 3%2 on on in#os P%


 AI#$8istorian and the AI# OPC I/O Gate client. This sections e*"lains 6or at least tries to e*"lain7 ho- to setu" the AIM=istorian -ith remote collectors and interfacing -ith 01C Servers from a third "arty through the 01C I+0 5ate client. NOT<( This cha+ter deals 3ith an OFF P@ATFO)# AI#$8istorian setu+ 3ith )e!ote Collectors and the AI#$OPC I/O Gate. In this setu" -e assume an 0ff'"latform AIM= istorian although the setu" on this side is no different from the standard. The AIM=01C client -ill be installed on another 1C "latform -here -e -ill setu" both the 01C I+0 5ate and the remote collector 6the mandatory installation7. This cha"ter -as -ritten based on a s"ecific customer site installation. The 9indo-s "latform -as 9indo-s $%%% Server for both the AIM=istorian and the remote collectors+01C I+0 5ate soft-are. 9e start -ith the AIM istorian "latform first

.1 Settin- u+ the AI#$8istorian AI#$8istorian *.%. ere -e follo- the standard "rocedure of installing AIM=istorian.

)igure 2Run setu" from the CD...

ou -ill see the standard dialog to acce"t the license etc. The "acage -ill be installed in the 1rogram )iles folder by default. Mae other choices if you need to. In order to install AIM= AI M= istorian -e need to install at least the istorian 6duh7 and the AIM=?tilities.

AI+.istorian AI+.isto rian an# OPC I/O )ate $lient% Page 3 of of 106 AI+.istorian an# the AI+ OPC )ate $lient%


)igure (%Select AIM=istorian and ?tilities

Page  of of 106 AI+.istorian AI+.istor ian an# the AI+ OPC OPC I/O )ate )ate $lient% AI+.istorian


2 Foxboro OPC I/O Gate 4to
2.1 Introduction. Maing the I based I+A Series system. The 01C station is A9!%%$ in this e*am"le is of course a ne-ly introduced >T based station in that ?>I environment. A T 01C Server on a remote location 60ff'shore in this "articular case7. The
•

The customer "rovided us the CD'R0M that contained contained the 01C Server soft-are that -ould -ould enable us to install the 01C Server soft-are 6or "arts of it7 on the )o*boro machine. In this e*am"le I have taen taen the Hsim"le a""roach a""roach to run Hsetu" and see -here -here that taes us.

2.% Prere6uisites. 4efore you continue -ith this "rocedure the 01C client must be setu" Has good as "ossible -hich re8uires some actions to be taen. Taing a good loo at the )o*boro 01C client documentation documentation is a very good start. Mae sure that all the ste"s as mentioned in the )o*boro 01C Client documentation documentation are follo-ed "rior to follo-ing this "rocedure. In short this includes at least the follo-ing:0n the )o*boro 01C client: Install the
•

•

2.%.1 Actions on the
•

Added the user Fox -ith -ith -no!es as -no!es as the "ass-ord 6as sho-n in user documentation for the 01C I+0 5ate7 Added the Fox user user to the users th at -ould be allo-ed to access and launch the CI1 >T Server a""lication. 6Qust follo- the documentation o this7.

Foxboro OPC I/O )ate *to 45erson PO7O OPC Serer-% Page ! of of 106


AdQust the CO# settings on the Server according the suggestion in the )o*boro doc and set default security to anon'!ous and default Im"ersonation to none decided to ADD the )o* account to the list of Hallo-ed users on the 0T<: IGm not sure that all the ste"s are re8uired to get the client to connect to the 0T re8uired and in the end it -ill "rove that co"ying one or t-o D;; files -ill do the tric bu until then let us enQoy the sho-. •

2.* Installin- the
)igure (Read the readme file no-

Clic No to go on if you no- -hat you are doing. 9hen you select No you "roceed to the ne*t screen.

Page 6 of of 106 Foxboro OPC I/O I/O )ate )ate *to 45erson 45erson PO7O PO7O OPC OPC Serer-% Serer-%


)igure ($Start the installation...

Start the installation by selecting Next. Chose the defaults -here a""licable 6see belo-7:

)igure (Choose the location for the 01C Server

Choose Next to continueP

Foxboro OPC I/O )ate *to 45erson PO7O OPC Serer-% Page & of of 106


)igure ((Revie- your selection and "ress the Next: button.

Continue -ith Next to resume the installation: >e*t -e -ill choose the o"tion as sho-n in the dialog and -e choose to install the client:

)igure (#Select Client -ith Remote Server for this setu"

ou -ill be "rom"ted a se*y looing D0S bo* -here the 01C server to co nnect to must be s"ecified. This is the name as found in the FhostsF table and this is the Hnet-or name of the remote machine. In the e*am"le the remote 01C Server -as HCI1)#.

Page ' of of 106 Foxboro OPC I/O I/O )ate )ate *to 45erson 45erson PO7O PO7O OPC OPC Serer-% Serer-%


)igure (3
After entering the correct name "ress <>T
)igure (!01C Server installation com"leted.

This concludes the 01C Server+client setu" for this A9 and the )o*boro 01C Client re8uires a reboot no-. After the reboot you should be able 6mae sure the I+0 5ate is running7 to get the configured
Foxboro OPC I/O )ate *to 45erson PO7O OPC Serer-% Page ( of of 106


Page !0 of of 106 Foxboro OPC I/O I/O )ate )ate *to 45erson 45erson PO7O PO7O OPC OPC Serer-% Serer-%


 8one'3ell/#easurex OPC Server 4to Foxboro OPC I/O Gate5. An 01C Server -e encountered at a "a"er "lant and a glass-ool insulation "lant. T he 01C connection -as used to establish a real time data collection lin bet-een Foxboro I/A Series and the 8one'3ell/#easurex system. The 01C Server found on both sites is the 8#B )ae Server. A name that -ill encounter more than once in this cha"ter.

.1 Confi-uration ste+s on the 8#B )aeServer OPC Server. This is some info ho- to allo- the M Rae Server to interact -ith the )o*boro 01C I+0 5ate client. Some im"ortant ste"s as usual: . The I+A Series account should be introduced on the 01C Server: )o*+gnomes, not e*"iring yada yada. $. 9e must go through the DC0M settings for the 01C Server. Some screenshots are "rovided that ho"efully "rovide some additional information. 9e have found that the 8#B )aeServer does not use the default DC0M settings but instead uses its o-n settings. Thus the default settings -hich are sho-n here are >0T used by the 01C Server:

0nce again: The H
one8ell/+easurex OPC Serer *to Foxboro OPC I/O )ate-% Page !1 of of 106


)igure (/Available "rotocols for DC0M

To set the DC0M "ro"erties for the 01C Server -e must select this a""lication from the list:

)igure (2Select the M 01C Server to change DC0M settings

9hen you select H"ro"erties here, you -ill get a screen as sho-n ne*t: )or Authentication @evel choose HConnect:

Page !2 of of 106 one8ell/+easurex OPC Serer Serer *to *to Foxboro OPC OPC I/O I/O )ate-% )ate-%


)igure #%Select Conect as the Authentication ;evel

The ne*t ste" it to define -here the a""lication is run. In the @ocation tab select to )un the a++lication on this co!+uter:

)igure #Run on this com"uter

>ote: This differs from the default setting for this serverJ The ne*t tab is the Securit' tab -here -e must select the security settings. Mae sure that the user Fox is added to the list of users that are allo-ed to Access and @aunch the 01C Server a""lication. one8ell/+easurex OPC Serer *to Foxboro OPC I/O )ate-% Page !3 of of 106


)igure #$Add the user )o* to the Acces 1ermission list

After a##ing the Fox a$$ount to the AccessPermission tab, the LaunchPermissions 5ust hae the sa5e a$$ount9 a## the user Fox to the Launching users as shon belo9

)igure #Add )o* to the ;aunching users

After all these 5o#ifi$ations the OPC Serer 5a$hine 5ust be reboote#%

Page ! of of 106 one8ell/+easurex OPC Serer Serer *to *to Foxboro OPC OPC I/O I/O )ate-% )ate-%


.% Confi-uration ste+s on the OPC Client 4A&05 After successful installation of the OPC I/O Gate "acage, it is time to configure the different layers in the system. This includes: . >et-oring configuration. $. DC0M settings. . 01C Server registration. (. 01C Client setu" o"tions. 9e have created an 6in this case o"tional7 alias for the 01C Server name since this name is rather long. These aliasses are set+found in the a"asnames(cf file as found in the directory : d:\opt\diw\iogates\opc\cfg\. The first field is the 01C Server name that you set in the
< the letter “O” not the number zero “0”

As a result the
.* Introducin- the 8#B )aeServer on the A&0. These ste"s "rovide the necessary info to "ro"erly configure the 01C Server on our A9!% -here the 01C Client runs. This maes sure that all D;;s and su""ort files for the 01C connection to the 6remote7 server are correctly installed on the client side. 0n the install media 6at least that I had7 there are some files and notes that are s"ecific for this install. A short list of the files that I received from 8one'3ell/#easurex 4usually these files are "rovided on disette -ith some instruction ho- to "ut everything in "lace7: opcco$n_ps"dll opcen$"e!e opcpro!6"dll O%&Ser*er"dll O%&Ser*er"e!e 4this one !a' not be on 'our set5 OpcSer*er"eg register",at

The 8one'3ell/#easurex server taes these ste"s to "ro"erly configure the Server on our A9!% "latform. 6thans Measure* for the assistance7: In this e*am"le -e choose to install the re8uired files on the D: drive in the system. The directory -ill be D:\$!\rae\,in . . Create a directory D:\$!\rae\,in on the A9!%s D: drive. $. ave all files listed above available on the A9!% and co"y them to the location you have Qust created one8ell/+easurex OPC Serer *to Foxboro OPC I/O )ate-% Page !! of of 106


. )rom this location, run the Hregister",at  "rogram -hich -ill register some D;;Gs and register the 01C server on the A9!%. (. Bia the >T Control 1anel add a variable $!root -ith the value d:\$! . #. In DC0M 6-ith Start/)un.../dco!cnf-7 set the default "ro"erties to efault Autentication @evel 4None5J efault I!+ersonation @evel Anon'!ousJ as sho-n belo-:

3. Create an R STA) The 01C Servers I1 address or hostname from the 9indo-s Hhosts file. 2$.3/.$.% or MRote that this is the 01C 5rou" name that -ill be created for you in the server s"ace. %. Chec"oint the database and o"en System Management. . 9hen the Client and Server are connected you should be able to get the

one8ell/+easurex OPC Serer *to Foxboro OPC I/O )ate-% Page !& of of 106


Page !' of of 106 one8ell/+easurex OPC Serer Serer *to *to Foxboro OPC OPC I/O I/O )ate-% )ate-%


9 A rtdb OPC Client 4to Foxboro AI#$OPC Server5. Connecting the A44 01C Client to the )o*boro AIM01C server.

9.1 Introduction. Setting u" an 01C lin bet-een the A44 RTD4 01C Client and the )o*boro AIM01C Server. The 01C Server tested -as version .$.%.! The A44 RTD4 01C Client -as version $.

9.% )e6uire!ents. This e*am"le assumes that the )o*boro 01C Server -as installed and configured correctly -ith the default as set forth in cha"ter  The )o*boro AIM=01C Server on 9indo-s >T. Modifications to these default are noted here -hen a""licable.

9.* To doKs on the Server. Some things you must better al-ays do on the 01C Server.

9.*.1 Create the user account. The user account by -hich the A44 Client -ill connect must be added to the 01C Server. This is a normal 9indo-s Administrative tas and the account must be added -ith the 9indo-s Huser manager a""lication. 9e have found that this user must be a member of the Administrator grou".

9.*.% CO# Settin-s( 0h yes, the DC0M settings. 9e can leave some security in "lace if -e -ant to... 0"en the dco!cnf- a""lication and mae these modifications: efault Authentication: None efault I!+ersonation @evel: Identif' and mae sure that the 01C Server uses these defaultsJ ?nder the 3efault *ecurity ta! add the 01C enter the 01C Client user to the 3efault 7ccess Permissions and 3efault Launch Permission dialoges. ou must select Add/Sho3 ,sers to allo- see the users configured.

9. To doKs on the Client. The 01C Client re8uires only the AIM01C registry ey to find the Server correctly. There are no no-n other issues on the A44 Client side.

A:: rt#b OPC Client *to Foxboro AI+.OPC Serer-% Page !( of of 106


Page 60 of of 106 A:: A:: rt#b OPC OPC Client *to Foxboro AI+.OPC Serer-%


D The Foxboro FSI OPC river for F#%*% and F#%**. 9ith I+A version /.% )o*boro has develo"ed a ne- conce"t of integrating devices into the I+A series system. This ne- -ay of integration is referred to as H)DSI, short for H)oreign Device System Integrator. Instead of using a module on the C1'level as integrator 65ate-ays and )D' Integrators7, a set of four $%%'series )4Ms have been introduced 6)4M$%+$+$$+$7 that can be used in four -ays of connecting to foreign devices: Serial Single, Serial Redundant,
D.1 &hat 'ou should no3. The reader of this cha"ter should be generally familiar -ith the I+A Series system, "referably -ith I+A /.%, although this is not critical. Terms lie Com"ound, 4loc, 6)7C1,
D.% )elated docu!ents. . )o*Doc /.% 4%!%%4: )DSI Driver X 01C Clients user guide $. )o*Doc /.% 4%/%%A: )ield Device System Integrators 6)4M$%+$+$$+$7 ?sers 5uide

D.* General infor!ation about the OPC FSI F#. D.*.1 )e6uire!ents. The basic re8uirements to get the )DSI'01C )4M -oring: •

•

•

•

•

An I+A /.% 6or higher7 system -ith at least  W)YZC1$!% and at least  )4M$$ or  or $ )4M$ The 01C I+0 Driver 6)DSI Drivers are not installed on a default I+A installation7 The )DSI Configurator Soft-are. An 01C Server -ith 01C Items to connect to. >et-or e8ui"ment to connect the )4M6s7 and server6s7, lie ?T1'cables and ubs+S-itches.

Also recommended is: The )DSI 01C Diagnostic Client tool. •

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page 61 of of 106


D.*.% ifference bet3een the Sin-le and )edundant F#. The )4M and the drivers have been develo"ed in such a -ay that using a single or redundant )4M does not re8uire any more or less configuration effort or different soft-are. The only im"ortant difference is the
D.*.* ifference 3ith other %00Lseries F#Ks The design and im"lementation of the )DSI )4M is significantly different from the ard-ired'I0 )4Ms, different enough to mention it here in order to avoid -rong e*"ectations and more im"ortant, -rong assum"tions and conclusions during o"eration. The )DSI runs 9indo-s C< as o"erating system and contains several layers of soft-are to bring the foreign data into the I+A C:4'environment. 4ecause of the fle*ibility of the drivers and the H1C'lie nature of the )4M, it is more com"le* than ard-ired'I+0 )4Ms and needs more configuration than Qust an
D.*. @i!itations •

•

•

•

The 01C Client Driver does not su""ort 01C .% Servers In contrast to the 01C I+0 5ate, a single )4M 01C Client can connect to only  server at a time. The t-o )4Ms in a redundant setu" can connect to t-o different I1'adresses, but the server'soft-are must be the same as -ell as all "oints in that server. The )4M can handle a ma*imum of $%%% 01C items. 01C Array data ty"es are not su""orted

Page 62 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


D. Ste+ b' Ste+ +rocedure( )edundant OPC F# to #atrion Si!ulation Server This cha"ter -ill go through the ste"s to get a redundant )4M'"air connected to a Matrion Simulation Server. As mentioned before, the configuration bet-een a single )4M or a redundant "air is not very different and configuring a )4M$$ by using this guide should be no "roblem. 9here necessary, the differences -ill be e*"lained. It is assumed that an I+A system is running -ith at least  C1$!% and that this C1 is connected to a base"late -ith a )4M$ "air 6or single )4M$$7. It is also assumed that a 1C is available -ith the Matrion Simulation Server installed. 6)ree do-nload from the Matrion 9ebsite, ---.matrion.com.7 Connecting the )4M6s7 to the server using )T1 cables and a hub+s-itch or a cross'?T1'cable should also "ose no "roblems and is not discussed in this document. The C1s letterbug in this e*am"le is 013$%%, the )4M is 013$%A. 6A single )4M -ould be called 013$%7 The )4M6s7 should be "lugged into their base"late and both the red and green leds should light u" after a -hile. 60ffline7

D..1 The FSI Confi-uration tool. 2.(.. 1ur"ose of the )DSI Configuration tool. >ormally, the "ro"erties of a )4M that are configurable by the user can be set on the bloc that is associated -ith the )4M, being the
The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page 63 of of 106


2.(..$ Installing the )DSI Configuration tool. The tool can be installed on any -indo-s'1 machine, it is not necessary to do this on a 6the7 A9, ho-ever this is sometimes convenient because this saves you from having to co"y the created files to the A9. The tool comes on CD and can be installed using the normal -indo-s setu" "rocedure, using setu".e*e. The configurator needs the Microsoft .>
)igure #( Installing .>
Page 6 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


)igure ## Al-ays agree -ith MS

)igure #3 Installing the )DSI configurator itself

)igure #! Select a installation dire ctory. ou might -ant to change the defaultJJ

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page 6! of of 106


)igure #/Start menu folder selection

)igure #2Almost done

)igure 3%Restart your 1C 6or A9 through )o*Bie-7

Page 66 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


D..% Installin- the FSI OPC OPC Client driver. The )DSI 01C Driver com"rises a set of e*ecutables and dlls that should, eventually, end u" in the )4M. The 01C driver files normally come "aced as a single file called H01C.i"h that should be "laced on the A9 host of the C1 -here the )4M is connected to. The directory is H+usr+fo*+s"+files+devices, and this directory is used for all other configuration files associated -ith the )4M. De"ending on ho- the driver -as shi""ed to you, it should al-ays end u" as file -ith the e*tension H.i"h and should be "laced in the mentioned directory. The official CD'R0M containing the driver installation soft-are should be installed on the host' A9 and -ill "lace the driver, some e*am"le files and user documentation in the correct directories for you . After loading the CD in the CD'R0M drive 6and "ossibly clicing setu".e*e7 you -ill get the screen as sho-n belo-:

)igure 3)DSI 01C Driver installShield -iard .

To install the driver clic Next : t-ice and eventually a dialog -ill inform the user of a successful installation.

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page 6& of of 106


)igure 3Installation finished )igure 3$Directory information

The 01C Driver is no- installed on your I+A A9 Station. ;ater in this document it is e*"lained ho- to load the driver in the )4M.

D..* Confi-uration needed on the server side. The configuration of the server can be difficult. 0ften, finding the right DC0M'settings to allothe client access to the 01C server can tae a -hile. DC0M also tends to cache acce"ted clients, so some changes that -ere needed to get access suddenly mae no difference once the connection is succeeded. In this e*am"le, -e focus on the )4M, so -e chose the easiest -ay to get the connection running. In this e*am"le, -e used the Matrion Simulation Server. It -as installed on an A9!% 69indo-s 1 -ith S17. The )DSI 01C ?sers guide reccommends these DC0M settings on the server: Default Authentication level : >one Default Im"ersonation level : Identify

In my setu", I used:

61lease refer to the other Server'Setu" cha"ters in this document to find screenshots and detailed information -here these settings should be made 6dcomcnfg77

Default Authentication level : >one Default Im"ersonation level : Anonymous )urther more, I added H

Simulation Server.

D.. The Port Confi-uration File. 2.(.(. 9hat is the "ort configuration The "ort configuration file defines the basic connection settings, lie I1'addresses, 01C Server name etc. It does not have anything to do -ith the o"c'items, this is solely a matter for the device'
2.(.(.$ Creating a 1ort Configuration file. Start the )DSI configurator. The first dialog -ill be:

)igure 3()DSI Configurator

Clic H>e-.

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page 6( of of 106


)igure 3#Config )ile Ty"e selection

This dialog needs you to select -hich configuration'file you -ant to create. In our case, -e start -ith the so called H1ort file -hich defines the basic information for the )4M to connect to the 01C Server. The )DSI'ty"e in to select in our case is H01C. The ne*t dialog needs you to fill in all connection configurations for your )4M6s7.

)igure 3301C 1ort Configuration

F# T'+e( ou can select here if you -ant to use a )4M$$ or a redundant "air of )4M$s. In our e*am"le -e -ill use the redundant configuration. In case of the $$'o"tion, you cannot fill in the bacu"')4M information and thus becomes only easier.

Page &0 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


8CP
The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page &1 of of 106


)igure 3!)inding the C;SDID of the s erver in the Registry
Another easy -ay is using the 01C Diagnostic tool. There is a se"arate cha"ter on this.

)igure 3/)inding the C;SID of the server using the 01C Diagnostic tool

>o- ty"e in the C;SID in the 01C Server 1ro"erties section {including the brackets} . OPC Server Na!e( The 01C server name may be any name you lie, but its obvious to use the actual 01C severs name, in this case HMatrion.01C.Simulation. ou can no- save this file by clicing the save'icon 6or file'save7. If you are on the A9, you can directly save this file in the D:+usr+fo*+s"+files+devices directory. If you save this file some-here else, remember to co"y this file to the mentioned directory laterJ The name of this file is im"ortant because you need it later -hen you configure the

10.0.0.10 255.255.255.0 10.0.0.1 10.0.0.100
10.0.0.11 255.255.255.0 10.0.0.1 10.0.0.100 Matrikon.OPC.Simulation {F8582CF3-88FB-11D0-B850-00C0F0104305}

D.. The evice Confi-uration File4s5 2.(.#. 9hat is the Device Configuration As -ith the 01C'Io gate, at least one device 6-hich is a child'0T mandatory but it is recommended. The device configuration file has the follo-ing functions: Configuring the 9atchdog "oint for the device. The -atchdog 1oint is used to let system' managment generate an alarm -hen the connection -ith the 01C Server is lost. If the -atchdog "oint is not s"ecified 6either by not filling in, or by not using the file at all7, system management can only detect total failure of the connection 6cable removed of server shut' do-n7. The -atchdog "oint can be any "oint of any ty"e 6boolean,integer,real7, as long as it ee"s changing "eriodically. If such a "oint is not available in the server, )o*boro recommends to create a changing value on the I+A side, -rite this to an 01C'item in the server and read it bac as a -atchdog. This -atchdog configuration is the reason that the device configuration file is al-ays recommended, even if the ne*t items in this list are not needed. Configuring 01C Item Aliases. As -ith the 01C'I0'gate -here alias files are also used, the bloc'"arameters in I+A are limited to $ characters. If the 01C'items in the server are longer, you need to configure an alias that is shorter. This file -ill lin the alias to the actual o"c'item. Configuring the 01C'grou"s and there u"date'"eriod. •

•

•

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page &3 of of 106


2.(.#.$ Creating a Device Configuration file. Start the )DSI configurator. The first dialog -ill be:

)igure 32)DSI Configurator

Clic H>e-.

)igure !%Config )ile Ty"e selection

Select HDevice and H01C and clic 0U.

Page & of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


The device configuration dialog consists of three Tabs: 5eneral, 5rou"s and I+0 1oints.

)igure !Device Configuration, 5eneral Tab

evice Na!e( This is the name of the device and can be anything you -ant, you -ont see it ever again. 6could be used for versioning the file for instance..7. I Qust used HSimulation Server. 8eartbeat I/O Point( This is the 01C'item of the heartbeat "oint. This must be an continuously u"dating "oint in the server. )or the Matrion Simulation Server, this is easy because there are many "oints that change automatically all the time. 6Thats -hy its a simulation sever, right7. 9e use the "oint HSa-'toothed 9aves.Int$. 8eartbeat Scan )ate( This is the "eriod in milliseconds in -hich the 01C Driver checs to see -hether the heatbeat has changed. If it has not for three consecutive "eriods, the Device
The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page &! of of 106


)igure !$Device Configuration, 5rou"s Tab

Grou+ Na!e( ere you can s"ecify -hich 01C'grou"s you -ant for the "oints that need aliases and ho- to call them. The number of grou"s de"ends on the need for more than one scan'rate for the "oints, -hich is configured "er 01C'grou". If one scan'rate is sufficient, than the recommendation is again to ee" it sim"le and use only one grou" for the alias'"oints. Scan )ate( The scan rate for the grou" you ty"ed in, in milliseconds. 1ress HAdd button to add the grou" to the list.



)igure !Device Configuration, I+0 1oints Tab

The I+0 "oints tab enable you to add 01C items and their aliases that are to be used in the bloc configuration. It can also generate many I+0 "oints and aliases automatically if they have an increasing number as "refi* or suffi*. As this is not often the case, -e -ill leave the I+0 1oint 5eneration "art of this dialog for you to figure out. To add I+0 "oints: PNT?NO( This is the alias that -ill be used in the I+A DCI'blocs "arameter H1>TV>0. OPC Ite!( This is the actual 01C'item as it is no-n in the 01C Server. Grou+( This is the grou" you -ant to have the "oint in, and must be a selection of the grou"s you have created on the Hgrou"s tab. 1ress HAdd to add the "oint to the list. In this e*am"le, -e have added three "oints. >ormally -e -ould not use the aliases in this case, since the o"c'items are all shorter than $ characters, but this is Qust an e*am"le. <*actly the same as -ith the 1ort'Configuration file, you can no- save this file by clicing the save'icon 6or file'save7. If you are on the A9, you can directly save this file in the D:+usr+fo*+s"+files+devices directory. If you save this file some-here else, remember to co"y this file to the mentioned directory laterJ The name of this file is im"ortant because you need it later -hen you configure the
The file that is no- created loos lie this:

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page && of of 106


2000 1000 Saw-to othed Waves.Int4 Random.Real4 Triangle Waves.UInt2

D..2 Creatin- a Control atabase The database can no- be created. This can be done -ith any Database configurator, such as ICC, IACC of )o*cae. In this e*am"le I use IACC, but it should be easy enough to e*tract the "arameter'information and to use that -ith another configurator if re8uired. The database needs the follo-ing items: 1ort
•

•

2.(.3. The 1ort
Page &' of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


)igure !(Creating an )4M$ in IACC, including
The 013$%%V
)igure !#
The im"ortant "arameters here are: ev?id( This ID defines the )4M to use, not the blocname. It is also needed in the Device'

2.(.3.$ The Device
)igure !3Added a child
A child
Page '0 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


)igure !!
The im"ortant ot used for
The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page '1 of of 106


2.(.3. The DCI I+0 blocs The )DSI )4M uses the DCI blocs to get the value into I+As Com"ound'4loc -orld. This means you cannot directly use AI> or CI> blocs, you must use RI>, 4I>, II>, I0?T, R0?T etc. blocs. The functionality of the DCI blocs is roughly the same as )II>, )RI> etc bloc of the 01C I0'gate. )or the 01C )4M, if you use an Device Configuration )ile, the 01C Driver -ill thin all 1>TV>0 items that are configured in the DCI blocs are alias and tries to find these in the Device configuration file. ou can "revent the driver from doing this by "refi*ing the 01C'item that has no alias and can be directly re8uested from the server -ith a H\ 6aa hash' or 1ound'sign7. In this e*am"le, -e have three "oints in the alias'file 6as the device'configuration'file is sometimes referred to7. 9e -ill build these three blocs and a additional bloc to use the \' o"tion to see a value -ithout alias.

)igure !/DCI'bloc com"ound

In IACC a com"ound H01C<AM1;< -as created and four DCI'blocs -ere build, three II>' blocs and one RI>'bloc. Their configurations are as follo-s, -here the I0MID and the 1>TV>0 "arameters are the only changes from the default values. >ote that these corres"ond -ith the Device'Configuration files aliases.



D.. @oadin- the driver in the F#. As soon as the
)igure !2)ind the )4M in system management.

Select the )4M and clic  to set only the main )4M online. The )4M should go online, and the red light on the )4M should go off. To do-nload the driver, clic H<<1R0M+S0)T D09>;0AD, and then clic HS0)TVD09>;0AD.

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page '3 of of 106


)igure /%Start Driver Do-nload

The 01C Driver -ill no- be do-nloaded. 9hen this is finished, the )4M -ill automatically reboot. This -ill also automatically ha""en for the 4acu" )4M if a redundant )4M$ is used. . After the do-nload is finished and the )4M is rebooted, it -ill come bac u" 0n';ine. To chec the driver do-nload, loo at the second "age of H<8ui" Infoof the )4M. This -ill shothe HDriver Ty"e and the HDriver Bersion. The driver ty"e re"resents the build'name of the driver 6not necessarily the same as the driver filename7 and the driver version is a combined checsum of the driver'files. This checsum can be checed -ith the version'te*t file that came -ith the driver installation. 6stored in +usr+fo*+s"+files+devices7

Page ' of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


)igure /Driver Bersion information 6)4M -as already running in this screenshot7

>0T<: 9henever the driver is re'do-nloaded in a -oring )4M both 1ort and Device configuration files are deleted from the )4Ms memory and must be re'do-nloaded.

D..9 o3nloadin- the Port confi-uration file. The "ort configuration file can no- be do-nloaded. This is al-ays necessary -henever the ot Ready in system management. This can be seen on "age $ of the <8ui"ment Info in the )4M Status'field. This -ill sho- HDCI Ready or HDCI >ot Ready, and this -ill corres"onds -ith a ello-+9hite and 4lue 600S7 )4M in system management. At this stage in our e*am"le, the )4M is blue and the <8ui"ment Info "age sho- HDCI >ot ready, telling us to do-nload the 1ort Config )ile.

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page '! of of 106


)igure /$Do-nload the 1ort Config )ile -hen the ot ReadyF 64lue7

Clic HD4 Do-nload on the )4M 60T C0>TI>?< if this status is not reached. Also, the "ort should be enabled. 0ften this goes automatically but chec to see -hether the you can enable the "ort H<>A4;< 10RT  on the <8ui"ment C5 "age.

D..D o3nloadin- the evice Confi-uration File. >e*t ste" -ill be getting the Device file in the )4M. In system management, Clic on the )4M and select H>e*t ;evel to loo at the devices connected to the


)igure /H>e*t level of the )4M sho-s the device6s7

>o- clic H<8ui"ment Chg.

)igure /(Clic D4 Do-nload to do-nload the Device Config )ile.

To do-nload the device'configuration file, clic HD4 Do-nload. 6This -ill be only "icable if the
The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page '& of of 106


)igure /#Device
D..10 Startin- co!!unication If the Device Config file is do-nloaded, the communication can be started by enabling the communication.

)igure /3
The )4M should no- start communicating -ith the server. If this is successful, the device'state -ill go from blue to yello-+-hite, ot )ailed.

Page '' of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


)igure /!Device
The DCI'bloc should no- not be 00S anymore and sho- valuesJ

)igure //Balues are coming from the Server

D..11 acu+ F# in redundant confi-uration. To get a redundant )4M -oring, the best -ay is to get the MAI> com"letely u" and running first, and then turn your attention to the 4ACU?1. So if a redundant )4M is used, no- -ould be a good time to set the bacu" )4M online. This )4M The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page '( of of 106


-ill no- be automatically u"dated -ith all configuration information from the master )4M. This -ill be visible in the
)igure /2Master )4M is u"dating 6educating7 the Tracer )4M

9hen the education is finished, the bacu" )4M should start communicating -ith the server -ithout other user intervention. The )4M and device 6
)igure 2%)4M ealthy

Page (0 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


D..1% #aster/Tracer )ole s3itchin- in redundant confi-uration. >o- the )4M is redundant, you should be able to test the fault'tolerance of the )4M by, for instance, disconnecting the cable from the Master )4M. 9hich )4M has -hat role can be seen on the )4Ms themselves 6Master+Tracer lights7, in system management and on the
D. OPC ia-nostic Client The )DSI )4M -ith 01C driver has a lot of diagnostic "ossibilities on the
D..1 Connectin- the client to the F#. 9hen the client is started, the follo-ing screen a""ears -hen H)ile 'O Connect or the left'most icon in the toolbar is cliced:

)igure 201C Diagnostic Client -ith Connect Dialog

To connect to the )4M, select HRemote for the mode, chec the H)DSI )4M checbo*, s"ecify the )4Ms I1 address 6or station name if "resent in host'table7, and clic HConnect.

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page (1 of of 106


D..% ia-nostic vie3 The diagnostic vie- that -ill a""ear no- loos lie this for our e*am"le configuration:

)igure 2$Diagnostic Bie-

In the left "ane, the connected server is sho-n, as -ell as the 01C'grou"s that are connected to the server. 4y selecting a radio'button of a grou", the right "ane -ill sho- all "oints connected, including the 01C'tag, current value 6live7, time stam" , 8uality and Status. The status is im"ortant, because it -ill tell you if there are any synta* errors in the 01C'Items. The lo-er "art of the diagnostic vie- -ill sho- general information, such as number of "oints active, and number of invalid items . 6"er grou"7

D..* @o- Files The Diagnostic client -ill also generate log files -ith detailed information on the )4M and the 01C Driver in it, but only -hile its connected to the )4M. These files are located in the Hlog subdirectory of the 01C Diagnostic installation directory. The logfiles can be vie-ed using the HBie- ;og functon in the HBie- menu and the log functionality can be turned on+off in using the H;og Configuration o"tion in the H)ile menu.

D.. OPC ro3ser functionalit' The 01C Diagnostic client also has the "ossibility to connect to a Server and sho- information lie the C;SID, connected clients and the available "oints. To start the 01C'bro-ser, use the HBie- menu or the button on the toolbar. Ty"e in a station name or I1'address, and connect to the server. In the left "ane, rightclic the 01C Data Access version $ and clic H1o"ulate.

Page (2 of of 106 The Foxboro F;SI F;SI OPC OPC ;rier for for F:+232 F:+232 an# F:+233% F:+233%


The 4ro-ser -ill no- connect the the server and add the found 01C Servers on the machine. >o-, you can right'clic the found 01C'Servers -hich -ill sho- the detailed information of this server. This vie- can be sho-ed at the same time as the connection'vie- of the )4M diagnostic. See screen shot belo-.

)igure 201C Diagnostic of )4M and Server simultaneously

The Foxboro F;SI OPC ;rier for F:+232 an# F:+233% Page (3 of of 106


10 Troubleshootin- / FA7. 01C -ithout troubleshooting, that -ould be somethingJ ?ntil -e get there -e go here...

10.1 General ti+s for troubleshootintroubleshootin- OPC. OPC. •

•

•

•

•

•

•

?se the #atrion OPC I only7: 7 opt7fo!7storian7,in7isttil="doc 6in middle of document7. ]O bad bit is the /th bit 6first bit is nr %: 6the 2th bit from the right is the bad bit7: if error value is == 2 ==== ==== ==9= ==99 bad bit is not active. if error value is =9 2 ==== ===9 ==9= ==99 bad bit is active.

9hen facing a system that is unres"onsive after -oring fine for a long "eriod 6"oints going to 4AD, data froen in the 01C clients etc.7 there are some ste"s you can tae: . Try to sto" the the 01C Client Client 601C I+0 5ate 5ate etc.7 and -ait some some time before bringing the the client bac on line. If a first attem"t fails, retry and allo- a""ro*. % minutes before going on line again. % minutes is a general total DC0M timeout after -hich all DC0M "rocesses are illed. $. If that fails, Uill Uill client and also sto" the 01C Server. ;et ;et the system system rest for a little -hile and then restart the 01C client a""lication. The client should then automatically start the 01C Server. . )or 0)) "latform "latform 01C Server configurations it may be an an idea to reboot reboot that 01C Server machine. (. 4e-are of this ste". 4ut -hen "ossible it it may be -orth to sto"+start sto"+start the AIMA1I interface "rogram on the host. Tae good notice of other a""lications that may be using this interface 6AIMist, AIMDatalin etc.7. #. If that fails, a more drastic measure may may be in order: reboot both 01C Server and Client machines. 4oot the Server first -hile client remains off'line. 9hen Server machine is u" and running, then 6and not earlier7 start the 01C Client. 3. Try to mae sure sure that A;; 01C items items you are addressing addressing are indeed e*isting e*isting on either "latform. 01C does not deal -ith non'e*istent items very -ell. !. If that that fail fails: s: anic or or read on. on.

Page ( of of 106 Troubleshooting // FA<%


10.% @ocal Clients connect but re!ote clients canKt. 1roblem: ;ocal Client can connect to the 01C server, but remote clients cannot. A"art from the obvious "roblems that are account and DC0M related and -hich are covered in the "revious cha"ters there can be something else. Solutions: in 9indo-s 1 the enabled sim"le file sharing must be uncheced. This o"tion is found under Start/Pro-ra!s/Accessories/&indo3s
10.%.1 ,nable to add -rou+s. 1roblem: 9hen starting OPC I/O -ate to -ate to a remote 9indo-s 1 A9!% from a local 9indo-s 1 A9!%, the 01C I+0 gate only sho-s the 01C server, but no grou"s 6
Solution: Several changes have been made and then this "roblem -as solved, the e*act cause is not clear, 1roblems -here solved by checing and correcting the follo-ing items: Corrected the 5ate-ay I1 address on the 01C client. Corrected the 5ate-ay I1 address on the 01C server. Corrected errors in the ost table on the 01C server. 6In this "articular case the host name -as available, but the I1 address -as incorrect7. •

•

•

10.%.% Ta-s in OPC clients sho3 bad status" status" even thou-h the blocs on the server are health' in I/A( ]O 1ossible solution: Euicfi* that solves the "roblem described for IA !. and 3.#. as: F)or a""lications using AIM=A1I or )0=A1I, once initialiation is com"leted, any action that triggers an u"date of a connected "oint -ill correct its status and value and causes it to function correctly thereafter. The 8uicfi*es are: E)%%# E)%%# for IA !. on ?ni* E)%%#/ E)%%#/ for IA 3.#. on ?ni* E)%%#$! E)%%#$! for IA 3.#. for 9indo-s 1 E)%%#$/ E)%%#$/ for IA !. for 9ido-s 1 •

•

•

•

There may be another "ossible solution: the bloc in a"i does not have enough time to get connected therefore in the ai$api"cfg add the te*t: te*t: FCTD;A]$%%F 6#% is default7 CTD;A is defined as: FA delay in hundreds of seconds in various stages of the connection "rocess to ensure success.

Troubleshooting / FA<% Page (! of of 106


10.%.* &hile atte!+tin- connection( )PC server not found 9hile trying to setu" a connection bet-een the 01C client and 01C Server you receive an error stating: R1C server not found. Some "ossible causes for this: >o net-or connection available, chec net-or cables and+or I1 addresses etc. 01C server is not registered on this machine. The remote 01C Server must be registered in the 01C Client 1C. •

•

10.* Foxboro OPC I/O Gate The 01C I+0 5ate related stuff.

10.*.1 The I/O I/O Gate 3indo3s sta's e!+t'. 9hen the 01C I+0 5ate is started nothing a""ears in the screen. >o servers are detected. There can be numerous reasons for this, some of the most obvious: The net-or connection bet-een bet-een the server and client is broen Try to see if that is the case. 6"ing -ors7 If the net-or is 0U, it may be 3CO< related. Mae sure that the ?ser Fox is is enabled on the Server. Chec the 3CO< settings for the Fox user. user. Chec if DC0M a""lication are set the use the defaults regarding security, and if not mae sure that you chec the custom settings for that a""lication. Did you "ut the
•

•

•

•

•

•

•

•

10.*.% Get error !essa-e( Interface not re-istered. After installing the OPC I/O -ate *.0.% on *.0.% on a I/A 0 Series &indo3s BP machine: BP machine: During startu" of the I+0 5ate 6-here the ote: This may also hel" in a system -ith an I+0 gate .%. on a A9!% 9indo-s >T machine -ith a 01C server .$ on a 9in1 machineJ At one customer site -e had this FInterface not registeredF error and running the registry command fi*ed the "roblem.

Page (6 of of 106 Troubleshooting // FA<%


10.*.* )e-isterin- the OPCProx'.dll. )or this "roblem see: 2..$ 5et error message: FInterface not registeredF

10.*. Cant -et
10.*. odebus or ote that the Secondary net-or is %%^ 0U in this setu", I1 addresses etc. are correct. 01C connects through this secondary interface only but still the "rimary net-or configuration causes this "roblem to e*ist. The -oraround for this is to change the I1 address 6via System Definition7 of one of the t-o "latforms.

10.*.2 None of the confi-ured ite!s 3or. Most "robably the synta* is incorrect. If the i tems sho- u" in the 01C I+0 5ate -indo-, select the item and find out -hat the messages is. Try to install an OPC
10.*. OPC Ite!s do not 3or and -rou+ scan rate sho3s 0 !secJ. After starting u" the I+0 5ate ,the 01C items do not sho- u" or a""ear very slo-ly. A very im"ortant sym"tom is the scan rate in the 01C I+0 5ate -indo- for that grou". This sho-s a value of H% instead of a more realistic value lie H#%% or H$%%%. This should be investigated as the I+0 5ate may loose communication -ith the 0bQect Manager 6System Management goes red on you7.

10.*.9 OPC I/O Gate crashes after installin- 7F1001D09. The 8uicfi* for the 01C I+0 gate: E)%%2%/ M?ST >0T 4< installed on 9indo-s 1 based I+A Series stations 6I+A 3.( and higher7 because this version contains ne-er dll files than the 8uicfi* "rovides.

Troubleshooting / FA<% Page (& of of 106


10.*.D locs in the OPC I/O Gate a++ear" but slo3l'. Sym"tom: It taes very long for all blocs to a""ear in the 01C I+0 gate tree 6they come lie % every % seconds7. Most liely solution: remove incorrect BA;VIDs or incorrect references in the 7liasfile on the 01C server. >0T<: if a C:4.1 as mentioned in the aliasfile is not found in the CSA database, this -ill not result in an error status in the 01C I+0 gateJJ In the %&T&F(AI0"9"O%&"log file on the 01C server, these items can be found by searching on the te*t string FCSA errorF.

10.*.10 Onl' read of OPC ite!s +ossible" No 3rites Sym"tom: All -ors fine, adding grou"s and items is not a "roblem and the system is res"onsive. o-ever, it is only "ossible to read data from the 01C Server. 5enerally s"eaing this an issue that must be solved through A+iAd!in. The user account created there -ill by default alloreads of all obQects only. ?se the checbo*es "rovided in A"iAdmin under the Security tab to mae the modifications desired.

10.*.11 &hen 3ritin- OPC ite!s" all
10. AI#$OPC Server. The AIM=01C related )AE section.

10..1 Cant enter a license e' because OPCAO or OPC8A are not in list. If you have installed the AIM=01C Server you need to enter the li cense ey to get it -oring. 0n the installation CD you -ill find a file Ha"mre(dat  This file M?ST be co"ied to the d:\opt\ai$\,in directory on the A9.

10..% No +aca-es at all in the list 3hen tr'in- to enter the license. ou co"ied the Ha"mre(dat  file to the "ro"er location but forgot to remove the Hread only attribute from the file. ;ocate the file -ith e*"lorer, right clic and toggle the )eadLonl' attribute 6see "icture7

Page (' of of 106 Troubleshooting // FA<%


+igure /: Remove read$only from aimreg.dat file

10..* OPC Server does not start 4does not sho3 in s'stra'5. Starting the AIM 01C server 6through the 9indo-s START menu7 to access the configurator, does not a""ear to have any effect. i.e.:the red cross does not a""ear in the S'stra'. Sym"tom: After maybe u" to five minutes the 01C Server+configurator may sho- in the Systray after all. A "ossible cause for this may be that the A1I server is not available 6eg aima"i is not running on the A9#7.

10.. e*t start re-edit and using the search function, locate that "articular ey. The value of this ey should be H. In this registry, the authenticationlevel must be set to FF. 6by doubleclicing on the authenticationlevel and entering the value FF7.

10..
Troubleshooting / FA<% Page (( of of 106


Solution: Re'configure the DC0M settings for the 01C server.

10. APIAd!in tool. Some "roblems encountered -hen using A"iAdmin for >T+1 or ?>I

10..1 No Servers found 3hen invoin- APIAd!in. 0n 9indo-s "latform this can related to the fact that broadcast is disabled and no server aliases are configured. 0n ?>I -hen starting a+ida!in from the "rom"t ou must start the a+iad!in a""lication from C'shell . Doing this from the 4ourne shell results in an em"ty Server list no matter -hat you have configuredJ

10.2 Onl' read of OPC ite!s +ossible" No 3rites 5enerally s"eaing this an issue that must be solved through A+iAd!in. The user account created there -ill by default alloreads of all obQects only. ?se the check!o,es "rovided in A+iAd!in under the Security tab to mae the modifications desired.

10. Net3or connection settin- not available after installin- OPC. >ote for 9indo-s $%%% )amily 6and "ossibly 1 hosts7: Setting the Default Im"ersonation to Anonymous may cause >et-or and Dial'u" connections "reviously defined to be no longer visible. 9indo-s <*"lorer uses the efault I!+ersonation level settings to access these obQects. Anonymous access does not give the correct "rivileges to dis"lay these. See also ?:@4 . Another -oraround: 01C clients running on 9indo-s $%%% could can run -ith dcom settings: FconnectF and FidentifyF.

10..1 Not all ite!s beco!e active. 1roblem: 9hen OPC I/O Gate starts, not all items become active 6It does >0T a""ear in the I+0 5ate dis"lay7. 1ossible solution: Increase the scanrate of the )'blocs, note that fastest scanrate in a grou" is forced on all )4;0CUS in that grou". Add 6"er 01C grou"7 t-o dummy )'blocs as the first t-o blocs in that Com"ound and+or turn on the Com"ounds one by one -ith % seconds "oses. >ote that each dummy bloc should have its o-n "arameter on the 01C Server. Do not "oint all blocs to the same 01C itemJ

10..% Analo- values sho3n in the OPC I/O Gate sho3 .0000J. Sym"tom: in the 01C I+0 gate -indo- an analog out"ut value gives the value F.%%%%F. Solution: This does not al-ays indicate a 4AD tag. Try to modify the value of this out"ut. This -ill "robably sho- the correct value after an u"date. This can be related to an incorrect AIMA1I version. Page 100 of of 106 Troubleshooting // FA<%


10..* Cannot start the OPC Server Confi-urator. Sym"tom: 9hen trying to start the OPC Server via the e*ecutable \ai$\opc\ai$opcs*r"e!e , nothing ha""ens and the error FCould not re-ister class factoriesF a""ears. 1ossible cause for this: If the 9indo-s tasbar is hidden 6in case of o"erator -orstation functionality on A9!% this is liely to be the case7 then the 01C server configurator can not be started. Solution: The 01C Server configurator can only be accessed+started by enabling the 9indo-s tasbar: &indo3s ex+lorer:#' co!+uter:control +anel: foxboro icon: and then: 6startOsettingsOcontrol "anelOfo*boro icon, enable tasbar6)ull control or something lie that7 To activate this ne- settings, do the follo-ing 6this has not been intensively testedJ7: Uill the e!plorer"e!e "rocess in the tas!ana-er. Then via the tas!ana-er:file:ne3 tas4)un5:ex+lorer.exe The tasbar should no- a""ear, and the AI#OPCSE) can no- be started via the the Start menu. •

•

10.. Initial connection fails" retr' al3a's 3ors. 1roblem: During startu" of A9!% -ith on "latform 01C server, the 01C server is started before AIM A1I is started. 1robable solution: Delay the start of the 01C server "rocess until AI and A1I are fully started.

10.9 FSI F#  OPC river 4&or In Pro-ress5 10.9.1 8e'... It doesnKt 3or. >o 01C connection is ever easy, es"ecially not -hen you try to set u" a "articular connection for the first time. The blac'bo* nature of the )DSI )4M does not really im"rove this. Most of the time, 01C connections fail because of the security 6DC0M7 settings on the Server. If you use 9indo-s 1 S1$, then things can get really difficult. The follo-ing things can be done to rule out the )4M:

%./.. Chec the "ort configuration. The first thing to chec is the I1 configuration, and the net-or. Can the )4M and Server reach each other 6>o fire-alls in bet-een7 Try to "ing the )4M from the server and vice'versa: 6In this e*am"le the I1 addresses from the )4M and Server are 2$.3/..$# and 2$.3/.. res"ectively7

Troubleshooting / FA<% Page 101 of of 106


)igure 2#1ing the )4M from the server

Then, telnet to the )4M 6see figure above7 and try to "ing the server:

)igure 23After telnetting to the )4M, try to "ing the server bac

If this -ors, you no- that the "ort'configuration file -as successfully do-nloaded, the )4M assigned the I1 address to its net-or card correctly and the net-or is also correctly connected. Rechec also the other information in "ort'config file, such as the Servers I1'address and the C;SID. See also ne*t ti".

%./..$ Are the correct files do-nloaded If you are maing changes to the 1ort or Device config files but the changes dont seem to hel", you might -ant to chec to see the correct file is do-nloaded and active in the )4M. Start a cmd.e*e and telnet to the )4M. CD to the directory +fo*+lib. In this directory, the do-nloaded configuration files 6.M;7 -ill a""ear, -ith their CRCs as file'names. There can be more than one file "resent, as old files -ill not al-ays be removed. In the e*am"le belo- there is  "ort'configuration file and $ device configuration files. ou can see the contents of the file -ith

Page 102 of of 106 Troubleshooting // FA<%


the Hty"e command.

)igure 2!Checing the files inside the )4M

If all configurations in the 1ort+Device files are correct and you can "ing bac and forth to the )4M, the "roblem is most liely >0T in the )4M. If the
10.9.% F# Not res+ondin- to co!!ands" )ebootin- the F# The )4M 0S is 9indo-s... Sometimes it Qust hel"s rebooting the )4M, sometimes its Qust "lain necessary because it does not res"ond to commands. 5enerally s"eaing, it is not necessary to

Troubleshooting / FA<% Page 103 of of 106


reboot after I1 or other configuration changes. There are three -ays of rebooting the )4M: . Clic HReset on the <8ui"ment Change "age in system management. $. If the )4M does not res"ond to system management anymore, you can try to Telnet to the )4M and ty"e Hfbmreboot . If you cannot telnet the fbm anymore or there is no telnet session around, you have to "ull and reseat the )4M on the base"late.

10.9.* ia-nostic locs and +ara!eters This cha"ter holds some ti"s and trics that are not documented in the official documentation, and can therefore be subQect to change by develo"ment.

%./..
%./..$ Diagnostic DCI 4locs ou can build DCI blocs in your C1 -hich can interface directly to the 0T TV>0 values: !A"NIN#$ %hese &unctionalities are created &or debugging 'ur'oses b( de)elo'*ent and are not docu*ented +(et,- %he dri)ers are still being de)elo'ed at the ti*e o& this .riting and this *a( or *a( not .ork .ith the O dri)er (ou ha)e-

Page 10 of of 106 Troubleshooting // FA<%

Foxboro I/A Series OPC Solutions Installation, Configuration, Troubleshooting I 1lock%('e

N%2NO )alue

3unction

STRI>

)4M%VI1ADDR
I1 address of )4M in Single mode or Master )4M I1 Address in redundant mode.

STRI>

)4MMVI1ADDR
I1 address of )4M of Main )4M in redundant mode.

STRI>

)4M4VI1ADDR
I1 address of )4M of 4acu" )4M in redundant mode.

RI>

)4M%VC1?V?SA5<

Single )4M C1? load or Redundant 1air Masters C1? load. 6%'%% ^7

RI>

)4MMVC1?V?SA5<

Redundant "airs Main )4M C1? load. 6%'%% ^7

RI>

)4M4VC1?V?SA5<

Redundant "airs 4acu" )4M C1? load. 6%'%% ^7

RI>

)4M%VM
Single )4M Memory load or Redundant 1air Masters Memory load. 6%'%% ^7

RI>

)4MMVM
Redundant "airs Main )4M Memory ;oad 6%'%%^7

RI>

)4M4VM
Redundant "airs 4acu" )4M Memory ;oad 6%'%%^7

4I>

)4MMV01CV
Main )4M in redundant "air has not connected all configured "oints correctly 6yet7 =

4I>

)4M4V01CV
4acu" )4M in redundant "air has not connected all configured "oints correctly 6yet7 =

A9his feature is under develo"ment at the time of writing. 7n +-<=?= version of this is not availa!le yet.

See e*am"le bloc configuration:

)igure 2/C1? ?sage Diagnostic bloc e*am"le

Troubleshooting / FA<% Page 10! of of 106

OPC Service Manual-V1.7

Recommend Documents