Skip to main content

Creating a file share

ON THIS PAGE

Creating a file share

Creating a file share or shared folder is a prerequisite before you install Qlik Sense. The file share stores all binary app data, including the data models and dashboard sheets. It must be accessible to all nodes in your Qlik Sense site. You can create a file share either on the same server as the central node or on a separate server. If you have a large multi-node site we recommend that you configure the file share on a dedicated server for better resilience and performance.

If you create the file share on a separate server then you can follow the same steps as for a central node but you must ensure that the same Windows domain user that you use to run the Qlik services has read and write access to the file share folder.

To create a file share and share the folder with specific users:

  1. Create a local folder on your server computer. For example, create a folder called QlikShare on the C:\ drive.
  2. Right click the folder, and then click Properties.
  3. Click the Sharing tab, and then click Share.
  4. Enter the name of your Windows user, and click Add.
  5. In the Permission level column, select Read/Write, then click Share.
Note: Make a note of the network path shown in the confirmation screen as you use this later during setup of your shared persistence storage folders. The network path will be in the following format: \\server-name\QlikShare

Ensure that permissions on the folder, subfolders, and files are set to full control for the user account you selected.

Do the following:

  1. Click the Security tab.
  2. Select the user account you want to use for the installation.
  3. Click Advanced and verify that your current user has full control, and that this permission applies to the folder, subfolders, and files.
  4. Click the Effective Access tab, then click Select a user and enter your user account name.
  5. Click View effective access, then check the Permission column that your user has full control.
Note: A file share cannot be used for more than one Qlik Sense site. If two sites use a single file share, there is a potential for file locking issues, and there can be incorrect meta-data references because data in the file share is being updated by two independent sites.

Creating an NFS file share

You can host an NFS file share on a Microsoft Windows Server and map it to your Qlik Sense Enterprise on Windows installation. Before you create an NFS file share, you must first enable the Server for NFS feature on the Windows server.

To enable Server for NFS, do the following:

  1. Open the Windows Server Manager.
  2. Click Manage.
  3. Click Add Roles and Features.
  4. In the Add Roles and Features Wizard, select the following:

    Configuration setting Instruction
    Installation Type Select Role-based or feature-based installation
    Server Selection Use the pre-selected server.
    Server Roles Under Files And Storage Services > File and iSCSI Services, select Server for NFS.
    Features Ensure that Client for NFS is selected.
    Confirmation Click Install.
    Results Verify the install is successful. You will need to restart the server.

To create a NFS file share, do the following:

  1. Create a new folder on your Windows Server.
  2. Right-click the folder, then click Properties.
  3. Under the NFS Sharing tab, select Share this folder.
  4. Enter a Share name.
  5. Click Permissions.
  6. Click Add to add IP addresses or host names that can connect to the NFS file share, and set their Type of access as needed. Click OK
  7. Click Apply, then OK.
Note: Your NFS file share is listed under Shares in the Windows Server Manager. You can access the NFS share information by right-clicking the share, then selecting properties. When you install Qlik Sense Enterprise, use the NFS file share remote path when setting up your shared persistent storage. Enter the remote path in the following format: \\server-name\share-name.

Changing the file share path

You can change the Qlik Sense file share path after installing Qlik Sense Enterprise on Windows by using the QlikSenseUtil.exe, which is included with the Qlik Sense installer.

To change the file share path, do the following:

  1. On the file share server, create a new file share.

  2. Copy the share path to a notepad. You need to add the new share path to the QlikSenseUtil.exe later.

  3. Stop all Qlik services except the Qlik Sense Repository Service.

  4. Move the Apps, ArchivedLogs, CustomData, and StaticContent folders from your existing file share to your new file share.

  5. Run the QlikSenseUtil.exe as administrator.

    Note: If you used the default installation path for Qlik Sense, QlikSenseUtil.exe is located: %Program Files%\Qlik\Sense\Repository\Util\QlikSenseUtil\QlikSenseUtil.exe
  6. From the QlikSenseUtil window, click Connect to database.

  7. On the Connect to database window, enter the Qlik Sense repository database username and password, then click OK.

    QlikSenseUtil window with repository username and password entered.

  8. Select Service cluster, then click OK to retrieve the current file share path.

  9. Replace the current file path with the new file path, then click Save.

  10. Verify that the file share paths have been updated correctly by clicking Clear, and then OK. The fields should populate with the new file paths.

    QlikSenseUtil with file paths.

  11. Restart the Qlik services that you closed.

  12. Restart the QMC.