### System Settings The System Settings page contains information that you must enter before the WebCTRL® application can run properly. On the System Configuration tree, select System Settings. Click each tab, then enter the necessary information. Tab details are described below.
Click for details below General tab Security tab Communications tab Scheduled Tasks tab Daylight Saving tab Add-ons tab
#### General tab The General tab presents the following system information: System Directory Name Path to the Webroot Directory Database Type System Language - The language to be used for: The default language for new operators Alarms logged to the database State text and object names downloaded to the field The login page NOTE Language also refers to formatting conventions. For example, English uses the date format mm/dd/yy, but English (International) uses the date format (dd/mm/yy). You can edit or use the following fields and buttons.
Field | Notes
--- | ---
System Information |
System Statistics button | Click to see the following system information: Number of controllers Number of controllers that can run control programs Number of points, regardless of vendor Number of trend sources in database Number of trend samples in database
Levels displayed in paths | The number of levels displayed in WebCTRL® paths. For example, if Node Name Display Depth is set at: 2, a typical path might be ..\AHU-1\RA Temp 3, a typical path might be ..\Atlanta R&D\First Floor\AHU-1 NOTE Changing this field does not take effect until you restart the WebCTRL Server application.
Logs |
Select a week of logs to review | For troubleshooting, you can download a zip file that contains logs of system activity.
Time |
Time Sync | Click to immediately synchronize the time on all IP network controllers in the system database to the WebCTRL® server's time. Time synchronization occurs daily if the Enable time synchronization of controllers daily at____ field on the Scheduled Tasks tab is enabled. (Click this link for more information on time synchronization.)
Time Format | Select one of the following for the system's time: 12-hour clock (Example: 4:34 pm) 24-hour clock (Example: 16:34)
Date Format | Select the format you want the system to use.
Alarms |
Use a single alarm template for CMnet alarms | If your system is an upgraded legacy system: Check to have alarms for CMnet equipment use only the alert_auto alarm template. Uncheck to allow multiple alarm templates.
Enable support for Alarm Notification Clients to connect to this server | Check to use the Alarm Notification Client application. See Alarm Popup alarm action.
Restrict to IP Address | If the server has more than one network interface adapter, type the IP address of the server's network connection that the Alarm Notification Client application will connect to.
Port | Change this field if the Alarm Notification Client application will use a port other than 47806 on the server.
Current client connections | Shows any workstation whose Alarm Notification Client is actively connected to this server.
Schedules |
Disable Schedules | If your system has no need to run schedules, check this box so that the Schedules feature is no longer visible in WebCTRL® interface.
Trends |
Keep historical trends for ___ days | Stores trend data in the WebCTRL® database for the time you specify. This is a default setting that you can change when you set up trends for an individual point. Specify the time of day that the trends are deleted on the Scheduled Tasks tab.
Display gap in graph line for missing data | Check to show a gap if trend data is missing.
Enable Server Trending of Color | Leave this checked unless directed otherwise by Technical Support.
Poll Interval | The frequency that the server polls routers for color trend data. Increase this field only if Last Poll Duration exceeds the Poll Interval.
Source Files |
All Source Files | Use to export source files to a .zip file that can be imported into another WebCTRL® or Field Assistant system. Source files include: Control programs (.equipment files only) Drivers Graphics (.view files only) Touchscreen files BACview® files Report design files for Equipment Values or Trend Sample reports NOTE If import detects a difference between a database file and an import file with the same name, import does not overwrite the database file. A message lists any file differences so that you can resolve them. See Commissioning equipment using Field Assistant.
Email Server Configuration | The information in this section is used by the Send email alarm action and used to email a Scheduled Report.
From | Enter a valid address if required by your mailserver.
Mail Host | The mailserver's address. This can be an IP address or a system name, such as mail.mycompany.com.
Mail Host Port | Change this field if using a port other than the default port 25.
Mail Host Security Options | Select the type of security the mailserver uses. Cleartext (SMTP) – Uses the SMTP protocol to send as clear text over TCP/IP Secure SSL (SMTP with SSL) – Uses SSL, a communication protocol that provides data encryption Secure TLS (STARTTLS) – Uses TLS, but does not begin encryption until the WebCTRL® application issues STARTTLS command
Specify Mail User for Mail Host Authentication | Select if your mailserver requires a username and password.
Test connection | Click to have the WebCTRL® application try to connect to the email server. A message will appear below this button stating if the connection was successful or if it failed.
#### Security tab
Field | Notes
--- | ---
Logging |
Log audit data to file | Records operator activities and some system activities (such as opening and closing the database or automatic deletions) in a text file. The default file is auditlog.txt stored in WebCTRL\webroot\<system_name>. You can change the file name and include a different path. To prevent the file from growing too large as new data is appended, you can archive the data to another text file by selecting an archive frequency in the Archive log file contents field. The archive file is auditlog_yyyy_mm_dd.txt, where yyyy_mm_dd is the creation date of the archive file. This file is created in the same location as auditlog.txt. NOTE If you do not archive the log file contents, you should manually delete the oldest entries.
Log audit data to database | Records audit data in a database named audit.mdb that can be accessed by third-party software. NOTE For Access, MSDE, and Derby, the database is automatically created. An Access database is named audit.mdb; a MSDE database is named audit.mdf. The Derby database consists of multiple files in a folder called audit. For MySQL, SQL Server, PostgreSQL, or Oracle, you must create the database manually.
Delete database entries older than ____ days | Automatically deletes entries in the database that are older than the number of days you specify.
Log errors for invalid URLs | Check this field to write to the core.txt log any time an external source sends a request to the WebCTRL Server application. NOTE Regular maintenance scans by external software can cause the log files to grow large.
Security Policy |
Change Policy | See Location-dependent operator access for information on Change Policy.
Remote Access |
Allow remote file management | Lets you access the system using WebDAV.
Operators |
Return operators to previous locations when server reconnects | Returns operators to current tree locations when the server reconnects.
Log off operators after _:_ (HH:MM) of inactivity | The system automatically logs off an operator who has had no activity in the system for the time period specified. This is a default setting for the system. The System Administrator can change this setting for an individual operator on the Operators page.
Lock out operators for __ minutes after __ failed login attempts | Clear Lockouts removes lockouts for all users. NOTE Restarting the WebCTRL Server application will remove lockouts.
Use advanced password policy | You can place specific requirements on passwords to increase security. See Advanced password policy.
Do not synchronize operator and privileges | If using hierarchical servers, the WebCTRL® application automatically synchronizes the operator/privilege settings on the child servers with those on the parent server. You have the following options: Check this field on all servers to stop the synchronization process. Check this field on a child server to remove it from the synchronization process so that you can manage that server's settings locally.
Synchronize Now | Click this button on the parent server for immediate synchronization of operator/privilege settings.
Permissions |
Permissions | When control programs, views, and touchscreen and BACview® files are created by an original equipment manufacturer (OEM), they cannot be used in a WebCTRL® system without the creator's permission. However, the creator can produce a key for a system with a different license that will grant permission to the key's recipient. If you receive a key, put it in the WebCTRL X.X\resources\keys folder. The table in the Permissions section of the Security page shows all keys in the that folder. To activate a key, click Add, then browse to the key. To delete a key from your system, select the key in the table, then click Delete. Red text in the table indicates the key has a problem such as it does not apply or has expired. See the Notes column for an explanation.
#### Communications tab The fields on this tab let you define controller communication with the WebCTRL Server application and BACnet network communication.
Field | Notes
WebCTRL Server BACnet Controller Instance and BACnet Alarm Recipient Instance | The BACnet identifier for the system's server and the alarm recipient. You enter these system properties in SiteBuilder.
Always upload properties from controller s to WebCTRL database on mismatch | Automatic uploads are listed in the Audit Log. If you do not check this field, properties must be manually uploaded or downloaded by the operator when a mismatch occurs. NOTE If an automatic upload fails and the operator chooses to do nothing at that time, the upload will be attempted again when he returns to the page where he encountered the mismatch.
Ignore incoming alarms from sources not in this database | The WebCTRL® application will ignore alarms from third-party devices not in the database or devices from other WebCTRL® systems on the same network.
BACnet Settings | Native WebCTRL® system only
Log BACnet Binding Conflicts | The WebCTRL® application uses BACnet (dynamic) binding for communication between devices unless your system uses NAT routing. If using NAT, the WebCTRL® application uses information in its database to bind to BACnet devices. When checked, the WebCTRL® application logs binding conflicts that result from duplicate network numbers or device IDs.
#### Scheduled Tasks tab
Field | Notes
--- | ---
Automatically delete alarm incident groups which have been closed for more than ___ days | An incident group is all alarms related to a particular incident, such as Off Normal, Fault, and Return to Normal. NOTE Alarms in an incident group are not deleted until all alarms in the group have been closed.
Archive alarm information upon alarm deletion | Writes alarm information to a text file.
Archive file | The default file is eventdel.txt stored in WebCTRL\webroot\<system_name>. You can change the file name and include a different path.
Archive file format | The alarm information to be written to the archive file. To add information, select field codes in Append Field Code. To delete field codes, highlight them in the Archive file format box and press Delete.
Automatically delete expired schedules daily at ___ | To ensure there are no time zone conflicts, the WebCTRL® application waits 2 days after a schedule expires to delete it.
Remove expired historical trends daily at ____ | Deletes trend data that has been in the database longer than the time specified in the Keep historical trends for ___ days field on the General tab.
Enable time synchronization of controllers daily at____ | Automatically synchronizes the time on all equipment to the time on the server, adjusting for different time zones and Daylight Saving Time. We recommend that you check this field. The WebCTRL® application will send a daily time sync message to each IP network device that is in the system database. IP devices not in the database will not be synchronized. For all ARC156 or MS/TP networks in the database, the WebCTRL® application will send a broadcast time sync message. All devices on these networks will be synchronized, regardless of whether or not the devices are in the database. CAUTIONS Make sure that your server’s time and time zone setting are correct. Make sure that each site’s time zone setting in SiteBuilder is correct. To prevent time sync problems when the transition to and from Daylight Saving Time occurs, set the time sync to occur at least 1 hour after the last controller in the system is adjusted for DST. For example, your server and part of your system is in the Eastern Standard Time zone, but you also have controllers in the Pacific Time zone. Your server is adjusted for DST at 2:00 a.m. Eastern Standard Time, but the controllers in the Pacific Time zone are not adjusted until 3 hours later. So you would set the time sync to occur daily at 6:00 a.m. or later. NOTES You can disable this function for an individual site on the site’s Properties page. See To set up site properties. You can perform system-wide time synchronizations using the Time Sync button on the General tab. Or, you can synchronize individual devices using the Time Sync button on the devices' Properties page. Between time sync broadcasts, Automated Logic® routers include time sync information in each color request to the devices below the router. This ensures devices without a battery-backed clock will get the time shortly after powering up.
#### Daylight Saving tab On this tab, you can adjust the Daylight Saving Time settings for WebCTRL Server. Click Update to automatically set the table's Begin and End dates for the next 10 years based on the system's timezone. This marks all controllers with ExecB drivers for a Parameters download. If the updated dates are incorrect If you clicked Update but the dates are incorrect, your system's Java timezone data may be out-of-date. Do the following: Go to the Oracle Java SE Download site. Download the JDK DST Timezone Update Tool (tzupdater-< version >.zip). In the WebCTRL® interface, go to System Settings > Daylight Saving, then click Import. Browse to the tzupdater.zip file, select it, then click Open. Click Continue. Restart the WebCTRL Server application. On the System Settings > Daylight Saving tab, click Update. NOTE If you have sites in different time zones that use Daylight Saving Time, you can click View DST Dates on the site's Properties page to see DST information and time change dates.
3. #### Add-ons tab A WebCTRL® system supports add-ons, such as EnergyReports, that retrieve and use the WebCTRL® data. By default, the WebCTRL® application allows only signed add-ons that are supported by Automated Logic®. If needed, you can override this setting in SiteBuilder by going to Configure > Preferences > Web Server, and checking Allow unsigned add-ons. To install an add-on Save the add-on's file (.addon or .war) to your computer. On the System Settings > Add-ons tab, click Browse, and then open the file. Click Install. After a few seconds, the add-on will appear in the Installed table, and will be enabled. The table below gives a description of each column.
   Column | Notes
   --- | ---
   Name | The add-on's name.
   Path | To open the add-on in a web browser, append this path to your WebCTRL® system's address. For example, to open EnergyReports, type: `http://<system_name>/EnergyReports,` or `http://<system_IP_address>/EnergyReports`
   Version | The version is shown if the author provided the information in the add-on.
   Status | If this column shows: • Running, you can open the add-on in a web browser. • Disabled, click Enable to run the add-on. • Startup error, select the table row to see an explanation of the error under Details.
4. Select an add-on in the Installed table to disable or enable it, or to see the following Details.
   Add-on main page | Click the main page link to open the add-on, if the author provided a main page.
   Description | A description of the add-on, if the author provided one
   Vendor Name | The add-on's author
   Public Data Directory | This public directory contains data generated by the add-on. This data is visible in a web browser.
   Private Data Directory | This private directory contains information such as configuration data.
To back up the add-on's private and public data directories NOTE This procedure will not back up data stored in an external database. For example, EnergyReports uses an external database. Select the add-on in the table. Click Save Data. Click OK. Click Save. Select the location where you want to save the data, then click Save. To update an add-on NOTE Add-ons for WebCTRL® v6.0 or later systems have a different folder structure than previous versions. Select the add-on in the table. Click Remove Add-on and Keep Data Follow the procedure above to install the new version of the add-on. To uninstall an add-on Select the add-on in the table. Click Remove Add-on and Data.