Qlik Sense Enterprise (Client-Managed)
  • 20 Sep 2023
  • 4 Minutes to read
  • Dark
    Light

Qlik Sense Enterprise (Client-Managed)

  • Dark
    Light

Article summary

Installation in Qlik Sense Enterprise

To install your personal ancoreSoft License Extension, as well as ancoreShare Extension and ancoreScript in Qlik Sense Enterprise (Client-Managed Server), please perform the following steps.

Note:
For installing ancoreShare Extension in Sense Enterprise (Server) or Cloud environment, you must have admin access to the Qlik Management Console (QMC).
Important
Some browsers require a hard-refresh in order to load newly installed license files or after a version or license update of the extension.
How to perform a hard-refresh in browsers 
  1. Open the development tools of your browser.
    In most browsers you can press F12 or Ctrl+Shift+I
  2. Make sure the Disable Cache is enabled in Network
  3. While keeping the dev-tools open, press Ctrl+F5
    (Make sure to save your work before you do this.)

 

Upload Zip Files

Log on to the Qlik Management Console (QMC) using administrator credentials and navigate to Start or MANAGE RESOURCESExtensionsClick on the Import button on the bottom and choose the installation zip file in your file explorer (a password is not required). Click on Import in the dialog box and wait for the files to get loaded.

Repeat this step for each installation zip file:

  • XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.zip
    (Your personal ancoreSoft License Extension, showing your account number)
  • ancoreShare_Extension_stable.zip
  • ancoreScript_Extension_stable.zip

You have successfully installed ancoreSoft Extensions (they will usually appear at the bottom of the list at first):

Info
Although we re-branded the product name to ancoreShare, we chose to stay downwards compatible in respect of our long-time users, hence the QEXT filename will continue to be "NPQReports".

Grant Reading Rights

Make sure all users who work with an ancoreSoft extension have at least reading rights to this extension. This applies to all extensions, such as the ancoreSoft License extension, as well as the tools ancoreShare Extension or ancoreScript. 

Important
Make sure users have at least reading rights to all uploaded extensions.

To do this switch to User access and check if all users have R enabled on the respective extensions.


For manual updates only

If you operate with an ancoreShare Extension or ancoreScript version that requires manual updating you can either replace/overwrite, or delete and re-install your existing extensions:

Option 1 (Replace): Just click on the Import button on the bottom and choose the new installation zip file in your file explorer to then import it to the management console (a password is not required).
Click on Import, wait for it to get loaded, and confirm you want to Replace the existing installation(s).

Option 2 (Delete): If you prefer a "clean update", first select both ancoreScript Extension "NPQReports" and "ancoreScript" in your list of extensions and click on Delete. Make sure to select both before importing the bundle installation zip file, otherwise an error message will appear stating that the extension (one of them) already exists. (Alternatively you can of course confirm you want to Replace the existing installation(s) like in option 1 above).

Then newly install/import the extension zip file as described in the previous step.

Done!

You can now start using ancoreShare Extension & ancoreScript to create amazing reports & all kinds of events and tools directly from within your Sense apps!


Licensing Named Users

This step is optional and only applies if you have a license for less users than there are in your Qlik Sense environment. For example, if you have a total of 1000 Qlik Sense users in your environment, but you only purchased an ancoreShare Extension license for 50 users, you will need to follow this additional step.

If you have purchased a license for a particular Qlik environment with unlimited ancoreSoft Extension users, this step is not necessary and you're already all set up by simply adding your personal ancoreSoft License Extension to your Qlik Management Console in the previous steps.

Named Users License Only
This step is only required, if you purchased a license for named users, instead of licensing a particular Qlik environment with unlimited ancoreSoft Extension users (learn more).

For those with a Named Users License the following section explains how to assign your Qlik users to your ancoreSoft license. In the ancoreShare About Dialog you can check how many users are currently allowed with your license.  

Max. user count
Make sure the number of users in the text file does not exceed the maximum number of users allowed with your license, otherwise no user will have access.
Assign named users

You can assign Qlik Sense users to an ancoreShare license by uploading a file to a specific Content Library in your QMC:

  • Create content library
    • Log on to your Qlik Management Console (QMC) using administrator credentials and navigate to Content libraries under MANAGE CONTENT.
    • Click on Create new and enter the Name: ancoreSoft
    • Make sure all users who work with the extension have at least reading rights to this content library. To do this switch to User access and check if all users have R enabled.
  • Create text file
    • Go to your text editor of choice (for example Notepad) and create a simple text file. Name the file "ancoreshare.users.txt". Make sure to name the file exactly like this, all in lower case, where ".txt" is the file extension.
    • For all users who should be assigned to the ancoreShare Extension license, enter the respective Qlik Sense USERID (you can refer to this Qlik Help article if you want to learn more).
      You can look up the USERID of a user in your QMC if you go to Users under MANAGE CONTENT and double click on a user to edit the record. The USERID consists of:
      The "User directory" + a backslash "\" +  the "User ID".
      For example "ANCORESOFT\kathryn"
    • Next go back to your Content library ancoreSoftContents and upload the text file you created.

Now only users who are member of this text file will be licensed. 

You can reassign users any time either by reuploading an updated version of the text file or by directly editing the file in your Qlik Sense StaticContent.

Done!

From now on all your licenses will be managed automatically for all your ancoreSoft extensions.





Next Steps:



Was this article helpful?