Cisco Catalyst Center Third-Generation Appliance Installation Guide, Release 3.1.x

PDF

Configure a secondary node using the Advanced Install configuration wizard

Want to summarize with AI?

Log in

Overview

You can add additional nodes to a cluster using the Advanced Install configuration wizard.

Follow the steps to configure the second and third appliances in the cluster using the Advanced Install configuration wizard.

  • In order to build a three-node cluster, the same version of the System package must be installed on your three Catalyst Center appliances. Otherwise, unexpected behavior and possible downtime can occur.

  • The third-generation 80-core Catalyst Center appliance (Cisco part number DN3-HW-APL-XL) supports configuration using this wizard.

  • You can only use this wizard to complete the initial configuration of a new Catalyst Center appliance. To reimage an appliance that's been configured previously, you will need to use the Maglev Configuration wizard (see Configure the Appliance Using the Maglev Wizard).

  • In a three-node cluster, log out of the appliances before configuring them. Otherwise, the Quick Start workflow (which you complete to discover your network's devices and enable telemetry) will not start after you have configured your cluster's appliances and log in to Catalyst Center for the first time.

  • Ensure that all of the IP addresses you enter while completing this procedure are valid addresses with valid netmasks. Also make sure that the addresses and their corresponding subnets do not overlap. Service communication issues can result if they do.

When joining each new secondary node to the cluster, you must specify the first host in the cluster as the primary node. Consider these details when joining secondary nodes to a cluster:

  • Ensure that all installed packages are deployed on the primary node before adding a new node to the cluster. You can check this by using Secure Shell to log in to the primary node's Catalyst Center Management port as the Linux user (maglev) and then running the command maglev package status. All installed packages should appear in the command output as DEPLOYED.

  • Ensure to join only a single node to the cluster at a time. Do not attempt to add multiple nodes at the same time, as doing so will result in unpredictable behavior.

  • Expect some service downtime during the cluster attachment process for each secondary node. Services will need to be redistributed across the nodes and the cluster will be down for periods of time during that process.

Before you begin

Ensure that you:

  • Configured the first appliance in the cluster according to the steps in Configure the primary node using the Advanced Install configuration wizard.

  • Collected all of the information called for in Required IP addresses and subnets and Required configuration information.

  • Installed the second and third appliances, as described in Appliance installation workflow.

  • Have done these steps:

    1. Ran the maglev package status command on the first appliance.

      You can also access this information from the Catalyst Center home page by clicking the Help icon () and choosing About > Show Packages.

    2. Contacted the Cisco TAC, gave them the output of this command, and asked them to point you to the ISO that you should install on your second and third appliances.

  • Configured Cisco IMC browser access on both secondary nodes, as described in Enable browser access to the Cisco Integrated Management Controller.

  • Checked that both secondary nodes' ports and the switches they use are properly configured, as described in Execute preconfiguration tasks.

  • Are using a compatible browser. For a list of compatible browsers, see the Release Notes for the version of Catalyst Center you are installing.

  • Enabled ICMP on the firewall between Catalyst Center and both the default gateway and the DNS server you specify in this procedure. The wizard uses ping to verify the gateway and DNS server you specify. This ping might get blocked if a firewall is in place and ICMP is not enabled on that firewall. When this happens, you will not be able to complete the wizard.

Procedure

1.

Start the Advanced Install configuration wizard:

  1. Point your browser to the Cisco IMC IP address you set during the Cisco IMC GUI configuration you performed, then log in to the Cisco IMC GUI as the Cisco IMC user (see Enable browser access to the Cisco Integrated Management Controller).

    After successful login, the appliance displays the Cisco Integrated Management Controller Chassis Summary window, with a blue link menu at the upper right.
  2. From the blue link menu, select Launch KVM and then select HTML based KVM.

    The KVM console opens in a separate browser window or tab automatically. Use it to monitor the progress of the configuration and respond to Maglev Configuration Wizard prompts.

  3. With the KVM displayed, reboot the appliance by making one of these selections:

    • In the main Cisco IMC GUI browser window: Choose Host Power > Power Cycle. Then switch to the KVM console to continue.

    • In the KVM console: Choose Power > Power Cycle System (cold boot).

    If asked to confirm your choice to reboot the appliance, click OK.

    After displaying reboot messages, the KVM console displays the Static IP Configuration screen.

    The KVM console displays the Static IP Configuration screen with the Skip and Configure options in the bottom-right corner.

    Note the URL listed in the Web Installation field.

  4. Do one of these tasks:

    • If you want a DHCP server to assign an IP address, subnet mask, and default gateway to your appliance's enterprise interface, click Skip.

    • If you want to assign your own IP address, subnet mask, and default gateway to your appliance's enterprise interface, enter the information described in this table and then click Configure.

    IPv6 mode check box

    If you want to configure an IPv6 address, check this check box.

    IP Address field

    Enter the static IP address that you want to use.

    Netmask field

    Enter the netmask for the IP address you specified in the previous field:

    • If you entered an IPv4 address, you can enter either a netmask or CIDR address.

    • If you entered an IPv6 address, you can only enter a CIDR address.

    Default Gateway Address field

    Specify the default gateway that will be used to route traffic.

    Static Routes field

    Enter one or more static routes in this format, separated by spaces: <network>/<netmask>/<gateway>. This is usually required on the Management port only.

    The KVM console displays the Maglev Configuration wizard welcome screen.

    The Maglev Configuration wizard displays two Cisco DNA Center cluster options for how you would like to configure the node.
  5. To bring up the Appliance Configuration screen, open the URL that was displayed in the Static IP Configuration screen.

  6. Click the Join a Cisco Catalyst Center Cluster radio button, then click Next.

    The Appliance Configuration screen displays the Advanced Install workflow option with the Start button in the bottom-right corner.
  7. Click the Advanced Install radio button, then click Start.

    The Overview slider opens. Click > to view a summary of the tasks that the wizard will help you complete.

    The Advanced Install Overview slider displays a summary of the workflow with the Start Workflow button in the bottom-left corner.
  8. Click Start Workflow to start the wizard.

    The Appliance Interface Overview screen opens, providing a description of the four appliance interfaces that you can configure.

    The Appliance Interface Overview screen summarizes the four configurable interfaces on your appliance.

    At a minimum, you must configure the interfaces on your appliance's enterprise and cluster ports, as they are required for Catalyst Center functionality. If the wizard fails to display either or both of these ports during the course of configuration, they may be non-functional or disabled. If you discover that they are non-functional, click Exit to exit the wizard immediately. Ensure you have completed all of the steps provided in Execute preconfiguration tasks before resuming configuration or contacting the Cisco Technical Assistance Center (TAC).

2.

Complete the Advanced Install configuration wizard:

  1. Click Next.

    The How would you like to set up your appliance interfaces? screen opens.

    The How would you like to set up your appliance interfaces? screen displays the step to choose if you want to configure dedicated Management and Internet Access interfaces.
  2. Indicate whether you want to configure dedicated Management and Internet Access interfaces, then click Next.

    The Configure Your Enterprise Network Interface screen opens.

    The Configure Your Enterprise Network Interface screen displays the step to enter configuration values for the Enterprise interface.
  3. Enter configuration values for the enterprise interface, then click Next.

    As explained in Interface cable connections, this is a required interface used to link the appliance to the enterprise network. See Required IP addresses and subnets and Required configuration information for a more detailed description of the values you need to enter.

    Table 1. Secondary node entries for the enterprise interface

    LACP Mode slider

    Select one of these network interface controller (NIC) bonding modes for the enterprise interface:

    • Active-Backup mode: This mode provides fault tolerance by aggregating two Ethernet interfaces into a single logical channel. When the interface that's currently active goes down, the other interface takes its place and becomes active.

    • LACP mode: This mode aggregates two Ethernet interfaces that share the same speed and duplex settings into a single logical channel. This provides load balancing and higher bandwidth.

    For more information about Catalyst Center's implementation of NIC bonding, see NIC bonding overview.

    Host IP Address field

    Enter the IP address for the enterprise interface. This is required.

    Subnet Mask field

    Enter the netmask for the interface's IP address. This is required.

    Default Gateway IP Address field

    Enter a default gateway IP address to use for the interface.

    Ensure that you enter a default gateway IP address for at least one of your appliances' interfaces to be able to complete the configuration wizard.

    Note

    You designated this interface to use the default gateway assigned to it by a DHCP server. Complete these steps to specify a different gateway:

    1. Delete the IP address that is currently listed in this field and then click Exit.

      This will bring you back to the first wizard screen.

    2. Return to the enterprise port's wizard screen and enter the gateway IP address you want to use.

    DNS field

    Enter the IP address of the preferred DNS server.

    To enter additional DNS servers, click the Add (+) icon.

    • For each node in your cluster, configure a maximum of three DNS servers. Problems can occur if you configure more than three DNS servers for an appliance.

    • For NTP, ensure port 123 (UDP) is open between Catalyst Center and your NTP server.

    The wizard validates the information you have entered, confirms that the port is up, and notifies you of any settings that need to be changed before you can continue with the wizard. If the settings you have entered are valid and the port is up, the wizard's Configure Your Intracluster Interface screen opens.

    The Configure Your Intracluster Interface screen displays the step to enter configuration values for your Intracluster interface.
  4. Enter configuration values for your Intracluster interface, then click Next.

    As explained in Interface cable connections, this required port is used to link the appliance to your cluster. See Required IP addresses and subnets and Required configuration information for a more detailed description of the values you need to enter.

    Note
    • If you opted to configure the enterprise and Internet access interfaces on the same port, complete this step and then continue to Step 2e (which describes how to configure your management interface).

    • If you opted to configure the enterprise and management interfaces on the same port, complete this step and then skip ahead to Step 2f (which describes how to configure your Internet access interface).

    • If you opted to configure the enterprise, management, and Internet access interfaces on the same port, complete this step and then skip ahead to Step 2g.

    Table 2. Secondary node entries for the intracluster interface

    LACP Mode slider

    Select one of these NIC bonding modes for the intracluster interface:

    • Active-Backup mode: This mode provides fault tolerance by aggregating two Ethernet interfaces into a single logical channel. When the interface that's currently active goes down, the other interface takes its place and becomes active.

    • LACP mode: This mode aggregates two Ethernet interfaces that share the same speed and duplex settings into a single logical channel. This provides load balancing and higher bandwidth.

      If you want to enable LACP mode on your appliance's Intracluster interface, do so now. You won't be able to after you complete this wizard.

    For more information about Catalyst Center's implementation of NIC bonding, see NIC bonding overview.

    Host IP Address field

    Enter the IP address for the Intracluster interface. This is required. Note that you cannot change the address of the Intracluster interface later.

    Subnet Mask field

    Enter the netmask for the interface's IP address. This is required.

    The wizard validates the information you have entered, confirms that the port is up, and notifies you of any settings that need to be changed before you can continue with the wizard. If the settings you have entered are valid and the port is up, the wizard's Configure Your Management Network Interface screen opens.

    The Configure Your Management Network Interface screen displays the optional step to enter configuration values for the Management port.
  5. (Optional) Enter configuration values for the Management interface, then click Next.

    As explained in Interface cable connections, this port is used to access the Catalyst Center GUI from your management network. If you chose to configure a dedicated Management interface, enter the information described in this table. (See Required IP addresses and subnets and Required configuration information for a more detailed description of the values you need to enter.)

    Note

    If you opted to configure the enterprise and Internet access interfaces on the same port, complete this step and then skip ahead to Step 2g.

    Table 3. Secondary node entries for the management interface

    Host IP Address field

    Enter the IP address for the management interface.

    Subnet Mask field

    Enter the netmask for the interface's IP address.

    Default Gateway IP Address field

    Enter a default gateway IP address to use for the interface.

    Ensure that you enter a default gateway IP address for at least one of your appliance's interfaces. Otherwise, you will not be able to complete the configuration wizard.

    DNS field

    Enter the IP address of the preferred DNS server.

    To enter additional DNS servers, click the Add (+) icon.

    • For each node in your cluster, configure a maximum of three DNS servers. Problems can occur if you configure more than three DNS servers for an appliance.

    • For NTP, ensure port 123 (UDP) is open between Catalyst Center and your NTP server.

    The wizard validates the information you have entered, confirms that the port is up, and notifies you of any settings that need to be changed before you can continue with the wizard. If the settings you have entered are valid and the port is up, the wizard's Configure Your Internet Access Interface screen opens.

    The Configure Your Internet Access Interface screen displays the optional step to enter configuration values for the Internet Access interface.
  6. (Optional) Enter configuration values for the Internet Access interface, then click Next.

    As explained in Interface cable connections, this is an optional port used to link the appliance to the Internet when you cannot do so through the enterprise port. If you chose to configure a dedicated Internet Access interface, enter the information described in this table. (See Required IP addresses and subnets and Required configuration information for a more detailed description of the values you need to enter.)

    Table 4. Secondary node entries for the Internet Access interface

    Host IP Address field

    Enter the IP address for the Internet access interface.

    Subnet Mask field

    Enter the netmask for the interface's IP address. This is required if you entered an IP address in the previous field.

    Default Gateway IP Address field

    Enter a default gateway IP address to use for the interface.

    Ensure that you enter a default gateway IP address for at least one of your appliance's interfaces. Otherwise, you will not be able to complete the configuration wizard.

    DNS field

    Enter the IP address of the preferred DNS server.

    To enter additional DNS servers, click the Add (+) icon.

    • For each node in your cluster, configure a maximum of three DNS servers. Problems can occur if you configure more than three DNS servers for an appliance.

    • For NTP, ensure port 123 (UDP) is open between Catalyst Center and your NTP server.

    The wizard validates the information you have entered, confirms that the port is up, and notifies you of any settings that need to be changed before you can continue with the wizard. If the settings you have entered are valid and the port is up, the wizard's Interface to Port Configuration screen opens.

  7. Review the settings that you have entered for the secondary node's interfaces.

    If you need to make any changes, click the Edit link for the relevant interface.

  8. When you are happy with the interface settings, click Next.

    After initial interface configuration has completed, the Configure Proxy Server Information screen opens.

    The Configure Proxy Server Information screen displays the step to choose if you want your network to use a proxy server to access the internet.
  9. Do one of these tasks and then click Next:

    • If your network does not use a proxy server to access the internet, click the No radio button.

    • If your network does use a proxy server to access the internet, enter the values described in this table:

    Table 5. Secondary node entries for proxy server settings

    Proxy Server field

    Enter the URL or host name of an HTTPS network proxy used to access the Internet.

    Note
    Connection from Catalyst Center to the HTTPS proxy is supported only via HTTP in this release.

    Port field

    Enter the port your appliance used to access the network proxy.

    Username filed

    Enter the user name used to access the network proxy. If no proxy login is required, leave this field blank.

    Password field

    Enter the password used to access the network proxy. If no proxy login is required, leave this field blank.

    The wizard validates the information you have entered and notifies you of any settings that need to be changed before you can continue with the wizard. If the settings you have entered are valid, the wizard's Primary Node Details screen opens.

    The Primary Node Details screen displays the step to enter its IP address and password.
  10. To establish a connection with your cluster's primary node, enter its IP address and password (by default, the username is already set to maglev) and then click Next.

    The Advanced Appliance Settings screen opens.

  11. Enter configuration values for your cluster, then click Next.

    Table 6. Secondary node entries for advanced appliance settings

    CLI credentials

    Enter and confirm the password for the maglev user.

    Ensure that this password complies with the Password requirements.

    NTP server settings

    NTP Server field

    Enter at least one NTP server address or hostname. To enter additional NTP server addresses or hostnames, click the Add (+) icon.

    For a production deployment, Cisco recommends that you configure a minimum of three NTP servers.

    Turn On NTP Authentication check box

    To enable the authentication of your NTP server before it's synchronized with Catalyst Center, check this check box and then enter this information:

    • The NTP server's key ID. Valid values range between 1 and 4294967295 (2^32-1).

      This value corresponds to the key ID that's defined in the NTP server's key file.

    • The SHA-1 key value associated with the NTP server's key ID. This 40-character hex string resides in the NTP server's key file.

    Note

    Ensure that you enter a key ID and key value for each NTP server that you configured in the previous field.

    The wizard validates the information you have entered, confirms that the port is up, and notifies you of any settings that need to be changed before you can continue with the wizard. If the settings you have entered are valid, the wizard's Summary screen opens.

    The Summary screen displays the step to review all the entered settings before starting the configuration.
    Note

    To download the appliance configuration as a JSON file, click the here link.

  12. Review all of the settings that you have entered while completing the wizard. If necessary, click the appropriate Edit link to open the wizard screen in which you want to make updates.

  13. To complete the configuration of your Catalyst Center appliance, click Start Configuration.

    The configuration process takes roughly 90 minutes. The wizard screen continuously updates during the process, indicating the tasks that are currently being completed and their progress, as well as any errors that have occurred. To save a local copy of this information as a text file, click the download icon.

    The Appliance Configuration In Progress screen informs you how long the configuration should take and displays a progress bar.

What to do next

When this task is complete:

  • If you have an additional appliance to deploy as the third and final node in the cluster, repeat this procedure.

  • If you are finished adding nodes to the cluster, complete the first-time setup: First-time setup workflow.