È possibile abilitare l'anteprima dei file di Kopano WebApp senza installare un pacchetto "FileViewer" separato nella configurazione documentata, ma MDM è un plugin separato che deve essere installato e connesso a Z-Push. Questa distinzione è importante: il manuale di amministrazione di WebApp documenta l'anteprima tramite ENABLE_FILE_PREVIEWER, mentre il manuale di MDM documenta un pacchetto dedicato, un file di configurazione e le dipendenze. L'installazione del componente aggiuntivo "File" errato non abiliterà l'anteprima.
Questa guida è destinata agli amministratori di un'implementazione esistente di Kopano WebApp. I manuali pubblicati da Kopano per WebApp e MDM sono documentazione relativa a edizioni precedenti, pertanto, prima di apportare modifiche all'ambiente di produzione, è necessario verificare che i nomi dei pacchetti e le impostazioni corrispondano esattamente alle versioni di WebApp, PHP, Z-Push e del sistema operativo in uso. I passaggi seguenti illustrano il percorso documentato e come verificarlo in modo sicuro.
Utilizzare l'impostazione di anteprima file integrata quando gli utenti devono visualizzare in anteprima gli allegati supportati nell'app Web. L'opzione di amministrazione documentata è ENABLE_FILE_PREVIEWER; controlla se agli utenti viene offerta un'impostazione di anteprima. Il manuale dell'app Web non descrive questa opzione come un pacchetto FileViewer separato da installare tramite un gestore di pacchetti.
Kopano Files è diverso. Aggiunge un'area File per la navigazione e la gestione di account di archiviazione esterni, come WebDAV o altri backend configurati. Potrebbe richiedere pacchetti e configurazioni backend separati. Se il tuo obiettivo è visualizzare le anteprime degli allegati, inizia con l'impostazione di anteprima, non con Kopano Files. Se l'obiettivo è connettere l'archiviazione condivisa all'applicazione Web, segui il manuale di Files separato, il cui link si trova alla fine.
Il plugin di Kopano per la gestione dei dispositivi mobili espone informazioni e azioni relative ai dispositivi mobili che si sincronizzano con Kopano tramite Z-Push. A seconda della configurazione, gli utenti possono visualizzare i dettagli del dispositivo ed eseguire azioni come risincronizzare, rimuovere, aggiornare o cancellare i dati. È utile quando utenti o amministratori necessitano di questi controlli sui dispositivi nell'applicazione Web; non sostituisce Z-Push e non gestisce autonomamente la sincronizzazione con i dispositivi mobili.
Il manuale di Kopano MDM elenca Z-Push 2.0 o versioni successive e il supporto PHP SOAP come dipendenze. Se Z-Push è in esecuzione su un host diverso da WebApp, la configurazione MDM deve puntare a tale server Z-Push. Prima di installare qualsiasi cosa, verificare l'endpoint di Z-Push, il runtime PHP installato e la compatibilità dei pacchetti con il proprio ambiente.
Innanzitutto, individua l'applicazione Web attiva config.phputilizzata dalla tua installazione. In una distribuzione basata su pacchetti, si trova solitamente in /etc/kopano/webapp/, ma i container e le installazioni personalizzate potrebbero montare la configurazione altrove. Esegui un backup del file effettivo prima di modificarlo ed evita di creare una seconda definizione se l'impostazione esiste già.
Nella configurazione attiva, trovare ENABLE_FILE_PREVIEWER. Il manuale di amministrazione di Kopano WebApp documenta truecome mostrare agli utenti l'opzione per abilitare l'anteprima dei file nelle proprie impostazioni e falsecome nascondere tale opzione e disabilitare le anteprime per tutti gli utenti. Ad esempio:
define("ENABLE_FILE_PREVIEWER", true);Se la riga esiste già, modificane il valore anziché aggiungerne una duplicata define(). Mantieni intatta la sintassi PHP circostante. Se tale riga non esiste, utilizza il modello o le istruzioni di configurazione corrispondenti al pacchetto WebApp installato, invece di copiare un'intera configurazione di esempio sul file di produzione.
Dopo il salvataggio, verificare la presenza di errori di sintassi PHP utilizzando l'interprete PHP che gestisce l'applicazione Web. Ad esempio, se il file di configurazione si trova nel percorso standard del pacchetto:
php -l /etc/kopano/webapp/config.phpUn controllo della sintassi convalida solo l'analisi PHP; non conferma che l'impostazione venga caricata dal sito in esecuzione. Accedi come utente di prova, apri le impostazioni dell'app Web e verifica che l'opzione di anteprima dei file sia disponibile. Abilitala, applica la modifica, quindi apri un allegato di un tipo supportato dalla tua app Web. Se il controllo non è presente, verifica di aver modificato la configurazione attiva, che i plugin e le impostazioni dell'app Web siano disponibili e che un aggiornamento del pacchetto o il montaggio del container non stia fornendo un altro file di configurazione.
Utilizza il pacchetto MDM compilato per la stessa versione e distribuzione di Kopano WebApp del server. Il manuale di Kopano MDM documenta un pacchetto per la famiglia Debian denominato kopano-webapp-plugins-mdme un pacchetto RPM per le distribuzioni basate su RPM. Di seguito viene mostrato lo schema di installazione Debian; sostituisci il segnaposto con la versione effettiva del pacchetto ottenuta dalla tua fonte di pacchetti affidabile e compatibile:
sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.debNon digitare letteralmente il segnaposto tra parentesi angolari. Se l'installazione del pacchetto segnala dipendenze non risolte, utilizza la normale procedura di gestione dei pacchetti della tua distribuzione per risolverle dai repository attendibili, quindi verifica che il pacchetto MDM installato e la versione dell'app Web siano compatibili. Evita di scaricare una build di pacchetto casuale o di combinare versioni diverse per soddisfare una dipendenza.
Verifica che l'estensione PHP SOAP sia abilitata nell'ambiente PHP utilizzato dall'applicazione web. Un controllo rapido è il seguente:
php -m | grep -i '^soap$'Se non viene visualizzato alcun output, installare e abilitare l'estensione SOAP compatibile con la versione di PHP e il runtime del server web utilizzati da WebApp. Un controllo PHP da riga di comando può differire da PHP-FPM o dal modulo PHP di Apache, quindi confrontare la configurazione del server web se il comando mostra SOAP ma MDM continua a segnalare una funzione SOAP mancante.
Il manuale MDM pubblicato posiziona le sue impostazioni in /etc/kopano/webapp/config-mdm.php. Esegui il backup del file, quindi controlla le opzioni documentate:
PLUGIN_MDM_USER_DEFAULT_ENABLE_MDMcontrolla se il plugin è abilitato di default per gli utenti; il manuale elenca il valore predefinito come false.PLUGIN_MDM_SERVERidentifica il server Z-Push; il valore predefinito documentato è localhost.PLUGIN_MDM_SERVER_SSLdovrebbe essere impostato su truequando la connessione utilizza SSL/TLS; il valore predefinito documentato è false.Se WebApp e Z-Push si trovano su host separati, sostituire l'impostazione del server predefinita con il percorso Z-Push effettivo richiesto dalla propria implementazione. Utilizzare il protocollo e il nome host corretti e abilitare l'opzione SSL se l'endpoint utilizza HTTPS. Non esporre l'endpoint pubblicamente solo per far rispondere il plugin; mantenerlo raggiungibile tramite il percorso di rete previsto e un certificato valido. Preservare la sintassi PHP utilizzata dal file installato.
L'impostazione predefinita non è necessariamente la scelta giusta per ogni organizzazione. È possibile consentire agli utenti di abilitare MDM autonomamente oppure abilitarlo per impostazione predefinita, se la policy lo consente. Se la configurazione dell'applicazione Web disabilita globalmente i plugin o blocca il plugin MDM, è necessario risolvere prima tale impostazione centrale; la sola modifica dell'impostazione predefinita specifica per MDM non sovrascriverà un plugin esplicitamente disabilitato a livello di applicazione Web.
Dopo l'installazione e la configurazione del pacchetto, accedi a WebApp e apri Impostazioni, quindi la scheda Plugin. Seleziona MDM e applica le modifiche. Il manuale MDM indica che la panoramica del dispositivo viene visualizzata in una scheda MDM separata in Impostazioni e include informazioni sul dispositivo, l'ultima sincronizzazione e un ID dispositivo. Se il plugin non è presente nell'elenco, verifica innanzitutto che i file del pacchetto siano installati nella directory dei plugin WebApp attiva e che le impostazioni globali dei plugin non lo nascondano o disabilitino.
Eseguire un test con un account che dispone già di un dispositivo sincronizzato tramite Z-Push. Se l'elenco dei dispositivi è vuoto, verificare se l'account dispone di un dispositivo Z-Push, se l'impostazione del server MDM punta al servizio Z-Push corretto e se PHP SOAP è disponibile per il processo WebApp. Esaminare i log di WebApp e Z-Push relativi a una richiesta di test prima di modificare impostazioni del server non correlate.
Considerate le azioni MDM come controlli operativi, non come semplici pulsanti di aggiornamento. Il manuale MDM di Kopano avverte che la funzione Wipe rimuove tutti i dati dal dispositivo e raccomanda cautela. Prima di rendere la funzione Wipe disponibile agli utenti, testate l'interfaccia con un dispositivo non critico e familiarizzate con il processo di ripristino dell'organizzazione. Confermate l'ID del dispositivo di destinazione e l'utente prima di avviare la funzione.
Anche la rimozione ha delle conseguenze: il manuale specifica che la rimozione di un dispositivo dall'elenco implica che l'utente debba rimuovere e ricollegare l'account sul telefono affinché il dispositivo venga visualizzato nuovamente. La risincronizzazione richiede un'altra sincronizzazione; l'aggiornamento aggiorna l'elenco dei dispositivi visualizzati. Non utilizzare la cancellazione come procedura generica di risoluzione dei problemi per un dispositivo che presenta semplicemente una sincronizzazione lenta.
Per l'anteprima dei file, verificare che l'utente possa visualizzare e abilitare l'impostazione, quindi aprire un allegato supportato senza prima scaricarlo. Per MDM, verificare che l'utente di prova possa visualizzare le informazioni sul dispositivo previste e che i dettagli dell'ultima sincronizzazione corrispondano a un dispositivo noto per essere sincronizzato tramite Z-Push. Testare prima azioni a basso rischio come Aggiorna o Risincronizza. Mantenere la funzione Cancella disabilitata o limitata in base alle policy dell'organizzazione fino a quando non se ne è verificato l'impatto.
Se i controlli di anteprima non sono presenti, ricontrollare la configurazione WebApp attiva e le impostazioni utente. Se MDM non è presente o non mostra dispositivi, verificare la compatibilità dei pacchetti, PHP SOAP, il percorso di configurazione MDM, l'host Z-Push e le restrizioni globali dei plugin. I manuali pubblicati da Kopano descrivono i nomi delle impostazioni e il modello dei pacchetti, ma non garantiscono la compatibilità con ogni distribuzione e versione di PHP corrente; fare riferimento alla documentazione del pacchetto per la build specifica del server come fonte definitiva.
Comprendere come i termini "ingress" e "egress" descrivono il traffico in entrata e in uscita, perché la direzione dipende dal confine della rete e come monitorare la larghezza di banda e individuare i trasferimenti di dati rischiosi.
Confronta sei server e collettori syslog gratuiti per Windows e Linux, inclusi strumenti con interfaccia grafica, opzioni open source, funzionalità di ricerca, avvisi e trasporto sicuro.
Scopri cosa fa Microsoft IIS, come funzionano la sua pipeline di richieste e i pool di applicazioni e quando Apache, NGINX o Caddy potrebbero essere più adatti alle tue esigenze di server web.
Diagnostica i picchi di utilizzo della CPU del browser Jitsi Meet e riduci il carico del client controllando i riquadri video, gli effetti della fotocamera, la grafica del browser e le impostazioni dell'host.
Monitora lo stato di salute, il carico della conferenza e il traffico di Jitsi Videobridge con il suo endpoint Prometheus integrato, quindi esplora e visualizza i dati in Grafana.
Configura un dominio personalizzato per Jitsi Meet Docker con DNS, URL pubblico, HTTPS, Let's Encrypt, porte del firewall, impostazioni NAT e verifica end-to-end.
Fix Zimbra Admin Console 404 errors after SSL renewal by checking the correct URL and port, proxy routing, service status, deployed certificates, and logs.
Scopri come diagnosticare e risolvere l'avviso di configurazione di PHP OPcache di Nextcloud controllando l'SAPI PHP attivo, i limiti di dimensionamento, i commenti e le impostazioni di riconvalida.
Risolvere i problemi di migrazione del database Kopano dopo un aggiornamento di MySQL o MariaDB verificando i backup, le versioni del server, le modalità SQL, il set di caratteri, lo stato dello schema e i log.
Collega Nextcloud a LDAP o Active Directory con trasporto sicuro, filtri per utenti e gruppi, attributi di accesso e un'implementazione collaudata.
