Skip to main content

Creating a node

ON THIS PAGE

Creating a node

You can create one or more nodes and use them in a multi-node site. Give each node a specific role within the deployment to support planning of resources. For example, specify if a node is to run scheduled reloads or serve content to users.

When you create a node its associated services are also created and they inherit the node name: repository, engine, printing, proxy, and scheduler.

Do the following:

  1. Open the QMC: https://<QPS server name>/qmc

  2. Select Nodes on the QMC start page or from the StartArrow down drop-down menu to display the overview.

  3. Click Create new Create new in the action bar.

  4. Fill out the properties.

     

    Identification

    All fields are mandatory and must not be empty.

    Identification property descriptions
    Property Description

    Name

    The node name.

    Host name

    The host name. You cannot edit the host name after the creation of the node. The server address must either be in the fully qualified domain name format: node2.domain.com or the machine name format: node2.

    Note: We recommend that you use the fully qualified domain name (FQDN). If you only use the machine name as the host name, the FQDN must be added manually to the virtual proxy Host allow list.
    Note: There is support for using an IPv6 address as host name.

    Node purpose

    Use the drop-down to select which environment the node is intended for: Production, Development, or Both.

    This setting is defined in the QMC on each node that is added. Depending on what node purpose you choose, different properties are applied to the node. These properties can then be used by load balancing rules and security rules for controlling access.

    The effects of choosing the different options are as follows:

    • Production: this server is intended to support users to access apps but not create them. This means that when a user connects to this node, the Create new app button in the hub is not displayed to the user. To hide the Work section in the hub, you need to disable the security rule that grants the application owner access. This means that when a user connects to this node, the buttons in the hub to create apps and the Work section are not displayed to the user. You cannot edit an app on a production node.
    • Development: this server is intended to allow users to create apps but not serve the normal user traffic for users consuming published apps. Create and edit capabilities are enabled.
    • Both: this setting allows both activities to occur on the node. This means that both normal user traffic is handled and users can create apps.

    Node configuration

    Note: This section is only available when you have a Shared Persistence installation.

    In a multi-node environment, you can select one or more nodes to be Failover candidates. In a failover scenario, where the central node stops working, one Failover candidate assumes the role of central node. This solution eliminates the risks associated with the central node as a single point of failure.

    A requirement for a Failover candidate is that the services Repository, Engine, Proxy, and Scheduler are active. A node that does not have all these services active cannot be a failover candidate.

    Note: It is only when creating a new node that you can make it a Failover candidate. Once a node has been created you can neither make it a Failover candidate nor clear any Failover candidate selection.

    Node roles

    These are the roles that by default are assigned to the failover node.

    Node roles
    Role Description

    Scheduler master

    Responsible for the scheduled reload tasks and user synchronization tasks within a Qlik Sense site.

    License maintainer Responsible for the maintenance of licenses and tokens within a Qlik Sense site.
    User synchronizer Responsible for the user synchronization within a Qlik Sense site.
    Node registrator Responsible for the registration and removal of nodes within a Qlik Sense site.
    App manager Responsible for the management of apps within a Qlik Sense site.
    Database cleaner Responsible for the cleaning of the database within a Qlik Sense site.

    Services activation

    Select which services to include. If a service is not installed when trying to activate, the properties will be applied when the installation is complete.

    Service descriptions
    Property Description

    Repository

    The Qlik Sense Repository Service (QRS) is always included.

    Engine

    The Qlik Sense Engine Service (QES).
    Printing The Qlik Sense Printing Service (QPR).

    Proxy

    The Qlik Sense Proxy Service (QPS).

    Scheduler

    The Qlik Sense Scheduler Service (QSS).

    Tags

    Tags properties
    Property Description
    Tags
    Tip: If no tags are available, this property group is empty.

    Connected tags are displayed under the text box.

    Custom properties

    Note: If no custom properties are available, this property group is not displayed at all (or displayed but empty) and you must make a custom property available for this resource type before it will be displayed here.
    Click Apply to save your changes. If a mandatory field is empty, Apply is disabled.
  5. Click Apply in the action bar to create and save the node.

    Successfully added is displayed at the bottom of the page and a dialog with your authorization password appears.

    If you typed the Host name incorrectly the message Node registration failed appears.

    Note: You cannot edit the host name after the node has been created. Create a new node and type the correct host name.
  6. Copy the authorization password and follow the instruction in the dialog to authorize the certificate on the host name machine.

    If successful, the Certificate setup dialog displays The service was successfully unlocked.

  7. Restart the services that you installed on the new node.

You have now created a new node and authorized the certificate to make the node operational.

Load balancing

You can use load balancing to get a more even distribution of the work load between different nodes. On the central node, load balancing is automatically added to the virtual proxy, but on all other nodes you need to configure the virtual proxy with load balancing. If you create a new virtual proxy, you must configure it by adding load balancing and selecting which nodes that the virtual proxy can forward work to.