BSCW Administrator Documentation Release 7.2.1
Total Page:16
File Type:pdf, Size:1020Kb
BSCW Administrator Documentation Release 7.2.1 OrbiTeam Software Oct 10, 2019 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.2.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..................................... 25 3.4 Configuration............................................. 29 3.4.1 Apache HTTP Server Configuration............................ 29 3.4.2 BSCW instance configuration............................... 33 3.4.3 Administrator account................................... 35 3.4.4 De-Installation....................................... 35 3.5 Database Server Startup, Garbage Collection and Backup..................... 36 3.5.1 BSCW Startup....................................... 36 3.5.2 Garbage Collection..................................... 37 3.5.3 Backup........................................... 37 3.6 Folder Mail Delivery......................................... 38 3.6.1 BSCW mail delivery agent (MDA)............................. 38 3.6.2 Local Mail Transfer Agent (MTA)............................. 39 4 Installation procedure for Windows 43 4.1 System requirements......................................... 43 4.2 Installation and Configuration.................................... 44 4.3 Software for BSCW Preview..................................... 53 4.4 Database Server and Garbage Collection.............................. 57 4.4.1 Windows Service...................................... 58 4.4.2 Task Scheduler....................................... 58 4.5 Further Configuration Details.................................... 59 4.5.1 BSCW Server Root Definition............................... 60 4.5.2 Apache HTTP Server Configuration............................ 60 4.5.3 IIS Configuration...................................... 64 4.5.4 De-Installation....................................... 67 4.6 Folder Mail Delivery......................................... 67 5 Configuration of BSCW Servers 69 5.1 Authentication............................................ 70 5.2 conf/config.py............................................ 71 5.2.1 MANDATORY server settings............................... 71 i 5.2.2 Mail handling........................................ 74 5.2.3 Server access........................................ 76 5.2.4 web/proxy server settings.................................. 82 5.2.5 BSCW appearance settings................................. 91 5.2.6 Optional BSCW packages................................. 98 5.2.7 BSCW database server settings............................... 102 5.3 conf/config_actions.py........................................ 108 5.4 conf/config_applet.py........................................ 108 5.5 conf/config_cal.py.......................................... 109 5.6 conf/config_clientmap.py...................................... 109 5.7 conf/config_controls.py....................................... 109 5.8 conf/config_convert.py........................................ 109 5.9 conf/config_countries.py....................................... 112 5.10 conf/config_grid.py......................................... 112 5.11 conf/config_guided_tours.py..................................... 112 5.12 conf/config_help.py......................................... 112 5.13 conf/config_html_ui.py....................................... 112 5.14 conf/config_icon.py......................................... 112 5.15 conf/config_icons.py......................................... 112 5.16 conf/config_meet.py......................................... 113 5.17 conf/config_menus.py........................................ 113 5.18 conf/config_metadata.py....................................... 113 5.19 conf/config_mimegroups.py..................................... 113 5.20 conf/config_mime_icons.py..................................... 113 5.21 conf/config_mimemsg.py...................................... 113 5.22 conf/config_mime.py......................................... 113 5.23 conf/config_mobile_ui.py...................................... 114 5.24 conf/config_mpick.py........................................ 114 5.25 conf/config_portlets.py........................................ 114 5.26 conf/config_prio_categ.py...................................... 114 5.27 conf/config_quicksearch.py..................................... 114 5.28 conf/config_search.py........................................ 114 5.29 conf/config_service.py........................................ 114 5.30 conf/config_styles.py......................................... 115 5.31 msg/<lang>/lg_msgconfig.py.................................... 115 6 BSCW Packages 117 6.1 Content Search PyLucIndex..................................... 118 6.1.1 Configuration........................................ 118 6.1.2 Command line tools..................................... 121 6.1.3 Index creation and update.................................. 123 6.2 LDAP................................................. 124 6.2.1 Installation......................................... 124 6.2.2 LDAP Browser....................................... 127 6.3 Desktop Widgets........................................... 127 6.4 Document Approval......................................... 128 6.5 Blog (Weblogs)............................................ 128 6.6 Case – File Synchronisation..................................... 128 6.7 Chat.................................................. 129 6.8 Expire................................................ 129 6.9 Export PDF.............................................. 130 6.10 Flow-Folder............................................. 130 6.11 Http.................................................. 130 6.11.1 Enabling the BSCW HTTP server............................. 131 6.11.2 Disabling the BSCW HTTP server............................. 132 6.12 Incognito............................................... 132 6.13 Metaprofiles............................................. 133 6.14 Online Office............................................. 133 ii 6.14.1 Collabora Online configuration............................... 133 6.14.2 BSCW office package configuration............................ 134 6.15 Poll.................................................. 135 6.16 SSO – Single Sign On........................................ 136 6.16.1 CAS Authentication..................................... 136 6.16.2 OpenID........................................... 137 6.16.3 Shibboleth Authentication................................. 138 6.17 Sync - MS Outlook Synchronization................................. 140 6.18 Tasks................................................. 140 6.19 WebFolder.............................................. 140 7 Administration of BSCW Servers 143 7.1 Administration using the Web Interface............................... 143 7.1.1 BSCW status page..................................... 145 7.1.2 BSCW Access Management................................ 146 7.1.3 Configuration........................................ 149 7.1.4 BSCW licence management................................ 150 7.2 Administration using the bsadmin script............................... 152 7.3 User administration......................................... 154 7.3.1 User status with bsadmin users............................... 155 7.3.2 User registration with bsadmin register........................... 156 7.3.3 User management with bsadmin (rename | chpwd | rmuser)................ 157 7.3.4 Additional anonymous users................................ 158 7.4 Asynchronous Services....................................... 159 7.4.1 User Notification Services (UNO)............................. 159 7.4.2 User account expiry..................................... 160 7.4.3 Automatic disk usage update................................ 161 7.5 Public space deactivation....................................... 161 7.6 WebDAV............................................... 163 7.6.1 Microsoft Support for WebDAV.............................. 163 7.6.2 Known Problems...................................... 164 7.7 Quota - Disk Usage Limitation.................................... 164 7.7.1 Limit Classes........................................ 165 7.7.2 Quota Activation...................................... 166 7.7.3 Calculation of current disk usage.............................. 167 7.7.4 Report disk usage...................................... 167 7.8 Definition of Roles.......................................... 168 7.8.1 The BSCW role concept.................................. 168 7.8.2 Role definition and default roles.............................. 170 7.8.3 Site-specific Roles..................................... 173 7.9 Site-specific banner......................................... 174 7.10 Server-wide template folders..................................... 175 7.11 Web Service API........................................... 176 7.12 Some useful hints.......................................... 176 8 BSCW Help 179 8.1 Languages.............................................. 179 8.1.1 Existing translations...................................