Home

MatrikonOPC Server for Simulation User Manual

1. User Group Configured Paths Browse Add Read Write Everyone Allow Deny Deny Deny Everyone Configured Aliases Deny Unspec Unspec Unspec DOMAI N john doe DOMAI N fred stone DOMAI N sally simpson DOMAI N the admin Supervisor Deny Allow Allow Deny Restricted group Common group Allow Allow Allow Deny Common group Triangle Waves Deny Deny Deny Deny Admin group Allow Allow Allow Allow Admin group Bucket Brigade nt4 Unspec Unspec Unspec Deny Table 48 Example 2 Permissions User Group Configured Paths Restricted DOMAIN john doe Common DOMAIN fred stone DOMAIN sally simpson Admin DOMAIN the admin Tip 1 Table 49 Example 2 Groups and Members Adding a user name and not defining any permissions for that user name or any group it belongs to will completely restrict their access to information in the OPC server MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 111 MatrikonOPC Case 1 User DOMAI N john doe connects The user is unable to perform any function at any level since no permissions have been defined for this user name or the Restricted group to which it belongs Tip 2 Use the root location to define permissions for locations that have not been defined Use the default user to define permissions for users that are not listed Case 2 User DOMAIN no name connects This name is not defined so the default user per
2. Add Permissions Allow Deny Unspecified Browse Add Read Write Figure 58 Edit lt Groupname gt Window Permissions Tab On the Permissions tab the permissions associated with this group relating to browsing adding reading and writing for any specific paths or OPC items are configured Refer to the Edit User section regarding configuration on the Permissions tab Group and user permissions are configured in the same way MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 106 MatrikonOPC On the General tab Figure 59 of the Edit lt Groupname gt window the name of the group can be changed To edit a group s name 1 Enter a new name in the Name field 2 Click on the OK button Edit Group1 Permissions General Members Name Groupl Figure 59 Edit lt Groupname gt Window General Tab On the Members tab Figure 60 the users that are part of the current group are defined By default the Group Members screen section is empty In Figure 60 Userl has been added to Groupl MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 107 MatrikonOPC Edit Group Permissions General Members Group Members User Remove Figure 60 Edit lt Groupname gt Window Members Tab To add one or more members to the group 1 Click on the Add button The Add Existing User window Figure 61 appears
3. Everyone Allow Allow Allow Allow Table 46 Default Tag Security As no users or groups are defined any NT user connecting to the OPC server will use the Everyone default user for permissions Only the root level location is defined under the Configured Paths list which gives full permissions to the entire OPC server An administrator will want to change these default settings for the OPC server to provide more security on its tags MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 110 MatrikonOPC Example 1 Table 47 contains a possible tag security configuration enforces complete restricted access except for the NT user DOMAI N Admin User Group Configured Paths Browse Add Read Write Everyone Deny Deny Deny Deny DOMAI N Admin Allow Allow Allow Allow Table 47 Example 1 At this point more users can be added which belong to a more restricted group This group may be denied write capability or restricted to certain areas in the server hierarchy Example 2 Following is an example of a tag security configuration for the MatrikonOPC Server for Simulation and Testing with sample use cases Table 48 lists all defined users and groups and their associated permissions Table 49 indicates which users are members of the defined groups Unspec permission indicates Unspecified Groups in this example are Private Groups
4. Input Calculation Calculation applied to the value read from the OPC item Table 43 Additional File I mport Export Field Descriptions Calculation Scaling Scaling Algorithms For each type of scaling a different algorithm Table 44 is applied to values read from the OPC item A reverse algorithm is applied to any values written to the OPC item Scaling Algorithm Example Reverse Algorithm Example Scaled Scaled RaW pion RAW bow Linear x Raw ae 4 Scaled PA x Scaled Mp Raw Raw High T Raw o Scaled High 7 Scaled Raw men Raw Low Square Scaled Scaled wile as Scaled x Scaled y l l 2 om Rawy y RAW pign RAW gow Scaled pign Scaled Gain x Offset Offset Gain x Offset cree Expression SORT INPUT 5 OUTPUT 5 OUTPUT 5 Calculation round Random Real4 N A Table 44 Scaling Algorithms MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 85 MatrikonOPC Appendix C Standard Data Types The Standard data types and their descriptions are listed in Table 45 Hex Dec Data Type Description 0000 0 VT_EMPTY Default Empty nothing 0002 2 VT_I2 2 byte signed integer 0003 3 VT_14 4 byte signed integer 0004 4 VT_R4 4 byte single precision real 0005 5 V
5. The user DOMAI N john doe wants to read the item Random Real4 The permission routine would not be able to find an exact location match under the Configured Paths list However it would loop through each partial match in the Configured Paths list looking for a defined permission The location Random would be the closest match and the permission would be DENY MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 114
6. coomcconnncnnnnconnncnnnncannnencnnrnnnncnnnnrannnrnnnrananrncanracanes 105 Figure 58 Edit lt Groupname gt Window Permissions Tab scsscseeseeseeeceeneeeeeeeeeeeeees 106 Figure 59 Edit lt Groupname gt Window General Tab ssssssssnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 107 Figure 60 Edit lt Groupname gt Window Members Tab scsscsecseeseeeeeeeeeceeneeneeeeeeeeanes 108 Figure 61 Add Existing User Window omccoocnconnnconnnconnncannncnnnnrannnrnnnnrananrnnnrananracanracanes 109 Figure 62 Change Password Window ccccsceeeeceeeseeeeeceeeeeeeeeceaeseuaeseeaueauaescueuauaseausaeans 110 Table of Tables Table 1 Data OptiONS oocoococoncnconnncnnnncnnnncnnnncnnnnnnrnnnnrnnnnrnnnnrnnnncnnnncnnnnrnnnncnnancnnancnnanennaneasa 9 Table 2 Terms and DefinitiONS coccccccncnnconcnnconcnnnnnnnnnnnnnnn nan nnn ener rre 11 Table 3 Files Installed in Simulation Folder oococcccccnccnconcnnnonnnannnnnnnnnnrnnnnncnnennnnnnnnnnas 22 Table 4 Files Installed in Common Folder cccccsceceeeeecceececeecesceeeeeeeseeceeseeceeeeeeenaneaes 23 Table 5 Files Installed in system32 Folder coomccoonoconcncnnnacanoncnonacanancnnnncanancnnnncananenss 23 Table 6 MatrikonOPC Support Regional Contact I nformation ssssssssssnsnnnnnnnnnnnnnnnnnnn 24 Table 7 After Hours SUpport imcccococoncnconcnconnncnnnncnnnncnnnncnnnncnnnncnnnncnnrncnnnncnnancnnanennancananenss 24 Table 8 Tool Tray Menu COMMANAS cocccccnconconc
7. Command Description Statistics Displays hides general communication statistics for the currently selected object Reset Statistics Resets all statistics for the currently selected object to zero Defaults Displays the Server Defaults window used to configure the default settings for the various types of communication objects available in the server E Refresh Rebuilds the tree display of the server configuration and fully expands all branches Options Displays the Options window used to change general server options Tools Menu Table 14 View Menu Commands Table 15 describes the Tools menu commands Command Description 4 DCOM Configurator Launches the Microsoft Distributed COM Configuration Properties MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Command Description utility This utility can be used to edit DCOM settings for specific COM servers to allow client applications on remote computers to connect to the server Launches MatrikonOPC Explorer which is a general purpose OPC client ah u included with all MatrikonOPC servers that may be used to test the View Tags capabilities of the software For more information refer to the MatrikonOPC Explorer User s Manual Launches the Enter server password window where you are asked to enter the security password set during the installation of the server
8. access denied properly MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC OPC client unable to create or read items under configured object device Problem The OPC client is unable to create or read items under a configured object or device Check the object configuration Ensure that the Enabled checkbox is selected and verify Solution A the access credentials are correct e g Username Passwora Server does not retain settings Problem The server does not retain its previous settings and needs to be reconfigured each time it starts up In the Configuration window choose Options from the View menu Under the General tab ensure that the Load configuration on start up checkbox is selected and that the correct file name appears in the edit box see General Options Solution Server cannot save configuration in XML format Problem The OPC server cannot save the configuration file in XML format Solution Microsoft Internet Explorer 4 01 or later must be installed to use the XML format Server does not show up in the list of locally available program Ds in OPC client application Problem The server does not show up in a list of locally available program IDs in the OPC client application Make sure that a user with local administrative rights installs the OPC server so that it Solution can create the necessar
9. AN following syntax SERVI CE TOPI C NAME In this case consider the TOPIC to be the item ID and the NAME to be a combination of the scan rate and access path MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Starting the MatrikonOPC Server for Simulation To launch the MatrikonOPC Server for Simulation choose the appropriate shortcut from the Start menu To start the MatrikonOPC Server for J ohnson Controls N2 1 Click on the Windows Start button and select Programs gt MatrikonOPC gt Simulation and choose MatrikonOPC Server for Simulation 2 If the server is not installed as a Windows service the server starts and the Matrikon logo appears in the Tool Tray Figure 10 located by default in the system tray N S 12 27pm Figure 10 Tool Tray Tool Tray Menu Note If the server is installed as a Windows service the Tool Tray and Tool Tray Menu are not available The Tool Tray Menu provides access to the Control Panel the Configuration window and the About screen It also contains the commands to shut down the server To view the Tool Tray Menu 1 Right click your mouse on the Matrikon logo D 2 The Tool Tray Menu appears Figure 11 Show Control Panel Ry Configure x Shutdown About Figure 11 Tool Tray Menu Table 8 describes the commands in the Tool Tray Menu Command Description Show Control Panel Displays the configuration contro pane
10. MatrikonOPC MatrikonOPC Server for Simulation User s Manual MatrikonOPC MatrikonOPC Server for Simulation User s Manual This manual is a product of Matrikon Inc Matrikon Inc Suite 1800 10405 Jasper Avenue Edmonton AB T5 3N4 Canada Phone 780 448 1010 Fax 780 448 9191 www matrikonopc com Document Revision History Document eer Date Version Description Author 2003 08 19 1 0 Initial document DENG 2004 04 02 1 1 Added HDA and AE functionality descriptions IMF 2008 05 14 2 0 Converted to new template LB Added OPC item descriptions updated Installed 2008 08 25 2 1 Files updated Installation and Un Installation RK LB sections updated Troubleshooting section MatrikonOPC Server Framework v1 11 1 0 1 7 0 0 applied to server Software version updated to 1 5 0 0 Updated Installation section Updated Contacting Support section Alias Configuration 2009 07 17 3 0 section updated to include Calculation scaling and g Item Browser information Limitations section updated Appendix B Aliases added Scaling Calculation section updated CSV File Format and Scaling Algorithms sections Updated Appendix E Security MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 2 MatrikonOPC SOFTWARE VERSION Version 1 5 0 0 DOCUMENT VERSION Version 3 0 COPYRIGHT I NFORMATION Copyright 1997 2009 Matrikon Inc All rights reserved No part of
11. 5 To add the selected group click on the OK button The group is then added to the list of users and or groups currently defined refer to Figure 46 for a sample list of defined users and groups 6 The Edit lt Groupname gt window Figure 58 appears for NT Groups there is only the Permissions tab Follow the instructions in the Edit Group section for adding permissions Private Group To add a Private Group 1 From the MatrikonOPC Tag Security Configuration Utility main screen click on the Add Group button 2 The Add Group window Figure 48 appears Select the Private Group option button Figure 49 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 97 MatrikonOPC Add Group C NT Group Private Group Add a group from a elias BET Danae Create a new private group Group Name Private groups exist only within this OPC Server They are not created on any NT Domains Cancel Figure 49 Add Group Window Private 4 Enter a name for the group to be created The group is private and will only exist in the OPC server The group cannot be created if there is already a configured user or group with that same name 5 Click on the OK button to create the group It will be added to the list of users and or groups currently defined refer to Figure 46 for a sample list of defined users and groups 6 The Edit lt Groupname gt window Figure 58 appears Follow the instructions in the Edit Group se
12. 9 appears stating that MatrikonOPC Server for Simulation has been successfully installed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 720 O MatrikonOPC A MatrikonOPC ooo Figure 9 MatrikonOPC Server for Simulation Setup Complete Screen 16 At this point you have the option of selecting the applicable checkboxes and launching any or all of the following e MatrikonOPC Server for Simulation User s Manual e MatrikonOPC Server for Simulation Release Notes e Simulation Configuration Video 17 Click on the Finish button to complete the installation and exit the Wizard 18 The necessary files have now been copied to the target computer the software components registered and shortcut icons created in the Start menu Note At this point it is recommended that you verify the DCOM AN settings Reference to the DCOM configuration can be found in the DCOM Manual This configuration varies for different operating systems Installed Files The installation program copies all necessary files to the target computer and creates shortcut icons in the Start menu MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 21 MatrikonOPC The files listed in Table 3 are installed by default in the following location C Program Files Matrikon OPC Simulation File Name Description Plugins ACL sec Access control list containing users and permissions configured for the server ACLSecure e
13. Figure 31 Add Remove PrograMS oocccoonoconcnconnnconnncnnnncanancnnnnrnnanennnnrnnanrnnanrnnanencanennanens 62 Figure 32 Welcome to MatrikonOPC Server for Simulation Maintenance Screen 63 Figure 33 Ready to Uninstall WiNdoOW cmocccnonoconcncnnnncancncnnnncanancnnnncanancnnrncanrncnnrncananenss 64 Figure 34 Uninstalling MatrikonOPC Server for Simulation ScreenN ommcnonoconcncnonanananenos 65 Figure 35 MatrikonOPC Server for Simulation Setup Complete sceseseeeeseeeeeeeeeeeees 66 Figure 36 Distributed COM Configuration Properties WindOW cmomocoorocnonononcncnonacananenos 75 Figure 37 Distributed COM Configuration Security Tab coomccnonocnonacnnnacnnnncannncnnnncananenos 76 Figure 38 Registry Value Permissions WiNdOW occccococnnnncnnnncnnnncnnnncanrncnnrncanancnnancananenas 77 Figure 39 Add Users and Groups WiINdOW i mccococoococonnaconcncnnnacanancnnnnranrncnnrnranrncnnancananenss 77 Figure 40 DDE Share ccoonocoococoncnconnncononcnnnncnnnncnrnnnn enn rana near rana EE EEE E Ena ERES aa aaa ai aan naa i 88 Figure 41 Start Menu NavigatiON mcocoococoococnnnnconnncnnnncanancnnnncnnancnnrncnnrncnnrncananennancananeanns 91 Figure 42 Enter Server Password Window comccoocncnonoconcncnnnncanancnnnncanrncnnrncanrncnnnncananenss 91 Figure 43 MatrikonOPC Tag Security Configuration Utility Main Screen ccssseeeeseees 92 Figure 44 MatrikonOPC Tag Security Configuration Utility Main Screen Use
14. MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 108 MatrikonOPC Add Existing User Members Everyone COMPUTER NAME Administrator Usert Cancel Figure 61 Add Existing User Window 2 The Members screen section lists all the defined users from which you may choose Select one or more desired users to become members of the group 3 Click on the OK button The selected user or users appear in the Group Members screen section on the Members tab Figure 60 To remove a user from the group 1 Select that user in the Group Members screen section 2 Click on the Remove button Notes e Ifa user name and a group name to which the user belongs have permissions defined for the same location the user name will be used If a user belongs to two groups that have permissions defined for the same location the group that is alphabetically first will be used e The exact location full item ID for reading writing and adding or the full path for browsing is always looked for first when determining the permission for a particular user If the exact location is not found or is found but does not contain a defined permission then the closest match in location is looked at next and so on The root location i e empty string will always match and is used if no partial location match is made Delete To delete a previously added user or group 1 From the MatrikonOPC Tag Security Configuration U
15. Options 9 Create a new value using the context menu and choose New String Value from the menu GB EE E e E EE El E 1 6 v 10 Set the value of the LockServer entry to 1 Note To edit the value select the entry and select the Modify menu option from the Edit menu 11 Shut down the server and restart it for the change to take effect Cannot configure client access paths so cannot configure item options Problem The OPC client does not provide a means to configure access paths making it difficult to correctly specify the data acquisition options for the items Solution The server provides a global parameter for configuring an escape character to allow users to append communication options to the end of an item ID which would accommodate clients that do not support access paths Perform the following steps as shown with example below MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 56 MatrikonOPC Note Microsoft highly recommends that you back up the registry before editing it or making changes to it 1 From the Run command enter REGEDIT 2 The Registry Editor is launched In the Registry Editor under HKEY_CLASSES_ ROOT look for the required program ID e g Matrikon OPC Simulation 1 o Expand the program ID branch Click on the CLSID branch Record the global universal ID GUID Under the HKEY_CLASSES_ROOT CLSID b
16. Read item Saw toothed Waves UInt2 VT_UI2 Y INIONSA SKOTE SAVE OO WAVE z Read item Triangle Waves I nt4 VT_14 Y Integer Triangle wave Read item Triangle Saves Money VT_CY Y oo Tenge wave Read Table 25 Available Items Examples The following are examples of valid item IDs e Bucket Brigade Money e Random Real4 e Saw toothed Waves ArrayOfReal8 Dynamic Item Creation The OPC Server for Simulation has the ability to create many more items then what can be initially browsed for though the browsing interface Any item that is added under a simulation category is a valid OPC item for the Simulation server For example Bucket Brigade xxx and Square Waves yyy are valid items that can be added The behaviour of these items that are added will always be the same as the category to which they belong e g a Bucket Brigade item will be readable and writable but cannot change on its own a Saw Toothed Wave will ramp up to the maximum and then start coming back down Any new automatically created item is of the type MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 2 Motrikon0PC VT_BSTR This enables the Simulation server to easily create thousands of tags with data with no configuration required MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 51 MatrikonOPC Diagnostics The server supplies diagnostic information to assist operators and support personnel with troubleshooting commun
17. Simulation screen Figure 34 appears and the uninstall takes place MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 64 0 MatrikonOPC 4 Uninstalling MatrikonOPC Server for Simulation MatrikonOPC eeoo Feature Unpublishing Product Features Cancel gt Figure 34 Uninstalling MatrikonOPC Server for Simulation Screen 11 When the un install has finished the MatrikonOPC Server for Simulation Setup Complete screen Figure 35 appears stating that MatrikonOPC Server for Simulation was successfully un installed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 65 0 MotrikonOPC 4 ooo A Figure 35 MatrikonOPC Server for Simulation Setup Complete 12 Click on the Finish button to complete the un install and exit the Wizard 13 The program no longer appears listed in the Add or Remove Programs window MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 66 MatrikonOPC OPC Compliance For more information on OPC view the documents listed below as well as other OPC Specifications at http www opcfoundation org e OPC Overview 1 0 e OPC Common Definitions and Interfaces 1 0 e OPC Historical Data Access Custom Interface Standard 1 20 e OPC Data Access Custom Interface Standard 2 05 e OPC Data Access Custom Interface Standard 3 00 e OPC Alarms and Events Custom Interface Standard 1 10 Installation The server is by default installed as a local out of p
18. Synchronous Asynchronous ReadRaw Y Y ReadProcessed Y Y ReadAtTime Y Y ReadModified Not supported Not supported ReadAttribute Y Y Table 32 OPC Historical Data Access Custom Interface Standard v1 20 Read Functions Table 33 lists the update functions in the OPC Historical Data Access Custom Interface Standard v1 20 supported by the MatrikonOPC Server for Simulation 7 Supported Function Synchronous Asynchronous Insert Y Y Replace Y Y InsertReplace Y Y DeleteRaw Not supported Not supported DeleteAtTime Not supported Not supported Table 33 OPC Historical Data Access Custom Interface Standard v1 20 Update Functions Table 34 lists the annotation functions in the OPC Historical Data Access Custom Interface Standard v1 20 supported by the MatrikonOPC Server for Simulation z Supported Function Synchronous Asynchronous Read Not supported Not supported Insert Not supported Not supported Table 34 OPC Historical Data Access Custom Interface Standard v1 20 Annotation Functions Table 35 lists the playback functions in the OPC Historical Data Access Custom Interface Standard v1 20 supported by the MatrikonOPC Server for Simulation Function Supported ReadRawWithUpdate Not supported ReadProcessedWithUpdate Not supported Table 35 OPC Historical Data Access Custom Interface Standard v1 20 Playback Functions MatrikonOPC Se
19. Thay Men aia A A da 26 Control Panel iii Ad And 26 Configuration WindaW ceva ieeeeeas bee ed evden elaine cee ciier ea EEE AEE ders re vee ee 27 FUG Men ria A A wine A DA aa 29 Edit MO A ia 29 View MU a deveined ee 30 TOO MEU A A E dd ees pager A ii 30 Help Mena A a io 31 Options WIN Wii e ld 31 General OPTIONS canino in A de bbb denen ig A A AA 31 General Logging Options oooocccoccoccnccncconnncnnnancnnnnnnnnnnnnnnrnn nan nrrnnr nn ene nan n aa EEE 33 Interface Logging OptiONS oocooconccccccnconnncnnnnncnnnnnnnnnnnnnnn eee EEE EEEE ene EREE 34 Advanced ODPtions 0 c cece cnn aaa rra r ar eee eee 36 Server Config ratioN sssr ap pena tyne cee ge det eigen Png he Cees da EEA R A LP Ea eR ned eles rana 37 Alas Configuratio M wi toad aah ota Madea leeds Meo a 37 Inserting Alias GrOUPS cece renter r rar eet etna nnenaee 37 Renaming Alias Groups 0 cce eee rr rra narran eaten 37 Inserting New AllaS S is civoooiarita rt ta a aa a o le 37 Editing AllaSOS caia oa a A a date A 41 REMOVING AIIASES ana aaar RA a a Oa oa coo Pda 41 Removing Alias GrOUPS 0 caca 41 Exporting Alla SES ueri niies innia iie ai a nii r nna nant nena eee ami 41 Importing A OS hesien nO da 42 Expression WIiZa FO uracica raid tica dal ies o A eli aa a a a rt 42 tem Path BrOW SEM anciana aa 46 Saving a CONfIgUFatiON ooococccccnccoccnncnnnncnnncnncnncnnnnnnnrnn nera r ran aAa aa Eai 48 Clearing a ConfiguratiON xi dda ede a rr a
20. The Alias Group is renamed Inserting New Aliases Use the Insert New Alias window Figure 18 to insert a new alias into an Alias Group or insert a new alias on its own directly under the Alias Configuration node MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 37 MatrikonOPC Y Insert New Alias Alias Settings Name Item Path Data Type Update Rate fo msec Save amp Create New M Default to new Scaling gt gt Cancel A MMO Default X Read only Poll when inactive Figure 18 Insert New Alias Window Table 21 describes the components of the Insert New Alias window Component Description Name Name for the alias unique within the alias group Item Path Fully qualified item ID for the OPC item to which the alias refers Click on the ellipsis button to display the Item Path Browser window used to select an existing OPC item on the server Alternatively leave the item path blank to use the alias as a general in memory variable When doing so either define the data type for the alias point as something other than Default or have the alias set for reading and define the data type while writing values to the alias from an OPC client This component is disabled when the Calculation form of scaling is used Item paths are specified in the calculation itself Data Type Set the value of the OPC item to the specified type unless Defaul
21. a user from a o rs Create a new private user From this Location COMPUTER NAME User Check Name Cancel Figure 45 Add User Window NT 3 By default the local machine name appears in the From this Location field To browse to a different location click the Locations button 4 The User field can be entered manually Clicking on the Check Name button performs validation on the entered user The user names are the same as the Windows NT domain names used on the network To avoid manually entering a user click on the Search button and select a user from the displayed list of users 5 To add the selected user click on the OK button The user is then added to the list of users and or groups currently defined refer to Figure 46 for a sample list of defined users and groups 6 The Edit lt Username gt window Figure 51 appears Follow the instructions in the Edit User section for adding permissions MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 94 MatrikonOPC Group Group Default User E Userl Private User Add Group Change Password Show Help MatrikonOPC Server for Simulation and Testing Figure 46 Defined Users and Groups Private User Private users have names and passwords associated with them custom to the OPC client application which must implement the OPC Security Private interface for this section to be meaningful Private users exist only in the OPC
22. but rather are used for browsing organization Configuring permissions for adding reading and writing will not affect items below it For more information refer to Permissions MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Add Permission Server Address Space BA B Simulation Items 3 Bucket Brigade 2 E H 0 Read Error 3 Saw toothed Waves O Square Waves 13 Triangle Waves Ea write Error 9 Write Only m HOfflineMode H Configured Aliases m Monitor4CLFile rad Clients Random Figure 54 Add Permission Window Browsing Server Address Space 4 Click on the OK button 5 The selected path or item will be listed in the Configured Paths screen section of the Edit User window Permissions can now be assigned as in the example depicted in Figure 55 Note In this example Userl is allowed to browse the Random path of the OPC server s address space Adding privileges are denied and Reading and Writing privileges are unspecified MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 103 MatrikonOPC Edit User Permissions General Configured Paths Add Permissions Allow Deny Unspecified Browse Add Read Write Figure 55 Edit lt Username gt Example On the General tab Figure 56 of the Edit lt Username gt window the name and password of the user can be changed To edit a user s name 1 Enter a new name
23. displays its leaves in the Leaf List component Branch Hierarchy Displays the list of leaves belonging to a selected branch from the Leat LISE Branch Hierarchy Left clicking a leaf enables the OK button OK Select this button to add the selected item from the Leaf List to the Input Output component of the Insert New Alias form Select this button to exit the Item Path Browser without adding any Cancel item paths Select this button to refresh the browsing hierarchy in the Branch Refresh Hierarchy component Table 24 Item Path Browser Options Note The Item Path Browser appears and functions the same for an input calculation as it does for an output calculation To create an Input or Output Calculation with item paths 1 On the Configuration window select Alias Configuration or a previously configured Alias Group 2 The Contents table for that Alias Group is displayed on the right side of the Configuration window Figure 13 listing the aliases it contains 3 Either create a new alias for instructions see To insert a new alias or Double click your mouse on an existing alias or MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 46 MatrikonOPC Right click your mouse on an existing alias and select the Edit Alias option from the displayed menu 4 Click on the Scaling button to enable scaling for the alias The Scaling Options are displayed at the bottom of the Insert New Ali
24. is used in OPC Security OPCSecurityPrivate describes how proprietary user credentials are used in OPC Security The OPC Security specification defines how user credentials are passed from client to server but very little else The type of functionality in an OPC server that is controlled by OPC Security is vendor determined Appendix Structure This appendix is structured as follows e Introduction this introductory section e OPC Security Implementation description of user access dependencies e MatrikonOPC Tag Security Configuration Utility describes the utility that is used to configure security for MatrikonOPC servers e Security Details describes how permissions are applied how security settings are stored and other important details OPC Security Implementation Whether a user has access or not will depend on 1 Identity the user behind the OPC client s actions 2 Location the OPC item ID or hierarchy path being accessed 3 Type the type of functionality the user is trying to perform Identity Using the IOPCSecurityNT interface for OPC Security the identity of the OPC client is the domain user that is running the OPC client and connecting to the OPC server The OPC Framework will attempt to impersonate the client that is connected to the server and use the name from those credentials for access control This method does not require any implementation of OPC Security by the OPC client since no interface calls ar
25. not show up Problem The About screen and Configuration window do not who up when a remotely connecting client or a client that runs as a Windows server such as Aspen Technologies CIMIO OPC Manager tries to launch the OPC server Either set the identity for the OPC server to the interactive user or consider running the server as a Windows service For more information refer to Appendix A Distributed COM DCOM Solution DA 2 0 asynchronous I O does not work Problem After installing an older OPC server DA 2 05a asynchronous 1 0 no longer works The old installation program installed and registered its own older version of the OPC id proxy stub DLL Reinstall the standard OPC proxy stub DLLs using an up to date installation program or re register them using the REGSVR32 command line utility refer to the OPC Compliance Installation section in this manual Trouble communicating through a network Problem Problems communicating to the remote machine through a network Make sure users can ping the device Use Start gt Run with command CMD to bring Solo up a command window Enter the following Ping ipaddress e g C temp gt ping 127 0 0 1 Pinging 127 0 0 1 with 32 bytes of data Reply from 127 0 0 1 bytes 32 time lt 1l0ms TTL 128 Reply from 127 0 0 1 bytes 32 time lt 1l0ms TTL 128 Reply from 127 0 0 1 bytes 32 time lt l0ms TTL 128 Reply fr
26. of the alias to update the OPC item If the OPC item being referenced in a calculation is found within the servers address space the server creates a subscription to it using the lowest update rate of the item and the alias For example if the update rate of Com1 Rtu Regl is ten seconds and a subscription is created to an alias with an update rate of one second the new update rate of the OPC item is one second When the subscription to the alias is cancelled the item returns to using the previous update rate However if the option Poll Always is enabled for the alias the server will always have a subscription to that alias and therefore the lower update rate of the alias is used In the event that the server cannot create a subscription to the OPC item the alias quality reports Bad bad configuration Alias scaling calculations may use any of the operators listed in Table 37 Construct Description Examples Minus operator x y Unary minus operator X Not logical operator Returns 1 if x is 0 else returns 0 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Construct Description Examples I Not equal logigal operator giy Returns 1 if true 0 if false nae find remainder of the division of x x y And logical operator ates 1 if pe O if false one a Multiplication operator x
27. pre defined tag such as Bucket Brigade Boolean or Square Waves I ntl An example of a new simulation item is Bucket Brigade xxx or Square Waves yyy Thus a new simulation item consists of a valid existing simulation item type and a period followed by a string that does not refer to a pre defined data type The event notification sent to the A amp E client is as follows Attribute Description Simulated item type which is a reference to the object that generated the event notification Source Time The time that the event occurred Event Category 2 set by the server Severity 1 which indicates a low severity Message The following string New simulation item created Table 27 Simulated I tem Creation Event Event Notification Attributes Historical Data Access Functionality The MatrikonOPC Server for Simulation is capable of acting as a Historical Data Access server by caching values in a rolling buffer which is capable of storing a maximum of 100 items that can be read back using function calls contained in the HDA Custom Interface An HDA client can be used to connect to the Simulation server and perform a variety of read and update operations on a variety of different simulation items Performing an update operation will write data to the buffer while performing a read operation allows the user to view data that is already present in the buffer The following table displays the types
28. server They are not created in any NT domains To add a Private user 1 From the MatrikonOPC Tag Security Configuration Utility main screen click on the Add User button 2 The Add User window Figure 45 appears 3 Select the Private User option button Figure 47 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 95 MatrikonOPC Add User NT User Private User Add a user from a A e A Create a new private user Username Password Password Confirmation Private users exist only in the OPC Server They are not created in any NT domains Usernames and passwords are stored in an encrypted file Cancel Figure 47 Add User Window Private In the Username field enter a user name In the Password field enter a password In the Password Confirmation field re enter the new password oy i oe Click OK to create the Private user It will be added to the list of users and or groups currently defined refer to Figure 46 for a sample list of defined users and groups Note The user name cannot be added if there is already a configured User or Group with that same name Add Group Groups are used to group users together so that they can share common permissions Groups are not necessary to use OPC Security However they are convenient when you need to apply common permissions to multiple users A group must contain at least one user and any combination of users can be grouped
29. the View menu select the Options menu item 2 The Options window appears 3 From the Options window select the Advanced tab Figure 17 Options General General Logging Interface Logging Advanced M Timing S You can fine tune specific timing attributes H of the server OPC Group Update ho Rate minimum 100 msec Time granularity 100 msec You can customize the way the server provides data through DDE Enable DDE Communication DDE Service Name Matrikon _OPC_Simulatio DDE Item Delimiter Defaults Cancel Figure 17 Advanced Options Tab Table 20 describes the fields available on the Advanced options tab Field Description Minimum update rate milliseconds allowed for an OPC group OPC Group Update Rate Prevents OPC clients from requesting update rates that are impossible minimum to achieve or that cause heavy CPU loads The default value is 100 ms OPC server group scan thread interval milliseconds Determines the Time granularity maximum resolution for data change detection Time granularity should always be equal to or less than the minimum group update MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 36 MatrikonOPC Field Description rate DDE Configures the way the server provides data through DDE Table 20 Advanced Options Tab Fields Note The server loads these settings from the Windows registry on start up Cha
30. the server configuration is complete use the Save Configuration window to save the configuration to an XML file To save a configuration to an XML file 1 From the File menu select the Save As menu option or click on the ll button alternatively users can choose Save or click ll 2 The Save Configuration window appears 3 Enter a file name if saving the file for the first time 4 Click Save 5 The configuration is saved Clearing a Configuration Note Starting a new configuration will clear the existing one To clear a configuration 1 From the File menu choose the New menu option or click on the L button 2 If OPC clients are still connected to the server a warning message appears 3 Click OK 4 The configuration is cleared Loading an Existing Configuration To load an existing configuration file From the File menu select the Open menu option or click on the 5 button The Open Configuration window appears Browse for the configuration file that you want to load Click Open If OPC clients are still connected to the server a warning message appears AL eN Notes e At this stage the connection between the server and the client needs to be broken e When the new configuration is completely loaded the changes will take effect in the OPC client Click OK 7 The old configuration is cleared and the new configuration is loaded from the file MatrikonOPC Server for Simulation v1 5 0 0 User s Man
31. to step 14 or Perform steps 9 through 13 using a combination of the Function Variable and Operators buttons to create your expression which will be displayed in the Input Output Expression field as you build it 9 Click on the Function button to go to the Select function Figure 23 window After selecting the required function click on the Continue button to close the Select function window and return to the Expression Wizard Expression Wizard M Select function Category All erta IF lt Exp gt lt X gt lt Y gt Returns lt gt or lt gt depending on the boolean expression lt Exp gt Figure 23 Select Function Window MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 44 MatrikonOPC 10 Click on the Variable button to go to the Select variable Figure 24 window After selecting the required variable click on the OK button to close the Select variable window and return to the Expression Wizard Expression Wizard Select variable INPUTQUALITY INPUT TIME NOW APPSTART TIME APPSTARTDATE APPNAME Value Modify variables Figure 24 Select Variable Window 11 If required from the Select variable window click on the Modify variables button to access the User Defined Functions Editor Figure 25 which allows you to add change or delete variables User Defined Functions Edtor Available User Defined Functions Local defines C Global defines INP
32. together Note A user can exist in multiple groups but if two or more of the groups have the same configured path refer to the Edit User section and each group defines a permission Allow Deny for the type of access then the group whose name alphabetically comes first is used There are two types of groups for which security can be configured NT Groups and Private Groups NT Group To add an NT group 1 From the MatrikonOPC Tag Security Configuration Utility main screen click on the Add Group button MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 96 MatrikonOPC 2 The Add Group window Figure 48 appears The NT Group option button is selected by default This will allow the addition of an NT group from a Windows NT Domain Add Group NT Group C Private Group Add a group from a a Create a new private group From this Location COMPUTER NAME Group Check Group Cancel Figure 48 Add Group Window NT 3 By default the local machine name appears in the From this Location field To browse to a different location click the Locations button 4 The Group field can be entered manually Clicking on the Check Group button performs validation on the entered group The group names are the same as the Windows NT domain group names used on the network To avoid manually entering a group click on the Search button and select a group from the displayed list of groups
33. were to see the sentence Refer to Figure 1 for more information pressing the MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 9 MatrikonOPC CTRL key and clicking your mouse on the text Figure 1 will automatically take you to the location of Figure 1 within the document This manual consists of several chapters and is structured as follows Introduction this introductory chapter Getting Started provides instructions for installing the software and MatrikonOPC Support team contact information Configuration shows how to start and configure the server and describes each component in detail including windows screens panels tabs and menu commands OPC Data Items describes the server s items Diagnostics explains how to use logging statistical items data qualities and timestamps and result codes to get the most efficiency from the user s system Limitations provides information on specific performance and operational limitations of the software if any Troubleshooting provides solutions for common problems that may be encountered and answers to frequently asked questions Un installation provides instructions on un installing the software OPC Compliance details supported interfaces with regard to installation common interfaces and data access Appendices o A DCOM o B Aliases o C Standard Data Types o D Microsoft Excel as a DDE Client o E Security Referenc
34. y Division operator x y di Calculates x raised to the power of y x y Or logical operator siy Returns 1 if true 0 if false Addition operator x y Lesser than logical operaron isy Returns 1 if true 0 if false lt Lesser than or equal logical operator Returns 1 if true 0 if false RETI Equal logical operator Returns 1 if true 0 if false E gt Greater than logical operator Returns 1 if true 0 if false eae gt Greater than or equal logical operator Soy Returns 1 if true 0 if false Table 37 Calculation Operators for Alias Scaling Alias scaling calculations may use any of the functions listed in Table 38 Construct Description Examples abs Absolute value abs x acos Arccosine acos x asin Arcsine asin x atan Arctangent atan x avg Returns the average of a set of values avg v1 v2 V3 bin Converts a binary number to a decimal bin binNumber number ceil Ceiling ceil x cos Cosine cos x cosh Hyperbolic cosine cosh x MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Construct Description Examples derivate Differentiate the expression with respect to Aena a one variable at the specified point variable point fact Returns the factorial of x x x fact x 1 x 2 x x 1 floor Floor floor x hex Converts an hexadecimal number to a hex hexNumber decima
35. 0 User s Manual 1S5 MatrikonOPC Destination Folder HTML Help Workshop A a DT 1 InstallShield Installation Information 5 Intel 5 Internet Explorer Matrikon E E OOO 5 Messenger 5 Microsoft Microsoft ActiveSync 5 Microsoft Device Emulator 5 microsoft frontpage Microsoft Office al S eeo O Ci Program Files Matrikon OPC ETE a AAA A Figure 4 Destination Folder Screen 8 Select the folder in which to install the MatrikonOPC Server for Simulation Note By default the C Program Files Matrikon OPC folder is selected 9 Click on the Next button The Start Menu screen Figure 5 appears MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 16 MatrikonOPC foe Ct at ae EZE E coca OE ____________ _ _ Figure 5 Start Menu Screen 10 Select the Start Menu group and specify whether you want shortcuts created only for yourself or for all users by selecting the applicable option 11 Click on the Next button The Enter Password screen Figure 6 appears MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 17 O MotrikonOPC E Soa aR aR eeee Figure 6 Enter Password Screen 12 A default password is supplied for you in the Password and Confirm Password fields Notes e The default password provided for you is MatrikonOPC Note this password for future reference DA e If you need to change the pas
36. 9 Registry Editor 4 Expand the program ID branch 5 Click on the CLSID branch 6 Record the global universal ID GUID MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 55 MatrikonOPC 2 Registry Editor View Favorites Help H MakeCab MakeCab 1 Name Data a mapi ab Default F8582CF2 88FB 11D0 B850 00C0F0104305 E 13 MAPI Session Y MAPI Session 1 Y MapiCvt MapiCvt A MapiCwt MapiCvt 1 E mapifvbx object 3 mapifvbx object 1 C MARQUEE MarqueeCtrl 1 E Matrikon OPC Automation 5 Matrikon OPC Automation 1 5 Matrikon OPC IEC60870 5 Matrikon OPC IEC60870 1 5 Matrikon OPC Simulation 5 Matrikon OPC Simulation 1 SN J opc 5 Matrikon OPC TunmellerHDA Y Matrikon OPC TunnellerHDA 1 Y Matrikon OPCHDA Automation 3 Matrikon OPCHDA Automation 1 Y mccsserver mccsserver 1 Y MccSServer MCCSCategory E MccsServer MCCSCategory 1 Y MccsServer MCCSColor E MccsServer MCCSColor 1 ER MAACO won en BAKO ON wm mre mn lt IM gt lt My Computer HKEY_CLASSES_ROOT Matrikon OPC Simulation 1 CLSID Figure 30 Program ID Branch 7 Under the HKEY_CLASSES ROOT CLSID branch search for the GUID retrieved in the previous step e g HKEY_CLASSES ROOT CLSID 024C7FFC 9CC3 476f 867A BC3CAD79F4FE 8 Create a string value called LockServer in the Options branch underneath the GUID e g HKEY_CLASSES_ROOT CLSI D 024C7FFC 9CC3 476f 867A BC3CAD79F4FE
37. Access The server supports the mandatory functionality specified in the OPC Data Access Custom Interface Standard MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Groups The server supports the addition removal and cloning of private groups The server allows the client to manage group state e Name e Active state e Update rate 100 millisecond resolution e Time bias e Dead band percent of analog item high low range Items The server supports the addition removal and validation of items in a group The server allows the client to manage item configuration e Active state e Requested data type e Dead band percent of analog item high low range e Sampling rate e Buffer values used only when sampling rate is enabled and is sampling faster than the group update rate Browsing and Item Properties The server supports address space browsing e Hierarchical address space e Simulate flat address space e Branch leaf name filter pattern matching e Item data type filter e Item access rights filter The server supports the following mandatory item properties e Value quality and timestamp e Canonical data type e Access rights e Scan rate 1 O Operations The server supports synchronous I O operations e Read active item values from cache e Read item values from device e Read items value from device based on how old the cache items value is e Read items without adding the
38. Cancel outstanding operations The server supports the data change event notification client side interface as defined for DA 1 0a e Data change or dead band exceeded data with time stamps e Data change or dead band exceeded data without time stamps e Asynchronous write operation complete Alarms and Events Functionality The MatrikonOPC Server for Simulation can be used to simulate simple events and send notifications of these events to client applications The events that can be generated fall into two categories e Simulated Event e Simulated Item Creation Event MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 5Je MatrikonOPC Simulated Event A Simulated Event is generated every time a write operation is performed on a Bucket Brigade item of type string An event notification containing the following attributes are sent to the client Attribute Description Bucket Brigade String which is a reference to the object that generated the event notification Source Time The time that the event occurred Event Category 1 set by the server Severity 1 which indicates a low severity Message The string that is written to the Bucket Brigade item by the user Table 26 Simulated Event Event Notification Attributes Simulated I tem Creation Event A Simulated Item Creation Event is generated when a new simulation item is created Note This is different than simply adding a
39. Client named at the end of this License eeee The following are the terms and conditions under which Matrikon Inc provides this evaluation copy of the Matrikon Simulation Server 1 Definitions 1 1 Licensed Product s means the Matrikon Simulation Server including its compiled object including their API s as well as any images photographs templates animations audio text and applets and online or electronic or printed documentation of the Matrikon software referred to in this License 1 2 Computer System means the computer hardware equipment on which the Client has elected to install and or execute the Licensed v o O I reject the license agreement i Figure 2 License Agreement Screen 3 Read the Software License Agreement using the scroll bar to view the entire message 4 Select the I accept the license agreement option Click on the Next button The Setup Type screen Figure 3 appears Note From this point onward the Back button is available allowing you to return to the previous screen or screens MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 14 O MatrikonOPC E MatrikonOPC eee E E E eeeo ORIO ULA e a _ QQ Figure 3 Setup Type Screen 6 Select the type of setup to be performed Note Matrikon recommends that you select the Complete Setup option 7 Click on the Next button The Destination Folder screen Figure 4 appears MatrikonOPC Server for Simulation v1 5 0
40. Marshalling Library Opcenum exe OPC server list component opcproxy dll OPC Data Access 2 05 and 1 0a Interfaces and Marshalling Library opcSec_PS dll OPC Security Interfaces and Marshalling Library Table 5 Files Installed in system32 Folder Licensing Most MatrikonOPC products require some form of licensing criteria be met to ensure that it functions successfully The MatrikonOPC Server for Simulation supports neither software nor hardware licensing Contacting Support The MatrikonOPC Customer Services department www opcsupport com is available 24 hours a day seven days a week MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Contact MatrikonOPC Support using the information below or send an email support MatrikonOPC com For Monday to Friday daytime support requests contact MatrikonOPC Support using the regional phone numbers provided in Table 6 Region Office Hours Contact I nformation oon 8 00 am 5 00 pm 1 877 OPC 4 ALL UTC GMT 7 hours MST i did Europe Africa 49 221 969 77 0 9 00 am 5 00 pm UTC GMT 1 hours CET Request OPC Support Middle East 5 973 174 UTC GMT 3 hours 9 00 am 5 00 pm 973 65363 Australia Asia 61 2 4908 2198 9 00 am 5 00 pm UTC GMT 10 hours AEST Request OPC Support Toll free regional numbers coming soon Table 6 MatrikonOPC Support Regional Contact I nformation For after hours support in a
41. MatrikonOPC Command Description Removes the currently selected object from the server configuration Prompts the user for confirmation before continuing to see if the OPC clients X Delete have reference to items associated with the selected object or one of its children Does not remove such objects but simply disables them and sets them to marked for deletion ae Define New Displays the Insert New Object window used to create a new configuration object under the currently selected configuration object Table 12 Edit Menu Commands Server Configuration Table 13 describes the Edit menu commands that appear when the currently selected object appears under the Alias Configuration node Command Description Undo Can t Undo Not implemented Ey Rename Renames the currently selected alias group This option is only available once a group has been created and then selected X Delete Alias Group Removes the currently selected alias group and all subordinate groups and aliases Delete Alias Removes the currently selected aliases Insert Alias Group Creates a new alias group under the currently selected alias group Insert New Alias Displays the Insert New Alias window used to create a new alias under the currently selected alias group View Menu Table 13 Edit Menu Commands Alias Configuration Table 14 describes the View menu commands
42. REGSERVER command line switch Starting server manually when installed as a service Problem Does the server need to be started manually when it is installed as a service Solution No the first OPC client that tries to connect will start the OPC server Search the MatrikonOPC Support Knowledge Base at www opcsupport com to find the answers to other commonly asked MatrikonOPC Server for Simulation questions MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 61 MatrikonOPC Un I nstallation To successfully un install MatrikonOPC Server for Simulation using the Add orRemove Programs from the Microsoft Windows Control Panel is recommended To un install MatrikonOPC Server for Simulation 1 Click on the Start button and highlight the Control Panel item 2 From the displayed menu select Add or Remove Programs 3 The Add or Remove Programs window is displayed 4 Scroll through the list of currently installed programs and updates to find and select MatrikonOPC Server for Simulation Figure 31 ES Add or Remove Programs Ea tx ad Currently installed programs O Show updates Sort by Name Change or Remove Bl matrikonOPC Analyzer Size 1 54MB Programs A MatrikonOPC Explorer Size 242 00MB F D MatrikonOPC Server for APACS Size 2 93MB Add New 2 MatrikonOPC Server For OpenBSI 5 83MB Programs A E MatrikonOPC Server For RS3 RNI i 4 13MB a 7 MatrikonOPC Server for Simulatio
43. System Requirements The software has Software and Hardware system requirements These requirements must be met for the software to function properly up as an administrative user account rather than a restricted user i Note To install and configure a MatrikonOPC server you must be set account Software Requirements The following software is required e Microsoft Windows XP or e Microsoft Windows 2003 or e Microsoft Windows 2000 Note It is recommended that the most current service packs are installed Hardware Requirements The following hardware is required e Intel Pentium 4 Processor e 512 MB RAM e 40 GB 7200 RPM Hard Drive Installation Once the system requirements have been met you are ready to install the software MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 12 MatrikonOPC Notes e Prior to starting the installation process it is recommended that you make sure that the Data Execution Prevention DEP is set to Turn on DEP for essential Windows programs and services only If not you will need to re install the product DEP does not affect all operating systems i e DEP is DA used in XP SP2 and 2003 SP1 e As part of the installation process the MatrikonOPC Analyzer tool is installed and used to detect the system settings that affect the use of this software No information is communicated back to Matrikon Information is stored on this system only for future use by MatrikonOPC Su
44. T_R8 8 byte double precision real 0006 6 VT_CY Currency 0007 7 VT_DATE Date 0008 8 VT_BSTR Text UNI CODE 000A 10 VT_ERROR Error code 000B 11 VT_BOOL Boolean TRUE 1 FALSE 0 0011 16 VT_I1 1 byte signed integer 0012 17 VT_UI1 1 byte unsigned integer 0013 18 VT_UI2 2 byte unsigned integer 0014 19 VT_UI4 4 byte unsigned integer 2002 8194 VT_ARRAY VT_12 Array of 2 byte signed integers 2003 8195 VT_ARRAY VT_14 Array of 4 byte signed integer 2004 8196 VT_ARRAY VT_R4 Array of 4 byte single precision real 2005 8197 VT_ARRAY VT_R8 Array of 8 byte double precision real 2006 8198 VT_ARRAY VT_CY Array of currency values 2007 8199 VT_ARRAY VT_DATE Array of dates 2008 8200 VT_ARRAY VT_BSTR Array of text values 200A 8202 VT_ARRAY VT_ERROR Array of error codes 200B 8203 VT_ARRAY VT_BOOL Array of Boolean values 2011 8208 VT_ARRAY VT_I1 Array of 1 byte signed integers 2012 8209 VT_ARRAY VT_UI1 Array of 1 byte unsigned integers 2013 8210 VT_ARRAY VT_UI2 Array of 2 byte unsigned integers 2014 8211 VT_ARRAY VT_UI4 Array of 4 byte unsigned integers Table 45 Standard Data Types MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Appendix D Microsoft Excel as a DDE Client Microsoft Excel can act as both DDE client and DDE server When using Excel as the client DDE items can be bound to specific cells in a spreadsheet creating a read only hot link to the DDE items Using Visual B
45. The a default password set during the installation of this server is MatrikonOPC Security Settings The MatrikonOPC Tag Security Configuration Utility screen is then displayed which allows you to configure security settings For more information refer to Appendix E Security Table 15 Tools Menu Commands Help Menu Table 16 describes the Help menu commands Command Description MatrikonOPC on the Opens a link to the MatrikonOPC web site Web User s Manual Opens this User s Manual Displays the Welcome screen which includes information about the About i software version Table 16 Help Menu Commands Options Window The Options window is used to edit the server s options and contains four tabs General General Logging I nterface Logging and Advanced General Options The General tab allows users to edit general server options i e settings To view the General options 1 On the Configuration window from the View menu select the Options menu item 2 The Options window appears 3 From the Options window select the General tab Figure 14 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 31 MatrikonOPC Defaults Options General General Logging Interface Logging Advanced Configuration File You can customize the way the server saves and loads its configuration files Save current configuration on shutdown al i Backup 0 E copies Loa
46. UTQUALITY INPUT TIME NOW Add Edit Delete Figure 25 User Defined Functions Editor 12 The Operators buttons Figure 26 allow you to enter an operation descriptor based on the selected button MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Figure 26 Operators Buttons 13 Click on the Validate button to determine whether or not the expression is valid 14 If the expression is valid i e a confirmation message is displayed click on the OK button to close the message window and return to the Expression Wizard screen 15 Click on OK button on the Expression Wizard screen to close the wizard and display the expression in either the Input or Output field depending on which expression you defined 16 From either the Insert New Alias or Edit Alias window click on the Save button 17 The Insert New Alias or Edit Alias window closes and you are returned to the Configuration window Item Path Browser The Calculation form of scaling uses the Item Path Browser to add item paths The created formula is a simple text equation that is applied to either incoming values i e reads or outgoing values i e writes Table 24 describes the Item Path Browser fields Component Description Displays the branch hierarchy of the OPC server when browsing actions are being performed The symbols can be used to display hide the branches below the specified branch Left clicking a branch
47. ads these settings from the Windows registry upon start up Changes to the General options settings take effect when the server is restarted General Logging Options The General Logging tab allows users to edit general logging options To view the General Logging options 1 On the Configuration window from the View menu select the Options menu item 2 The Options window appears 3 From the Options window select the General Logging tab Figure 15 Options General General Logging Interface Logging Advanced General Activity Logging You can customize the way the server records error and debug information V Enable activity logging Loy I Commit all log file writes Y Overwrite old log information Filename C Program Files Common Files Filtering Enter a Filter string and an associated file if you want a filtered log Filter String Filename C Program Files Common Files Defaults po i Cancel Figure 15 General Logging Options Tab Table 18 describes the fields available on the General Logging tab Field Description Enable activity logging Enables disables general activity logging at the specified detail level MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 33 MatrikonOPC Field Description High Medium Low or None if selected Note This option should not be selected unless users are debugging a problem as this will have a ne
48. ains the additional fields listed in Table 40 Field Description High Raw Raw value range double precision real Low Raw High Scaled Scaled value range double precision real Low Scaled Clamp options 0 none Clamp 1 clamp low value 2 clamp high value 3 clamp both high and low values MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Table 40 Additional File mport Export Field Descriptions Linear Square Root Scaling When the scaling field specifies gain offset 3 scaling the line contains the additional fields listed in Table 41 Field Description Gain Scaling factor double precision real Offset Scaling offset double precision real Table 41 Additional File mport Export Field Descriptions Offset Scaling When the scaling field specifies expression 4 scaling the line contains the additional fields listed in Table 42 Field Description Input Expression Simple formula applied to the value read from the OPC item Simple formula applied to values written to the OPC item The Output Expression output formula should be the reciprocal of the input formula Table 42 Additional File I mport Export Field Descriptions Expression Scaling When the scaling field specifies calculation 5 scaling the line contains the additional fields listed in Table 43 Field Description
49. aling Expressions Alias scaling expressions may use any of the expression constructs listed in Table 36 Construct Description Examples i Text value single hello rene quotation marks Joe s Alias Addition or Append Hoxj Subtraction 2 74 1 8 2 Multiplication and hi there Division Equal To Less Than _ ee Greater Than Unequal a a To Less or Equal To a Greater or Equal To Logical Not Logical And _ Not And Or Logical Or May also be en A 12 And 5 4 used for binary math TIME Current time as text The time is TIME DATE Current date as text Today is DATE INT x Returns the integer part INT 3 14 3 of x FRAC x Returns the fractional FRAC 3 14 0 14 part of x SORT x dial the square root SORT 16 4 DIV x y Divides x by y DIV 42 7 6 Returns x if expression _ A apc IF expr x y evaluates to TRUE TES ea 12 OK Bad OK otherwise returns y TRUE FALSE Constant Boolean true 5 gt 6 FALSE and false Returns the data type of x as a text description TYPEOF x STRING INTEGER TYPEOF hello STRING FLOAT BOOLEAN ERROR STR x Converts the numeric STR 3 14 3 14 value x to text UPPER x Converts the text value x UPPER alarm ALARM LOWER x to all upper case or lower LOWER ALARM alarm PRETTY x case letters or the f
50. as window Figure 18 or the Edit Alias window Note Whether the Insert New Alias window or the Edit Alias window is displayed depends on whether you are creating a new alias or editing an existing one 5 Select the Calculation tab Figure 27 Expression Calculation Linear Square Root Gain Offset Input FO E Figure 27 Calculation Tab 6 Click on the ellipsis button adjacent to the Input field or Output field 7 The Item Path Browser Figure 28 is displayed item Path Browser Sy Simulation Items Refresh Figure 28 Item Path Browser 8 Browse the Branch Hierarchy until you find the branch containing the leaf you are interested in 9 Left click your mouse on the leaf in the Leaf List and press the OK button The item path is inserted surrounded by square brackets into the Input Output component of the Insert New Alias form 10 Edit the calculation in the Input Output component until the syntax is finalized Refer to Table 37 and Table 38 for more information on the calculation syntax 11 Perform steps 9 through 11 for any additional item paths you wish to add to the calculation MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 47 MatrikonOPC 12 From either the Insert New Alias or Edit Alias window click on the Save button 13 The Insert New Alias or Edit Alias window closes and you are returned to the Configuration window Saving a Configuration Note When
51. asic Excel can also be used to transmit write the data contained in a specific cell of a spreadsheet to a DDE server DDE Read To perform a DDE Read using Excel simply enter a DDE Item as a formula in some spreadsheet cell SERVI CE TOPIC NAME Excel will initiate a DDE Advise loop or hot link to the topic and item within the service The DDE Management system in this case Windows will forward any update sent by the DDE service to the appropriate DDE client in this case Microsoft Excel The DDE service is responsible for update rate behaviour To disable a specific hotlink in Excel use the Links menu option under the Edit menu Special Characters in Excel Excel reserves the use of specific characters for use in any cell If a SERVICE TOPIC or NAME contains any special characters surround the specific field with single quotation characters SERVI CE TOPI C NAME SERVI CE TOPI CNAME SERVI CE TOPI C NAME To include single quotation characters in the name enter two simultaneous single quotation characters matrikon_opc_simulation_1 Power Generator s Value 1000 DDE Write To perform any DDE command other than requests read or advise hot link a Visual Basic VB function must be used Most DDE commands are available by using the application object For example the following function will poke write the contents of column 1 row 1 to an item in the OPC Simulation
52. atrikonOPC server the following e Who has permission e Which tags locations they have permissions for e The type of permissions for those locations Security settings configured using this utility are read by the OPC Framework and populated in memory upon server start up and are monitored for changes Note In order for the MatrikonOPC Tag Security Configuration Utility to work properly the windows user running the utility must have Administrator rights to the computer The MatrikonOPC Tag Security Configuration Utility is a component of an OPC server installation and is installed in the following location C Program Files Common Files MatrikonOPC Common ACLConfig exe The MatrikonOPC Tag Security Configuration Utility can be run either directly from its installed location or from a shortcut found in the Start Menu If the utility is run from the installed location then the user must select the OPC server for which security will be configured If the MatrikonOPC Tag Security Configuration Utility is run from the shortcut then it will configure security for the OPC server to which the shortcut belongs MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 90 MatrikonOPC To run the MatrikonOPC Tag Security Configuration Utility from its shortcut 1 Click on the Windows Start button 2 Select Programs gt MatrikonOPC gt lt OPC Server Name gt gt Tag Security B Maintenance r CEL oe gt 2 Micros
53. ce cece eee iienaa iiien anie ina Aa iao da eee 68 I O OPSRALIONS inician a A da di bo 68 Alarms and Events Functionality 0 cece cece ene nnnnnrrnnennrnnrnannnnnes 69 Simulated Eventual bit reel al dese aaa o a ie a edge aa a eaaa da 70 Simulated Item Creation EVent cece eee nnn eae enae 70 Historical Data Access Functionality oooococcccccccnccnccnnconcnnnnnnnnonncnnnnnnnnnn eee net nee eee nee 70 Read Functionality cuina cee be Maeva o Ai il di 71 Update Functionality 00 cece ee eee rn rnnrnnranrnnnnnnanennnanes 72 MatrikonOPC Server for Simulation Functionality cccccceec eee eect ee eee eee eee e teen ee na eeaes 72 Table of Appendices Appendix A Distributed COM DCOM cccccsccccccceneeneeneeceeneeeneeseeseeeeeneeeeeneeseeneeaeeeenanease 74 DCOM Configuration Utility ooooocccccnccccccccnccnccnncnnnnnncnnnnonncnnnnnnnnnnrn nn EnEn tenet nae ee tenes 74 Default Properties susi c sitters ido a a heen othe ideas el ett iia bd 74 Security PerMisSiONS ooococonccnccnccnncnnnncnncnnnrnn cnn rre ene ren nr rn Eaa 75 Server Identity cion A A bebe deeded ede 78 Default ProtocolS vitral tar A a il dt 78 Remote Program D 0 ccc rn 79 Appendix B AliaSeS coomccoonoconcncnnnncanancnnnncnnnncnnnnrnnnnrnnnrnnnnrnnnnrnnnnrnrnnnnrnnnnrncanrncnnrasanencnnes 80 Scaling EXPreSSION Su nereiidi be le Io li ed 80 Scaling CalculatiONS iii A aa 81 CSV File Format siii A A A nice dee
54. cncnnnncnnnncnnnnc anna Enea nen nr rn nrnrnnrncnnrncnnaass 73 Table 35 OPC Historical Data Access Custom Interface Standard v1 20 Playback FUNCION S iia A e Erana i a aN Eaa anaana 73 Table 36 Expressions Constructs for Alias Scaling ocoonocoonnconcncnnnncannncnnnncanancnnnncananenns 81 Table 37 Calculation Operators for Alias ScalinQ oomccoonocnnnncnnnncnnnncnnnncnnnncanancnnrncananenss 82 Table 38 Calculation Functions for Alias Scaling omccoococnonanoncncnnnacananennnncananenanacananenos 83 Table 39 File mport Export Field Descriptions coomccoonocnnnaconcncnnnncanancnnnncanancnnrncananenss 84 Table 40 Additional File I mport Export Field Descriptions Linear Square Root Scaling A a sdsavulsiesssWeusnGauseh ses ovaruedsatedsesauesucse tues 85 Table 41 Additional File I mport Export Field Descriptions Offset Scaling 0005 85 Table 42 Additional File I mport Export Field Descriptions Expression Scaling 85 Table 43 Additional File Import Export Field Descriptions Calculation Scaling 85 Table 44 Scaling AlgorithmMsS mcoomccoonnnnnconcncnnnncannncnnnncnnnncnnnncnnancnnnncnnancnnnncanancnnancanancana 85 Table 45 Standard Data TypeS cocccoococonnnconnncannncanancnnnnrnnnncnnnnrnnanrnnnnrnnnnrnnnrnanrnnanennanensa 86 Table 46 Default Tag Security oomcconnncoonacannncnnnncanancnnnnranancncnnrananrncnnrananrncnnrananencnaracanes 110 Table 47 Example Tocconnnnccnnaco
55. cnnnnconancnnnncanancnnnncanancnnnnranennrncnnnncananenss 38 Figure 19 Insert New Alias Window Scaling OptiONS ococoonocnonncnnnncnnnncnnnncannncnnnncananenas 39 Figure 20 Contents Table coomccoonoconcncnonacanancnnnnranancnnnnnnrncnnrnnanrncnnrananrnnnnrananrannracanencanes 40 Figure 21 Expression Tab ocoocccoonoconnanacanancnnnnranancncnnrnnnnrnnnnrnnnnrncnnrnnnnrncnnrananrncnnracanencanes 43 Figure 22 Expression Wizard ccooncconnnconnnconancnnnncanancnnnncnnancnnnnrnnnnrnnnnrnncnnrnnnnrncnnracanracanes 44 Figure 23 Select Function Window ccmococoncncnonaconcncnnnacanancnnnncnnanennnncnnrncnnrncanancnnnncaninenss 44 Figure 24 Select Variable WiNdoW ccoonccoocncnnnnconcncnnnncanancnonnranancnnnnrananencnnranacnnracanencanes 45 Figure 25 User Defined Functions EditOF oocoococoonocnnnncnnnncnnnncnnnncnnnncnnrncnnrncanancnnnncnnanenas 45 Figure 26 Operators ButtoNS coocccoonnconnnconnncnnnncanancnnnncnnnncnnnnrnnnnrnnnnnrnnnracnnrnnnracanencanes 46 Figure 27 Calculation Tab oomcoonoconcocnnnacancncnnnncnnnncnnnncnnrncnnnncnnrncnnnnrnnrncnnrncanrncnnrncananeanns 47 Figure 28 Item Path Browser coomccoonnconnnconnncnnnncannncnnancnnnnrnnnnrnnnnrnnnrnnnnennnrananenanencacanes 47 Figure 29 Registry Editor coonccoonnconcnconnncannncnnnncnnancnnnncnnnncnnnnrnnnnrnnnnrnnanennannnrannracanencanes 55 Figure 30 Program ID Branch omcccocncnonoconcncnnnncanoncnnnncnnancnnrncnnrncnnncnnrncnnrnranrncnnancananenss 56
56. ction for adding permissions Duplicate Another way to create a new user or group is to duplicate an existing one To create a new user or group via duplication 1 From the MatrikonOPC Tag Security Configuration Utility main screen right click your mouse on the user or group you wish to duplicate From the displayed menu select Duplicate The Enter New Name window Figure 50 appears Enter New Name Figure 50 Enter New Name Window MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 98 MatrikonOPC 4 Enter a name for the new user or group to be created Click on the OK button There must not already be a configured user or group with that same name The new user or group will then appear in the list and will contain the same properties as the duplicated parent i e original user or group Edit Once the desired users and or groups are defined they must be edited to configure their respective permissions Note Permissions can also be defined for the user Everyone which is defined as the default user For every NT user not configured in the MatrikonOPC Tag Security Configuration Utility the user Everyone is used for determining security permissions Permissions for allowing denying browsing adding items reading items and writing items can be configured Permissions are defined for users and groups for a particular location in the server s address space hierarchy A location can either be a tag
57. d configuration on startup Filename o pa Y Launch configuration program on startup You can control which items an OPC client can add Restrict items to preconfigured aliases only i Cancel Figure 14 General Options Tab Table 17 describes the fields available on the General tab Field Description Save current configuration on shutdown Automatically saves the current configuration to the specified file before shutting down if selected Backup X copies Automatically keeps up to the specified number i e X of backup copies of the configuration file when saving the configuration Load configuration on setup Automatically loads a configuration from the specified file when starting up if selected Filename Displays the full path of an existing file for load and save operations Click on the ellipsis button to display the Open window used to select an existing file name Launch configuration program on startup Automatically launches the configuration utility when starting up as a local executable rather than a Windows service if selected Restrict items to preconfigured aliases Prevents OPC clients from adding items other than configured aliases if selected MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 32 MatrikonOPC Field Description only Table 17 General Options Tab Fields Note The server lo
58. details the procedure used in determining permission rights 1 Look for a permission match with the NT domain name or private name This step occurs only if the NT domain name or private name has been defined in the Users amp Groups list MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 113 MatrikonOPC 2 If a permission match was not yet found look for one using each group defined in the Users amp Groups list that the NT domain name or private name belongs to The first group that contains a permission match will be the one used An NT domain name does not need to be defined in the Users amp Groups list for a group it belongs to to have a permission match The NT domain name must be part of Group Members for private groups or in the Active Directory for NT groups 3 If a permission match was not yet found look for a permission match using the default user Everyone The procedure used in finding a permission match for a particular identity is as follows 1 Check whether the exact location is found in the Configured Paths list for the identity f found a Check whether the permission type browse add read or write is specified Figure 55 If the permission type is specified for the action being performed a match is found and the permission either allow or deny is used 2 If a permission match was not found in step la check whether a partial match of the location is found in the Configured Paths list
59. dewebianedine 84 Scalling AlGOrtAMS cs siii ti a de a dee ei la tati cl 85 Appendix C Standard Data TypS oococoococoococonnaconnncnnnncannncnnnncnnancnnnncnnancnnnncanancnnnncananenss 86 Appendix D Microsoft Excel as a DDE Client coocccnonoconcncnnnacancncnnnncananennnnrananennnncananenas 87 DDE RESO onotota rasiat inaa ali A A o lt a aa a o lad 87 DDE Wire dra rito ea anie 87 Net DDE stc beeches cede A bike wend ec eehe weed da A ANE EEA tereulles elas ed iias eth sexes 88 Appendix E Security ccccccceceececeeeeeeeeeeeeeeeeeeaeeseeeeeeaeeeuaeeeuaseeuaseauassauaseguasaeuausguanseuansguans 89 INEOdUCHON nara ld dada ii 89 OPC Security Implementation 0 ene eee ene tennant 89 MatrikonOPC Tag Security Configuration Utility 0 cece cece eee eee teeta eee e teeta nae 90 Security Detalls asara e a o a Ei ie 112 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 5 MatrikonOPC Table of Figures Figure 1 InstallAware Wizard Verification Window ccecseeeeseeeuseeeuseeeueeeeeeeeeueeeeneeees 13 Figure 2 License Agreement Screen mccocncoonaconcncnnnnranancnnnncanancnnnncannnnrncnnrnranancnnancananenss 14 Figure 3 Setup Type Screen mmccococooroconraconcncnnnncnnnncnnnncnnrncnnnncnnrncnnrncnnrncnnnncanancnnancananenss 15 Figure 4 Destination Folder Screen ommmccoococnonacnnnncnnnncnnnncnnancnnanennnnennrncnnrncnnanennanennanenns 16 Figure 5 Start Menu Scre eN cconcconcncononon
60. double quotation marks Double quotation marks occurring inside quoted values are escaped with an extra double quotation mark Lines beginning with a hash mark are ignored used for comments Each line contains the fields listed in Table 39 Field Description Name of the alias group folder where the alias belongs Periods in the name indicate subfolders below the root e g North FIC101 alias Alas Group group North under the Alias Configuration root and alias group FIC101 under that Name of the alias Full alias path name composed of the alias group Alias Name path a period and the alias name e g North FIC101 CV for an alias named CV Item Path Fully qualified item ID for the OPC item to which the alias refers Data Type Decimal number indicating the data type for the alias Specifies whether the alias is read only or read write Read only O read write 1 read only Specifies whether the alias is polled continuously or not Poll Always 0 only poll as requested by an OPC client normal 1 poll continuously at the specified update rate Update Rate Update rate milliseconds to use with the Poll Always option Scaling type for the alias 0 none 1 linear Scaling 2 square root 3 gain offset 4 expression 5 calculation Table 39 File I mport Export Field Descriptions When the scaling field specifies linear 1 or square root 2 scaling the line cont
61. e controlled using the MonitorACLFile OPC item found in the root branch when browsing the server The MonitorACLFile is a boolean OPC tag that has a default value of True when the server starts which indicates that the tag security permissions are monitored and applied while the server is running By adding this item to an OPC group and writing a value of False to this item the server no longer applies tag security configuration changes while the server is running The server would need to be stopped and restarted for the changes to take effect By disabling the ability of run time tag security configuration a malicious user that has access to the machine cannot delete the ACL file and thus remove all user permissions for OPC security Run time tag security configuration can be re enabled when changes to the tag security need to be made and then disabled again once they have been applied Security should be applied to the MonitorACLFile tag so that unauthorized users are unable to control this ability described above Client Connections and Private Log On When an OPC client connects to the server the OPC Framework impersonates the client and determines the name of the NT user that is running the client This client name consisting of the domain name and the user for that domain is what the OPC Framework uses when checking permissions set in the MatrikonOPC Tag Security Configuration Utility f this NT user was not added in the Users a
62. e is not present since it has to try each protocol in turn For most situations it is best to remove all unused protocols from the list and only include those that are necessary for your network For example on a TCP IP network one would include the Connection oriented TCP IP protocol Contact your IT personnel for more information about your network MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Evidence indicates that there are problems with the datagram oriented protocols such as UDP IP that can cause memory leaks in DA DCOM Therefore it is strongly recommended that these protocols be removed from the list of default protocols Datagram oriented protocols are not supported under Windows 2000 at all although the DCOM configuration utility still allows you to configure them Remote Program ID Before the OPC Server Browser became available OPC client applications had to search the registry to generate a list of available OPC servers Therefore some older OPC clients need to have a program ID in the local registry in order to connect to a particular OPC server The simplest solution is to install the OPC server software on the client machine even if it is not used Alternatively use the following steps to copy a program ID to the client machine Note This method may not work for every OPC client Please check the client documentation for more information WARNING Any changes made to the reg
63. e necessary Using the OPCSecurityPrivate interface for OPC Security the OPC client must make a call to the OPC server to log on with a user name and password In this scenario the OPC client must implement and follow the OPC Security specification in terms of following the calls necessary to provide credentials The credentials provided through the private interface override those provided from the NT interface The OPC client may choose to log off at which point the NT credentials are used until the log on call is made again Location Some of the interface calls made from an OPC client to an OPC server require the client to provide an OPC item ID The OPC Framework will take the OPC item ID provided and determine whether access to that location is allowed or not A particular server installation may want to control access to a particular device or branch in the hierarchy and is able to do so by setting permissions for a partial item ID or path MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 89 MatrikonOPC Other interface calls do not provide an ID but may depend on the state of the server with respect to previous calls OPC Browsing DA 2 0 is an example of this In this case the full path up to that particular location is used for determining access rights Type There are four types of interface functionality in the OPC Framework specifically the OPC Outer Layer that are controlled using OPC Security 1 Brow
64. edanaedes 48 Loading an Existing Configuration ccccee cece ee enna eee eee e neta nee 48 Shutting Down the Server ccc cece ne rr r narra ata e neta e eee tee 49 OPC Data lteMS occnoccnccnccnncnnrnncnn conc nn cnn nn cnn nn nn nn nr nn n rar nnrnnrnnrnncnncnncnncnncnncanennss 50 Simulation EMS oo da a A a Genet conta needs 50 Available tOMS siii ii A A A A A A A Ad 50 Dynamic ltem Creation ist iio lat dt leia e iaa ia alaa 50 DiAQNOStICS cccccnconcncnnnncnnnncnnnn cnn aE aa E EE EEEE aa ani 52 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 4 MatrikonOPC LODO 2 ir dai 52 Limitations cooocncnnnncnnnacnncncnnrncnn rn nn ran aa Ena nn ne nar nrnennrncnnrnennrncanancnnanss 53 Troubleshooting ccoococoncnconnncanancnonncnnnncnnnn cnn enn cnn rn rana rana rana nrnnnnnnrnnnnrncanrncnnrasanencanes 54 Problems and SOlUtIONS 00 cece enna rr rr rara rrnrrnnrrnnnnnnes 54 Un nstallation ccccccceeeeeeeeeeeeeeeeeeeeeseaeeeeeeeaeaeeeeaeeaeaeeeeseaseeeaseseaseauaseeuasaauasseuasueuanseuassguans 62 OPC Compliance cccccceeeeceeeeeeeeeeeeeeeeeeeeeaeeeeaeeaeaeeeeaeeaeaeeauaseauaeeeuaeeauaseeeauaeeauaeeauaeeauansauanes 67 PSC ATOR arstina ears arc we A A Stace nda a niente 67 Common Interfaces issin ets a A a 67 Data ACCESS music a a A coche dase eatbateeed 67 GROUPS eas tects ON 68 AMS perii ian aa ata dalealdiadaendaed adobauea wees ali 68 Browsing and Item Properties c
65. elect Alias Configuration or a previously configured Alias Group The Contents table for that Alias Group is displayed on the right side of the Configuration window Figure 20 listing the aliases it contains Either create a new alias for instructions see To insert a new alias or Double click your mouse on an existing alias or Right click your mouse on an existing alias and select the Edit Alias option from the displayed menu Click on the Scaling button to enable scaling for the alias The Scaling Options are displayed at the bottom of the Insert New Alias window Figure 19 or the Edit Alias window Note Whether the Insert New Alias window or the Edit Alias window is displayed depends on whether you are creating a new alias or editing an existing one Select the Expression tab Figure 21 Expression Calculation Linear Square Root Gain Offset Input PT ge Output FE eS Figure 21 Expression Tab Click on the ellipsis button adjacent to the Input field or Output field 7 The Expression Wizard Figure 22 is displayed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 43 MatrikonOPC Expression Wizard Input Expression Insert at cursor position Database field Function Variable s ce ae Paes es Not And Or Clear Validate Cancel Figure 22 Expression Wizard 8 Manually enter your new expression in the I nput Output Expression field and proceed
66. es This document references information found within the following documents sites www opcfoundation org www matrikonopc com www opcsupport com OPC Overview 1 0 OPC Common Definitions and Interfaces 1 0 OPC Historical Data Access Custom Interface Standard 1 20 OPC Data Access Custom Interface Standard 2 05 OPC Data Access Custom Interface Standard 3 00 OPC Alarms and Events Custom Interface Standard 1 10 Terminology The following terms are used interchangeably throughout this document MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC e screen and window e tab and panel e MatrikonOPC Server for Simulation and Simulation server and MatrikonOPC Server for Simulation and Testing Table 2 provides a list of definitions for terms used throughout this document Term Abbreviation Description COM Component Object Model A method for organizing software specifying how to build components that can be dynamically interchanged DA OPC Data Access Provides access to real time process data Distributed Component Object Model An extension of COM that allows DCOM aan communication between COM components over a network DDE Dynamic Data Exchange Allows the transfer of data between two running applications DDL Data Definition Language HDA OPC Historical Data Access HMI Human Machine Interface Device that allows interaction between the user and mac
67. es Int1 Setting Read Write and Add permissions for the Saw toothed Waves branch will affect the items below as Saw toothed Waves is part of the item ID of the Intl item Saw toothed Waves Int1 and therefore the Saw toothed Waves folder does not appear as a red folder like the Simulation I tems folder does Note User permissions override group permissions For example if a defined group is denied writing privileges to an OPC item Random Int4 while a defined user a member of that group is allowed writing privilege to Random items Random lt iteml D gt then the user permissions would take precedence for that OPC item even though the permissions relating to the group are a better match for the OPC item Random Int4 To edit a user s permissions 1 Click on the Add button to begin configuring permissions for the current user 2 The Add User Permission window Figure 53 appears This window allows you to browse the OPC server address space to find either a path in the hierarchy or a particular OPC item MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Add Permission Server Address Space mA Figure 53 Add User Permission Window 3 Expand on the server address space s root node and continue to browse to the desired path in the hierarchy or the desired OPC item Note Branches i e folders that are red in colour see Figure 54 are not part of an item s path
68. espective organizations Matrikon and MatrikonOPC are trademarks or registered trademarks of Matrikon Inc OTHER MatrikonOPC is a division of Matrikon Inc MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 3 MatrikonOPC Table of Contents PMtrOCUCTION 2 ccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeaeaeeaeeeeeeeseaeaseaeeseaeeeeaseeaseaeasuaeaeeaeeeeaeseuasaauanueuanegeas 9 Who Should Use This Manual vicio ia 9 Overview Of Manual ccc cece eee rre nae eee eae 9 References miii A Ad ee ieee 10 VETO OY terio A A eee oes aa Spence ed ca a re 10 Getting Started cccccccceeeeceeeeeeeeeeeeeeeeeeeeeaeeeueeeeeeeeauaeeseaeeeuaeeeueuaeeseaeusuaeeauaeeauaeeauaeeauaeeaeaegs 12 System REQUIFEMENES veces ce code A Ri 12 Software REQuUIreMentsS cria ride ne swede tees sere aaa icerda eet aera eee eben 12 Hardware Requirements 0 cece eee eee nett ee eee nee nae 12 NStallation taceuis veges cheers eds a ena ea ee 12 Installed Fl asses ar a eee nated E E A EOE iien ised cn pela meee peewee daa abet 21 LICENSING PORC EU nate teal i Pet se lew AA EA n nin nals e theta Peak eae 23 Contacting SUpport meri A a A 23 Configuration cocnnconnncocnncnnnncncnncnnnnr nn rana Ena nara nn a 25 Configuring Dynamic Data Exchange DDE oooocccccccccnconcnnconccnnnnancnnnnonnnnnnnannrnncnnnnnnnnnnnannss 25 Starting the MatrikonOPC Server for SiMulatiON oooocccccccccnccncconconnnnnncnnncnncnncnnnnnnncrnnrnnnnanes 26 TOO
69. ettings in the right hand panel Server Configuration Server configuration is not required for MatrikonOPC Server for Simulation Alias Configuration Define aliases and alias groups under this node Object Settings Panel Displays the current settings of the object presently selected in the tree Displays available statistics for the object presently selected in the tree Statistics Panel Sent Received Timed Out Retried Failed Overrun MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 28 MatrikonOPC Command Description Reset Statistics Resets statistics on the object presently selected in the configuration tree Matrikon Logo Opens a link to the Matrikon web site Clients Displays the total number of OPC clients presently connected to the server Server Time Displays the current time Table 10 Configuration Window Commands The following sections describe the menus available from the Configuration window and what they are used for File Menu Table 11 describes the File menu commands Command Description Clears the current configuration and starts a new one If OPC clients are still C New connected to the server the user is prompted for confirmation before continuing Clears the current configuration and loads a new one from an existing file So Displays the Open Configuration window to prompt for the file name If
70. for the identity A partial match is always a sub string of the given location that starts with the same characters This represents starting from the root location and moving down the browsing hierarchy For example the location Random is a partial match of the full item ID Random String However String is not a partial match even if it is a sub string because it does not match the first seven characters The root location is considered a partial match for every full item ID For each partial match from step 2 apply step la The best partial match i e the one that has the most characters that is successful in step 1a is the one whose permission is used Example The following is an example of a tag security configuration Table 50 lists all defined users and their associated permissions User Group Configured Paths Browse Add Read Write Everyone DOMAIN john doe Allow Allow Allow Allow DOMAIN john doe Random Allow Deny Deny Deny DOMAIN john doe Random nt Allow Allow Allow Allow Table 50 Example 2 Permissions The user DOMAI N john doe wants to read the item Random I nt4 The permission routine would not be able to find an exact location match under the Configured Paths list However it would loop through each partial match in the Configured Paths list looking for a defined permission The location Random l nt would be the closest match and the permission would be ALLOW
71. gative effect on performance of the OPC server Always set this back to None when not in use Display activity on screen Displays logged messages in a console window as they occur if selected Commit all log file writes Purges the file buffer after each message is logged in the event of an unexpected server shut down Overwrite old log information Overwrites the old log file each time the server starts up if selected Otherwise rename the old log file with a bak suffix General Activity Logging Filename Displays the full path for the general activity log file Click on the ellipsis button 214 to display the Open window used to select an existing file name The default path is C Program Files Common Files MatrikonOPC Common PSTCFGMatrikon OPC Simulation 1 LOG Filter String Match string for filtered log is displayed Filtering Filename Displays the full path for the filtered log file Click on the ellipsis button J to display the Open window used to select an existing file name Table 18 General Logging Options Tab Fields Note General Logging options settings take effect immediately Interface Logging Options The Interface Logging tab allows users to view and edit COM interface logging options To view the Interface Logging options 1 On the Configuration window from the View menu select the Options menu item 2 The Options window appears 3 From the O
72. hierarchy From the Permissions tab when the Add button is selected the Add Permission screen is displayed In the Server Address Space screen section folders and items are shown as nodes are selected and expanded Red folders indicate a null branch This means that the item names below this branch do not contain the branch name so permissions set on the branch will not reflect on Add Write and Read permissions for the items below the branch To properly set permissions on the items below the branch they have to be set on the items themselves Figure 52 provides an example of a null branch and items below it all of which are outlined in black MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 100 MatrikonOPC Add Permission Server Address Space Simulation Items bucket Brigade andom 9 Saw toothed Waves ma Ulnt2 Saw toothed Waves Intl Figure 52 Add Permission Screen Server Address Space When browsing using the example in the diagram above Simulation I tems is a null branch identified by the red folder Saw toothed Waves is a non null branch and Intl is an item Setting permissions on the Simulation Items branch does not affect Read Write and Add permissions for the Saw toothed Waves branch of the Intl item below that This is because when adding the Intl item the item ID of the Int1 item is actually Saw toothed Waves I nt1 and not Simulation Items Saw toothed Wav
73. hine Typically used in process control applications LAN Local Area Network Matrikon Matrikon Inc MatrikonOPC Matrikon s brand name for its OPC servers and clients OPC The communication standards published by the OPC Foundation Refer to www opcfoundation org for more information PLC Programmable Logic Controller Sync Async Abbreviations for Synchronous and Asynchronous operations Table 2 Terms and Definitions MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 11 MatrikonOPC Getting Started This section of the User s Manual contains important information regarding software installation and how to contact MatrikonOPC s Support team The System Requirements section shows how to avoid future problems by ensuring that the system meets the minimum software and hardware requirements Detailed step by step instructions in the nstallation section will guide you through the installation process and provide a list of files that are installed during this process Once the software is installed refer to the Licensing section for information on how to obtain the appropriate license The Licensing section will refer you to the Licensing Procedures document that was installed along with the server and this User s Manual The Contacting Support section will provide you with contact information for the MatrikonOPC Support team should you have any problems during the installation or licensing of the software
74. i e OPC Item 1D or a path leading up to an item Edit User To edit a user 1 From the MatrikonOPC Tag Security Configuration Utility main screen either e Double click your mouse on the user you wish to edit or e Right click your mouse on the required user and select Edit User from the displayed menu or e Click your mouse on the required user and then select the Edit button 2 The Edit lt Username gt window Figure 51 appears Notes e In this example the user being edited is Userl so the window s title reads Edit Userl e There are two tabs on this window Permissions and General The General tab only appears for private users MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 99 MatrikonOPC Edit User ps Permissions General Configured Paths Add Permissions Allow Deny Unspecified Browse Add Read Write Figure 51 Edit lt Username gt Window Permissions Tab Permissions On the Permissions tab the permissions associated with this user relating to browsing adding reading and writing for any specific paths or OPC items are configured The Configured Paths screen section lists the paths and or OPC items for which permissions are defined The Permissions screen section indicates those permissions with option buttons which can be set to Allow Deny or Unspecified Selecting Unspecified directs the OPC Framework to look for the permission higher up in the
75. ication problems and software faults Logging All MatrikonOPC servers produce log files that record errors and debugging information The log files can be extremely valuable for troubleshooting As such it is important to note that the default log level is set to low The General Logging tab of the Options dialogue in the main configuration window contains settings to control server logging General Activity Logging records information about the internal workings of the OPC server It is useful for troubleshooting problems with configuration and device communication Interface Activity Logging records information about the client server OPC communication It is useful for troubleshooting compliance issues For General logging the higher the log level the more information that is recorded However server performance may decrease at higher log levels The recommended operating level is Medium More log levels are available for both types of logging which record more detailed information as well as the ability to output log statements to a console window at run time Contact MatrikonOPC support for further instructions on how to enable the higher log levels and console logging For Interface logging the log level can be considered very high and therefore should never be used during normal operation of the OPC server unless specifically working on problems related to interfacing MatrikonOPC Sniffer is a useful tool for logging OPC client serve
76. imulation v1 5 0 0 User s Manual 92 MatrikonOPC MatrikonOPC Tag Security Configuration Utility Actions Users amp Groups Everyone Default User Add Group Change Password Show Help MatrikonOPC Server for Simulation and Testing Figure 44 MatrikonOPC Tag Security Configuration Utility Main Screen Users amp Groups Note After any action is performed the changes made do not take effect until either the OK or Apply button has been selected Clicking on the OK button saves the changes and closes the Utility screen Clicking on the Apply button saves the changes and keeps the Utility screen open Clicking on the Cancel button or the X button on the top right of the screen discards any changes made Add User There are two types of users for which security can be configured NT Users and Private Users Adding a user to the configuration will allow permissions to be defined for that user For NT users the OPCSecurityNT interface is used and for Private users the OPCSecurityPrivate interface is used NT User To add an NT user 1 From the MatrikonOPC Tag Security Configuration Utility main screen click on the Add User button MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 93 MatrikonOPC 2 The Add User window Figure 45 appears The NT User option button is selected by default This will allow the addition of a user from a Windows NT Domain Add User e NT User C Private User Add
77. in the Name field 2 Click on the OK button MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 104 MatrikonOPC Edit User Permissions General Name Userl Reset Password Figure 56 Edit lt Username gt Window General Tab To change the user s password 1 Click on the Reset Password button The Reset Password window Figure 57 appears Reset Password Password Password Confirmation Cancel Figure 57 Reset Password Window 2 Enter the new password in the Password field 3 Re enter the password in the Password Confirmation field 4 Click on the OK button MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Edit Group To edit a group 1 From the MatrikonOPC Tag Security Configuration Utility main screen either e Double click your mouse on the group you wish to edit or e Right click your mouse on the required group and select Edit Group from the displayed menu or e Click your mouse on the required group and then select the Edit button 2 The Edit lt Groupname gt window Figure 58 appears Notes e In this example the group being edited is Group1 so the window s title reads Edit Groupl e For Private Groups there are three tabs on this window Permissions General and Members For NT Groups there is only the Permissions tab Edit Group1 oe Permissions General Members Configured Paths
78. inimum value Minimum Retrieve the minimum value in the resample interval Retrieve the maximum value in the resample interval and the Maximum actual time timestamp of the maximum value Maximum Retrieve the maximum value in the resample interval Table 29 Aggregation Functions Supported by Simulation Server ReadAttribute Reads attribute values and timestamps from the history buffer for the specified time domain for the item The item attributes tracked by the Simulation server are Attribute ID Attribute Name Attribute Description 1 data_type Data type MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 71 MatrikonOPC Attribute ID Attribute Name Attribute Description 2 description Item description 11 normal_ maximum High Engineering Units 12 normal_minimum Low Engineering Units 13 itemid Item ID 5 triangle Triangle wave 4 square Square wave 3 sawtooth Saw toothed wave 2 random Random 1 bucket Bucket Brigade Table 30 Attributes Stored for Each Item by Simulation Server Update Functionality Insert Inserts values and qualities into the history buffer at the specified timestamps for one or more items If data is already present at the insertion point in the butter the insert operation fails and the message data exists is returned If the maximum size of the buffer is exceeded i e more than 200 ite
79. irst PRETTY ALARM Alarm MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Construct Description Examples letter upper case and the rest lower Returns a sub string of the x copying length COPY FIDDLE 2 4 characters starting at IDDL start COPY x start length Converts the numeric FORMATNUMERIC FORMATNUMERIC mask x value x to text using the 123 4567 123 5 format mask The incoming value read INPUT from OPC INPUT 3 1415 The outgoing value OUTPUT written to OPC OUTPUT 3 1415 text Text value single hello quotation marks oe s Alias Table 36 Expressions Constructs for Alias Scaling Scaling Calculations Calculations may contain references to any OPC item in the server s syntax However they may not contain references to other alias items There are no limits on how many items can be used in a calculation The only limiting factor may be performance related To reference another OPC item in the calculation wrap the items full item path in square brackets For example to add the items Com1 Rtu Regl1 and Com1 Rtu Reg2 together the correct expression would be Com1 Rtu Reg1 Com1 Rtu Reg2 If the OPC item being referenced in a calculation is not found within the servers address space the server attempts to add it If successful the OPC server uses the update rate
80. is ensures that the server can always be accessed even if no one is presently logged on to the machine and only one server process ever starts up It also adds a greater degree of security in terms of who is able to shut down the server process Servers that run as local executables have the option of running as the launching user the calling client this is the default the interactive user the one currently logged onto the machine or a specified user It is usually best to use the interactive user or a specified user Otherwise remote clients might start up multiple separate server processes that are not accessible to others Servers that run as NT services should generally run as the local System account Alternatively the server can be set to run as a specified user although this is usually done from the Service Control Manager applet rather than DCOMCNFG Access and Launch permissions are particularly important when installing a server to run as an NT service Default Protocols The Default Protocols tab specifies the communication protocols available to DCOM The order that protocols appear in the list indicates the priority in which they will be used the topmost having the highest priority The more protocols that appear in the list the better the chances of connecting to an OPC server on an unknown remote machine such as at an OPC Interoperability Workshop However it may also take longer for DCOM to time out if a server machin
81. istry must be made with extreme caution Back up your registry On the server machine run REGEDIT as a user that has access rights to the local registry Expand the HKEY_CLASSES_ROOT key Find the program ID s for the desired OPC server s Note In the case of Matrikon OPC Servers the ID has the form Matrikon OPC Device If you quickly type the first few letters then REGEDIT should jump to the location of that key Some servers may have both a version specific as well as a version independent program ID In this case both IDs should be copied to the client machine gt PUN 5 For each program ID select the key and choose Export Registry File from the Registry menu Enter a file name and then click Save Be careful not to overwrite other export files that you are creating 6 Copy the exported REG files to the client machine 7 Merge the REG files into the registry of the client machine Note This should simply be a matter of double clicking on the file from the desktop of the client machine Alternatively run REGEDIT on the client machine and choose Import Registry File from the Registry menu selecting each file in turn This must be done as a user who has write access to the local registry 8 Use REGEDIT to check that the program IDs have in fact been copied 9 Delete the REG files since they are no longer needed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 79 MatrikonOPC Appendix B Aliases Sc
82. item to an OPC group e Write control values to items on device MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 68 MatrikonOPC e Write control value quality and or timestamp to items if the server supports such features e Write control values without adding the item to an OPC group The server supports asynchronous I O operations as defined for DA 3 0 e Read items value from device based on how old the cache items value is e Write control value quality and or timestamp if the server supports such feature The server supports the data change event notification client side interface as defined for DA 3 0 e Keep alive call back indicating server is alive The server supports asynchronous I O operations as defined for DA 2 0 e Read items values from device e Write control values to items on device e Refresh active items from cache e Cancel outstanding operations e Enable disable event notifications The server supports the data change event notification client side interface as defined for DA 2 0 e Data change or dead band exceeded e Asynchronous refresh operation complete e Asynchronous read operation complete e Asynchronous write operation complete e Asynchronous operation cancellation complete The server supports asynchronous I O operations as defined for DA 1 0a e Read items values from device e Read items values from cache e Write control values to items on device e Refresh active items from cache e
83. l Rs Configure Displays the main Configuration window Q Shutdown Shuts down the server About Displays the server s Welcome screen which includes information about the software Table 8 Tool Tray Menu Commands Control Panel Note If the server is installed as a Windows service the Control Panel is not available The Control Panel displays the server s status system time and number of clients connected to the server The Control Panel allows users to e Access the Configuration window MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC e Access the About screen e Execute the command to shut down the server The Control Panel stays on top of every other window on the desktop to help monitor the status of the server To view the Control Panel 1 Right click your mouse on the Matrikon logo pu 2 The Tool Tray Menu appears 3 From the Tool Tray Menu select the Show Control Panel menu option 4 The Control Panel Figure 12 appears MatrikonOPC Server 5 Configure Shutdown Figure 12 Control Panel 5 To window shade the Control Panel so that it displays only the client count double click your mouse on the title bar Table 9 describes the commands in the Tool Tray Menu Command Description Status Displays the current status of the server Time Displays the current time Clients Displays the total number of OPC clients presently connected t
84. l number if If the condition is true returns vall else if condition vall val2 returns val2 isNaN Returns 1 if the number is a NaN value isNaN value log Natural logarithm log x log10 Base 10 logarithm log10 x max Returns larger of a set of values max v1 v2 v3 max Returns larger of two values max x y max Returns larger of three values max x y Z min Returns smaller of a set of values min v1 v2 v3 min Returns smaller of two values min x y min Returns smaller of three values min x y z rand Random value between 0 and 1 rana rand Random value between min and max rand min max round Round the fractional part of a number round x sin Sine sin x sinh Hyperbolic sine sinh x Finds the variable s value that yields the solve expression variable result solve desired result using the Newton s numerical v0 0 approximation method tol 0 01 maxlter 100 sqrt Square root sqrt x sum Returns the sum of a set of values sum v1 v2 V3 tan Tangent tan x tanh Hyperbolic tangent tanh x trapezoid Compute a numerical approximation to the trapezoid expression variable a integral between a and b b step 0 1 Table 38 Calculation Functions for Alias Scaling MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC CSV File Format The alias import export file contains lines of comma separated values Values containing commas or spaces are enclosed in
85. ll regions please use either of the following numbers There is no extra charge from MatrikonOPC for calling their after hours support numbers Region Contact I nformation 1 780 231 9480 1 780 264 6714 Table 7 After Hours Support All MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Configuration The server s Graphical User Interface GUI allows users to view and alter configuration parameters at run time When a user views a configuration parameter the information is retrieved and displayed The updated parameters are sent as a group to the server when submitted This server functions without creating a configuration However you can use the aliases to define your own customized tag structure The Alias Configuration section explains how to create user defined aliases in place of regular OPC items followed by four sections that cover saving clearing and loading configuration settings and shutting down the server The Starting the MatrikonOPC Server for Simulation section of this manual shows users how to start the software The next four sections describe the Tool Tray Menu Control Panel Configuration window and the Options window in detail Instructions for configuring the MatrikonOPC Server for Simulation as a DDE service appear in the Dynamic Data Exchange DDE section below Configuring Dynamic Data Exchange DDE The server may act as a DDE service In this
86. lowing the server to identify the calling client to see if it is allowed access to a certain resource but not to actually access any of these resources as the client e Select the Provide additional security for reference tracking to make even the reference counting on COM objects secure This setting is not generally required Security Permissions The most important DCOM settings for an OPC server are the security permissions There are two ways for you to set these 1 Change the specific settings for the server recommended 2 Change the default settings not recommended and make sure that the OPC server will use these Be certain that the access and launch permissions are correct for the server Setting Security Permissions To set the security permissions for an OPC Server 1 Open the DCOM configuration utility 2 Select the OPC server and then click Properties 3 The Distributed COM Configuration Properties window Figure 36 appears Distributed COM Configuration Properties Applications Default Properties Default Security Default Protocols Applications Matrikon FileCollector Matrikon ODBC Server for OPC Configuration Matrikon OPC Server for DDE Matrikon OPC Server for Desktop Historian Matrikon OPC Server for Modbus Devices Matrikon OPC Server for Simulation and Testing MatrikonOPC Server for Generic Database Access GDA Media Player MediaCatalogDB OLE DB Provider Microsoft Agent Server 2 0 Micros
87. mask that is in binary which will only have the third bit present In binary this is the number 4 0100 To apply the mask users must use the AND operator which will leave a 1 if and only if both the bits in that position are 1 0110 1100 0000 0100 0000 0100 Data bit we want to access In decimal notation this would be expressed as 108 AND 4 4 To do this in an OPC server users would configure an alias to use the IF operator With the example above where the user wishes to access the third bit in the integer the statement would appear as IF INPUT AND 4 4 1 0 Therefore if the bit in position 3 is a 1 since 1 AND 1 1 the IF statement would be true and would return a 1 If the bit in position is O O AND 1 O the IF statement would return a false value which is a 0 Server is using a large portion of CPU resources Problem Server is using 99 of CPU resources MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Check for the server s Time Granularity setting by editing the ServerOpts ini file located at C Program Files Matrikon OPC MatrikonOPC Server for Performance Monitor Ensure that the granularity is not set to O It is not recommended to set the value lower than 100 Solution Removing OPC server as a service Problem How do remove the OPC server as a service Solution Re register the OPC server executable using the
88. missions are used At the root level location the default user can browse but no more The only other location where permissions are defined for the default user is Configured Aliases here browsing is denied and adding reading and writing permissions are not defined Thus DOMAI N no name will be able to browse the entire server except the Configured Aliases branch and all aliases under it Also DOMAI N no name will not be able to do any item addition reading or writing Since item addition reading and writing permissions were not defined for the default user for under Configured Aliases it would use the permissions defined at the root level Case 3 User DOMAI N fred stone connects This user belongs to the defined group Common At the root level the group Common can browse add and read items but writing is denied The only other location which defines permissions for this group is Triangle Waves This location has denied all permissions for the Common group Case 4 User Supervisor connects through the private security interface and logs on This user does not belong to any group but its name has a root level permission which allows it to add and read items No other locations have permissions defined Since the user cannot browse it will need to know the item syntax for any items it wishes to add and read Case 5 User DOMAI N the admin connects This user belongs to the Admin group which at the root level has all permissi
89. mp Groups list Figure 46 then the user Everyone is used instead If the OPC client chooses to use the OPCSecurityPrivate interface it must call the Logon function and provide a name and password The OPC Framework will immediately look for the private user in the Users amp Groups list Figure 46 If the user is found and the password provided is correct the Logon result is successful and the user name provided replaces the NT user that was obtained through impersonation If not found the Logon result is failure and the NT user remains as the name used for security permissions When the OPC client calls Logoff the NT user becomes the name used for security permissions Determining Permission Whenever a browsing item addition read or write operation is performed by the OPC client the OPC Framework will call a permission routine to determine if permission is allowed or denied Three pieces of information are always sent to this routine call 1 Identity 2 Location 3 Type Identity is the user name described in the previous section either the NT domain name a private name or the default user Everyone In addition identity includes any groups private or NT that the user belongs to Location is either the full item 1D or a partial path in the server hierarchy Type is the access type browsing item addition reading or writing Each piece of information is checked in the order listed above The following information
90. ms exist as a result of an insert operation items are deleted from the beginning of the buffer Replace Replaces values and qualities in the history buffer at the specified timestamps for one or more items This operation results in existing data being overwritten If an attempt to replace a non existent data point is made the misleading error message data exists is returned and the replace operation fails InsertReplace Inserts or replaces values and qualities at the specified timestamps for one or more items If the item has a value at the specified timestamp the new value and quality will replace the old one If there is no value at that timestamp the function will insert the new data MatrikonOPC Server for Simulation Functionality Alarm and Event Capabilities Table 31 lists the events in the OPC Alarms and Events Custom Interface Standard v1 10 that are supported by the MatrikonOPC Server for Simulation Event Supported Condition related Not supported Tracking related Not supported Simple Y Table 31 OPC Alarms and Events Custom Interface Standard v1 10 Events Historical Data Access Capabilities Table 32 lists the read functions in the OPC Historical Data Access Custom Interface Standard v1 20 supported by the MatrikonOPC Server for Simulation MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Supported Function
91. n Size 237 00MB Add Remove Click here For support information s frequently Windows Last Used On 5 2 2008 Components a Te To change this program or remove it from your computer click Change or Remove Change Ranta Q A Microsoft NET Framework 1 1 Set Program 5 Microsoft NET Framework 1 1 Hotfix KB928366 Access and Defaults a Microsoft NET Framework 2 0 Service Pack 1 186 00MB Figure 31 Add Remove Programs 5 Click on the Remove button associated with the MatrikonOPC Server for Simulation program to initiate the un install process 6 The MatrikonOPC Explorer InstallAware Wizard appears and the Welcome to MatrikonOPC Server for Simulation Maintenance screen Figure 32 is displayed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual P 0 MotrikonOPC 4 T A y e ps y p y pal MatrikonOPC Server for Simulation InstallAware Wizard 4 Welcome to MatrikonOPC Server for Simulation Maintenance eeee _ _ _ Figure 32 Welcome to MatrikonOPC Server for Simulation Maintenance Screen 7 Select the Remove option button to uninstall MatrikonOPC Server for Simulation entirely 8 Click on the Next button The Ready to Uninstall window Figure 33 is displayed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 63 0 MotrikonOPC A OOO n GSLSN Figure 33 Ready to Uninstall Window 9 Click on the Next button 10 The Uninstalling MatrikonOPC Server for
92. ncocnnracnnracnnrannnrncnnrannnrncnnrnnnnrncnnrnnnnrnnnnrnnnnrncnnranannnracanencanes 111 Table 48 Example 2 PermissSiODS coocooconconconconcnncnncnncnnnnnnnnnnnnnn nara nnn ran rnnrnnrnrnnnnnnnnnnns 111 Table 49 Example 2 Groups and MemMberFS coomocococococnoranancannoranancannnrananrncnnracanencnnracanes 111 Table 50 Example 2 PermissSiODS ooococconconconconcnncnncnncnncnnnnnnnnnnn rana nara rnnrnnrnrnnnnnnnnnnns 114 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 8 MatrikonOPC Introduction The MatrikonOPC Server for Simulation also referred to as MatrikonOPC Server for Simulation and Testing or Simulation server enables data interchange to any OPC clients The server provides different types of data that offers testing abilities Table 1 lists the various data options available in the server Source Type Function Provides variables that can be set to any value depending on their type Bucket Brigade Read and Write capabilities Random Produces random values to test Read capabilities of an OPC client Read Error Allows testing on OPC client s behaviour when an error occurs Waves Produces read only values in a Square Saw tooth or Triangle wave Write Errors Allows test for Write errors Write Only Allow Write tests Table 1 Data Options The MatrikonOPC Server for Simulation can be used to simulate other OPC servers on a simple level and to test your OPC clie
93. ncoonoconcncnnnacannncnnnncanancnnnnranancnnrncananenss 38 Table 22 Insert New Alias Window Scaling Options cmococoonoconcnconnncnnnncnnnncananennnncnnanenns 39 Table 23 Expression Wizard Options omoocoocncoonoconcncnnnncannncnnnncanancnnrncananennrncananennancananenss 42 Table 24 Item Path Browser OptiONS cccoococoonoconcncnnnncannncnnnncnnancnnnncnnnncnnrncananennancananenns 46 Table 25 Available temis oooooccoconconconcnncnncnncnnnnnnnnnnnn nn nn aa rn rn rn rn 50 Table 26 Simulated Event Event Notification AttributeS s ssssssssssnnnnnnnnnnnnnnnnnnnnnnnn 70 Table 27 Simulated Item Creation Event Event Notification Attributes ccsssee 70 Table 28 Simulated Item Types Supported Operations cmocccoonoconnacnnnacannncanancnnnncnnancnns 71 Table 29 Aggregation Functions Supported by Simulation Server c ccsceeeseeeeeeeeeeees 71 Table 30 Attributes Stored for Each Item by Simulation Server sccssseeeeseeeeeeeeeeeees 72 Table 31 OPC Alarms and Events Custom Interface Standard v1 10 Events 000 72 Table 32 OPC Historical Data Access Custom Interface Standard v1 20 Read Functions E A iaa 73 Table 33 OPC Historical Data Access Custom Interface Standard v1 20 Update Functions A a a aida 73 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 7 MatrikonOPC Table 34 OPC Historical Data Access Custom Interface Standard v1 20 Annotation FUNCTIONS ccccccno
94. nges to Advanced options settings take effect when the server is shut down and restarted Server Configuration No configuration is necessary Alias Configuration MatrikonOPC servers including this one provide the ability to create user defined aliases that can be used in place of regular OPC items This feature is particularly useful when the item path for a given server is very complex or difficult to remember for example Com1 Radio1 Unit1 41 4 123 Servers can also be configured so that client applications have access to configured aliases only rather than every available item This section of the manual describes how to create and edit aliases using the Configuration window Note It is not necessary to define aliases before accessing server data items from an OPC client Inserting Alias Groups Note Alias Groups are used to contain one or more configured aliases To insert an Alias Group 1 On the Configuration window select Alias Configuration or a previously configured Alias Group 2 From the Edit menu choose Insert Alias Group or click on the button 3 A new Alias Group folder appears 4 Enter a new name for the Alias Group and press Enter 5 The Alias Group is renamed Renaming Alias Groups Note Alias Groups can be renamed after they have been created To rename an Alias Group 1 On the Configuration window select an Alias Group 2 From the Edit menu choose Rename or click on the Y button 3
95. nt or architecture This server can give users a useful source of data to test their system Not only does it come pre loaded with data points that perform multiple functions but you can also add more simulated tags as needed The Simulation server can also be used to troubleshoot system connectivity by replacing your OPC server with the Simulation server which can then expose OPC server configuration issues Who Should Use This Manual This manual is intended for all users of MatrikonOPC Server for Simulation This manual explains how to install license and configure the software and how to perform common tasks In addition and where required technical information about OPC data items diagnostics information and a troubleshooting section is included Overview of Manual This manual uses icons to highlight valuable information Remember these icons and what they mean as they will assist you throughout the manual This symbol denotes important information that must be acknowledged Failure to do so may result in the software not functioning properly Font displayed in this color and style indicates a hyperlink to the BOLD applicable associated information within this manual or if applicable any external sources The User s Manual has been designed so that you can click on references in the document to jump to that referenced point without having to scroll through several pages in some cases For example if you
96. ntains Contents of alias group New Alias 1 Name tempan Data Type RW Update Rate BES Netl Host1 Unit1 041 4 123 Default RAW Alias2 Net Host Unitl 041 4 124 Default Rew Alias3 Net Host Unitl 041 4 125 Default RAW Figure 20 Contents Table From the Edit menu choose Insert New Alias The Insert New Alias window Figure 18 appears Enter a name for the alias in the Name field 91 21 qe 0 Enter the item Path and 1D for the item to which the alias refers or click on the Browse button to navigate to the item 7 Click on the Scaling button to enable scaling for the alias Click on the No Scaling button to disable scaling and hide the Scaling Options 8 The Scaling Options are displayed at the bottom of the Insert New Alias window Figure 19 9 Configure the Scaling Options as required see Table 22 for a description of these options by clicking the appropriate tab for the form of scaling that maybe required Note Available forms of scaling include Expression Calculation Linear Square Root and Gain Offset Expression which uses an Expression Wizard to help build equations is MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC used frequently and is intended to view individual bits from registers Refer to the Expression Wizard section for more information Calculation which uses the Item Path Browser to add items to calculation is intended fo
97. o the server Configure Displays the main Configuration window Shutdown Shuts down the server About Displays the server s Welcome screen which includes information about the software Table 9 Control Panel Commands Configuration Window Note If the server is installed as a Windows service the Tool Tray Menu and Control Panel are not available In this case the Configuration window is then accessed via the Windows Start menu The Configuration window is used to configure aliases It displays the current configuration and allows users to change configuration parameters To view the Configuration window 1 From the Tool Tray Menu or the Control Panel select Configure 2 The Configuration window Figure 13 appears MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 27 MatrikonOPC File Edit View Tools Help DOS he AA x 8 Current configuration 4 Server Configuration tay Alias Configuration Reset Statistics O Motrikon Clients 0 Server Time 7 16 2009 12 29 19 PM Figure 13 Configuration Window Table 10 describes the commands in the Configuration window Command Description Main Menu Provides access to the File Edit View Tools and Help menus Main Toolbar Provides shortcut buttons for commands in the Main Menu Displays a tree of configuration objects currently defined in the server Ruente Configuration Select an object to display its current s
98. oconcncnnnncnnancnnnncnnnncnnnncnnancnnnnrnnnnennrncananennnncananenss 17 Figure 6 Enter Password Screen mmcoonnconcnconnncannncnnnncnnancnnannrncnnnncnnnncnnrncnnrncananennancananenss 18 Figure 7 Ready to Install Screen ocooncconnnconnnonacnnnncnnnncnnrncnnnncnnancnnrncnnrncnnrncnnancnnancananenas 19 Figure 8 Installing MatrikonOPC Server for Simulation Screen mcocococnonononanararacanananas 20 Figure 9 MatrikonOPC Server for Simulation Setup Complete ScreenN ccomcconnocnonanonnnnnos 21 Figure 10 Tool Tray ccoonccoocnconcncnnnncanoncnnnncnnnncnnnrnnnrnnnn a aaa 26 Figure 11 Tool Tray MeNU occoocncoococoncncnnnnranancnnnnrannncnnnnrnnnnnnrnnnnrncnnrananrncnnrananrncnnracanencanes 26 Figure 12 Control Panel oonccocnnconcnconnncannncnnnncnnnncncnnrnnnnrncnnrnnnnrncnnrnnnnrncnnrnnnnrncnnraanencanes 27 Figure 13 Configuration WiNdOW cccccococoncncnnnaconnnconnncnnancnnnncnnancnnancnnrncnnrncananennancananenns 28 Figure 14 General Options Tab cccococconoconcncnnnacancncnnnncanancnnnncnnancnnncnnrncnnrncanancnnnncananenss 32 Figure 15 General Logging Options Tab ooccococoncnconnncnnnncnnnncnnnncnnnncanrncnnrncanrnennnncananeanns 33 Figure 16 Interface Logging Options Tab cmocccoonoconnnconnncnnnncnnnncnnnncnnrncnnrncanrncanancananenns 35 Figure 17 Advanced Options Tab ccooncconcnconnacancncnnnncananennnncananennnnrananennnncananennancanannanenas 36 Figure 18 Insert New Alias WiNdOW ccoocccoonconcn
99. of operations that can be performed on each simulation item Simulation Item Updateable Readable Bucket brigade Y Y Random x Y Read error Y Y MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Simulation Item Updateable Readable Saw toothed waves Y Y Square waves v Y Triangle waves Y Y Write error Y Y Write only Y x Table 28 Simulated Item Types Supported Operations The Simulation server supports a number of HDA read and update functions which are described in the following sub sections Read Functionality ReadRaw Reads the values qualities and timestamps from the history buffer fro the specified time domain for one or more items in a group ReadAtTime Reads the values and qualities from the history buffer for the specified timestamps ReadProcessed Computes aggregate values qualities and timestamps from the data in the history buffer for the specified time domain for one or more items The aggregate functions are performed during the retrieval of the data The aggregate functions supported are Aggregation Function Description Uses the linear straight line interpolation method to estimate a Interpolation P value between known values Retrieve the time weighted average data over the resample Time average interval Retrieve the minimum value in the resample interval and the Im eo Ae timestamp of the m
100. oft Clip Organizer Microsoft Equation 3 0 Microsoft Excel Application Microsoft Graph Application Microsoft Help and Support Services Microsoft IMAPI Microsoft Live Meeting Console Launcher Microsoft Office Access Application Microsoft Office Excel 2007 Workbook Properties Cancel Figure 36 Distributed COM Configuration Properties Window 4 Click on the Security tab to set the security for the server MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 75 MatrikonOPC 5 The Distributed COM Configuration Security tab Figure 37 appears Matrikon OPC Server for Simulation and Testing Prop EJES General Location Security Identity Endpoints C Use default access permissions m Use custom access permissions You may edit who can access this application Edit C Use default launch permissions e Use custom launch permissions You may edit who can launch this application Edit Use default configuration permissions Use custom configuration permissions You may edit who can change the configuration information for this application Edit Figure 37 Distributed COM Configuration Security Tab Notes e The Access Permissions contain an Access Control List of principals that are allowed to interact with objects supplied by a server e The Launch Permissions contain an Access Control List of principals that are allowed to start up a server process or se
101. oft SQL Server 2005 7 Explorer gt E Monitoring gt 7 OPCUniversal gt E OPC Foundation gt Security Gateway gt Pray CENE gt E Startup gt 4 MatrikonOPC Server for Simulation mm System Tools gt Tag Security E Testing gt oem anton a Figure 41 Start Menu Navigation After the MatrikonOPC Tag Security Configuration Utility is run 1 A window appears asking for a password to be entered This protects the security settings and prevents unauthorized individuals from accessing these settings For servers that required a security password to be entered during their installation the Enter server password window Figure 42 appears 2 Enter server password zi Please enter the security password set during installation of this OPC Server Cancel Figure 42 Enter Server Password Window Enter the password that was created during the installation of the OPC server Click on the OK button Note During installation if the user did not enter a password for encryption then steps 1 through 3 are skipped 4 The MatrikonOPC Tag Security Configuration Utility screen Figure 43 appears MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 91 MatrikonOPC Layout MatrikonOPC Tag Security Configuration Utility Use this button to add users from Active Directory or create new private users Add User EF Use this button to create new groups Add Grou
102. om 127 0 0 1 bytes 32 time lt l0ms TTL 128 Ping statistics for 127 0 0 1 Packets Sent 4 Received 4 Lost 0 0 loss Approximate round trip times in milli seconds MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 59 MatrikonOPC Minimum Oms Maximum Oms Average Oms Where ipaddress is the IP address of the user s machine If it says no response then there are likely network issues between the user s machine and the remote machine Note Refer to the DCOM Manual to further diagnose DCOM issues How can OPC data be accessed through other applications Problem How can access OPC data in Microsoft Excel Microsoft Word or another application with support for Visual Basic VBA or VB Script Solution Use the MatrikonOPC Automation Component to create a Visual Basic script that connects to a server creates groups and items and receives data change updates Contact MatrikonOPC Support for examples of how to do this in Excel Visual Basic or in an HTML document How can individual bits be accessed from an integer item Problem How can individual bits be accessed from an integer item In order to do this users will have to apply a mask to the value which will null all of the solution bits in the integer value except the one that users want to keep For example if the user wanted to isolate the third bit they would have to apply a
103. om the list The former will affect all servers configured to use the default settings The latter will affect the selected server only DCOM settings are stored in the registry and loaded by COM and OPC servers at start up Therefore server processes must be shut down and re started for these changes to take effect Default Properties The Default Properties tab contains settings that affect all DCOM communication on the machine e First of all ensure that the Enable Distributed COM on this computer is selected in so that the machine is available to others via DCOM e Select the Enable COM Internet Services on this computer to allow DCOM access to the machine from the Internet check with your administrator e In general the other settings do not need to be changed The Authentication Level specifies when COM should authenticate the identity of calling clients each call each packet etc e Normally it should be set to Connect indicating that COM should authenticate clients when they first connect to a server If it is set to None then COM performs no authentication and ignores any access permission settings The Impersonation Level specifies whether servers can ascertain the identity of calling clients and whether they can then perform operations on the client s behalf as if the server is the client MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC e Normally it should be set to Identify al
104. oncnnconcnncnncnnnnnnnnnnn ran rnnrnnrnnrnnrnnrnnennnnnnnnnannas 26 Table 9 Control Panel COMMANAS ccccceceeeeeeeneeseeeeeeeeeeeeceneeeseeseeseeeeeeeeeeeeeeeeeeeeeeeaenaneass 27 Table 10 Configuration Window COMMAanNdS coccccccncnnconcnnncnnnannnnnancnncnnrnnrnncnncnnnnnnnnnnnnnnas 29 Table 11 File Menu CommandS cooccoccnconconconcnncnncnncnncnnnnnnnnnnnn narrar rn rn rnnrnnrnnnnnnnnnnnnnnas 29 Table 12 Edit Menu Commands Server Configuration cmomccoonocnonaconcncnnnncanancnnnncananenns 30 Table 13 Edit Menu Commands Alias Configuration oocoonccnonocnnnacnnnncnnnacannncnnnncanancnns 30 Table 14 View Menu COMMaANdOS cccoccoconconconconconcnncnncnnnnnnnnnnnnnn rn ran rnn enn rnnrnnrnnnnnennnanennnanas 30 Table 15 Tools Menu COMMAN S ccoocccconconconconconcnncnncnnnnnnnnnnnnnn rara ran rnnrnnrnnrnnrnnennnannnnnnnas 31 Table 16 Help Menu COMMAS cccocccconconconconcnncnncnncnncnnnnnnnnnnnnnnnnn rana ran rnnrnnrnnrnnrnnennnnnas 31 Table 17 General Options Tab Field oocoonocoonoconnncnnnncannncnnnncnnnncnnnncnnnncnnnncnnrncnnancananenns 33 Table 18 General Logging Options Tab FieldS oomcoonocoococonnaconcncnnnacanancnnnncannncnnnncananenns 34 Table 19 Interface Logging Options Tab Fields ocoocccnonoconnncnnnncnnnncnnnncnnnncananennnncananenns 35 Table 20 Advanced Options Tab Field ococcoccnnccnccncnnconcnnnnnnnnnnnnrnnnnn cnn rnnrnnrnnrnnnnnnnnnnnnnnns 37 Table 21 Insert New Alias Window Options cccooc
105. ons allowed The only other location where the Admin group has permissions defined is the full item ID Bucket Brigade l nt4 This user is unable to write to that item However the root permissions for browsing adding and reading the item apply as they are not defined at this level Security Details ACL File The permissions that the MatrikonOPC Tag Security Configuration Utility creates are stored in a file named ACL sec that is located in the same directory as the MatrikonOPC server executable C Program Files Matrikon OPC lt OPC Server Name gt ACL sec is encrypted with 256 bit AES using the password key that was provided during installation or changed in the security utility If ACL sec is missing from its location above then the OPC server will deny all users access to all browsing adding reading and writing functionality Note It is advised that this file is backed up and stored somewhere safe once tag security configuration has been completed In the event that this file is lost or deleted by accident simply transfer the stored backup if one was made to the directory stated above If ACL sec becomes deleted and no backup was made tag security will need to be re configured MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 112 MatrikonOPC Run Time Tag Security Configuration Tag security can be configured and updated while a MatrikonOPC server is running This run time security configuration can b
106. p Use this button to edit group and user properties such as their name permissions and password Use this button to delete users and groups Use this button to change your password Change Password Hide Help MatrikonOPC Server for Simulation and Testing Apply Figure 43 MatrikonOPC Tag Security Configuration Utility Main Screen The MatrikonOPC Tag Security Configuration Utility screen displays the name of the OPC server that is being configured for tag security In Figure 43 above the Utility screen shows that the MatrikonOPC Server for Simulation and Testing tag security is being configured The left hand side of the Utility screen shows a column of action icons that can be clicked upon These actions are further described later in this appendix Some actions may not be applicable depending on the context in which they are used and are identified by greyed out icons In the center of the Utility screen there are descriptions for each of the actions that can be performed The appearance of these descriptions can be toggled at any time by clicking on the Hide Help Show Help link that exists in the bottom right corner of the Utility screen When the Help screen is hidden a list of users and groups that have been added appears Figure 44 By default there is always a user named Everyone in the Users amp Groups list This user defines the permissions used for other NT users that are not configured MatrikonOPC Server for S
107. pen OPC clients are still connected to the server the user is prompted for confirmation before continuing Saves the current configuration to an XML file Displays the Save E save Configuration window to prompt for a new file name if the configuration is new and has not been saved before Y Saves the current configuration to an XML file Displays the Sav Save As g pay iii Configuration window to prompt for a new file name E Export Aliases Exports all currently configured aliases to a CSV file Displays the Export Aliases window to prompt for a file name EN mport Aliases Clears all aliases and imports new ones from a CSV file Displays the Import Aliases window to prompt for an existing file name Q Shutdown Server Closes the current configuration and shuts down the server after signalling the shutdown event to all connected clients If OPC clients are still connected to the server the user is prompted for confirmation before continuing Close Hides the main Configuration window The server shuts down after a short delay if no OPC clients are currently connected to the server Edit Menu Table 11 File Menu Commands Table 12 describes the Edit menu commands that appear when the currently selected object appears under the Server Configuration node Command Description Undo Can t Undo Not implemented MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 29
108. pport to assist with troubleshooting if required To install the software 1 Insert the MatrikonOPC Server for Simulation CD into the CD drive 2 If the MatrikonOPC Welcome screen does not automatically appear double click the MatrikonOPCSimulation exe file The MatrikonOPC Server for Simulation InstallAware Wizard verifies its contents Figure 1 and the License Agreement screen Figure 2 appears Notes e The Version number located in the lower left corner indicates the version number of the software that is being installed The text X X X X will be replaced with the specific product version e From the License Agreement screen you also have the option of selecting or rejecting the license agreement Selecting the I reject the license agreement option disables the Next button so your options are to return to the previous screen cancel the install by clicking on the Cancel button or select the accept the license agreement option enabling you to continue through the install InstallAware Wizard A The Install ware Wizard is verifying the contents of this setup package This may take a moment Cancel Figure 1 InstallAware Wizard Verification Window MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 13 MatrikonOPC p anr e es p Sa MatrikonOPC Server for Simulation InstallAware Wizard X License Agreement Software License Agreement A Between Matrikon Inc Matrikon and the
109. ptions window select the Interface Logging tab Figure 16 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 34 MatrikonOPC Options General General Logging Interface Logging Advanced Interface Activity Logging You can customize the way the server records error and debug information Enable logging None y I Commit all log file writes Defaults a Cancel Figure 16 Interface Logging Options Tab Table 19 describes the fields available on the Interface Logging tab Field Description Enables disables interface logging at the specified detail level High Medium Low or None if selected Generates a separate log file for each client named PST TMP in the server installation directory Note This option should not be selected unless users are debugging a problem as this will have a negative effect on performance of the OPC server Enable logging Purges the file buffer after each message is logged in the event of an Cammie all 169 Mle writes unexpected server shut down Table 19 I nterface Logging Options Tab Fields Note Interface Logging options settings take effect when the next OPC client connects to the server MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 35 MatrikonOPC Advanced Options The Advanced tab allows users to view and edit advanced server options To view the Advanced options 1 On the Configuration window from
110. r calculations with involve multiple items Refer to the Item Path Browser section for more information 10 Configure the remaining fields as required see Table 21 for a description of all the components 11 Click on the Save button to save the alias Editing Aliases Note Aliases can be edited after they have been created using the Edit Alias window This is virtually the same as the Insert New Alias window Figure 18 with the exception that it appears after the alias has been created To edit an alias 1 On the Configuration window select the alias you want to change and then double click or press Enter 2 The Edit Alias window appears 3 Make the changes as required Removing Aliases Note Any alias that was created can be removed To remove an alias 1 On the Configuration Window select one or more aliases that you want to remove 2 From the Edit menu choose the Delete Alias menu option 3 The alias is removed Removing Alias Groups Note Any Alias Group that was created can be removed To remove an Alias Group 1 On the Configuration window select the Alias Group you want to remove 2 From the Edit menu select the Delete Alias Group menu option or click on the X button 3 The Alias Group is removed Exporting Aliases Note Use the Export Aliases window to export all currently configured aliases to a CSV file To export all currently configured aliases 1 Fromthe File menu select the Expor
111. r communication It enhances the Interface Activity Logging by recording the client side transactions It can also be used with other OPC servers MatrikonOPC Sniffer is a utility used to troubleshoot OPC client server interoperability issues Contact the MatrikonOPC Sales department for further information about this product or use the following link to access the Matrikon Sniffer Download In general the server logs all errors and other information of immediate importance to the user at the low detail level all warnings and other information of moderate importance to the user at a medium detail level and additional information concerning the normal functioning of the software at a high detail level The server also logs further information of concern to support personnel at the debug log level server It is recommended that the log level be left at the default Note The higher the log level the slower the performance of the unless troubleshooting needs to be performed MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Limitations MatrikonOPC Server for Simulation has the following limitation 1 History the Simulation server has limited history and lists only the last 100 values per item Refer to the MatrikonOPC Server for Simulation Release Notes for known issues MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 53 MatrikonOPC Troubleshooting The following section addresse
112. ranch search for the GUID retrieved in the previous step e g HKEY_CLASSES_ROOT CLSI D 024C7FFC 9CC3 476f 867A BC3CAD79F4FE 8 Create a string value called Item DEscapeCharacter in the Options branch underneath the GUID e g HKEY_CLASSES_ROOT CLSI D 024C7FFC 9CC3 476f 867A BC3CAD79F4FE Options Note To create a new value use the context menu and select the New String Value menu option No Do Ure 9 Set the value of I temi DEscapeCharacter to a single character such as pipe Note To edit the value select the entry and select the Modify menu option from the Edit menu 10 Shut down the server and restart it for the change to take effect 11 Configure the Item DEscapeCharacter Item ID in the OPC client with the access path appended to the end with the configured escape character e g ITEMI D ACCESSPATH Server cannot be configured no Matrikon logo in Tool Tray Proben The server cannot be configured because there is no Matrikon logo in the Tool Tray If the Server is running as a service the Matrikon logo does not appear in the Tool Tray Solution To configure the server start the configuration utility by using the shortcut to the OPC server in the Windows Start menu this shortcut starts the Configuration utility as well as the OPC Server error on launch the DCOM permissions have not been configured A Note If the server configuration utility generates an
113. re Root Gain Offset Input Output EE lr Figure 19 Insert New Alias Window Scaling Options Table 22 describes the Scaling Options for the Insert New Alias window Tab Component Description Simple text equation to apply to incoming values reads Click on the Input ellipsis button J to display the Expression Wizard screen used to help build a formula For more information refer to the Expression Wizard section in this manual Expression Simple text equation to apply to outgoing values writes Click on the Output ellipsis button to display the Expression Wizard screen used to help build a formula For more information refer to the Expression Wizard section in this manual Calculation equation to apply to incoming values reads Click on the Calculation Input ellipsis button J to display the Item Path Browser screen used to add item paths to this field For more information refer to the tem Path Browser section in this manual Raw High Maximum expected raw value of the OPC item Raw Low Minimum expected raw value of the OPC item Scaled High Maximum desired scaled value for the alias corresponds to Raw Linear and Square Root High Scaled Low Minimum desired scaled value for the alias corresponds to Raw Low Clamp High Clamp the scaled value at the high limit to prevent it from going out of range Clamp Low Clamp the scaled value at the low limit to preven
114. rocess COM server and enters its registration information in the Windows registry when instructed to do so with the REGSERVER command line option The server installs itself as a Windows service and enters its registration information in the Windows registry when instructed to do so with the SERVICE command line option e Version independent program ID is Matrikon OPC Simulation e Version specific program ID is Matrikon OPC Simulation 1 e Vendor information string under OPC sub key is Matrikon Inc 780 448 1010 http www matrikon com e Globally unique application ID is FLFO7BB3 D2CB 4e68 A4BF 4888CE1FD9F2 e Globally unique class ID number is 81BD69CB 47A4 49bc B5BD 2CD55ACC2DDE e Full path of 32 bit local Server executable by default is C Program Files Matrikon OPC Simulation e OPC Data Access Server 1 0 and 2 0 implemented component categories The server removes its registration information from the Windows registry when commanded to do so with the UNREGSERVER command line option Common Interfaces The server supports the mandatory functionality specified in OPC Common Definitions and Interfaces The server supports the following locales for result code translation e US English 0x0409 e System default 0x0800 e User default 0x0400 e Neutral 0x0000 The server allows the client to set the client name for each connection The server supports the shutdown event notification client side interface Data
115. rs EULA pdf End User License Agreement in PDF format OEM_MATRKION_OPC DLL MatrikonOPC OEM Badge Library MatrikonOPC Automation Component enables developers to access OPCAuto d11 pin l e OPC data from client applications developed using automation tools opcda20_auto doc MatrikonOPC Automation Component interface standard MatrikonOPC HDA Automation Component enables developers to OPCDAAuto d11 access OPC data from client applications developed using automation tools such as Visual Basic VBA and VB Script The proxy stub file that allows OPC clients to make remote hd d11 openda_Pe connections to an OPC HDA server opchdal0_auto doc Developer documentation for the HDA Automation Component MatrikonOPC HDA Automation Component enables developers to OPCHDAAUTO DLL access OPC HDA data from client applications developed using automation tools PSTCFG exe Matrikon product configuration utility PSTcfgps dl1 Matrikon product configuration marshalling library Table 4 Files Installed in Common Folder The files listed in Table 5 are installed in the WINDOWS system32 folder File Name Description actxprxy dll ActiveX Interface Marshalling Library ExprEval dll Expression Evaluation Library for Alias Scaling Equations opc_aeps dll OPC Alarms and Events 1 10 Interfaces and Marshalling Library opccomn_ps dll OPC Common Interfaces and
116. rs Groups A o o 93 Figure 45 Add User Window NT cccccccsscsseenceceeceneeeeeneeasenseeseeneeneeeeeneeeeeneeeeeeeaeeaenaneanes 94 Figure 46 Defined Users and Groups cccoococoncnconcnconnncanancnnnncnnancnnnncnnnncnnnncannnnrncnnrncananeans 95 Figure 47 Add User Window Private cccsccsceccenceceeceeccecceeseeseseeeeeeeeeeeeeeeeeeeeeeeeeeneneane 96 Figure 48 Add Group Window NT sssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 97 Figure 49 Add Group Window Private c cccsccsceceeseeneeneeeeeeeeneeaseseeseeseeeeeeseneeseeaeeaneanes 98 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 9 MatrikonOPC Figure 50 Enter New Name WiNdOW ccoococoonoconcnconnncanoncnnnncanancnnnncannncnnnncnnanennancanannanenas 98 Figure 51 Edit lt Username gt Window Permissions Tab scsscsecseeseeseeeceeneeneeeeeeeeenes 100 Figure 52 Add Permission Screen Server Address Space s sssssssssunnnnnnnnnnnnnnnnnnnnnn 101 Figure 53 Add User Permission WiNdOW occcoonoconnncnonncanancnonnranancnnnnrananrncnnrananencnnrananes 102 Figure 54 Add Permission Window Browsing Server Address Space ssssseeseeenseeees 103 Figure 55 Edit lt Username gt ExaMple cccoocnconnnconnnconnncannnrannnrannnrannnrannnracanrananracanrananes 104 Figure 56 Edit lt Username gt Window General Tab ccsccseeseceeeseeseeeeeeneeneeneeeeeeenanes 105 Figure 57 Reset Password Window
117. rver for Simulation v1 5 0 0 User s Manual 73 MatrikonOPC Appendix A Distributed COM DCOM DCOM is an object protocol that enables COM components such as OPC clients and servers to communicate directly with each other across a network A certain amount of configuration is required on the system where the OPC server is installed to allow remote clients to connect to it over the network Administrator for more information about the settings that you should The following steps are suggestions only Ask your Windows Network use especially between different domains Readers should be familiar with DCOM and with Windows 2000 security features and security administration Information regarding Distributed COM and various links to related sites white papers specs etc can be found at http www microsoft com com tech DCOM asp Specifications on DCOM COM and release notes on COM can be found in the MSDN Online Library at http www microsoft com com resources specs asp DCOM Configuration Utility Start the DCOM configuration utility either from the server configuration utility or from the command line DCOMCNFG Answer yes to any message boxes that appear allowing the utility to assign application ID entries to those servers that don t already have them The main window for DCOMCNFG allows the user to either configure default settings for all COM servers or else to configure settings for a specific server chosen fr
118. rvice 6 Include the names of users or user groups from trusted domains that you wish to be able to use the OPC server on this machine Include the Everyone group to allow access to all users on a particular domain 7 To set the Access permissions click Use custom access permissions and then click Edit 8 The Registry Value Permissions window Figure 38 appears MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 76 MatrikonOPC Registry Value Permissions Registry Value AccessPermission Owner liz brisby Liz Brisby Everyone Allow Access Allow Access Allow Access Type of Access lAlowAccess Y ox Cancel al Remove Help Figure 38 Registry Value Permissions Window 9 To add users to the list click Add 10 The Add Users and Groups window Figure 39 appears Add Users and Groups List Names From MATRIKON Enterprise Admins Designated administrators of the enterpri A Europe Managers y Everyone All Users Enterprise Wide Systems E cima Domain Servers Exchange Domain Servers Forestry Industry German Managers German Managers only E E Show SU Search Add Names Type of Access allow Access 7 OK Cancel Figure 39 Add Users and Groups Window 11 To add a user to the list select the user and then click Add If the user you wish to add does not appear then click Show Users MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 77 MatrikonOPC 12 When yo
119. s some of the most common problems encountered and questions asked while using this OPC server Please check the following Problems and Solutions before contacting the MatrikonOPC Support team Problems and Solutions Server stops updating client with item values after 30 days Problem The server stops updating the client with item values after 30 days Solution The evaluation period for the license has expired Contact the MatrikonOPC Support team Server shuts down after five minutes when no clients connected Problem The server automatically shuts down after five minutes when there are no clients connected Solution This is standard behaviour for COM servers However this behaviour can be overridden as shown in the following example Note Microsoft highly recommends that you back up the registry before editing it or making changes to it 1 From the Run command enter REGEDIT 2 The Registry Editor Figure 29 is launched In the Registry Editor under HKEY_CLASSES_ ROOT look for the required program ID e g Matrikon OPC Simulation 1 MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 54 MatrikonOPC 2 Registry Editor File Edit View Favorites Help E My Computer aa HKEY_CLASSES_ROOT ab Default value not set 3 HKEY_CURRENT_USER 3 HKEY_LOCAL_MACHINE Y HKEY_USERS H HKEY_CURRENT_CONFIG Name Data My Computer HKEY_CLASSES_ROOT Des Figure 2
120. server Sub WriteToDDE open a DDE channel Field 1 SERVICE Field 2 TOPIC channel DDEInitiate matrikon_opc_simulation Bucket Brigade Real4 poke to the Item 10001 the value of cell Al DDEPoke channel 10001 Worksheets Sheet1 Range A1 close the channel DDETerminate channel End Sub MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Net DDE Since DDE commands are routed by the operating system it is not possible to establish a DDE session between two computers unless some transport mechanism is used This is usually supplied as a plug in component of the operating system In the Windows Environment the NetDDE Windows Service allows DDE communication between two computers DDE Share on SE Shares Help Figure 40 DDE Share NetDDE must first be configured using the DDEShare application DDEShare exe as shown in Figure 40 Each SERVICE and TOPIC pair or NetDDE Share that is to be available through NetDDE must be assigned a unique name MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC Appendix E Security Introduction The OPC Framework has implemented the OPC Security Customer Interface version 1 0 of the specification Both the OPCSecurityNT and IOPCSecurityPrivate interfaces are fully supported there are no optional pieces IOPCSecurityNT describes how NT authentication
121. sing 2 Adding items 3 Reading 4 Writing Browsing is the least intrusive followed by adding items reading values from the items and finally writing to the items being the most intrusive There are multiple interfaces and functions within those interfaces that can be used to perform the types of functionality listed above Thus security control has been added to each possible entry For example read control has been added to group subscriptions call backs as well as synchronous reads and asynchronous reads denying read control would disable reads for the possible types A location that is being accessed by an OPC client may have different permissions for the different types of access For example one particular item may be browseable added and read but the writing permissions might be restricted so that the user cannot interfere with the operation of the end device Note Of the four functionality types listed above three of them make use of the full OPC item ID when an interface call is made from the client to the server Adding Items Reading or Writing When browsing only a partial path leading to an OPC item may be known at any location in the browsing hierarchy MatrikonOPC Tag Security Configuration Utility The tag security settings for MatrikonOPC servers are configured and managed via the MatrikonOPC Tag Security Configuration Utility a tool that is installed with the server This utility allows users to define per M
122. sword at a later date access the Tag Security shortcut from the Start menu Click on the Windows Start button Select Programs gt MatrikonOPC gt lt OPC Server Name gt gt Tag Security For more information refer to Appendix E Security 13 Click on the Next button The Ready to Install screen Figure 7 appears MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 18 0 MatrikonOPC E MatrikonOPC OOO Es ac care eS _ __ _ Figure 7 Ready to I nstall Screen 14 Click on the Next button The Installation MatrikonOPC Server for Simulation screen Figure 8 appears installation begins and the server files are copied to the computer Note Prior to starting the installation you have the option of clicking on the Back button to change any of the installation information Click on the Cancel button if you wish to stop or cancel the installation MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 19 0 MotrikonOPC 4 Installing MatrikonOPC Server for Simulation MatrikonOPC a eeoo Don t let DCOM stand between you and your data MatrikonOPC Tunneller makes data access between computers simple It can t get any easier C SEC Click Here for Free Download RegCode dll 25 complete Cancel LLNS Figure 8 Installing MatrikonOPC Server for Simulation Screen 15 When the installation has finished the MatrikonOPC Server for Simulation Setup Complete screen Figure
123. t Aliases menu option or click on the button 2 The Export Aliases window appears 3 Enter a file name for the CSV export file 4 Click Save 5 The aliases are exported MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 41 MatrikonOPC Importing Aliases Note Use the Import Aliases window to clear all aliases and import new ones from a CSV file To import aliases from a CSV file From the File menu select the Import Aliases menu option or click on the amp button The Import Aliases window appears Browse to the CSV file name Click Open The old aliases are cleared and the new ones are imported ee oN Expression Wizard The Expression form of scaling uses an Expression Wizard to build formulas The created formula is a simple text equation that is applied to either incoming values i e reads or outgoing values i e writes Table 23 describes the Expression Wizard fields Component Description Displays the expression as it is created This field is free form which allows you to manually enter or edit information This field reads Input Output Expression Input Expression when creating an input or read expression It reads Output Expression when creating an output or write expression Database field This button is reserved for future enhancements Select this button to display the Select function window which allows Funesen you to select the necessary function from
124. t is selected Also serves as the canonical data type for the alias Read only When this checkbox is selected it prevents OPC clients from writing values to the alias This option is not available for Calculation aliases as they are read only Update Rate Update rate milliseconds to use with the Poll when inactive option Poll when inactive If selected continues updating the value for the alias at the specified update rate even if there are no OPC clients currently accessing the alias Save Save changes to the alias and hide the window Save amp Create New Save changes to the alias and begin configuring a new one Default to new Pressing Enter activates the Save amp Create New button rather than the Save button if selected Scaling gt gt Enables scaling for the alias displays scaling options lt lt No Scaling Disables scaling for the alias hides scaling options Cancel Discards changes to abandon creation of the alias and hides the window Table 21 Insert New Alias Window Options MatrikonOPC Server for Simulation v1 5 0 0 User s Manual MatrikonOPC By selecting the Scaling gt gt button the Insert New Alias window can be expanded to display Scaling Options Figure 19 The available forms of scaling include Simple text Expressions Calculation Linear Square Root and Gain Offset Expression Calculation Linear Squa
125. t it from going out of range Gain Offset Gain Scaling factor No limits are assumed Offset Scaling offset Table 22 Insert New Alias Window Scaling Options MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 39 MatrikonOPC e The data type for scaled values is double precision real unless the alias data type is specified e Using invalid settings such as zero zero for the high low range in Linear scaling may be fatal to the server OPC clients and communications e The OPC item values must be numeric for Linear Square DA Root and Gain Offset scaling to work e The OPC item values must be non negative for Square Root scaling to work Otherwise the scaled value will be 1 with a bad quality e The server may be unable to load configuration files containing invalid scaling expressions and may fail to start up properly If this occurs rename the configuration file so that the server will not load it upon start up Alternatively edit the XML file to correct the invalid alias settings To insert a new alias Note It is recommended that you create a new alias under an Alias Group rather than directly under the Alias Configuration node 1 On the Configuration window select Alias Configuration or a previously configured Alias Group 2 The Contents table for that Alias Group is displayed on the right side of the Configuration window Figure 20 listing the aliases it co
126. this document may be reproduced stored in a retrieval system translated or transmitted in any form or by any means electronic mechanical photocopying recording or otherwise without prior written permission of Matrikon Inc CONFI DENTI AL The information contained herein is confidential and proprietary to Matrikon Inc It may not be disclosed or transferred directly or indirectly to any third party without the explicit written permission of Matrikon Inc LI MI TATI ONS Matrikon has made its best effort to prepare this manual Matrikon makes no representation or warranties of any kind with regard to the completeness or accuracy of the contents herein and accepts no liability of any kind including without limitation warranties of merchantable quality satisfactory quality merchantability and fitness for a particular purpose on those arising by law statute usage of trade course of dealing or otherwise Matrikon shall not be liable for any losses or damages of any kind caused or alleged to be caused directly or indirectly from this manual LICENSE AGREEMENT This document and the software described in this document are supplied under a license agreement and may only be used in accordance with the terms of that agreement Matrikon reserves the right to make any improvements and or changes to product specifications at any time without notice TRADEMARK INFORMATION The following are either trademarks or registered trademarks of their r
127. those available Select this button to display the Select variable window which allows Variable you to select the necessary variable from those available Select the applicable button to add the corresponding operator or Operators operators to the expression Clear Select this button to clear the Input Output Expression field Select this button to validate the expression that appears in the Input Output Expression field If the expression is invalid an error Validate message is displayed If the expression is valid a message is displayed indicating there are no errors and also stating what the result is Select this button to accept changes to or the creation of the OK A expression Select this button to discard changes to or abandon the creation of Cancel i the expression Table 23 Expression Wizard Options Notes e The Expression Wizard appears and functions the same for an input expression as it does for an output expression The differences being the expression field label Input Expression Output Expression and that one is for reads and the other for writes MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 42 MatrikonOPC If you are expecting to read a particular alias create an Input Expression If you are expecting to write to a particular alias create an Output Expression To create an Input or Output Expression 1 6 On the Configuration window s
128. tility main screen either e Select the required user or group from the list and click on the Delete button Figure 46 or MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 109 MatrikonOPC e Fora group right click your mouse on the required group and select Delete Group from the displayed menu or e Fora user right click your mouse on the required user and select Delete User from the displayed menu Change Password To change the security password for the OPC server 1 From the MatrikonOPC Security Configuration Utility main screen click on the Change Password button Figure 43 2 The Change Password window Figure 62 appears Change Password Eo Please enter the old password for this OPC Server a Please enter the new password for this OPC Server Please confirm the new password Cancel Figure 62 Change Password Window Enter the old password for the current OPC server Enter and confirm the desired new password Click on the OK button Note Changes are applied in the Utility main window by clicking on either the OK or Apply button Examples This section contains examples of tag security settings made via the MatrikonOPC Tag Security Configuration Utility and the impact of these settings Default The default tag security configuration provided is quite simplistic as is shown in Table 46 User Group Configured Paths Browse Add Read Write
129. u are done adding users click OK to close the Add Users and Groups window You can then choose to Allow Access or Deny Access for each user Notes e The procedure to set the launch permissions is similar to the above but instead of choosing Allow Access for a user you would choose Allow Launch e The Configuration Permissions contain an Access Control List of principals that are allowed to modify the configuration information for a server In other words it indicates who is allowed to alter the registry entries for installed servers as well as who is able to access the registry for the purposes of installing new servers It is usually simpler to install and configure servers as a user with local administrative rights 13 To connect to an OPC server from outside of the domain create a local user account on both the server and the client machine with identical username and password Then add the local user on the OPC server to the DCOM permissions Use the local account on the client machine to connect to the OPC server Server Identity The Identity tab for a selected COM or OPC server specifies the user account that should be used when COM starts up the process The available settings are different for servers that run as local executables as opposed to those that run as NT services It is strongly recommended that OPC servers should be installed to run as NT services if they are going to be accessed by remote clients DA via DCOM Th
130. ual 48 MatrikonOPC Shutting Down the Server To shut down the server 1 On either the Control Panel or the Tool Tray Menu select Shutdown If the server is running as a local executable choose Shutdown Server from the File menu or click on the button If OPC clients are still connected to the server a warning message appears Click OK 4 The server is shut down as a Windows service Services can be shut down only from the A Note The shutdown command is not available for the server if it runs Service Control Manager applet in the Windows Control Panel MatrikonOPC Server for Simulation v1 5 0 0 User s Manual UNO MatrikonOPC OPC Data Items This section describes the OPC data items used in the MatrikonOPC Server for Simulation Simulation Items The MatrikonOPC Server for Simulation item ID syntax is as follows Source Type Data Type Where e Source Type is the name source the data types belong to e Data Type is the name of the item and the data type the item is Note The item OfflineMode browseable under Standard Simulation Items has no functionality within the MatrikonOPC Server for Simulation Available Items Item ID Data Type R Ww Comments Bucket Brigade l nt2 VT_I2 Y v Short Read Write item Bucket Brigade String VT_BSTR Y String Read Write item Random R8 VT_R8 Y Random Read Real item A Random value and size of Array of Y Random ArrayOfString VT_ARRAY VT_BSTR String
131. way a DDE client can request data from the server using the following DDE commands XTYP_POKE Write data to an item in the server XTYP_ REQUEST Read data from an item in the server XTYP_ADVREQ Read latest data from an active advice loop XTYP_ADVSTART Create and activate an advice loop on a single item in the server XTYP_ADVSTOP Stop and destroy an advice loop on a single item in the server DDE service can be enabled or disabled using the checkbox Note that these options will not be available if the server does not support DDE Items within the server can be referenced using the following syntax SERVICE NAME ITEM SCANDETAILS SERVICE_NAME represents the name of the DDE service The first edit box specifies the service name used by this server ITEM refers to an item ID of a point within the server SCANDETAILS is a combination of the desired scan rate of the item and an access path One or more delimiting characters separate the scan rate and access path The second edit box can be used to change the delimiters The delimiting characters must be provided when referencing an item in the server However the scan rate and access path are optional If no scan rate is specified only data contained in the server cache will be available through DDE and an advise loop will not be created Changes to the DDE options will not take effect until the server is restarted Note DDE Name Syntax DDE Names may be described in the
132. xe Command line security utility used to encrypt decrypt the ACL file AliasCalculationLib dll Altova dll AltovaXML dl1l CalcEngine _ u dll CalcEngineResource dll CalculationGraph dll clipsdl1 d11 icudt36 d11 icuin36 d11 icuuc36 d11 js32 d11 log4cxx dll NTEventLogAppender dl1l OpcDataDelivery _ u dll ProcessNetDataDelivery_u dll Scheduleru_dl1 d11 ScriptLibrary u dll Xerces c_2 7 dll Calculation Engine binary files MatrikonOPC Server for Simulation Release Notes pdf Release Notes for this server MatrikonOPC Server for Simulation User Manual pdf User s Manual for this server OPCSim exe Server executable Progld txt Product identification file used by ACLSecure exe Project Info log Product dependency file security cfg Security settings ServerOpts ini Server configuration file Simulation wmv Instructional video providing instructions on how to install and use the Simulation server Table 3 Files Installed in Simulation Folder The files listed in Table 4 are installed by default in the following location C Program Files Common Files MatrikonOPC Common File Name Description ACLConfig exe MatrikonOPC Tag Security Configuration Utility that configures tag MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 22 MatrikonOPC File Name Description level security in MatrikonOPC serve
133. y entries in the registry Ensure OPCEnum is registered as a service DCOM permissions are configured properly and the OPCEnum service is running Also especially for older OPC clients that do not use the OPC server browser make sure the client is running as a user that has read access to the registry Server does not show up as a program ID in a remote OPC client application Problem The server does not show up in a list of available program IDs in the OPC client application on a remote machine Follow the steps found in DCOM Manual to copy the program ID from the server Solution machine to the OPC client machine Access denied or time out error when connecting to remove server via DCOM Problem Access Denied error message appears or time out occurs when trying to connect to a remote OPC server via DCOM MatrikonOPC Server for Simulation v1 5 0 0 User s Manual 58 MatrikonOPC Ensure that the access and launch permissions for the OPC server are set correctly on the Solution server machine For more information refer to the DCOM Manual Server does not start up or client cannot connect Problem A client tries to connect to the server and fails or the server does not start up Ensure that the access and launch permissions for the OPC server are set correctly For Solution more information refer to the DCOM Manual About screen and Configuration window do

MatrikonOPC Server for Simulation User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents