background image

pCOWeb

 +030220966 – rel. 1.1 – 12.12.2017 

49 

9.7.2

 

Uninstalling a Plugin 

To uninstall a plugin: 
1.

 

access the 

pCOWeb

 main configuration page, opening the plugin tab 

2.

 

click “Uninstall”, obtaining a page similar the one shown in 

Figure 9.q

; at the end of the uninstallation procedure, a report is displayed, similar to the one 

created during the installation procedure. 

 

 

Figure 9.q - Plugin uninstallation report 

 

The following messages are displayed by the uninstallation report: 

 [ ok ]

 

file removed correctly  

[!!!]

 

file not removed correctly  

 

If a file has not been removed correctly (it may have been removed previously or the permission has been changed manually), manual access via FTP or 
SCP is required for complete removal. 
 
 

9.8

 

PROTECTION AND ACCESS CONTROL 

 

9.8.1

 

Access rights to the custom HTML pages 

Access restrictions can be defined to the custom HTML pages: to access these from a web browser (for example Mozilla Firefox) Username/Password 
authentication will be required. 

pCOWeb

 requires authentication if and only if the directory that contains the html page also contains the special file called: 

 

.htpasswd 

(note the dot before the letter h) 

 

Once the authentication data has been entered in the browser, these are compared against the data saved in .htpasswd; if the data does not match, access 
from the browser will be denied. The access restrictions to the HTML pages MUST NOT BE CONFUSED WITH THE AUTHORISATION FOR USERS OF 
THE OPERATING SYSTEM described further on; for example, the password specified to access a page is still valid even 

pCOWeb

 is started with the button; 

if forgetting the password, to access the HTML pages the access restrictions must be deleted (see this paragraph below). 
 

SETTING OR EDITING THE HTML ACCESS RESTRICTIONS 

Click the points shown in 

Figure 9.r

 

 

Figure 9.r - Protection and access control 

 
thus obtaining: 
 

           

 

Figure 9.s - Directory list for setting access restrictions to the HTML pages 

 

 

Summary of Contents for pCOWeb

Page 1: ...pCOWeb User manual I n t e g r a t e d C o n t r o l S o l u t i o n s E n e r g y S a v i n g s LEGGI E CONSERVA QUESTE ISTRUZIONI READ AND SAVE THESE INSTRUCTIONS...

Page 2: ......

Page 3: ...do not drop hit or shake the device as the internal circuits and mechanisms may be irreparably damaged do not use corrosive chemicals solvents or aggressive detergents to clean the device do not use...

Page 4: ......

Page 5: ...S 30 6 SNMP 34 6 1 OVERVIEW OF SNMP 34 6 2 THE pCOWeb SNMP TREE 35 6 3 MIB FILE 35 6 4 SNMP CONFIGURATIONS FOR pCOWeb 36 7 BACNET 37 7 1 BACnet Carel Mapping 38 7 2 BACnet MODBUS Mapping 38 7 3 BACnet...

Page 6: ...62 APPENDIX C ArGoSoft A FREEWARE MAIL SERVER 63 APPENDIX D FileZilla Server A FREEWARE FTP SERVER 66 APPENDIX E iReasoning MIB Browser as a TRAP receiver 67 APPENDIX F CAREL TAGS FOR pCOWeb HTML PAGE...

Page 7: ...ng functions WEB server used to check or change the operating status of the pCO controller using a remote computer running for example Mozilla Firefox Google Chrome or Microsoft Edge dynamic web pages...

Page 8: ...green Single pCO pCOWeb communication error one failed response from the pCO or attempt to write a variable with an index higher than 207 After 5 failed responses the Status LED starts flashing red un...

Page 9: ...om the pCO controller IMPORTANT to avoid damage before inserting pCOWeb disconnect power to the pCO controller Figure 2 c Inserting pCOWeb in the pCO controller Figure 2 d Securing pCOWeb with the cov...

Page 10: ...ce installed pCOWeb may however no longer be accessible Therefore during installation use the scissors to separate the two labels supplied and apply one in an easily accessible position near the pCO c...

Page 11: ...llation manager The steps to be completed are as follows 1 Configuration of the PC for direct connection to pCOWeb 2 Connection and start up of pCOWeb to check correct installation 3 Activation of the...

Page 12: ...possible 1 Open the Windows Control panel 2 Double click Internet options the window shown in left will be displayed 3 Click Connections Another window right will be displayed Figure 3 c Setting the...

Page 13: ...rebooted if the button is NOT pressed pCOWeb will return to the User configuration see chapter 9 on page 41 NOTE 2 These values are part of the Bootswitch parameters and unlike the user parameters can...

Page 14: ...if pCOWeb is now rebooted for example switching the pCO controller off and on again without pressing the button again as described in 3 1 2 on page 12 pCOWeb will use the user set IP address if this...

Page 15: ...o avoid losing access to other sites as an alternative the proxy can be disabled only for one or a few IP addresses o see point C in paragraph 3 1 1 on page 11 however with the variants shown in examp...

Page 16: ...ensure compatibility for direct communication as an alternative to the procedures described above the PC can be configured so that it responds not only to the IP address already set but also to a sec...

Page 17: ...documentation available at http ksa carel com APPENDIX G on page 68 lists the CAREL tags and describes an example of the default demo page resident on the pCOWeb Other pages are shown in APPENDIX I o...

Page 18: ...ion and paragraph 9 8 on page 49 shows how to read the current information The following examples assume that the current data being used are httpadmin fhttpadmin and the IP address is 10 0 5 0 Figure...

Page 19: ...directory or subdirectory Figure 4 g FileZilla with the Local Site left and Remote Site right windows The path for entering the web pages and the customized directory is usr local root flash http 6 Al...

Page 20: ...server on the local network or the Internet pCOWeb sends the e mail to the server and a PC can then access the server and download the messages that have been sent to it APPENDIX D on page 63 presents...

Page 21: ...arm fired alarm reenter to be included in the e mail and SNMP notifications to identify the activation and return events Example 1 Figure 4 k FTP PUSH and SNMP TRAP programmed to be sent for analog va...

Page 22: ...AR No action Suggests the character that the XML interpreter can use as the separator for the values of the analog variables SEPARATOR_CHAR SEPARATOR_CHAR SYSTEM End of the section with the sequ of ta...

Page 23: ...RE a From the pCOWeb main page see a pagina 42 open the Events page b Figure 4 n c The page is divided into eight tabs four of them d Figure 4 o Figure 4 p and Figure 4 q contain the common settings f...

Page 24: ...on N at least 1 required e mail addresses that pCOWeb will send the messages to Ftp Push FTP Push Configuration recipients for sending XML files Input file name required used to choose the XML templat...

Page 25: ...4 3 4 Setting the notifications set upon variations in the variables IMPORTANT Some settings described below Event Handlers Trap Configuration and E Mail Configuration are also used for the scheduled...

Page 26: ...set in Figure 4 t that the TRAP will be sent to for the events relating to the variable IMPORTANT any Hosts enabled after one that is not enabled will be ignored Example 1 1 2 3 3 4 4 5 Hosts 3 and 4...

Page 27: ...les Events enable enable all the events generated by variations to the variable Trigger an Activation notification event is generated when there are following variations in the value of the variable P...

Page 28: ...his window Timeout repeat time the first event will be generated after the Timeout has elapsed from when the Submit button was selected the following events will be generated when the Timeout has elap...

Page 29: ...LOCK WITH pCO SYNCHRONIZATION For this to occur the application program running on the pCO must transmit the information on five selected integer supervisory variables The page shown in Figure 5 a is...

Page 30: ...to 207 even if the ModBus Extended protocol is running START OR DISPLAY THE RECORDS 1 Open the Clock and Logger page Figure 5 d 2 Click the Logger tab The settings are located in the bottom section of...

Page 31: ...tically calculate the highest and lowest value reached by all the variables of the same group and automatically adjust the scale Manual Limits are defined by the user if one or more values overtake th...

Page 32: ...ction Update files to this very moment see below In the usr local root flash http log directory pCOWeb automatically saves the powerup log csv file containing the records with the date time of the eve...

Page 33: ...ment function Download all csv and graphs a window is opened this may take some time showing the list of directories for the months in which records have been saved to download select the directory an...

Page 34: ...or specific organisations The standard also allows as each number to be replaced by a name In the example the path is rewritten with the standardised name in brackets 1 iso 3 organization 6 dod 1 inte...

Page 35: ...58993460 NOTE 4 A variable is always read write however the value will be retained only if featured in the pCO application program Example 1 3 6 1 4 1 9839 2 1 2 45 0 type 2 pCO variable analog with i...

Page 36: ...ed by the device The default is 9839 which is the identifier assigned to CAREL the full list of assigned identifiers is available on https www iana org assignments enterprise numbers enterprise number...

Page 37: ...by pCOWeb save them on pCOWeb or on the PC for later use when required The BACnet configuration is saved on pCOWeb in a number of files in the usr local root flash etc sysconfig directory in the same...

Page 38: ...log Value Multi state Value and Binary Value objects are named A0001 A2048 I0001 I2048 and D0001 D2048 corresponding to their MODBUS mapping 7 3 BACnet features Alarming BACnet Intrinsic Alarming is s...

Page 39: ...vered from the factory 7 3 3 Schedules BACnet schedules are supported and made visible through the 16 Schedule and 16 Calendar objects For each Calendar object there can be from 0 to 16 dates in the D...

Page 40: ...read write the variables The ranges of variablesare aligned with the standard Modbus addresses The limits of variables are aligned with the standard Modbus limits read coils discrete inputs 2000 writ...

Page 41: ...e different from Figure 3 g 3 If the page appears as shown in Figure 3 g click the Go to Administrator area link An authentication dialogue box similar to the one shown in Figure 9 a will be opened Co...

Page 42: ...Summary page If the login data entered are correct the following page will be displayed as shown in The section in the middle Body is the information page and can be refreshed by clicking Information...

Page 43: ...pCOWeb date and time at the moment of the last update requested for the page displayed from the PC for example with F5 G symbol that the HTML page conforms to the HTML 4 01 standard H BTL Mark it sho...

Page 44: ...HTML page or CGI executable was loaded via FTP this process needed to be run to automatically attribute the transferred file the rights needed to be recognised by the pCOWeb operating system currently...

Page 45: ...emory only when selecting the Submit button IMPORTANT The values set will only be used when pCOWeb is next rebooted Figure 9 j Opening the network configuration page NOTE 2 If pCOWeb is started when t...

Page 46: ...ted If the speed set for pCOWeb is different from the value set for the pCO communication will not be possible 9 5 1 Extended range ad functionalities All the protocols and some of the functionalities...

Page 47: ...using the ENTER key and setting the desired value with UP DOWN keys If the DHCP option is set to ON it is not possible to change IP address and Netmask fields Pressing the ENTER key repeatedly all av...

Page 48: ...the unzip It will return the folder name used for the unzip process mnt data tmp and the status of each file present in the folder Install plugin report This report will provide the install informati...

Page 49: ...ccess these from a web browser for example Mozilla Firefox Username Password authentication will be required pCOWeb requires authentication if and only if the directory that contains the html page als...

Page 50: ...selecting Accessories Prompt and then entering telnet 10 10 7 132 IP address or name of the pCOWeb 2 at the login request type httpadmin and the password see 9 8 2 3 type cd usr local root flash http...

Page 51: ...e Tests page features the following tests IMPORTANT the Gateway normally needs to be set see 9 4 1 on page 45 Specify the name a DNS must be set see 9 4 1 on page 45 or the IP address then select the...

Page 52: ...al 0 1 Analog 3276 8 to 3276 7 Integer 32768 to 32767 Figure 9 w pCO variables test Send all notifications send all the notification messages set regardless of whether the corresponding events occurre...

Page 53: ...ing the value of a parameter wait until the setting has been confirmed to allow time for the confirmation to be sent via the browser to pCOWeb or alternatively select the Reboot button available on th...

Page 54: ...rupted due to a power failure the block A transferred is not valid Upon next reboot the normal functions will no longer work but pCOWeb due to presence of a valid block B will continue to operate to a...

Page 55: ...on page 43 9 11 2 Procedure for updating the firmware via FTP or SCP block A only INFORMATION The firmware only block A can also be updated via FTP or SCP An already updated pCOWeb where the firmware...

Page 56: ...ot both at the same time DEV default parameters PVT LCT bios logger configuration pCOWeb does not support BIOS BOOT Figure 9 ee pCO application zip file selection The pCO must have a bios version 4 10...

Page 57: ...deration any safety timing or specific procedure defined in the software Please go to http ksa carel com and download the step by step guide Updating pCO Application via pCOWeb pdf 10 TECHNICAL SPECIF...

Page 58: ...address Within a network each IP address must be unique The correct setting of this address is fundamental for the exchange of data between the various devices The IP address is made up of four number...

Page 59: ...ism for the transmission of a data packet is illustrated below NOTE A network device can contact another device only if its MAC address is known or the MAC address of the corresponding gateway that it...

Page 60: ...tination IP address of the personal computer subnet mask of the personal computer The communications manager using these three numbers establishes whether the recipient s IP address belongs to the ran...

Page 61: ...the server with the MAC address acquired E destination IP address outside of the subnet send to the gateway In this case the personal computer will send the message to a special network device called...

Page 62: ...mmunication buffer comm buffer var value is different from the value of the variable in the application AN12 if it is different it transfers the value of the variable in the application to the communi...

Page 63: ...er Finger Server started optional service not used by pCOWeb ignore Web Server started the server to access the MAILBOX from an Internet Browser is running IMPORTANT if port 80 is busy the web server...

Page 64: ...ia web pages To do this simply open an Internet browser that can access the computer where ArGoSoft is running and type the name or the IP address of the computer if the same computer is running the b...

Page 65: ...e one running Outlook the two computers must be able to exchange data It is recommended to use the same computer In this case enter 127 0 0 1 internal address of the computer visible to all the intern...

Page 66: ...mple below shows how to set a user on FileZilla Server the procedure is the same for setting other users Figure E b FileZilla Server Interface creating the ftpaccount user 1 Open the user configuratio...

Page 67: ...ully path through SNMP trees It also offers a built in trap receiver that can receive and process SNMP traps When started no configuration is required The user must select the IP address whose SNMP tr...

Page 68: ...r 0 VariableType VariableIndex MinValue MaxValue where 0 zero required reserved for future extensions VariableType 1 Digital 2 Analog 3 Integer VariableIndex 1 to 207 for Carel protocol 5000 for ModBu...

Page 69: ...value will not be indicated Figure G b The var TAG used for writing After having entered a new value selecting the Submit button sends pCOWeb the value entered for the variable and a new request for...

Page 70: ...see APPENDIX C on page 62 Example Figure G d on page 70 Displaying the result of the write operation DOCTYPE html PUBLIC W3C DTD HTML 4 01 Transitional EN html tagparser pcotagfilt head meta content t...

Page 71: ...rser pcotagfilt head meta content text html charset ISO 8859 15 http equiv content type title pCOWeb Demo Page title head body bgcolor ffffff h1 style text align center pCOWeb Demo Page h1 br BAUD RAT...

Page 72: ...xample html select name script setdb commcfg speed option value 9600 checkdbsel commcfg speed 9600 9600 option option value 19200 checkdbsel commcfg speed 19200 19200 option option value 38400 checkdb...

Page 73: ...g that is until the web page is returned other web pages are requested pCOWeb will need to be rebooted To use this type the following command directly into the address field in the web browser http 17...

Page 74: ...ibutes the title to the html page window opened by the browser meta content text html charset ISO 8859 15 http equiv content type link rel stylesheet href style css type text css title pCOWeb Demo Pag...

Page 75: ...t name script var 0 3 1 32768 32767 value var 0 3 1 td tr tr td Var 10 td td input type text name script var 0 3 10 32768 32767 value var 0 3 10 td tr table td tr table center br line break The follow...

Page 76: ...index equal to their supervisry index e g analog 101 is copied into the array called analogs to the index 101 The string is composed by TYPE START_INDEX END_INDEX TYPE2 START_INDEX2 It can contain up...

Page 77: ...the parser of the xml to the new format keeping the string as for version A135 will use the old xml format Copy and pasting the same URL to the browser it will return the following XML values contain...

Page 78: ...tion or to overtake the limitations of the embedded web server of the pCOWeb for example php or asp or net could be used to generate dynamic web pages 2 Any web developer is able to develop the page w...

Page 79: ...the HTML pages used to create the configuration files required for the correct use of the Plugin and they must be installed in the usr local root flash http plugins directory NOTE The presence of html...

Page 80: ...the Plugin bin_users directory of the Plugin being installed They represent the executable files binary files or bash scripts that manage the functions of the Plugin During installation the executabl...

Page 81: ...t Starting Ntp script in the system log 8 This line runs the ntp sh script see the previous section note that the standard output is redirected to dev null to avoid unnecessary messages 9 showStatus d...

Page 82: ...uninstallation of the Plugin IMPORTANT the contents of pluginname must not contain spaces In the case of the NTP Plugin the file contains the string Network_Time_Protocol and the following link is di...

Page 83: ...ressing Modicon Compatible Analog 1 1 2 2 2 3 207 207 208 5000 5000 5001 Integer 1 5001 5002 2 5002 5003 207 5207 5208 5000 10000 10001 Digital 1 1 2 2 2 3 207 207 208 2048 2048 2049 As a consequence...

Page 84: ...gital 2 and 3 are set to 0 Selecting the LOGICAL ADDRESSING 1 Data register 0 Number of points 3 Data read is 1 1 0 this because in versions 1 4 x there was a bug It is possible to read digital variab...

Page 85: ...OMPATIBLE addressing 3 Data register 1 Number of points 3 Again you see 1 1 0 For a correct visualization you should use 4 Data register 2 Number of points 3 as using Modscan selection Version 1 5 x 1...

Page 86: ...correct index the correct information is obtained A LOGICAL ADDRESSING data register 1 Number of points 3 Again with MODICON COMPATIBLE settings trying the previous set Data register 1 Number of poin...

Page 87: ...y 54 Firewall 21 flag 79 FTP 9 15 19 20 21 22 23 24 25 26 27 30 31 39 51 53 54 55 57 61 63 64 70 73 83 93 99 104 gateway 8 17 27 57 76 77 78 Gateway 12 27 57 64 76 GATEWAY 55 76 Glibc 104 GNU 60 63 68...

Page 88: ......

Page 89: ......

Page 90: ...CAREL Industries S r l Via dell Industria 11 35020 Brugine Padova Italy Tel 39 049 9716611 Fax 39 049 9716600 http www carel com e mail carel carel com pCOWeb 030220966 rel 1 1 12 12 2017...

Reviews: