Instruction Z-Ware 7.14.x Web Server Installation Guide Document No.: INS14486 Version: 8 Description: Z-Ware Web Server Installation, Configuration, Administration & Building Guide Written By: MIKOZIK;KAJAROSZ;ADGIELNI;JFR Date: 2020-07-07 Reviewed By: JCC;SCBROWNI;TRBOYD;PINOWOBI;ABUENDIA Restrictions: Public Approved by: Date CET Initials Name Justification 2020-07-07 03:08:18 NTJ Niels Johansen This document is the property of Silicon Labs. The data contained herein, in whole or in part, may not be duplicated, used or disclosed outside the recipient for any purpose. This restriction does not limit the recipient's right to use information contained in the data if it is obtained from another source without restriction. INS14486-8 Z-Ware 7.14.x Web Server Installation Guide 2020-07-07 REVISION RECORD Doc. Ver. Date By Pages Brief description of changes affected 1 20181126 AYY 2.5, 2.7, 7.1 Removed reference of BBB in Z-Ware build and configuration commands. 2 20190306 AYY 1.1, 2.1, 6.3, V7.11.0: changed Rpi reference to 3B+ with respective URL and images. 7.1, Removed Ubuntu 14.04 support and updated dependency list for Ubuntu 16.04. References Added firmware backup section. 3 20190532 SNA V7.11.1: No change 4 20191128 SNA V7.13.0; No change 5 20200110 SNA V7.13.1 - no changes 6 20200326 AYY 3.4.1, 3.4.2, Change @sigmadesigns.com email example to @silabs.com example 3.4.3 4, 4.1 Remove reference to Openldap 7 20200610 JFR Front page Typo 8 20200629 SCBROWNI All Tech Pubs Review 8 20200703 MIKOZIK All Change title to 7.14.x silabs.com | Building a more connected world. Page ii of iv INS14486-8 Z-Ware 7.14.x Web Server Installation Guide 2020-07-07 Table of Contents 1 INTRODUCTION................................................................................................................5 1.1 Purpose ................................................................................................................................5 1.2 Audience and Prerequisites..................................................................................................5 2 INSTALLATION..................................................................................................................6 2.1 Deployment Systems............................................................................................................6 2.2 Runtime Package Dependencies ..........................................................................................6 2.3 User Privilege........................................................................................................................6 2.4 Selection of Deployment Directory ......................................................................................6 2.5 Installation (Deployment) Procedure...................................................................................6 2.6 Install Time Only Configurations ..........................................................................................7 2.6.1 Upstart Settings ..........................................................................................................7 2.6.2 Autostart Setting.........................................................................................................7 2.7 Software License ..................................................................................................................8 3 SYSTEM CONFIGURATION ................................................................................................9 3.1 Configuration Description ....................................................................................................9 3.1.1 System Settings...........................................................................................................9 3.1.2 Z-Ware Portal Daemon Settings................................................................................10 3.1.3 Z-Ware Web Settings ................................................................................................12 3.1.4 HTTP Server Settings.................................................................................................12 3.1.5 Operating System Common CA Certificate Configuration ........................................12 3.1.6 SSL Settings ...............................................................................................................13 3.2 Secure HTTP .......................................................................................................................13 3.3 Certificate and Key Generation ..........................................................................................14 3.4 Scenes Configuration..........................................................................................................15 3.4.1 Group: SECURITY SCENE NOTIFICATION EMAIL........................................................15 3.4.2 Group: SECURITY SCENE NOTIFICATION SMS ...........................................................15 3.4.3 Group: SMTP.............................................................................................................16 3.5 Device-Specific Configuration and Information Database .................................................17 4 SERVICE MANAGEMENT .................................................................................................18 4.1 Managing Services Directly Using Upstart..........................................................................18 4.2 Auto Start Z-Ware Service after System Boot ....................................................................19 5 LOG FILES .......................................................................................................................20 5.1 Z-Ware Portal Daemon.......................................................................................................20 5.2 Z-Ware Web (CGI) ..............................................................................................................20 5.3 Apache HTTP Server ...........................................................................................................20 6 USER INTERFACE (WEB) ..................................................................................................21 6.1 Security...............................................................................................................................21 silabs.com | Building a more connected world. Page iii of iv INS14486-8 Z-Ware 7.14.x Web Server Installation Guide 2020-07-07 6.1.1 HTTPS Server Certificate ...........................................................................................21 6.2 Firmware Update ...............................................................................................................22 6.3 Firmware Backup................................................................................................................22 7 BUILDING .......................................................................................................................23 7.1 Platforms ............................................................................................................................23 7.2 Dependencies.....................................................................................................................23 7.3 Toolchain for RPi3B+ ..........................................................................................................23 7.4 User Privilege......................................................................................................................23 7.5 Location..............................................................................................................................24 7.6 Procedure...........................................................................................................................24 REFERENCES .........................................................................................................................25 Table of Figures No table of figures entries found. Table of Tables Table 2-1: Upstart Settings ............................................................................................................7 Table 3-1: System Settings.............................................................................................................9 Table 3-2: Z-Ware Portal Daemon Settings .................................................................................10 Table 3-3: Z-Ware Web Settings..................................................................................................12 Table 3-4: HTTP Server Settings...................................................................................................12 Table 3-5: Operating System Common CA Certificate Settings ...................................................12 Table 3-6: SSL Settings.................................................................................................................13 Table 3-7: SSL File Locations ........................................................................................................13 Table 3-8: Security Scene Notification Email Settings .................................................................15 Table 3-9: Security Scene Notification SMS Settings ...................................................................15 Table 3-10: Scene SMTP Settings.................................................................................................16 silabs.com | Building a more connected world. Page iv of iv INS14486-8 Z-Ware 7.14.x Web Server