When you're working with Vizlib Server it's important to be clear about what you can and can't do. We've collected any known issues and limitations and listed them in this article for you, along with any answers to any other questions you might need.
TABLE OF CONTENTS
- Set VZB_Server_Url after Updating Extension File
- Windows Service not Automatically Starting
- Browser not Loaded
- PFX Certificate password error
- Vizlib Server - Qlik Proxy Service Configuration
- Which Qlik Sense Licenses work with Vizlib Server?
- Vizlib Server started in Safe Mode
Set VZB_Server_Url after Updating Extension File
This issue relates to users updating their extension files for Vizlib Teamwork, Finance and Writeback products.
If you're updating any of these extensions in the Qlik Management Console (QMC), the Extension Server URL custom property VZB_Server_Url (Figure 1) needs to be set after the update completes.
Figure 1: VZB_Server_Url QMC Empty
If you restart Vizlib Server after the update in the Vizlib Management Console (VMC), the Extension Server Url custom property will be set automatically (Figure 2).
Figure 2: Extension Server Url VMC
You can also enter the property manually on each extension in the QMC (Figure 3).
Figure 3: VZB_Server_Url QMC Added
Windows Service not Automatically Starting
Very rarely, the Vizlib Server Windows Service gets created during the install but is not automatically started. If you encounter issues opening the VMC, double-check if Vizlib Server is running using Task Manager. If not, start the service manually.
Browser not Loaded
Occasionally, for slower servers, the browser is opened before Vizlib Server is fully initialized and the page is not loaded properly. If that happens, wait another minute and refresh the page.
PFX Certificate password error
If you specified the wrong password for the PFX certificate during an installation of Vizlib Server, the page won’t load properly over HTTPS and Vizlib Server falls back to the HTTP protocol. If this happens, activate the product by following the steps in the installation guide. Open the VMC at http://localhost:1980/vmc, open the Logs Browser tab and filter the error logs to check for any possible causes.
Vizlib Server - Qlik Proxy Service Configuration
If you're installing Vizlib Server on a dedicated server or you have a multinode environment and an error is occuring, check port 4243 has been opened for QPS communication between those servers.
Which Qlik Sense Licenses work with Vizlib Server?
Vizlib Server supports Qlik Sense Professional, Analyzer and Analyzer Capacity Licenses. Serverless access (e.g. using Vizlib Writeback Table without Vizlib Server) is limited to Qlik Sense Professional licenses only. The articles on VMC User Roles and Security Rules contain instructions that are designed to work with all supported license types.
Vizlib Server started in Safe Mode
If you return an error stating Vizlib Server has been started in Safe Mode (Figure 4) it means it is not connected to the database holding the configuration details.
Figure 4: Safe Mode
Potential causes are:
- The database needs to be restarted, which should start the Vizlib Server database service.
- The database user credentials have been changed, and needs to be checked.
- The database port is blocked, or not running on the port used in the configuration.