QueueMetrics - Advanced Configuration Manual 2018/04/20 ii QueueMetrics - Advanced Configuration Manual Loway 2018/04/20 Revision History Revision 18.04 - covers QueueMetrics 2018/04/20 L 18.04 Table of Contents 1. Acknowledgements .......................................................................................................... 1 2. ViciDial integration ......................................................................................................... 2 Prerequisites ............................................................................................................... 2 Changes to QueueMetrics database ................................................................................ 2 Changes to ViciDial .................................................................................................... 3 Changes to QueueMetrics ............................................................................................. 4 3. Serving QueueMetrics through Apache ................................................................................ 5 Prerequisites ............................................................................................................... 5 Installing mod_jk ........................................................................................................ 5 Configuration of Apache and mod_jk ............................................................................. 5 Virtual host configuration ............................................................................................. 6 Creating Virtualhosts in Tomcat .................................................................................... 8 Troubleshooting .......................................................................................................... 8 4. Serving QueueMetrics over Apache/SSL ............................................................................ 10 Prerequisites ............................................................................................................. 10 Configure the Name-Based SSL Virtual Hosts ................................................................ 10 Install the Apache HTTP Server and its SSL/TLS Module ................................................ 10 Configure the global Apache Settings ........................................................................... 11 Configure the global SSL/TLS Settings ......................................................................... 11 Create DNS records ................................................................................................... 11 Create the Application Directories ................................................................................ 12 Install the CRT, CSR, and KEY files ............................................................................ 12 Configure the Virtual Hosts ........................................................................................ 12 Verify the Configuration ............................................................................................. 14 Setup the service for automated startup ......................................................................... 14 Troubleshooting ........................................................................................................ 14 Summary of Log Files used by Apache ......................................................................... 14 Notes ....................................................................................................................... 15 Sources .................................................................................................................... 15 5. Installing QM as a ROOT webapp .................................................................................... 16 Prerequisites ............................................................................................................. 16 Model 1: using a ROOT webapp .................................................................................. 16 Model 2: defining a root context .................................................................................. 16 Changes to QueueMetrics ........................................................................................... 17 6. Enabling GZIP compression in Tomcat .............................................................................. 18 Prerequisites ............................................................................................................. 18 Changes to Tomcat .................................................................................................... 18 Changes to QueueMetrics ........................................................................................... 18 For further reading .................................................................................................... 18 7. Advanced QueueMetrics monitoring .................................................................................. 19 Prerequisites ............................................................................................................. 19 Assessing memory problems ....................................................................................... 19 Remote monitoring with VisualVM .............................................................................. 20 8. Database connection pooling ............................................................................................ 22 Prerequisites ............................................................................................................. 22 Changes to the MySQL server ..................................................................................... 22 Changes to QueueMetrics ........................................................................................... 22 Changes to Tomcat .................................................................................................... 23 9. Monitoring and fixing "slow queries" in MySQL ................................................................. 26 Prerequisites ............................................................................................................. 26 Changes to QueueMetrics ........................................................................................... 26 iv 10. Moving QueueMetrics to a different server ....................................................................... 27 Prerequisites ............................................................................................................. 27 Required steps .......................................................................................................... 27 11. Moving the queue_log table to InnoDB ............................................................................ 28 Prerequisites ............................................................................................................. 28 Changes to MySQL ................................................................................................... 28 Changes to QueueMetrics ........................................................................................... 29 12. Using Master-master database replication for strong high-availability ..................................... 30 Prerequisites ............................................................................................................. 30 Changes to MySQL ................................................................................................... 31 Changes to QueueMetrics ........................................................................................... 33 13. Native MySQL logging of queue_log data ........................................................................ 34 Prerequisites ............................................................................................................. 34 14. Separating audio recordings in a daily folder ..................................................................... 35 Prerequisites ............................................................................................................. 35 Archiving script ........................................................................................................ 35 Changes to QueueMetrics ........................................................................................... 36 Making older files accessible ....................................................................................... 36 15. Show ringing phones in the realtime page ........................................................................ 37 16. Using pre-purchased keys (PPK) ..................................................................................... 39 Terminology used ...................................................................................................... 39 Converting a PPK into a License key ............................................................................ 39 Upgrading / downgrading a PPK .................................................................................. 40 17. Enabling log rotation in Tomcat ..................................................................................... 41 Prerequisites ............................................................................................................. 41 The rotation file ........................................................................................................ 41 Misc changes ...........................................................................................................