BSCW Administrator Documentation Release 7.4.1 OrbiTeam Software Mar 11, 2021 CONTENTS 1 How to read this Manual1 2 Installation of the BSCW server3 2.1 General Requirements........................................3 2.2 Security considerations........................................4 2.3 EU - General Data Protection Regulation..............................4 2.4 Upgrading to BSCW 7.4.1......................................5 2.4.1 Upgrading on Unix..................................... 13 2.4.2 Upgrading on Windows................................... 17 3 Installation procedure for Unix 19 3.1 System requirements......................................... 19 3.2 Installation.............................................. 20 3.3 Software for BSCW Preview..................................... 26 3.4 Configuration............................................. 30 3.4.1 Apache HTTP Server Configuration............................ 30 3.4.2 BSCW instance configuration............................... 35 3.4.3 Administrator account................................... 36 3.4.4 De-Installation....................................... 37 3.5 Database Server Startup, Garbage Collection and Backup..................... 37 3.5.1 BSCW Startup....................................... 38 3.5.2 Garbage Collection..................................... 38 3.5.3 Backup........................................... 38 3.6 Folder Mail Delivery......................................... 39 3.6.1 BSCW mail delivery agent (MDA)............................. 39 3.6.2 Local Mail Transfer Agent (MTA)............................. 40 4 Installation procedure for Windows 45 4.1 System requirements......................................... 45 4.2 Installation and Configuration.................................... 46 4.3 Software for BSCW Preview..................................... 56 4.4 Database Server and Garbage Collection.............................. 60 4.4.1 Windows Service...................................... 60 4.4.2 Task Scheduler....................................... 61 4.5 Further Configuration Details.................................... 62 4.5.1 BSCW Server Root Definition............................... 63 4.5.2 Apache HTTP Server Configuration............................ 63 4.5.3 IIS Configuration...................................... 67 4.5.4 De-Installation....................................... 70 4.6 Folder Mail Delivery......................................... 70 5 Configuration of BSCW Servers 71 5.1 Authentication............................................ 72 5.2 conf/config.py............................................ 73 5.2.1 MANDATORY server settings............................... 73 i 5.2.2 Mail handling........................................ 77 5.2.3 Server access........................................ 79 5.2.4 web/proxy server settings.................................. 85 5.2.5 BSCW appearance settings................................. 93 5.2.6 Optional BSCW packages................................. 100 5.2.7 BSCW database server settings............................... 104 5.3 conf/config_actions.py........................................ 110 5.4 conf/config_applet.py........................................ 110 5.5 conf/config_cal.py.......................................... 111 5.6 conf/config_clientmap.py...................................... 111 5.7 conf/config_controls.py....................................... 111 5.8 conf/config_convert.py........................................ 111 5.9 conf/config_countries.py....................................... 114 5.10 conf/config_grid.py......................................... 114 5.11 conf/config_guided_tours.py..................................... 114 5.12 conf/config_help.py......................................... 114 5.13 conf/config_html_ui.py....................................... 114 5.14 conf/config_icon.py......................................... 114 5.15 conf/config_icons.py......................................... 114 5.16 conf/config_meet.py......................................... 115 5.17 conf/config_menus.py........................................ 115 5.18 conf/config_metadata.py....................................... 115 5.19 conf/config_mimegroups.py..................................... 115 5.20 conf/config_mime_icons.py..................................... 115 5.21 conf/config_mimemsg.py...................................... 115 5.22 conf/config_mime.py......................................... 115 5.23 conf/config_mobile_ui.py...................................... 116 5.24 conf/config_mpick.py........................................ 116 5.25 conf/config_portlets.py........................................ 116 5.26 conf/config_prio_categ.py...................................... 116 5.27 conf/config_quicksearch.py..................................... 116 5.28 conf/config_search.py........................................ 116 5.29 conf/config_service.py........................................ 116 5.30 conf/config_styles.py......................................... 117 5.31 msg/<lang>/lg_msgconfig.py.................................... 117 6 BSCW Packages 119 6.1 Content Search PyLucIndex..................................... 120 6.1.1 Configuration........................................ 120 6.1.2 Command line tools..................................... 123 6.1.3 Index creation and update.................................. 125 6.2 LDAP................................................. 126 6.2.1 Installation......................................... 126 6.2.2 LDAP Browser....................................... 129 6.3 Desktop Widgets........................................... 130 6.4 Document Approval......................................... 130 6.5 Blog (Weblogs)............................................ 130 6.6 Case – File Synchronisation..................................... 130 6.7 Chat.................................................. 131 6.8 Expire................................................ 131 6.9 Export PDF.............................................. 132 6.10 Flow-Folder............................................. 132 6.11 Http.................................................. 133 6.11.1 Enabling the BSCW HTTP server............................. 133 6.11.2 Disabling the BSCW HTTP server............................. 134 6.12 Incognito............................................... 135 6.13 Metaprofiles............................................. 135 6.14 Online Office............................................. 135 ii 6.14.1 Collabora Online configuration............................... 135 6.14.2 BSCW office package configuration............................ 137 6.15 Poll.................................................. 138 6.16 SSO – Single Sign On........................................ 139 6.16.1 CAS Authentication..................................... 139 6.16.2 OpenID........................................... 140 6.16.3 Shibboleth Authentication................................. 141 6.17 Sync - MS Outlook Synchronization................................. 143 6.18 Tasks................................................. 143 6.19 WebFolder.............................................. 143 7 Administration of BSCW Servers 145 7.1 Administration using the Web Interface............................... 145 7.1.1 BSCW status page..................................... 147 7.1.2 BSCW Access Management................................ 148 7.1.3 Configuration........................................ 151 7.1.4 BSCW licence management................................ 152 7.2 Administration using the bsadmin script............................... 154 7.3 User administration......................................... 156 7.3.1 User status with bsadmin users............................... 157 7.3.2 User registration with bsadmin register........................... 158 7.3.3 User management with bsadmin (rename | chpwd | rmuser)................ 159 7.3.4 Additional anonymous users................................ 160 7.4 Asynchronous Services....................................... 161 7.4.1 User Notification Services (UNO)............................. 161 7.4.2 User account expiry..................................... 162 7.4.3 Automatic disk usage update................................ 163 7.5 Public space deactivation....................................... 163 7.6 WebDAV............................................... 165 7.6.1 Microsoft Support for WebDAV.............................. 165 7.6.2 Known Problems...................................... 166 7.7 Quota - Disk Usage Limitation.................................... 166 7.7.1 Limit Classes........................................ 167 7.7.2 Quota Activation...................................... 168 7.7.3 Calculation of current disk usage.............................. 169 7.7.4 Report disk usage...................................... 169 7.8 Definition of Roles.......................................... 170 7.8.1 The BSCW role concept.................................. 170 7.8.2 Role definition and default roles.............................. 172 7.8.3 Site-specific Roles..................................... 175 7.9 Site-specific banner......................................... 176 7.10 Server-wide template folders..................................... 177 7.11 Web Service API........................................... 178 7.12 Some useful hints.......................................... 178 8 BSCW Help 181 8.1 Languages.............................................. 181 8.1.1 Existing translations...................................