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
- VizlibServer installer does not fully stop Vizlib services
- 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
- No Connection to Qlik Sense Services
- Security Rules
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 doesn't automatically start
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.
VizlibServer installer does not fully stop Vizlib services
- Cancel the update
- Go to Services and verify that both Vizlib services are stopped
- Open Task Manager and go to the Details tab
- Try to end task vizlib-server.exe and see if it automatically starts again.
If it starts again, continue to the next step - Look for node.exe processes which are running as user SYSTEM.
Typically you will have two processes like that created by the Vizlib-Server. - Right click, select Properties and inside Location verify that they relate to VizlibServer.
- End all of them and repeat step 4 if vizlib-server is still running.
- At this point you should be able to reattempt the update.
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.
No Connection to Qlik Sense Services
If the connection drops between Vizlib Server and any of the ports hosting Qlik Sense services (4747, 4243, 4242 and 443) an error will be displayed in the VMC Dashboard (Figure 5).
Figure 5: Connection Error
The connection can be lost after a change to network communication (e.g. modification of a firewall rule) or if the Qlik Sense services are stopped or become unresponsive.
To resolve the error, check which ports are affected and re-start the Qlik Sense service if it has stopped, then re-start Vizlib Server services. The connection should be restored.
Security Rules
Security rules-based has to be based on a user attribute or custom property that is in the repository because Dynamic User Attributes (available only per session) are not supported