Vizlib Home Try Vizlib

Vizlib Server Troubleshooting - Known Issues / FAQ

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.


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

Back to Contents

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.

Back to Contents

VizlibServer installer does not fully stop Vizlib services

  1. Cancel the update
  2. Go to Services and verify that both Vizlib services are stopped
  3. Open Task Manager and go to the Details tab
  4. Try to end task vizlib-server.exe and see if it automatically starts again.
    If it starts again, continue to the next step
  5. Look for node.exe processes which are running as user SYSTEM. 
    Typically you will have two processes like that created by the Vizlib-Server. 
  6. Right click, select Properties and inside Location verify that they relate to VizlibServer. 
  7. End all of them and repeat step 4 if vizlib-server is still running.
  8. At this point you should be able to reattempt the update.

Back to Contents

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.

Back to Contents

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. 

Back to Contents

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.

Back to Contents

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. 

Back to Contents

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. 

Back to Contents

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. 

Back to Contents

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

Back to Contents

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.