La documentazione per questo prodotto è stata redatta cercando di utilizzare un linguaggio senza pregiudizi. Ai fini di questa documentazione, per linguaggio senza di pregiudizi si intende un linguaggio che non implica discriminazioni basate su età, disabilità, genere, identità razziale, identità etnica, orientamento sessuale, status socioeconomico e intersezionalità. Le eventuali eccezioni possono dipendere dal linguaggio codificato nelle interfacce utente del software del prodotto, dal linguaggio utilizzato nella documentazione RFP o dal linguaggio utilizzato in prodotti di terze parti a cui si fa riferimento. Scopri di più sul modo in cui Cisco utilizza il linguaggio inclusivo.
Cisco ha tradotto questo documento utilizzando una combinazione di tecnologie automatiche e umane per offrire ai nostri utenti in tutto il mondo contenuti di supporto nella propria lingua. Si noti che anche la migliore traduzione automatica non sarà mai accurata come quella fornita da un traduttore professionista. Cisco Systems, Inc. non si assume alcuna responsabilità per l’accuratezza di queste traduzioni e consiglia di consultare sempre il documento originale in inglese (disponibile al link fornito).
Questo documento offre una panoramica delle procedure ottimali da seguire su Exchange per l'integrazione con SocialMiner e Cisco Unified Contact Center Express (UCCX) per Agent Email.
Basata sull'implementazione della chat multisessione in UCCX nella versione 10.5, la versione 10.6 introduce l'e-mail. Le e-mail vengono recuperate da Microsoft Exchange da SocialMiner e inoltrate agli agenti da UCCX. Gli agenti utilizzano un nuovo modello di risposta e-mail nel gadget multisessione di Finesse per rispondere alle e-mail.
UCCX 11.5 e SocialMiner 11.5 offrono la funzionalità di integrazione con Microsoft Office 365 per la posta elettronica. Office365 è un sistema di gestione degli account di posta elettronica basato su cloud di Microsoft e pertanto non presenta miglioramenti specifici delle prestazioni.
Cisco raccomanda la conoscenza dei seguenti argomenti:
Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Nota: Si noti che SocialMiner non memorizza effettivamente le e-mail nel suo database. Memorizza i metadati utilizzati per recuperare l'e-mail dal server e-mail. Questi metadati vengono utilizzati anche quando l'agente risponde all'e-mail.
Nota: In questo documento viene illustrato come eseguire l'installazione e la configurazione in laboratorio di Exchange 2013. Benché si tratti di una configurazione testata su Exchange, Cisco non prevede restrizioni alle implementazioni di Exchange. Questo documento non considera le distribuzioni di produzione e le configurazioni personalizzate.
Nota: In questo documento vengono forniti alcuni esempi di Exchange relativi al 2013 e considerazioni simili devono essere osservate in Exchange 2010. Per una soluzione ottimale, è consigliabile utilizzare questo articolo con l'aiuto di un amministratore di Exchange.
Nota: Questo documento fornisce le procedure ottimali in combinazione con i problemi riscontrati nelle implementazioni personalizzate, in quanto non esistono restrizioni di rilievo da parte di SocialMiner e UCCX per Exchange.
Accertarsi che l'host ESX sia configurato per NTP e verificare lo stato. Controllare la scheda Configuration dell'host e selezionare time configuration.
Per il controller di dominio, verificare che l'ora sia sincronizzata con l'host. È disponibile nella scheda vm/edit settings/options (Impostazioni/opzioni di vm/modifica), VMware Tools. Selezionare la casella Sincronizza orario ospite con l'host e fare clic su OK.
Nota: Il controller di dominio può eseguire la sincronizzazione dell'ora con qualsiasi altra origine. Nella maggior parte delle distribuzioni, il controller di dominio stesso funge da origine ora. Verificare che rimanga sincronizzato con l'host in cui verrà distribuito lo scambio.
Impostare DNS sul server Active Directory nel dominio.
Aggiungere il dominio come evidenziato di seguito.
Eseguire l'autenticazione con un account amministrativo nel dominio.
I prerequisiti sono documentati nel collegamento qui
Nel collegamento sopra riportato, seguire la sezione Prerequisiti di Windows Server 2012 R2 e Windows Server 2012 (dipende dalla piattaforma utilizzata per l'installazione), i ruoli del server Cassette postali o Accesso client devono essere seguiti per installare i ruoli del server Cassette postali o Accesso client.
Aprire PowerShell con privilegi di amministratore ed eseguire i comandi seguenti:
Install-WindowsFeature AS-HTTP-Activation, Desktop-Experience, NET-Framework-45-Features, RPC-over-HTTP-proxy, RSAT-Clustering, RSAT-Clustering-CmdInterface, RSAT-Clustering-Mgmt, RSAT-Clustering-PowerShell, Web-Mgmt-Console, WAS-Process-Model, Web-Asp-Net45, Web-Basic-Auth, Web-Client-Auth, Web-Digest-Auth, Web-Dir-Browsing, Web-Dyn-Compression, Web-Http-Errors, Web-Http-Logging, Web-Http-Redirect, Web-Http-Tracing, Web-ISAPI-Ext, Web-ISAPI-Filter, Web-Lgcy-Mgmt-Console, Web-Metabase, Web-Mgmt-Console, Web-Mgmt-Service, Web-Net-Ext45, Web-Request-Monitor, Web-Server, Web-Stat-Compression, Web-Static-Content, Web-Windows-Auth, Web-WMI, Windows-Identity-Foundation, RSAT-ADDS
Install-WindowsFeature Server-Media-Foundation
Riavviare il server per completare l'installazione.
Scaricare e installare "Unified Communications Managed API 4.0 Runtime". L'installazione è semplice. Accettare la licenza, fare clic su Avanti in ogni finestra di dialogo intermedia e quindi su Fine.
(è necessario riavviare ora prima di avviare l'installazione di Exchange 2013)
Eseguire il programma di installazione di "Exchange 2013". Nel primo fotogramma viene richiesto di verificare la disponibilità di aggiornamenti. Fare clic su Next (Avanti).
In questo caso, non sono stati trovati aggiornamenti. Fare clic su Next (Avanti).
Viene visualizzata la schermata di introduzione. Fare clic su Next (Avanti).
Accettare la licenza e fare clic su Avanti.
Selezionare "Usa impostazioni consigliate" e fare clic su Avanti.
Selezionare "Ruolo Cassette postali", "Ruolo Accesso client" e "Installa automaticamente ruoli Windows Server". Fare clic su Next (Avanti).
Mantenere il percorso predefinito e fare clic su Avanti.
Impostare l'organizzazione. Fare clic su Next (Avanti).
Lascia abilitata la ricerca malware. Fare clic su Next (Avanti).
Verifiche finali. L'operazione potrebbe richiedere alcuni minuti. Al termine, fare clic su Avanti.
Nota: Potrebbe essere necessario riavviare il server, se si raggiunge la fine dei controlli di fattibilità e informa su un riavvio in sospeso. Riavviare il server a questo punto ed eseguire nuovamente il programma di installazione. Dopo il riavvio possiamo continuare con i controlli di fattibilità e procedere con l'installazione.
Selezionare installa.
Fare clic su Finish (Fine). Installazione di Exchange completata. Riavviare come indicato.
È possibile accedere all'amministrazione di Exchange tramite il seguente URL:
https://<exchangeServerIp>/ecp/ or just https://localhost/ecp
Verificare HTTPS.
Selezionare "Cassetta postale utente".
Nota: Il tipo di account deve essere Cassetta postale utente. Le cassette postali per sale riunioni e attrezzature non sono supportate in quanto accettano e rispondono solo a convocazioni di riunioni ed eventi di Outlook.
Verrà visualizzata la finestra di dialogo "Cassetta postale utente". Immettere i dettagli per un nuovo utente di posta elettronica.
Accedere a Outlook Web Access:
https://<exchangeServerIp>/owa or just https://localhost/owa
Verificare HTTPS.
La configurazione per l'E-mail dell'agente basato su UCCX e SocialMiner richiede la configurazione nella pagina di amministrazione dell'applicazione UCCX per creare la configurazione di SocialMiner, creare il server di posta e la coda del servizio di contatto e-mail.
Per ulteriori informazioni, fare riferimento a questo documento
Da Exchange Management Shell Eseguire i comandi seguenti:
Impostare l'avvio automatico del servizio IMAP4 di Microsoft Exchange:
Set-service msExchangeIMAP4 -startuptype automatic
Avviare il servizio IMAP4 di Microsoft Exchange:
Start-service msExchangeIMAP4
Impostare l'avvio automatico del servizio back-end IMAP4 di Microsoft Exchange:
Set-service msExchangeIMAP4BE -startuptype automatic
Avviare il servizio back-end IMAP4 di Microsoft Exchange:
Start-service msExchangeIMAP4BE
Da Exchange Management Shell Eseguire i comandi seguenti:
In questo esempio viene impostato il limite di connessioni per un utente:
Set-ImapSettings -MaxConnectionsPerUser Value
Nota: Il valore predefinito è 16. È stato impostato su 200 negli ambienti lab, ma può essere aumentato per le distribuzioni di maggiori dimensioni.
SocialMiner 11.6 consente allegati fino a 20 MB di dimensioni per messaggi e-mail in entrata e in uscita. Come regola generale, per tenere conto dell'aumento delle dimensioni dovuto alla codifica e alla crittografia, si consiglia di impostare il limite massimo per le dimensioni dei messaggi in Exchange su 30 MB.
Nota: Exchange non prende in considerazione il limite delle dimensioni degli allegati nella configurazione del trasporto. Quando vengono applicate le regole per il limite delle dimensioni dei messaggi, vengono considerate le dimensioni combinate di tutte le parti, il corpo e gli allegati del messaggio.
I comandi seguenti sono utili per esaminare e regolare i limiti di velocità per il connettore Client Frontent. Questo è il connettore utilizzato da SMTP. Tutti questi comandi devono essere eseguiti da Exchange Management Shell.
Ottieni limite di velocità messaggi per i connettori:
Get-ReceiveConnector | ft Name,MessageRateLimit
Ottieni dettagli per un connettore:
Get-ReceiveConnector -Identity "Client Frontend <EXCHANGE2013 hostname>"
Aumentare il limite di velocità per il connettore che supporta SMTP:
Get-ReceiveConnector -Identity "Client Frontend <EXCHANGE2013 hostname>" | Set-ReceiveConnector -MessageRateLimit 50
Get-ReceiveConnector -Identity "Client Proxy <EXCHANGE2013 hostname>" | Set-ReceiveConnector -MessageRateLimit 100
Attiva registrazione circolare per Exchange 2010 e 2013
Apri Exchange Management Shell
Eseguire il comando: Get-Mailboxdatabase | Set-MailboxDatabase -CircularloggingEnabled:$true
Per rendere effettiva la modifica, è quindi necessario smontare e montare i database.
Dismount-Database -Identity "Nome database cassette postali"
Mount-Database -Identity "Nome database cassetta postale"
È inoltre possibile eseguire l'installazione e la disinstallazione quando si accede a Exchange Management Console (2010) o a ECP (2013)
(2010) Configurazione organizzazione -> Cassetta postale
Selezionare il database e nella casella Azioni in basso a destra selezionare Disinstalla database. Al termine, selezionare Monta database.
(2013) Server -> Database
Selezionare il database, quindi fare clic su "..." e fare clic su Disinstalla. Al termine, fare clic su "..." e fare clic su Mount.
Attendere che gli indici siano integri. Eseguire il comando per verificare
Get-MailboxDatabaseCopyStatus
Nota: SocialMiner non supporta formati di codifica diversi da UTF -8 per Exchange. Si consiglia inoltre di installare lo strumento di rilevamento di spam/malware su Exchange poiché UCCX o SocialMiner non sono in grado di identificare e-mail di malware/spam e possono causare problemi.
Riepilogo del problema |
1. Le risposte ai messaggi di posta elettronica inviati da un agente Finesse a indirizzi di posta elettronica esterni hanno esito negativo, mentre le risposte agli indirizzi di posta elettronica interni hanno esito positivo, ma con l'indirizzo FROM come nome dell'entità utente (UPN) anziché un indirizzo di posta elettronica valido. 2. SocialMiner non è in grado di connettere il feed di posta elettronica a Exchange perché Exchange non consente l'autenticazione con l'account .com esterno |
Messaggio di errore |
Finesse: "Impossibile rispondere all'e-mail del cliente. Fare clic su Invia per riprovare o su Riaccoda. Se il problema persiste, contattare l'amministratore di sistema." Feed e-mail SocialMiner: X rossa - "Impossibile stabilire la connessione con il server e-mail. Verificare che il nome utente e la password siano corretti." |
Possibile causa |
Verificare le impostazioni UPN in Active Directory |
Azione consigliata |
Esempio: In CCX Admin, Email CSQ è stato configurato con - L'organizzazione non ha imap e smtp come stessa entità. Abbiamo suddiviso DNS, .local interno e .com esterno Affinché SocialMiner funzioni, abbiamo inserito l'indirizzo e-mail utilizzato sia per IMAP che per SMTP, ma le e-mail interne passano solo con il .local e le e-mail di risposta possono essere inviate solo da un .com Risoluzione: Creare un suffisso UPN per un file .com che consenta flessibilità di autenticazione negli ambienti interni ed esterni. Questa operazione viene eseguita sul lato Exchange di Active Directory per includere .com nella rete locale a scopo di autenticazione. In DNS (Domain Name Server) - "Domini e proprietà", creare un suffisso UPN per gli account per semplificare l'accesso nelle organizzazioni di grandi dimensioni. Per "Utenti e computer" di Active Directory è necessario l'UPN predefinito specificato al momento dell'accesso. L'UPN specificato all'accesso corrisponderebbe all'indirizzo di posta elettronica. |
Riepilogo del problema |
Arresto anomalo del sottosistema non vocale su UCCX |
Possibile causa |
Il sottosistema non vocale si blocca a causa della presenza di caratteri Emoji nella riga dell'oggetto del messaggio. Il problema si verifica quando questo messaggio e-mail viene presentato a un agente che lo ripresenta allo stesso CSQ o a un altro CSQ. Il motivo è che quando i caratteri vengono passati a Openfire di UCCX, Openfire si blocca in quanto accetta solo un set di caratteri XML (Extensible Markup Language) 1.0 valido. I caratteri Emoji non fanno parte del set di caratteri XML 1.0. |
Azione consigliata |
|
Riepilogo del problema |
Il servizio XMPP (Extensible Messaging and Presence Protocol) di SocialMiner (Openfire) non elimina correttamente le sessioni HTTP che causano una perdita di dati. Vengono creati dump heap che causano problemi di prestazioni su Chat e Email con SocialMiner |
Possibile causa |
OpenFire versione 3.7.1 usato per SocialMiner 10.6 ha un bug noto che sembra essere stato risolto in una versione successiva. |
Azione consigliata |
|
Riepilogo del problema |
SocialMiner non riesce a connettere il feed di posta elettronica a Exchange |
Possibile causa |
SocialMiner e UCCX funzionano sulla versione 11.5 integrata con Exchange 2010 e 2013. Dopo l'aggiornamento alla versione 11.6, sul server e-mail su UCCX Appadmin apparirà la X rossa.
I registri di SocialMiner indicano: runtime/CCBU-runtime.2017-06-20T18-37-42.745.log:Causato da: javax.net.ssl.SSLHandshakeException: Il server ha scelto TLSv1, ma tale versione del protocollo non è abilitata o non è supportata dal client. runtime/CCBU-runtime.2017-06-20T18-37-42.745.log:000837786: 20 giu 2017 21:18:36,552 +0000: %CCBU__________FEEDS-3-SECURE_IMAP_CLIENT_CONNECTION_EXCEPTION: %[FEED_ID=100021][FEED_NAME=CCX Email Feed Team_IT_Tier2_Email][exception=javax.mail.MessagingException: Il server ha scelto TLSv1, ma tale versione del protocollo non è abilitata o non è supportata dal client.; |
Azione consigliata |
Accedere all'interfaccia CLI (Command Line Interface) di SocialMiner ed eseguire i comandi seguenti:
|
Errore del server temporaneo di Exchange 2013 451 4.7.0. Riprova più tardi. PRX5 Si tratta di un problema noto di Exchange 2013 (verificare la disponibilità di aggiornamenti da Microsoft).
Risoluzione: Verificare che la scheda di rete dei connettori di ricezione sia associata a un indirizzo IP specifico e non a "Tutti gli indirizzi IPv4". Ulteriori informazioni
L'utente invia un'e-mail ma, invece di inviarla correttamente, la inserisce nella cartella "Bozza".
Risoluzione: Per utilizzare l'interfaccia di amministrazione di Exchange, eseguire la procedura seguente:
Nel 2010
Nel 2013
Apri Exchange Management Console
Per ogni database
Set-MailboxDatabase -Identity <NomeDatabase> -DeletedItemRetention 0
Per verificare che funzioni,
Get-MailboxDatabase | nome ft,deleteditemretention
Elimina tutti gli elementi eliminati salvati per un potenziale recupero. Eseguire questa operazione per perfcustomer e perfqueue1-20.
Search-Mailbox -Identity "<nomeCassettaPostale>" -SearchDumpsterOnly -DeleteContent -Force
Recuperare lo spazio vuoto lasciato nel database per ridurre il file EDB:
Get-MailboxDatabase -Status | nome ft,dimensione database,disponibilenewmailboxspace -auto
Se viene visualizzata una grande quantità di AvailableNewMailboxSpace, è possibile deframmentare il database per recuperare lo spazio.
Per eseguire i comandi riportati di seguito, è necessario disporre almeno della quantità del nuovo DatabaseSize disponibile. È possibile calcolare quanto necessario per ("DatabaseSize" - " AvailableNewMailboxSpace") * 1.1 = DiskSpaceNeeded for NewDatabaseSize
Dismount-Database "DBtoShrink"
cd c:\Programmi\Microsoft\Exchange Server\V15\Mailbox\DBtoShrink
eseutil /d DBtoShrink.edb /t C:\defrag\temp.edb
Al termine, rimontare il database:
Mount-Database "DBtoShrink"
Eseguire nuovamente questo comando per verificare lo spazio disponibile:
Get-MailboxDatabase -Status | nome ft,dimensione database,disponibilenewmailboxspace -auto
Per recuperare completamente tutto lo spazio su disco, crea un nuovo database e sposta tutte le cassette postali in esso, quindi elimina la vecchia.
New-MailboxDatabase -Name "NewDB1" -Server "ExchangeServerName" -EdbFilePath C:\Program Files\Microsoft\Exchange Server\V15\Mailbox\NewDB1\NewDB1.edb
Mount-Database -Identity "NewDB1"
Attiva registrazione circolare,
Get-Mailboxdatabase | Set-MailboxDatabase -CircularloggingEnabled:$true
Dismount-Database -Identity "NuovoDB1"
Mount-Database -Identity "NewDB1"
Attendere che gli indici siano integri. Eseguire il comando per verificare:
Get-MailboxDatabaseCopyStatus
Sposta le cassette postali dal vecchio database al nuovo:
Get-Mailbox -Database "OldDB1" | New-MoveRequest -TargetDatabase "NewDB1"
In Exchange 2010 è possibile cancellare le richieste di spostamento esistenti prima di eseguire il comando precedente. Aprire Exchange Management Console. Passare a Configurazione destinatario -> Richiesta di spostamento.
Selezionare tutte le richieste di spostamento e fare clic su "Cancella richiesta di spostamento" nel pannello Azioni a destra.
Attendere il completamento dello stato. Per vedere lo stato
Get-MoveRequestStatistics -MoveRequestQueue "NuovoDB1"
Smonta database precedente:
Dismount-Database "OldDB1"
Verificare che sia possibile accedere a tutte le cassette postali nel nuovo database come previsto, quindi eliminare il vecchio database. Utilizzare la riga di comando o ECP. In Server -> Database. Selezionare il vecchio database DB1 e fare clic su Elimina.
Passaggio 1. Spazio su disco fisico di Exchange Server insufficiente.
Passaggio 2. Le cassette postali di Exchange hanno raggiunto il limite (il valore predefinito è 2 GB).
Passaggio 3. Controllare lo stato dell'indice di contenuto del database. È possibile che venga visualizzato Failed o failedAndSuspended.
Usa ECP per Exchange 2013
Usa Exchange Management Shell (sia Exchange 2013 che Exchange 2010)
Utilizza Exchange Management Console per Exchange 2010
Per correggere lo stato dell'indice di contenuto, attenersi alle istruzioni seguenti:
http://theucguy.net/fix-corrupted-content-index-catalog-of-a-mailbox-database-with-single-copy/
Per informazioni su come ottenere la documentazione, usare Cisco Bug Search Tool (BST), inviare una richiesta di assistenza e raccogliere ulteriori informazioni, vedere Novità della documentazione dei prodotti Cisco all'indirizzo: http://www.cisco.com/c/en/us/td/docs/general/whats
Iscrivetevi a What's New in Cisco Product Documentation, che elenca tutta la documentazione tecnica Cisco nuova e aggiornata, come feed RSS e consegnate i contenuti direttamente al vostro desktop utilizzando un'applicazione per la lettura. I feed RSS sono un servizio gratuito.