Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configuring Aliases for the QFabric System

This topic explains how to configure aliases for components of the QFabric system, such as Director devices, Interconnect devices, and Node devices. Aliases replace the hardware serial numbers of components, making it easier to identify system devices and simplify configuration tasks.

Before you create aliases in a QFabric system:

  • Issue one of the show fabric administration inventory commands to view the components that are available for aliasing and their hardware serial numbers.

Note:

The following rules apply to QFabric component alias naming:

  • Alias names must use alphabetic (A through Z and a through z), numeric (0 through 9), or dash (-) characters.

  • The maximum length of an alias name is 30 characters.

  • Alias names are case sensitive. For example, MY-NG-1 and my-ng-1 refer to different components.

  • You cannot use the reserved names all, fabric, or director-group as an alias name.

To create an alias for a Node device:

  1. Discover the serial number of the Node device you wish to rename by issuing the set fabric aliases node-device ? context-sensitive help command.

    As an alternate way to discover the serial number for a Node device, issue the show fabric administration inventory node-devices command. In this case, the serial numbers for the Node devices are BBAK8309BBAK8283BBAK8891BBAK8868BBAK8276 and BBAK8273.

  2. Specify the serial number of the Node device and the desired alias name by including the node-device statement at the [edit fabric aliases] hierarchy level.
  3. Review your configuration and issue the commit command.
  4. To view that your aliases are operational, issue the show fabric administration inventory node-devices command.
    Note:

    If you attempt to commit all configuration settings for a new Node group (such as the Node group itself, aliasing, and other features) at the same time, the commit operation might appear to succeed when it actually has failed. For this reason, we recommend configuring and verifying Node groups and aliases first, followed by configuring and verifying other features. Establishing the Node groups and aliases first enables the QFabric system to reject any potentially unsupported configuration. The resulting commit errors indicate where the configuration problem lies. To verify the establishment of Node groups and aliases before configuring other features, issue the show fabric administration inventory command.

To create an alias for a Node group:

  • Specify a name for the Node group when you include the node-group statement at the [edit fabric resources] hierarchy level.

    Note:

    You cannot use the aliases statement at the [edit fabric] hierarchy level to create an aliased name for a Node group.

To create an alias for a Director device:

  1. Discover the serial number of the Director device you wish to rename by issuing the set fabric aliases director-device ? context-sensitive help command.

    As an alternate way to discover the serial number for a Director device, issue the show fabric administration inventory director-group status command. In this case, the serial number for Director device DG0 is 0281052011000001 and the serial number for Director device DG1 is 0281052011000032.

  2. Specify the serial number of the Director device and the desired alias name by including the director-device statement at the [edit fabric aliases] hierarchy level.

  3. Review your configuration and issue the commit command.

  4. To view that your aliases are operational, issue the show fabric administration inventory director-group status command. In this case, the serial numbers in the Device Id/Alias field have been replaced with the Director0 and Director1 aliased names.

To create an alias for an Interconnect device:

  1. Discover the serial number of the Interconnect device you wish to rename by issuing the set fabric aliases interconnect-device ? context-sensitive help command.

    As an alternate way to discover the serial number for an Interconnect device, issue the show fabric administration inventory interconnect-devices command. In this case, the serial numbers for the Interconnect devices are IC-F1249 and IC-F4912.

  2. Specify the serial number of the Interconnect device and the desired alias name by including the interconnect-device statement at the [edit fabric aliases] hierarchy level.

  3. Review your configuration and issue the commit command.

  4. To view that your aliases are operational, issue the show fabric administration inventory interconnect-devices command.