EtherNet/IP Web Server Module1756-EWEB, 1768-EWEBUser Manual
Publication ENET-UM527E-EN-P - October 200610 Table of Contents
Publication ENET-UM527E-EN-P - October 2006100 Create Custom Web PagesJavascript Library: XMLObjectLoaderLib.jsThis library uses the conversion
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 101These functions are contained in the XMLObjectLoaderLib.js library.For ex
Publication ENET-UM527E-EN-P - October 2006102 Create Custom Web PagesWeb Page Forms and POST HandlersAny web page that displays controller dat
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 103Remove the newlines from the alert text or shorten the alert text to one
Publication ENET-UM527E-EN-P - October 2006104 Create Custom Web PagesFor example, this code:<html><head><title>Data View Jav
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 105if (STR_ACTIVEX.indexOf(".DOMDocument") != -1) { xmlhttp = new
Publication ENET-UM527E-EN-P - October 2006106 Create Custom Web Pagesdisplays this screen:In the web server module, the data view looks like t
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 107This example also requires a custom access level.This method (updating th
Publication ENET-UM527E-EN-P - October 2006108 Create Custom Web PagesACTION="/rokform/WriteLogixTags"This method is a web POST form
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 109The following example page displays a DINT tag from a controller and lets
11 Publication ENET-UM527E-EN-P - October 2006PrefaceAbout This PublicationUse this manual as a reference when installing, using, and troubleshooting
Publication ENET-UM527E-EN-P - October 2006110 Create Custom Web PagesACTION="/rokform/ReadLogixTag"This method performs an instant d
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 111ACTION="/rokform/CIPMessage"This method performs an instant CIP
Publication ENET-UM527E-EN-P - October 2006112 Create Custom Web PagesFor example:<html><head><meta http-equiv="Content-Typ
113 Publication ENET-UM527E-EN-P - October 2006Chapter 9Monitor DiagnosticsAbout This ChapterThe web server modules provide several levels of diagnost
Publication ENET-UM527E-EN-P - October 2006114 Monitor DiagnosticsDiagnostics OverviewThe Diagnostics > Diagnostic Overview page presents a
Publication ENET-UM527E-EN-P - October 2006Monitor Diagnostics 115CIP connections are for Logix-based communications, such as MSG instructions,
Publication ENET-UM527E-EN-P - October 2006116 Monitor DiagnosticsNetwork SettingsThe Diagnostics > Network Settings page presents a summary
Publication ENET-UM527E-EN-P - October 2006Monitor Diagnostics 117Message ConnectionsThe Diagnostics > Message Connections page presents a s
Publication ENET-UM527E-EN-P - October 2006118 Monitor DiagnosticsTarget The IP address of the device that is the target of the connection on E
Publication ENET-UM527E-EN-P - October 2006Monitor Diagnostics 119Ethernet StatisticsThe Diagnostics > Ethernet Statistics page presents a s
Publication ENET-UM527E-EN-P - October 200612
Publication ENET-UM527E-EN-P - October 2006120 Monitor DiagnosticsIn Unknown Protos Inbound packets with unknown protocolOut Octets Octets sent
121 Publication ENET-UM527E-EN-P - October 2006Appendix AUse the Web Server Module To Connect Over EthernetAbout This AppendixA connection is a commu
Publication ENET-UM527E-EN-P - October 2006122 Use the Web Server Module To Connect Over EthernetCIP communications take priority over HTTP com
Publication ENET-UM527E-EN-P - October 2006Use the Web Server Module To Connect Over Ethernet 123TCP ConnectionsThe web server module uses one
Publication ENET-UM527E-EN-P - October 2006124 Use the Web Server Module To Connect Over EthernetNotes:
125 Publication ENET-UM527E-EN-P - October 2006Appendix BSocket InterfaceAbout This AppendixThe socket interface lets you use a Logix controller to co
Publication ENET-UM527E-EN-P - October 2006126 Socket InterfaceBefore You BeginBefore you use the socket interface, you should be familiar with
Publication ENET-UM527E-EN-P - October 2006Socket Interface 127You can partition the 20 available socket instances between UDP and TCP sockets.
Publication ENET-UM527E-EN-P - October 2006128 Socket InterfaceTypical Sequence of Transactions For a TCP ClientThe following diagram shows a t
Publication ENET-UM527E-EN-P - October 2006Socket Interface 129Typical Sequence of Transactions For a TCP ServerThe following diagram shows a t
13 Publication ENET-UM527E-EN-P - October 2006Chapter 1Getting StartedIntroductionThis chapter describes procedures for getting started with your Ethe
Publication ENET-UM527E-EN-P - October 2006130 Socket InterfaceTypical Sequence of Transactions For UDP Without OpenConnectionThe following dia
Publication ENET-UM527E-EN-P - October 2006Socket Interface 131Typical Sequence of Transactions For UDP With OpenConnectionThe following diagra
Publication ENET-UM527E-EN-P - October 2006132 Socket InterfaceCommunicate With the Socket Object Via a MSG InstructionIn Logix controller prog
Publication ENET-UM527E-EN-P - October 2006Socket Interface 133For details on specific services, see See Socket Object Services on page 140.Mes
Publication ENET-UM527E-EN-P - October 2006134 Socket InterfaceService TimeoutsYou must specify a Timeout parameter (in milliseconds) for any s
Publication ENET-UM527E-EN-P - October 2006Socket Interface 135Programming ConsiderationsObserve these programming considerations.TCP Connectio
Publication ENET-UM527E-EN-P - October 2006136 Socket Interfacesituation, your (old) MSG instructions may succeed but may not be communicating
Publication ENET-UM527E-EN-P - October 2006Socket Interface 137Application Messages and TCPA TCP connection is a byte stream between two applic
Publication ENET-UM527E-EN-P - October 2006138 Socket InterfacePartial WritesYour program may need to handle the situation, although uncommon,
Publication ENET-UM527E-EN-P - October 2006Socket Interface 139This fragment Structured Text logic shows an example of handling a partial Write
Publication ENET-UM527E-EN-P - October 200614 Getting StartedEnhanced Web Server Module ApplicationsThe following features and applications are
Publication ENET-UM527E-EN-P - October 2006140 Socket InterfaceSocket Object ServicesThe Socket Object supports these services.From the perspec
Publication ENET-UM527E-EN-P - October 2006Socket Interface 141CreateSocketThe CreateSocket service creates an instance of the Socket object. T
Publication ENET-UM527E-EN-P - October 2006142 Socket InterfaceSelect the data type you created in the Source Element field of the Message Conf
Publication ENET-UM527E-EN-P - October 2006Socket Interface 143ConsiderationsUse the instance returned by CreateSocket on subsequent service re
Publication ENET-UM527E-EN-P - October 2006144 Socket InterfaceMSG Source ElementCreate a user-defined data type.where:You can use a single str
Publication ENET-UM527E-EN-P - October 2006Socket Interface 145MSG Destination ElementNot used; the MSG instruction does not return any data.Co
Publication ENET-UM527E-EN-P - October 2006146 Socket InterfaceAcceptConnectionThe AcceptConnection service accepts a TCP connection request fr
Publication ENET-UM527E-EN-P - October 2006Socket Interface 147MSG Destination ElementCreate a user-defined data type.where:ConsiderationsCreat
Publication ENET-UM527E-EN-P - October 2006148 Socket InterfaceReadThe Read service reads data on a socket. You specify a number of bytes to re
Publication ENET-UM527E-EN-P - October 2006Socket Interface 149MSG Source Element:Create a user-defined data type.where:MSG Source LengthSpecif
Publication ENET-UM527E-EN-P - October 2006Getting Started 15Features of EtherNet/IP Web Server Module in a Control SystemThe module provides t
Publication ENET-UM527E-EN-P - October 2006150 Socket InterfaceMSG Destination ElementCreate a user-defined data type.where:ConsiderationsSee P
Publication ENET-UM527E-EN-P - October 2006Socket Interface 151WriteThe Write service sends data on a socket. You specify the number of bytes t
Publication ENET-UM527E-EN-P - October 2006152 Socket Interfacewhere:MSG Source LengthSpecify 16 bytes (Timeout + Addr + BufLen) + number of by
Publication ENET-UM527E-EN-P - October 2006Socket Interface 153DeleteSocketThe DeleteSocket service deletes a socket instance. For a TCP connec
Publication ENET-UM527E-EN-P - October 2006154 Socket InterfaceDeleteAllSocketsThe DeleteAllSockets service deletes all currently created socke
Publication ENET-UM527E-EN-P - October 2006Socket Interface 155A typical use of DeleteAllSockets is when application development and debugging
Publication ENET-UM527E-EN-P - October 2006156 Socket InterfaceErrors for any of the Socket Object calls not covered by CIP general status code
Publication ENET-UM527E-EN-P - October 2006Socket Interface 157Socket AttributesYou access these attributes by configuring the CIP Generic MSG
Publication ENET-UM527E-EN-P - October 2006158 Socket InterfaceSocket Object Class AttributesThe Class attributes apply to the Socket Object, n
Publication ENET-UM527E-EN-P - October 2006Socket Interface 159Socket Object Instance AttributesThe Socket Object provides a number of instance
Publication ENET-UM527E-EN-P - October 200616 Getting StartedThe following diagram shows how EWEB modules might fit in your control system on a
Publication ENET-UM527E-EN-P - October 2006160 Socket InterfaceTroubleshoot Socket ApplicationsTo help debug and troubleshoot applications, the
Publication ENET-UM527E-EN-P - October 2006Socket Interface 161Additional ResourcesConsult the following publications for more information.You
Publication ENET-UM527E-EN-P - October 2006162 Socket InterfaceNotes:
Publication ENET-UM527E-EN-P - October 2006IndexAAcceptConnection 146accesscustom web pages 93access levelsclasses 77access limitsconfigure 78pre-defi
Publication ENET-UM527E-EN-P - October 2006164 IndexDdata views/user/system/dataviews 62add tags 58create 57edit 61examples 64, 65, 66external
Publication ENET-UM527E-EN-P - October 2006Index 165Nnavigate 22network parametersBOOTP/DHCP utility 36configure 31DNS addressing 42modify 49RS
Publication ENET-UM527E-EN-P - October 2006166 IndexTtags 56timer server 53Uupdate control system data 96user accountsclasses 77create 80Vverif
Publication CIG-CO521C-EN-P- May 2003 PN957988-64957782-91How Are We Doing?Your comments on our technical publications will help us serve you better
Other CommentsPLEASE FOLD HERENO POSTAGE NECESSARY IF MAILED IN THE UNITED STATESBUSINESS REPLY MAILFIRST-CLASS MAIL PERMIT NO. 18235 CLEVELAND OHPOST
Publication ENET-UM527E-EN-P - October 2006Getting Started 171756-EWEB Installation To install a ControlLogix Enhanced Web Server Module (1756-
Publication ENET-UM527E-EN-P - October 2006 170 PN 953030-29Supersedes Publication ENET-UM527D-EN-P - May 2006 Copyright © 2006 Rockwell Automation, I
Publication ENET-UM527E-EN-P - October 200618 Getting Started1768-EWEB InstallationTo install a CompactLogix Enhanced web Server module, comple
Publication ENET-UM527E-EN-P - October 2006Getting Started 19System RequirementsBrowser RequirementsThe following table describes browser requi
Important User InformationSolid state equipment has operational characteristics differing from those of electromechanical equipment. Safety Guidelines
Publication ENET-UM527E-EN-P - October 200620 Getting Started2. Log into the module.3. If logging into the module for the first time, enter the
Publication ENET-UM527E-EN-P - October 2006Getting Started 216. Confirm the network configuration by verifying the IP address and other network
Publication ENET-UM527E-EN-P - October 200622 Getting StartedNavigate the Web Server ModuleYou navigate the web server’s web pages using the or
Publication ENET-UM527E-EN-P - October 2006Getting Started 23Use the Web Server ModuleTo help familiarize yourself with the web server module,
Publication ENET-UM527E-EN-P - October 200624 Getting Started2. In the Create Data View box, specify a name for the data view and enter an opti
Publication ENET-UM527E-EN-P - October 2006Getting Started 25The created tags appear. 3. If you want to change a tag value, enter the new value
Publication ENET-UM527E-EN-P - October 200626 Getting StartedConfigure EmailTo configure the SMTP server that manages email, follow this proced
Publication ENET-UM527E-EN-P - October 2006Getting Started 27Configure the Time ServerConfiguring the Time Server helps ensure that files you s
Publication ENET-UM527E-EN-P - October 200628 Getting StartedEnable/disable Other ServicesUse this procedure to enable other services.1. In the
Publication ENET-UM527E-EN-P - October 2006Getting Started 29Additional ResourcesConsult the following publications for more information.You ca
3 Publication ENET-UM527E-EN-P - October 2006Summary of ChangesThis document describes how to use the EtherNet/IP Web server module. Revision bars in
Publication ENET-UM527E-EN-P - October 200630 Getting Started
31 Publication ENET-UM527E-EN-P - October 2006Chapter 2Configure a Network Address For a Web Server ModuleHow to Use This ChapterThis chapter describe
Publication ENET-UM527E-EN-P - October 200632 Configure a Network Address For a Web Server ModuleIf you use the module to initiate MSG instruct
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 33The module home page displays.The IP address f
Publication ENET-UM527E-EN-P - October 200634 Configure a Network Address For a Web Server ModuleIf your network configuration requires a stati
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 35Assign Network Parameters Without A DHCP Serv
Publication ENET-UM527E-EN-P - October 200636 Configure a Network Address For a Web Server ModuleUse the Rockwell Automation BOOTP/DHCP Utility
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 37The hardware address is on a sticker located o
Publication ENET-UM527E-EN-P - October 200638 Configure a Network Address For a Web Server ModuleIf you do not select the Disable BOOTP/DHCP bu
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 396. Select the Port Configuration tab.7. In the
Publication ENET-UM527E-EN-P - October 20064 Summary of Changes Notes:
Publication ENET-UM527E-EN-P - October 200640 Configure a Network Address For a Web Server Module5. Select Properties.6. Select the Port Config
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 41When you change the IP address or connect a we
Publication ENET-UM527E-EN-P - October 200642 Configure a Network Address For a Web Server ModuleDuplicate Detection ScenariosThe behavior of d
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 43Your network administrator should be able to a
Publication ENET-UM527E-EN-P - October 200644 Configure a Network Address For a Web Server ModuleVerify Network SettingsSelect Administrative S
Publication ENET-UM527E-EN-P - October 2006Configure a Network Address For a Web Server Module 45Additional ResourcesConsult the following publ
Publication ENET-UM527E-EN-P - October 200646 Configure a Network Address For a Web Server Module
47 Publication ENET-UM527E-EN-P - October 2006Chapter 3Manage Module SettingsHow to Use This ChapterThis chapter describes how to configure module set
Publication ENET-UM527E-EN-P - October 200648 Manage Module SettingsDefine Module-specific Information For the Home PageSelect Administrative S
Publication ENET-UM527E-EN-P - October 2006Manage Module Settings 49Modify Network ParametersSelect Administrative Settings > Device Configu
5 Publication ENET-UM527E-EN-P - October 2006Table of ContentsPrefaceAbout This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Publication ENET-UM527E-EN-P - October 200650 Manage Module SettingsEnable and Disable Communication ServicesSelect Administrative Settings >
Publication ENET-UM527E-EN-P - October 2006Manage Module Settings 51Manage Server SettingsSelect Administrative Settings > Server Management
Publication ENET-UM527E-EN-P - October 200652 Manage Module SettingsIn The Field Take This ActionWeb Home Page Select which home page is the de
Publication ENET-UM527E-EN-P - October 2006Manage Module Settings 53Configure the Time ServerTo configure the Time Server, select Administrativ
Publication ENET-UM527E-EN-P - October 200654 Manage Module SettingsDisplay the Server LogTo display the server log, select Administrative Sett
55 Publication ENET-UM527E-EN-P - October 2006Chapter 4Use Data Views to Access Controller DataAbout This ChapterThe module provides access to control
Publication ENET-UM527E-EN-P - October 200656 Use Data Views to Access Controller DataTags Supported In Data ViewsTo configure tags in data vie
Publication ENET-UM527E-EN-P - October 2006Use Data Views to Access Controller Data 57Create a Data ViewEach data view contains a group of tags
Publication ENET-UM527E-EN-P - October 200658 Use Data Views to Access Controller Data3. Click the Add button to add the tag you just specifie
Publication ENET-UM527E-EN-P - October 2006Use Data Views to Access Controller Data 59Monitor Data Views and Tag DataSelect Data Views > Dat
Publication ENET-UM527E-EN-P - October 20066 Table of ContentsChapter 3Manage Module SettingsHow to Use This Chapter . . . . . . . . . . . . .
Publication ENET-UM527E-EN-P - October 200660 Use Data Views to Access Controller DataSort Data ViewsYou can sort data views alphabetically by
Publication ENET-UM527E-EN-P - October 2006Use Data Views to Access Controller Data 61Edit a Data ViewFollow this procedure to edit an existing
Publication ENET-UM527E-EN-P - October 200662 Use Data Views to Access Controller DataCreate Data Views OfflineYou can create data views offlin
Publication ENET-UM527E-EN-P - October 2006Use Data Views to Access Controller Data 63Use an External Application to Access Data ViewsThe XML f
Publication ENET-UM527E-EN-P - October 200664 Use Data Views to Access Controller DataIf all the modified tags are successfully written, the we
Publication ENET-UM527E-EN-P - October 2006Use Data Views to Access Controller Data 65Example: Data View XML with Tag ValuesThis is an example
Publication ENET-UM527E-EN-P - October 200666 Use Data Views to Access Controller DataExample: Data View XML with Tag ErrorsThis example a data
67 Publication ENET-UM527E-EN-P - October 2006Chapter 5Send EmailAbout This ChapterThis chapter describes how to send an email message.For email, the
Publication ENET-UM527E-EN-P - October 200668 Send EmailSee the following sample system.PowerOUTL1L2/NFirewall/RouterControlLogix Controller Wi
Publication ENET-UM527E-EN-P - October 2006Send Email 69Configure the Web Server to Send EmailThe web server module uses the standard SMTP prot
Publication ENET-UM527E-EN-P - October 2006Table of Contents 7Chapter 6Manage User Accounts and Access LevelsAbout This Chapter . . . . . . . .
Publication ENET-UM527E-EN-P - October 200670 Send EmailSend an Email Via the Web PageUse the Send an Email link to enter and send email text.
Publication ENET-UM527E-EN-P - October 2006Send Email 71Send an Email with a Controller-initiated Message InstructionA Logix controller can sen
Publication ENET-UM527E-EN-P - October 200672 Send EmailCreate one controller-scoped tag of this new data type to contain the email text. Creat
Publication ENET-UM527E-EN-P - October 2006Send Email 73Configure the MSG InstructionUse the following process configure the MSG instruction th
Publication ENET-UM527E-EN-P - October 200674 Send Emailwhere:On the Communication tab of the MSG instruction, configure the path from the cont
Publication ENET-UM527E-EN-P - October 2006Send Email 75target web server module and the software automatically fills in the path.For more info
Publication ENET-UM527E-EN-P - October 200676 Send Email0x11 None Reply data too large. The Destination string must reserve space for the SMTP
77 Publication ENET-UM527E-EN-P - October 2006Chapter 6Manage User Accounts and Access LevelsAbout This ChapterThis chapter describes how to configure
Publication ENET-UM527E-EN-P - October 200678 Manage User Accounts and Access LevelsConfigure Access Limits For Web PagesYou protect individual
Publication ENET-UM527E-EN-P - October 2006Manage User Accounts and Access Levels 79You can change the default access limits for the predefined
Publication ENET-UM527E-EN-P - October 20068 Table of ContentsAppendix AUse the Web Server Module To Connect Over EthernetAbout This Appendix
Publication ENET-UM527E-EN-P - October 200680 Manage User Accounts and Access LevelsTo see the protection limits for predefined web pages and d
Publication ENET-UM527E-EN-P - October 2006Manage User Accounts and Access Levels 81Recover with Unknown PasswordThere are no back-door account
Publication ENET-UM527E-EN-P - October 200682 Manage User Accounts and Access Levels
83 Publication ENET-UM527E-EN-P - October 2006Chapter 7Access Files in the Web Server ModuleAbout This ChapterThis chapter describes how to use FTP to
Publication ENET-UM527E-EN-P - October 200684 Access Files in the Web Server ModuleThere are no restrictions on the type of files you can copy
Publication ENET-UM527E-EN-P - October 2006Access Files in the Web Server Module 85To connect to the web server module via FTP, specify the IP
Publication ENET-UM527E-EN-P - October 200686 Access Files in the Web Server ModuleWhen user files are accessed via HTTP, certain file extensio
Publication ENET-UM527E-EN-P - October 2006Access Files in the Web Server Module 87Back Up the File System On the Web Server ModuleThere are se
Publication ENET-UM527E-EN-P - October 200688 Access Files in the Web Server ModuleBack Up FilesYou must have Administrator access to back up f
Publication ENET-UM527E-EN-P - October 2006Access Files in the Web Server Module 89The module will require that you enter a valid user name and
Publication ENET-UM527E-EN-P - October 2006Table of Contents 9MSG Configuration Parameters . . . . . . . . . . . . . . . . . . . 154Possible E
Publication ENET-UM527E-EN-P - October 200690 Access Files in the Web Server ModuleThis appears on the locked backup/restore page.The module wi
91 Publication ENET-UM527E-EN-P - October 2006Chapter 8Create Custom Web PagesAbout This ChapterThis chapter describes how to use ASP functions in cus
Publication ENET-UM527E-EN-P - October 200692 Create Custom Web Pages3. Copy your files into the /user/Web directory.See chapter 7 for more inf
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 93Access Custom Web PagesOnce a custom web page is copied into the web serve
Publication ENET-UM527E-EN-P - October 200694 Create Custom Web PagesRead Controller TagsThere are two ASP functions you can use to read contro
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 95Read CIP DataThere are two ASP functions you can use to read CIP data.Func
Publication ENET-UM527E-EN-P - October 200696 Create Custom Web PagesWhile the value returned by specifying the “STRING” data type may not be v
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 97Retrieve Information About the Web Server ModuleYou can retrieve specific
Publication ENET-UM527E-EN-P - October 200698 Create Custom Web PagesJavascript LibrariesThe web server module provides built-in Javascript fun
Publication ENET-UM527E-EN-P - October 2006Create Custom Web Pages 99Javascript Library: Conversion.jsThe conversion.js library contains six fu
Commentaires sur ces manuels