Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configuring a Junos Space Virtual Appliance as a Junos Space Node

After you deploy a Junos Space Virtual Appliance on a VMware ESX, VMware ESXi, or Kernel-based Virtual Machine (KVM) server, you must enter basic network and machine information to make your Junos Space Virtual Appliance accessible on the network. You must also add disk space to the partitions of the Junos Space Virtual Appliance.

Note:
  • From Junos Space Network Management Platform Release 14.1R2 onward, you can configure Junos Space Ethernet interfaces with only IPv4 addresses, or both IPv4 and IPv6 addresses.

  • From Junos Space Network Management Platform Release 16.1R1 onward, you can configure access to Junos Space through a Network Address Translation (NAT) gateway.

Before you begin, ensure that you have the following information available:

  • IPv4 address and subnet mask for the node management (eth0) Ethernet interface

  • (Optional) IPv6 address and prefix for the eth0 Ethernet interface

  • IPv4 address of the default gateway for the eth0 Ethernet interface

  • (Optional) IPv6 address of the default gateway for the eth0 Ethernet interface

  • IPv4 address of the name server

  • (Optional) IPv6 address of the name server

  • (Optional) IPv4 address and subnet mask for the Ethernet interface eth3, if you are configuring a device management interface.

    Note:

    When you configure the eth3 interface as the device management interface, the IP addresses of the eth0 and eth3 Ethernet interfaces must be in different subnets.

  • (Optional) IPv4 address of the default gateway for the eth3 Ethernet interface

    Note:

    If you configure the IPv4 address for the eth3 Ethernet interface, you must configure the IPv4 address of the default gateway.

  • (Optional) IPv6 address and prefix for the eth3 Ethernet interface

  • (Optional) IPv6 address of the default gateway for the eth3 Ethernet interface

    Note:

    If you configure the IPv6 address for the eth3 Ethernet interface, you must configure the IPv6 address of the default gateway for the eth3 interface.

  • Virtual IP (VIP) address in IPv4 and IPv6 formats

    The IPv4 format of the VIP address is used for accessing the Junos Space Network Management Platform GUI through a Web browser. This IP address must be in the same subnet as the IP address assigned to the eth0 Ethernet interface

    The IPv6 format of the VIP address is used for receiving SNMP traps from managed devices.

  • IPv4 address or URI of the NTP source to synchronize time

  • (Optional) IPv4 address of the eth1 Ethernet interface

    If the IP address of the eth1 interface is not in the same subnet as the VIP address, ensure that you have the subnet mask and the default gateway for the eth1 interface.

  • (Optional) IPv4 address for the NAT outbound SSH

  • (Optional) IPv6 address for the NAT outbound SSH

  • (Optional) IPv4 port number for the NAT outbound SSH

  • (Optional) IPv6 port number for the NAT outbound SSH

  • (Optional) IPv4 address for the NAT trap

  • (Optional) IPv6 address for the NAT trap

  • (Optional) IPv4 port number for the NAT trap

  • (Optional) IPv6 port number for the NAT trap

This topic discusses the following tasks:

Configuring a Junos Space Virtual Appliance

You can configure a Junos Space Virtual Appliance as the first or standalone node in a cluster or add the node to an existing cluster.

To configure a Junos Space Virtual Appliance:

  1. Using a virtual machine client (such as VMware vSphere Client or Virtual Machine Manager [VMM]), log in and power on the Junos Space Virtual Appliance.
  2. Access the console on the virtual machine client to view the Junos Space login prompt.
  3. At the Junos Space login prompt, type admin as your default login name and press Enter.

    You are prompted to enter the administrator password.

  4. Type abc123 as the default administrator password and press Enter.

    Junos Space prompts you to change your default password.

  5. To change the default password, do the following:
    • Type the default password and press Enter.

    • Type your new password and press Enter.

    • Retype your new password and press Enter.

    If the password is changed successfully, the following message is displayed.

    Note:

    You can choose a password that is at least eight characters long and contains characters from at least three of the following four character classes: uppercase letters, lowercase letters, numbers (0 through 9), and special characters.

    However, if a password satisfies the preceding criteria but contains only a single uppercase letter at the beginning or only a single number at the end, then that password is considered invalid. For example, Abcdwip9, Qc9rdiwt, and bRfjvin9 are invalid passwords, but AAbcdwip99, Qc9rdiwtQ, and bRfjvin99 are valid passwords.

    Alternatively, instead of using a string of characters, you can choose a passphrase that is between 16 and 40 characters long and contains at least three dictionary words separated by at least one special character. For example, big#three;fork (14 characters long) and circlefaceglass (no special characters) are invalid passphrases, but @big#three;fork& and circle;face;glass are valid passphrases.

    Passwords and passphrases are case-sensitive.

  6. Enter the new password to log in to Junos Space.
  7. Type S to install the virtual appliance as a Junos Space node.

  8. Configure the IP address for the eth0 interface.
    • To configure the IPv4 address of the eth0 interface:

      1. Type 1.

      2. Type the IPv4 address for eth0 interface in dotted-decimal notation and press Enter.

        Note:

        All nodes that you configure in a cluster (fabric) must be in the same subnet.

      3. Type the subnet mask for the IPv4 address and press Enter.

      4. Type the IPv4 address of the default gateway for the eth0 Ethernet interface in dotted-decimal notation and press Enter.

    • To configure both IPv4 and IPv6 addresses:

      1. Type 2.

      2. Type the IPv4 address for the eth0 interface in dotted-decimal notation and press Enter.

      3. Type a subnet mask for the IPv4 address in dotted-decimal notation and press Enter.

      4. Type the IPv4 address of the default gateway for the eth0 interface in dotted-decimal notation and press Enter.

      5. Type the IPv6 address and prefix for the eth0 interface and press Enter.

        Note:

        If you configure an IPv6 address for the eth0 interface, you must also configure an IPv6 address for the name server.

      6. Type the IPv6 address of the default gateway for the eth0 interface and press Enter.

  9. Type the IPv4 address of the name server for the eth0 interface and press Enter.
  10. Type the IPv6 address of the name server for the eth0 interface and press Enter.
  11. Specify whether you want to configure the eth3 Ethernet interface.
    Note:
    • On a Junos Space fabric with two or more Junos Space nodes, if you configure the eth3 interface as the device management interface on one Junos Space node, then you must also configure the eth3 interface as the device management interface on all the other Junos Space nodes in that fabric.

    • When you configure the eth3 interface as the device management interface, the IP addresses of the eth0 and eth3 Ethernet interfaces must be in different subnets.

    • Type Y if you want to use a different Ethernet interface (eth3) to manage devices.

      • To configure the IPv4 address of the eth3 interface:

        1. Type 1.

        2. Type the IPv4 address for eth3 interface in dotted-decimal notation and press Enter.

        3. Type the new subnet mask of the IPv4 address in dotted-decimal notation and press Enter.

        4. Type the IPv4 address of the default gateway for the eth3 Ethernet interface in dotted-decimal notation and press Enter.

        5. Type the IPv4 address of the name server for the eth3 interface and press Enter.

      • To configure the IPv6 address of the eth3 interface:

        1. Type 2.

        2. Type the IPv6 address with prefix for the eth3 interface.

        3. Type the IPv6 address of the default gateway for the eth3 interface.

        4. Type the IPv6 address of the name server for the eth3 interface and press Enter.

      • To configure both IPv4 and IPv6 addresses:

        1. Type 3.

        2. Type the IPv4 address for the eth3 interface in dotted-decimal notation and press Enter.

        3. Type a subnet mask for the IPv4 address in dotted-decimal notation and press Enter.

        4. Type the IPv4 address of the default gateway for the eth3 interface in dotted-decimal notation and press Enter.

        5. Type the IPv6 address and prefix for the eth3 interface and press Enter.

          Note:

          You must provide an IPv6 address for the name server if you configure an IPv6 address for the eth3 interface.

        6. Type the IPv6 address of the default gateway for the eth3 interface and press Enter.

        7. Type the IPv4 address of the name server for the eth3 interface and press Enter.

        8. Type the IPv6 address of the name server for the eth3 interface and press Enter.

    • Type N if you want to use only the Ethernet interface eth0 to manage devices and the Junos Space Web clients.

  12. Specify whether you want to configure the node as a standalone node or you want to add it to an existing cluster.
    • To add the node to an existing cluster, type y.

      You are prompted to specify whether you want to configure NAT. Follow the procedure outlined in Configuring Access to Junos Space Through a NAT Gateway.

    • To configure the node as a standalone node, type n.

      You are prompted to enter the IP address for Web access.

      Note:

      If you configure only an IPv4 address for the eth0 interface, you are provided with an option to configure only the IPv4 address for Web access.

      1. Type 1 to configure the IPv4 and IPv6 addresses that will be used to access Junos Space Platform through a browser.

        Note:

        The IP address for Web access must be in the same subnet as the IP address for the eth0 interface, but must be a different IP address.

      2. Type the IPv4 address in dotted-decimal notation and press Enter.

      3. Type the IPv6 address and press Enter.

        You are prompted to specify whether you want to configure NAT.

      4. Follow the procedure outlined in Configuring Access to Junos Space Through a NAT Gateway.

        You are then prompted to configure the NTP server.

      5. Specify whether you want to configure the NTP server and time for the Junos Space node:

        • To skip configuring the NTP server:

          1. Type n.

            The current time of the Space node is displayed. You can edit the time or leave it as is.

          2. Press Enter.

        • To configure the NTP server:

          1. Type y to synchronize the node with an external NTP server and press Enter.

            You are prompted to enter the new NTP server.

          2. Enter the IP address or the URI of the NTP server.

            On successful addition of the NTP server, a message appears as shown in the following sample:

        You are prompted to enter a display name for the node.

      6. Type a display name for this node and press Enter.

        This is the name that Junos Space displays for the first node in a Junos Space cluster.

      7. Type the password for cluster maintenance mode and press Enter.

        Note:
        • You can choose a password that is at least eight characters long and contains characters from at least three of the following four character classes: uppercase letters, lowercase letters, numbers (0 through 9), and special characters. Ab(3)def, o0*wwrty, and 9Rtsgukj are some examples of valid password for maintenance mode.

        • When you configure the other nodes in a cluster (fabric), you are not prompted to enter a maintenance-mode password. The maintenance-mode password that you specify when you configure the first node of the cluster is applicable to all other nodes in that cluster (fabric); in other words, the entire cluster of nodes has the same maintenance-mode password.

        You are prompted to retype the password.

      8. Retype the password for cluster maintenance mode and press Enter.

        You are prompted to specify whether you want to restore backed up data.

      9. Perform one of the following actions depending on whether you are upgrading Junos Space Platform on the node or configuring a new Junos Space node.

        • Type Y to restore backed up data if you are upgrading Junos Space Platform.

          A message is displayed, warning you to wait till the backed up data is completely restored and all required Junos Space services are started on the node before attempting to access the Web GUI.

          The Settings Summary is displayed, as shown in the following example:

          1. Type A and press Enter to apply settings.

            You are prompted to specify the location from where you want to restore the backup.

          2. Select one of the following options depending on where the backup file is stored:

            • To restore from a remote SCP server:

              1. Type 1 and press Enter.

                You are prompted to confirm if you want to proceed with restoring the backup from the remote server.

              2. Type Y to continue.

                You are prompted to enter the IPv4 address of the remote server.

              3. Type the IPv4 address of the remote server and press Enter.

                You are prompted to enter the port number of the remote server.

              4. Enter the port number of the remote server and press Enter.

                You are prompted to enter the username to access the remote server.

              5. Type the username and press Enter.

                You are prompted to enter the password of the user.

              6. Type the password and press Enter.

                You are prompted to enter the full path of the directory where the backup file is stored.

              7. Type the full path of the directory and press Enter.

                The messages displayed on the console indicate whether the data is restored successfully to the Junos Space node.

            • To restore from a USB storage device:

              Note:

              Before you restore from a USB storage device, you must ensure that the USB storage device is plugged-in and mounted to the path /tmp/pendrive.

              1. Type 2 and press Enter to restore the backup from the USB storage device.

                You are prompted to confirm if you want to proceed with the backup from the USB storage device.

              2. Type Y to continue.

                The messages displayed on the console indicate whether the data is restored successfully to the Junos Space node.

              3. Unmount the USB storage device by typing the following command:

                umount /tmp/pendrive

                You can unplug the USB storage device after you unmount it.

            • To restore from a local drive:

              Note:

              To restore data from a local drive, you must first copy the backup file from the backup location to the Junos Space node.

              1. Type 3 and press Enter.

                You are prompted to confirm if you want to proceed with the backup from the local drive.

              2. Type Y to continue.

                You are prompted to enter the full path of the directory where the back up file is stored.

              3. Type the full path of the directory and press Enter.

                The messages displayed on the console indicate whether the data is restored successfully to the Junos Space node.

          When the data is restored successfully, JBoss services are started on the node and you can access the Junos Space Platform UI through a browser by using the virtual IP (VIP) address configured for Web access.

          The Junos Space Settings menu is displayed at this point of time after the data is restored and the services restarted.

        • Type N if you are configuring the first node of a fresh Junos Space Platform 16.1R1 or later installation and not upgrading Junos Space Platform.

          A message indicating that you have opted for a fresh installation of Junos Space Platform is displayed. You are prompted to specify whether you want to continue.

          • Perform one of the following actions:

            • Type Y to proceed with the fresh installation.

            • Type N if you do not want to proceed with the fresh installation.

              You are prompted to specify whether you want to restore backed up data.

              • Type Y to restore backed up data and go to Step 12.i.

              • Type N to proceed with the fresh installation.

                You are again prompted to confirm whether you want to proceed with a fresh installation. Type Y to confirm.

          The Settings Summary is displayed, as shown in the following example:

          • If the summary information is correct, type A to apply the settings.

            The Junos Space Settings Menu is displayed, as shown in the following example:

          • If the summary information is not correct, type C to change the settings.

            You are prompted to reenter all the basic configuration information that you have configured up to this point.

  13. (Optional) Expand the VM drive size.
    Note:

    Before expanding the VM drive size, ensure enough disk space is available on the host for allocation to the partitions of the virtual appliance. If no free space is available on the host for allocation, the No free disk space message appears and the Junos Space Settings Menu is displayed.

    1. Type 6 to expand the VM drive size.
    2. Enter the admin password.

      The following caution appears:

    3. Type y to continue expanding the drive size or type n to return to the Junos Space Settings Menu.

      If you type y, you are prompted to specify the partition that you want to expand.

    4. Enter the number present against the partition that you want to expand; for example, type 1 to expand the / partition or 5 to quit expanding disks and return to the Junos Space Settings Menu.

      The free space that can be allocated is displayed and you are prompted to enter the space that you want to allocate to the partition.

    5. Enter the additional disk space that you want to allocate.

      You can enter the disk space in megabytes (M), gigabytes (G), or terabytes (T). Do not add a space between the number and the unit; for example, enter 50M and not 50 M, 10G and not 10 G, and so on.

      You are prompted whether you want to expand more drives.

    6. Type y to continue adding disk space or n to return to the Junos Space Settings Menu.

      When you type n, the node is rebooted and the JBoss and MySQL processes that were stopped are resumed. If the VM drive size was expanded on a primary node, the node becomes secondary when it comes up.

  14. Type Q and press Enter to exit the Junos Space Settings Menu.

    The configuration of the Junos Space Virtual Appliance is now complete. It takes approximately 20 to 30 minutes after the configuration for the Junos Space Network Management Platform GUI to be up. You can access the Junos Space Network Management Platform by using a Web browser. Use super as the default username and juniper123 as the password.

Note:
  • If you have specified that the Junos Space node is the first node in the fabric or a standalone node, you can access Junos Space Network Management Platform by typing the IP address configured for the Web GUI in a browser.

  • If you have specified that the Junos Space node is part of an existing cluster (fabric), then you must add the Junos Space node to the Junos Space fabric using the Junos Space Network Management Web GUI. For more information, see the Adding a Node to an Existing Junos Space Fabric topic in the Junos Space Network Management Platform User Guide (available at https://www.juniper.net/documentation).

Configuring Access to Junos Space Through a NAT Gateway

Starting Junos Space Platform Release 16.1R1, you can choose to configure access to Junos Space through a NAT gateway when you are configuring a Junos Space node.

When prompted, specify whether you want to configure access to Junos Space using NAT.

  • To configure NAT, type Y.

    Note:
    • If you choose to configure NAT, the options that are displayed depend on the IP address or addresses that you have configured for the device management interface. If you have configured eth3 as the device management interface, then the options that are displayed will depend on the IP address or addresses configured for eth3. If eth3 is not configured, the displayed options will depend on the IP address configuration of the eth0 interface.

    • If the device management interface is assigned an IPv4 address, you are prompted to enter the IPv4 address for the NAT interfaces. If the device management interface is assigned an IPv6 address, you are prompted to enter the IPv6 address for the NAT interfaces. If the device management interface is assigned an IPv4 address and an IPv6 address, you are prompted to select either IPv4, IPv6, or both for the NAT interfaces.

    • If you are adding the node to an existing cluster and eth3 is configured, you are prompted to specify whether you want to configure the trap interface. You must choose to configure the trap interface, if you are adding the node as the standby VIP node. If eth3 is not configured for the node, you are not prompted to configure the trap interface.

    You are prompted to configure NAT IP addresses.

    • To configure the IPv4 address:

      1. Type 1 and press Enter.

      2. Type the IPv4 address of the NAT outbound SSH interface and press Enter.

      3. Type the port number of the NAT outbound SSH interface and press Enter.

        The port number must be in the range 0-65535.

      4. Type the IPv4 address of the NAT trap interface and press Enter.

        The IP address must be in the range 1.0.0.1 - 223.255.255.254 excluding 127.x.x.x.

      5. Type the port number of the NAT trap interface and press Enter.

    • To configure the IPv6 address:

      1. Type 2 and press Enter.

      2. Type the IPv6 address of the NAT outbound SSH interface and press Enter.

      3. Type the port number of the NAT outbound SSH interface and press Enter.

        The port number must be in the range 0-65535.

      4. Type the IPv6 address of the NAT trap interface and press Enter.

        The IP address must be in the range 1.0.0.1 - 223.255.255.254 excluding 127.x.x.x

      5. Type the port number of the NAT trap interface and press Enter.

    • To configure IPv4 and IPv6:

      1. Type 3 and press Enter.

      2. Type the IPv4 address of the NAT outbound SSH interface and press Enter.

        The IP address must be in the range 1.0.0.1 - 223.255.255.254 excluding 127.x.x.x.

      3. Type the port number of the NAT outbound SSH interface and press Enter.

        The port number must be in the range 0-65535.

      4. Type the IPv4 address of the NAT trap interface and press Enter.

        The IP address must be in the range 1.0.0.1 - 223.255.255.254 excluding 127.x.x.x.

      5. Type the port number of the NAT trap interface and press Enter.

        The port number must be in the range 0-65535.

      6. Type the IPv6 address of the NAT outbound SSH interface and press Enter.

      7. Type the port number of the NAT outbound SSH interface and press Enter.

        The port number must be in the range 0-65535.

      8. Type the IPv6 address of the NAT trap interface and press Enter.

        The IP address must be in the range 1.0.0.1 - 223.255.255.254 excluding 127.x.x.x.

      9. Type the port number of the NAT trap interface and press Enter.

        The port number must be in the range 0-65535.

  • If you do not want to configure NAT, type N and press Enter.

If you are configuring a standalone node, you are prompted to configure the NTP server. Go to Step 12.e.

If you are configuring a node to be added to an existing cluster, the Settings Summary is displayed, as shown in the following example:

  • If the summary information is correct, type A to apply the settings.

    The Junos Space Settings Menu is displayed, as shown in the following example:

  • If the summary information is not correct, type C to change the settings.

    You are prompted to reenter all the basic configuration information that you have configured up to this point.

  • To quit the configuration without applying the settings, type Q.

    The Junos Space Settings Menu is displayed.

    CAUTION:

    If you quit the configuration without applying the settings, then all the settings are discarded.

Configuring the eth1 Ethernet Interface

You use the eth1 Ethernet interface as the administrative interface for a Junos Space node. Configure the eth1 interface after the Junos Space node reboots after completing the basic configuration.

Note:
  • The eth1 interface must be configured separately for each node in a multinode fabric.

  • If you configure the eth1 interface, SSH is disabled on the eth0 and the eth3 interfaces. You can then access the CLI of the Junos Space virtual appliance only through the eth1 interface.

To configure the eth1 interface:

  1. On the Junos Space Settings Menu, type 7 to access the shell.

    You are prompted to enter your password.

  2. Type your password and press Enter.

    The shell prompt appears.

  3. At the shell prompt, type jmp_config and press Enter.

    You are prompted to enter the IP address of the eth1 interface.

  4. Type the IP address of the eth1 interface in dotted-decimal notation and press Enter.

    The IP address can be in the same subnet as the virtual IP (VIP) address or in a different subnet. If the IP address is not in the same subnet as the VIP address, you are prompted to enter the subnet mask and then the default gateway for the eth1 interface.

  5. (Optional) Type the subnet mask for the eth1 interface in dotted-decimal notation and press Enter.
  6. (Optional) Type the default gateway in dotted-decimal notation and press Enter.

    The eth1 interface is configured.

  7. To verify that the eth1 address is configured, run the ifconfig eth1 command and check that the IP address displayed for eth1 is the same as the one that you configured.

    You can now access the Junos Space node through the eth1 interface to perform administrative tasks.

To troubleshoot issues in configuring the eth1 interface, refer to the /var/log/changeEth1.log file.

Release History Table
Release
Description
16.1R1
From Junos Space Network Management Platform Release 16.1R1 onward, you can configure access to Junos Space through a Network Address Translation (NAT) gateway.
16.1R1
Starting Junos Space Platform Release 16.1R1, you can choose to configure access to Junos Space through a NAT gateway when you are configuring a Junos Space node.