Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Adding a Node to an Existing Junos Space Fabric

When you configure a JA2500 Junos Space Appliance JA2500) or a Junos Space Virtual Appliance as a Junos Space node by using the Junos Space CLI, Junos Space Network Management Platform automatically adds the first node to the fabric. By default, the Junos Space fabric contains this single node that provides complete Junos Space Platform functionality. For each additional node that you install and configure, you must add the node from the Junos Space Platform UI to represent the node in the fabric.

Before you begin, the following prerequisites must be in place:

  • Multicast must be enabled on the switches to which Junos Space nodes are connected.

  • IGMP-snooping needs to be disabled on the switches to which Junos Space nodes are connected. By default, IGMP-snooping is enabled on most switches.

  • All Junos Space nodes must be interconnected using a high-speed (1-Gbps or 100-Mbps) network with a maximum latency not exceeding 300 milliseconds.

Using the Junos Space CLI, you can configure a Junos Space Appliance or a Junos Space Virtual Appliance either as a Junos Space node or a Fault Monitoring and Performance Monitoring (FMPM) node. If you want to add a node to the fabric as a dedicated database node,it must be configured as a Junos Space node.

For information about how to configure a Junos Space Virtual Appliance as a Junos Space node, see Configuring a Junos Space Virtual Appliance as a Junos Space Node in the Junos Space Virtual Appliance Installation and Configuration Guide and for information about how to configure a JA2500 appliance as a Junos Space node, see Configuring a Junos Space Appliance as a Junos Space Node in the JA2500 Junos Space Appliance Hardware Guide.

For information about how to configure a Junos Space Virtual Appliance as an FMPM node, see Configuring a Junos Space Virtual Appliance as a Standalone or Primary FMPM Node or Configuring a Junos Space Virtual Appliance as a Backup or Secondary FMPM Node for High Availability in the Junos Space Virtual Appliance Installation and Configuration Guide. For information about how to configure a JA2500 appliance as an FMPM node, see Configuring a Junos Space Appliance as a Standalone or Primary FMPM Node or Configuring a Junos Space Appliance as a Backup or Secondary FMPM Node for High Availability in the JA2500 Junos Space Appliance Hardware Guide.

Note:

If you want to change an existing Junos Space node to an FMPM node or vice versa, you must reimage the appliance and reconfigure it as an FMPM node or a Junos Space node. For more information, refer to the Junos Space Appliance and Junos Space Virtual Appliance documentation.

Note:

Starting in Junos Space Network Management Platform Release 21.3R1, the AppLogic node restarts, when the Add Node jobs for JBoss and database nodes are successful. This is not applicable for Fault Monitoring and Performance Monitoring (FMPM) node.

Note:

Before you add a node to the Junos Space fabric, verify the following:

  • The version of Junos Space Platform installed on the node is the same as the version installed on other nodes in the fabric.

  • Ensure that no jobs are pending.

  • If a Junos Space node, a database node, or an FMPM node that is part of an existing fabric is deleted, then you need to reimage the node before the node can be readded to the fabric. Junos Space displays the following message when you try to add such nodes to an existing fabric:The node you are trying to add was part of another fabric, please re-image the node before adding to this fabric.

  • Ensure that you are not adding a non-FMPM node as an FMPM node. Junos Space Platform displays the following message when you try to add such a node to the fabric: Node agent is not running on {0}. Please make sure the node being added is not a specialized node.

From the Junos Space Platform UI, you can add a node to the Junos Space fabric by executing one of the following procedures, based on whether you have configured the node as a Junos Space node or as an FMPM node.

Adding a Junos Space Node to the Junos Space Fabric

To add a Junos Space node to the fabric:

  1. On the Junos Space Platform UI, select Administration > Fabric.

    The Fabric page appears.

  2. Click the Add Fabric Node icon.

    The Add Node to Fabric page appears.

  3. Click the appropriate option button in the Node Type field to select the type of node you want to add.
    Note:

    The options that are displayed depend on the number and type of nodes that are already part of the fabric.

    Table 1 describes the options that you can select while adding Junos Space nodes.

    Table 1: Number of Existing Nodes and Permitted Node Types

    Number of Nodes Existing in the Fabric

    Permitted Node Types

    Description

    One

    JBoss and DB Node

    DB Node

    When you add the second Junos Space node to the default single-node Junos Space fabric, you can add the new node as a JBoss and database node (standby load-balancer server), or the second and third nodes together as database nodes.

    In the case of database nodes, one node is designated the primary database node, and the other the secondary database node. The database VIP address must also be configured to enable database high availability.

    Two

    JBoss Node

    DB Node

    When you add nodes to a two-node Junos Space fabric, Junos Space Platform allows you to add a JBoss node, or two nodes as database nodes.

    In the case of database nodes, one node is designated the primary database node, and the other the secondary database node. The database VIP address must also be configured to enable database high availability. If the Junos Space fabric already has one database node added, then you can add either a JBoss-only node or one database node as the secondary database node. The database node already existing in the fabric is the primary database node.

    Three or more—With one or no database node configured

    JBoss Node

    DB Node

    When you add nodes to a Junos Space fabric with three or more nodes, with no database nodes added, Junos Space Platform allows you to add a JBoss node,or two nodes as database nodes.

    If the Junos Space fabric already has one database node added, then you can add a JBoss node, or one database node as the secondary database node. The database node already existing in the fabric is the primary database node.

    Three or more—With two database nodes configured

    JBoss Node

    When you add nodes to a Junos Space fabric with three or more nodes, with two database nodes already configured, Junos Space Platform allows you to add either a JBoss node. You cannot add more than two database nodes to the fabric.

  4. Perform one of the following procedures, based on the type of node you selected:
    • For the JBoss and DB Node, and JBoss Node options, perform the following steps:

      1. Enter a name for the node in the Name text box.

        The name of the fabric node cannot exceed 32 characters and cannot contain spaces.

      2. Enter the IP address of the node in the IP address field.

        This is the IP address for the eth0 interface that you specified during the basic configuration of the appliance.

      3. Enter the username in the User field.

      4. Enter the password in the Password field.

        Note:

        The login credentials that you specify in the User and Password fields must be the same username and password that you specified for SSH access using the Junos Space CLI during the initial installation and configuration of the node. If the credentials do not match, the node is not added.

      5. (Optional) Enter the fingerprint for the node in the Fingerprint field.

        Note:

        To obtain the fingerprint of a node, see Obtaining Fingerprint of a Junos Space Node.

    • For the DB Node option, perform the following steps:

      • In the Primary database section:

        Note:

        If you already have a database node as part of the fabric, the Primary database section does not appear. The existing database node is the primary database node and you can add only a secondary database node to the fabric.

        1. Enter a name for the primary database node in the Name text box.

          The name of the fabric node cannot exceed 32 characters and cannot contain spaces.

        2. Enter the IP address of the primary database node in the IP address field.

          This is the IP address for the eth0 interface that you specified during the basic configuration of the appliance.

        3. Enter the username in the User field.

        4. Enter the password in the Password field.

          Note:

          The login credentials that you specify in the User and Password fields must be the same username and password that you specified for SSH access using the Junos Space CLI during the initial installation and configuration of the node. If the credentials do not match, the node is not added.

        5. (Optional) Enter the fingerprint for the node in the Fingerprint field..

          Note:

          To obtain the fingerprint of a node, see Obtaining Fingerprint of a Junos Space Node.

        6. Enter the VIP address for the database nodes in the VIP field.

          The VIP address is used for communication between Junos Space nodes and database nodes. This IP address must be in the same subnet as the IP address assigned to the eth0 Ethernet interface, and the database VIP address must be different from the VIP address used to access the Web GUI and the FMPM nodes.

      • In the Secondary database section:

        1. Enter a name for the secondary database node in the Name text box.

          The name of the fabric node cannot exceed 32 characters and cannot contain spaces.

        2. Enter the IP address of the secondary database node in the IP address field.

          This is the IP address for the eth0 interface that you specified during the basic configuration of the appliance.

        3. Enter the username in the User field.

        4. Enter the password in the Password field.

          Note:

          The login credentials that you specify in the User and Password fields must be the same username and password that you specified for SSH access using the Junos Space CLI during the initial installation and configuration of the node. If the credentials do not match, the node is not added.

        5. (Optional) Enter the fingerprint for the node in the Fingerprint field..

          Note:

          To obtain the fingerprint of a node, see Obtaining Fingerprint of a Junos Space Node.

  5. (Optional) Select the Schedule at a later time check box to specify a later date and time when you want the node to be added.

    If you do not specify a date and time for adding the node, the node is added to the fabric when you complete this procedure and you click Add on the Add Node to Fabric page.

    1. Click the calendar icon and select the date.
    2. Click the arrow beside the time list and select the time.
    Note:

    The selected time in the scheduler corresponds to the Junos Space server time but is mapped to the local time zone of the client computer.

  6. Click Add to add the node to the fabric.

    The Job Information dialog box appears, with a message indicating that the job to add the node is successfully scheduled. You can click the job ID link that is displayed in the dialog box to view job details. You can also navigate to the Job Management page to view job details.

  7. Click OK.

    You are returned to the Fabric page.

    The node is added to the fabric and appears on the Fabric page. When you add a node, the node functions are automatically assigned by Junos Space Platform.

Adding an FMPM Node to the Junos Space Fabric

To add an FMPM node to the fabric:

  1. On the Junos Space Platform UI, select Administration > Fabric.

    The Fabric page appears.

  2. Click the Add Fabric Node icon.

    The Add Node to Fabric page appears.

  3. Click the Specialized Node option button in the Node Type field to add an FMPM node.
  4. Enter a name for the node in the Name text box.

    The name of the fabric node cannot exceed 32 characters and cannot contain spaces.

  5. Enter the IP address of the node in the IP address field.
    Note:

    This is the IP address for the eth0 interface that you specified during the basic configuration of the appliance.

  6. Enter the SSH username for the FMPM node in the User field.
  7. Enter the password in the Password field.

    The login credentials (SSH username and password) of the FMPM node that you specify in the User and Password fields must be the same username and password that you specified when you initially configured the node from the Junos Space CLI. If the credentials do not matcjh, the node is not added.

  8. (Optional) Enter the fingerprint for the node in the Fingerprint field.
    Note:

    To obtain the fingerprint of a node, see Obtaining Fingerprint of a Junos Space Node.

  9. (Optional) Select the Schedule at a later time check box to specify a later date and time when you want the node to be added.

    If you do not specify a date and time for the node to be added, the node is added to the fabric when you complete this procedure and you click Add on the Add Node to Fabric page.

    1. Click the calendar icon and select the date.
    2. Click the arrow beside the time list and select the time.
    Note:

    The selected time in the scheduler corresponds to the Junos Space server time but is mapped to the local time zone of the client computer.

  10. Click Add to add the node to the fabric.

    The Job Information dialog box appears, with a message indicating that the job to add the node is successfully scheduled. You can click the job ID link that is displayed in the dialog box to view job details. You can also navigate to the Job Management page to view job details.

  11. Click OK.

    You are returned to the Fabric page.

The node is added to the fabric and appears on the Fabric page. When you add a node, the node functions are automatically assigned by Junos Space Platform.

Obtaining Fingerprint of a Junos Space Node

In a Junos Space cluster, the fingerprint of a node helps in authenticating and authorizing the node.

Starting from Junos Space Network Management Platform Release 17.1R1, the Fingerprint field is introduced to authenticate and authorize a node before adding the node to a Junos Space cluster.

To obtain the fingerprint of a Junos Space node:

  1. Log in to access the command prompt of the node.

    The Junos Space Settings menu appears.

  2. Type 6 if the node is a JA2500 appliance or type 7 if the node is a Junos Space Virtual Appliance to access the shell.

    You are prompted to enter the administrator password.

  3. Enter the administrator password for the node..

    The shell prompt appears.

  4. Enter the ssh-keygen -lf /etc/ssh/ssh_host_rsa_key -E md5 command as shown below to obtain the fingerprint of the node:

    The node outputs its fingerprint as shown below:

    MD5:xx:xx:xx:00:00:00:0x:xx:x0:x0:00:00:x0:xx:00:x0:00 is the fingerprint in the MD5 format.

    Note:

    Do not include MD5: when you enter fingerprint in the Fingerprint field while adding the node to a cluster.

Release History Table
Release
Description
17.1R1
Starting from Junos Space Network Management Platform Release 17.1R1, the Fingerprint field is introduced to authenticate and authorize a node before adding the node to a Junos Space cluster.