Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Changing Network and System Settings for a Junos Space Appliance

 

You can use the Junos Space CLI to change the network and system settings for a Junos Space Appliance configured as a Junos Space node or a fault monitoring and performance monitoring (FMPM) node. You can perform the following tasks using the Junos Space CLI:

  • Change the default user (admin) password.

  • Change network settings such as DNS, virtual IP (VIP) address, and so on.

  • Change the time zone and NTP time server.

  • Retrieve and transfer system log files.

  • Change SSH and firewall settings.

  • Run shell commands.

Note

An openNMS user does not have permission to modify the Junos Space Settings.

Before you begin:

  • Ensure that you have connected a management device (PC or laptop) to the appliance using the management console, and that both the appliance and the management device are powered on. Alternatively, you can connect to the appliance via telnet or SSH if the appliance is accessible via the network.

  • Ensure that you have logged in to the appliance using the administrator username (admin) and password.

When you log in to the appliance, the Junos Space Settings Menu appears as follows:

Note

Password changes take effect immediately. Any other changes that you make to the settings do not take effect until you apply the changes. You can apply the changes from the Junos Space Settings Menu or any sub-menu by typing A at the prompt. Irrespective of the menu or sub-menu that you are in when you apply changes, all changes to the appliance settings are applied.

This topic includes the following sections:

Changing the Password for the Default User

You can change the password for the default user (admin) for the Junos Space Appliance. To change the password, do the following:

  1. On the Junos Space Settings Menu, type 1 at the prompt.
  2. Type y when you are prompted to change the password for the admin user.
  3. Type the current password and press Enter.Note
    • All passwords are case-sensitive.

    • You can choose a password that is at least eight characters long, and that 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. In order to be counted as a valid character class, a single uppercase letter must not be at the beginning of the password, and a single number must not be at the end. 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.

  4. Type the new password and press Enter.
  5. Retype the new password and press Enter.

    If the password change is successful, a message is displayed and you are taken to the Junos Space Settings Menu.

Changing Network Settings

You can change the following network settings for your Junos Space Appliance:

  • DNS servers

  • Virtual IP address of the Junos Space node or FMPM node, Ethernet interface parameters, and NAT configuration

  • Static routes

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.

  • On a multinode fabric, we recommend that you modify the network settings by using the Junos Space Network Management Platform GUI.

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

To change the network settings, do the following:

  1. On the Junos Space Settings Menu, type 2 at the prompt.

    The Change Network Settings menu is displayed.

  2. (Optional) To add or delete DNS servers, type 1 at the prompt on the Change Network Settings menu.

    The DNS name server options menu is displayed. You can do the following:

    • Type 1 to add the DNS server by entering the IP address in IPv4 format or type 2 to add the DNS server by entering the IP address in IPv6 format and follow the prompts on the CLI.

      After the DNS server is added, a message is displayed indicating that the change has been queued. Changes must be applied before you quit the CLI.

      Note

      You can add up to three DNS servers.

    • To delete an existing DNS server, type the number corresponding to the DNS server that you want to delete, and follow the prompts on the CLI.

  3. (Optional) To change the virtual IP address, Ethernet interface parameters, and NAT configuration, type 2 in the Change Network Settings menu.Note

    If the node is configured to be part of a Junos Space cluster, but is not yet added to the cluster from the Junos Space Platform UI, you can modify only the NAT configuration. The NAT configuration option is displayed even if NAT settings are not specified during the initial configuration of the node.

    You can do the following:

    • To modify the virtual IP (VIP) address, type 1 and follow the prompts on the CLI.

      Note

      For nodes in a Junos Space fabric, you can modify a VIP address from any node in the fabric.

    • To modify the settings of the Ethernet interface eth0, type 2 and follow the prompts on the CLI.

      You can change the IP address of the node, the subnet mask, and the default gateway.

    • To modify the settings of the Ethernet interface eth3, type 3 and follow the prompts on the CLI.

      You can change the IP address of the node, the subnet mask, and the default gateway.

      Note
      • The Change Device Management Interface option is available only if a device management interface (eth3) was specified during the initial configuration of the appliance.

      • 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.

    • To modify the NAT configuration, type 4 or 1, depending on the menu options displayed, and follow the prompts on the CLI.

      Note
      • The NAT configuration must not be modified in combination with the other changes that require a reboot of the node. If the node is rebooted, the NAT configuration is discarded. In such cases, modify the settings that require a reboot, reboot the node and then modify the NAT configuration.

      • If you modify only the NAT IPv4 or IPv6 address of a virtual appliance configured to be part of a Junos Space cluster, but yet to be added to the cluster from the Junos Space Platform UI, the last specified IP address overwrites the IP address configured during initial configuration. For example, if the virtual appliance was initially configured with a NAT IPv4 address and while modifying the network settings, you specify an IPv6 address, then the IPv4 address is discarded and the IPv6 address is used for the NAT gateway. If both IPv4 and IPv6 are configured initially, then only the IP address that is modified is updated.

  4. (Optional) To add or delete a static route, type 3 at the prompt on the Change Network Settings menu.

    On the subsequent menu, you can do the following:

    • To add a static route, type 1 and follow the prompts on the CLI.

      Note

      We recommend that you ensure that the access to the gateway is available before adding a static route.

    • To delete an existing static route, type the number corresponding to the static route that you want to delete, and follow the prompts on the CLI.

  5. Type A to apply all the changes that you made, or type M to return to the Junos Space Settings Menu without applying the changes.

Modifying the IP Address of the eth1 Interface

You may need to modify the IP address of the eth1 interface of a Junos Space Appliance when you move the Junos Space Appliance from one network to another.

Note

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 appliance only through the eth1 interface.

To modify the eth1 interface settings:

  1. On the Junos Space Settings Menu, type 6 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 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 the modified IP address of the eth1 interface, run the ifconfig eth1 command and check that the IP address displayed for eth1 is the same as that you modified.

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

Changing the Time Zone and NTP Servers

You can change the time zone, add or delete an NTP server, and enable or disable an NTP server. When you configure each Junos Space Appliance with an NTP server, you ensure that if the first node, which is used to synchronize time for all nodes in the fabric, goes down, all other nodes in the fabric remain synchronized. To ensure this behavior, all nodes in a fabric should be configured with the same external NTP server that you configured for the first appliance.

To change the time zone and NTP servers for your Junos Space Appliance, do the following:

  1. On the Junos Space Settings Menu, type 3 at the prompt.

    The Change Time Options menu is displayed.

  2. (Optional) To change the time zone, type 1 and follow the prompts on the CLI.
  3. (Optional) To modify NTP servers, type 2.

    You are taken to the NTP options menu. You can do the following:

    • Type 1 to disable or enable an NTP server, depending on whether the NTP server is enabled or disabled, and follow the prompts on the CLI.

    • Type 2 to add an NTP server, and follow the prompts on the CLI.

    • Type 3 to delete an NTP server, and follow the prompts on the CLI.

      The option to delete an NTP server is available only if the appliance has two or more NTP servers already configured.

  4. Type A to apply all the changes that you made, or type M to return to the Junos Space Settings Menu without applying the changes.

Retrieving and Transferring System Log Files

You can retrieve system log files using Secure Copy Protocol (SCP) if the network is functional, or a USB device if the network is down.

Note

To save the system log files to a USB device, the device must be connected to the Junos Space Appliance.

To retrieve system log files, do the following:

  1. On the Junos Space Settings Menu, type 4 at the prompt.
  2. On the subsequent menu, you can do the following:
    • To save the log files to a USB device, type 1 and follow the prompts on the CLI.

      Junos Space Network Management Platform retrieves the log files on all cluster (fabric) nodes and combines the log files into a tar file. After the file is created, you can copy the file onto a USB device.

    • Alternatively, to transfer the log files using SCP, type 2 and follow the prompts on the CLI.

      Junos Space Network Management Platform retrieves the log files on all cluster (fabric) nodes and combines the log files into a tar file. After the file is created, you can transfer the file to a remote server.

  3. Type A to apply all the changes that you made, or type M to return to the Junos Space Settings Menu without applying the changes.

Changing Firewall and SSH Settings

By default, the firewall and SSH are enabled on the Junos Space Appliance.

To change the firewall and SSH settings, do the following:

  1. On the Junos Space Settings Menu, type 5 at the prompt.
  2. (Optional) To change the firewall setting:
    • If the firewall is currently enabled, type 1 to disable the firewall.

    • If the firewall is currently disabled, type 1 to enable the firewall.

  3. (Optional) To change the SSH setting:
    • If SSH is currently enabled, type 2 to disable SSH.

    • If SSH is currently disabled, type 2 to enable SSH.

  4. Type A to apply all the changes that you made, or type M to return to the Junos Space Settings Menu without applying the changes.

Accessing the Shell

You can access a shell and run shell commands that can help during debugging. Do the following:

  1. On the Junos Space Settings Menu, type 6 at the prompt.

    You are prompted to enter a password.

  2. Type the password for the administrator (admin user).

    You are taken to a shell where you can run commands. When you are in shell mode, the prompt is of the format [root@identifier ~]# format, where identifier is a unique identifier for the node.

  3. To exit the shell, type exit and press Enter.

    You are taken to the Junos Space Settings Menu.

Applying or Cancelling Changes to Settings

Changes to the appliance settings are not applied immediately but are queued in the order that you made the changes. You must explicitly apply the changes before quitting the Junos Space CLI so that the changes to the appliance settings are made. Alternatively, you can choose to cancel some or all changes that you made.

To apply all changes or cancel one or more changes, do one of the following:

  • To apply all changes, type A.

    The changes are applied and you are taken to the Junos Space Settings Menu.

    Note

    For some changes, you may be asked to enter your administrator password before the change is applied.

  • To cancel a change, type the number corresponding to that change, and follow the prompts on the CLI.

  • To cancel all changes and quit the console session, type C.