Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation
Table of Contents
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    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.
      root@qfabric# set fabric aliases node-device ?
      Possible completions:
  <aliasable-item-name>   The name of the item to be aliased 
  BBAK8309             Node device
  BBAK8283             Node device
  BBAK8891             Node device
  BBAK8868             Node device
  BBAK8276             Node device
  BBAK8273             Node device
[edit]

      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.

      root@qfabric> show fabric administration inventory node-devices 
      Item                    Identifier              Connection      Configuration
Node device
  BBAK8309                                      Connected
  BBAK8283                                      Connected
  BBAK8891                                      Connected
  BBAK8868                                      Connected
  BBAK8276                                      Connected
  BBAK8273                                      Connected
    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.
      [edit fabric aliases]
      root@qfabric# set node-device BBAK8309 Node0
      root@qfabric# set node-device BBAK8283 Node1
      root@qfabric# set node-device BBAK8891 Node2
      root@qfabric# set node-device BBAK8868 Node3
      root@qfabric# set node-device BBAK8276 Node4
      root@qfabric# set node-device BBAK8273 Node5
    3. Review your configuration and issue the commit command.
      [edit]
      root@qfabric# show fabric
      aliases {
    node-device BBAK8309 {
        Node0;
    }
    node-device BBAK8283 {
        Node1;
    }
    node-device BBAK8891 {
        Node2;
    }
    node-device BBAK8868 {
        Node3;
    }
    node-device BBAK8276 {
        Node4;
    }
    node-device BBAK8273 {
        Node5;
    }
}
      [edit]
      root@qfabric# commit
      commit complete
    4. To view that your aliases are operational, issue the show fabric administration inventory node-devices command.
      root@qfabric> show fabric administration inventory node-devices 
      Item                    Identifier              Connection      Configuration
Node device
  node0                 BBAK8309                Connected
  node1                 BBAK8283                Connected
  node2                 BBAK8891                Connected
  node3                 BBAK8868                Connected
  node4                 BBAK8276                Connected
  node5                 BBAK8273                Connected

      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.
      root@qfabric# set fabric aliases director-device ?
      Possible completions:
  <aliasable-item-name>   The name of the item to be aliased 
  0281052011000001     Director device 
  0281052011000032     Director device 
[edit]

      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.

      root@qfabric> show fabric administration inventory director-group status 
      Director Group Status Tue Jun  5 15:11:26 UTC 2012

 Member Status Role     Mgmt Address    CPU Free Memory VMs Up Time
 ------ ------ -------- --------------- --- ----------- --- -------------
 dg0    online master   10.49.215.38    8%  17363152k   4   3 days, 20:55 hrs
 dg1    online backup   10.49.215.39    6%  20157440k   3   3 days, 20:55 hrs

 Member Device Id/Alias  Status  Role
 ------ ---------------- ------- ---------
 dg0    0281052011000001 online  master   

  Master Services
  ---------------
  Database Server                online    
  Load Balancer Director         online    
  QFabric Partition Address      online    

  Director Group Managed Services
  -------------------------------
  Shared File System             online    
  Network File System            online    
  Virtual Machine Server         online    
  Load Balancer/DHCP             online    

  Hard Drive Status
  ----------------
  Volume ID:4                    optimal    
  Physical ID:1                  online     
  Physical ID:0                  online     
  SCSI ID:1                      100%       
  SCSI ID:0                      100%       


  Size  Used Avail Used% Mounted on 
  ----  ---- ----- ----- ----------
  423G 5.4G 395G  2%   /          
  99M  16M  79M   17%  /boot      
  93G  7.3G 86G   8%   /pbdata    

  Director Group Processes
  ------------------------
  Director Group Manager         online    
  Partition Manager              online    
  Software Mirroring             online    
  Shared File System master      online    
  Secure Shell Process           online    
  Network File System            online    
  DHCP Server master             online     master                           
  FTP Server                     online    
  Syslog                         online    
  Distributed Management         online    
  SNMP Trap Forwarder            online    
  SNMP Process                   online    
  Platform Management            online    

  Interface Link Status
  ---------------------
  Management Interface           up        
  Control Plane Bridge           up        
  Control Plane LAG              up        
  CP Link [0/2]                  up        
  CP Link [0/1]                  up        
  CP Link [0/0]                  up        
  CP Link [1/2]                  down      
  CP Link [1/1]                  down      
  CP Link [1/0]                  down      
  Crossover LAG                  up        
  CP Link [0/3]                  up        
  CP Link [1/3]                  up        

 Member Device Id/Alias  Status  Role
 ------ ---------------- ------- ---------
 dg1    0281052011000032 online  backup   

  Director Group Managed Services
  -------------------------------
  Shared File System             online    
  Network File System            online    
  Virtual Machine Server         online    
  Load Balancer/DHCP             online    

  Hard Drive Status
  ----------------
  Volume ID:8                    optimal    
  Physical ID:1                  online     
  Physical ID:0                  online     
  SCSI ID:1                      100%       
  SCSI ID:0                      100%       


  Size  Used Avail Used% Mounted on 
  ----  ---- ----- ----- ----------
  423G 5.5G 395G  2%   /          
  99M  16M  79M   17%  /boot            
  93G  7.3G 86G   8%   /pbdata    

  Director Group Processes
  ------------------------
  Director Group Manager         online    
  Partition Manager              online    
  Software Mirroring             online    
  Shared File System master      online    
  Secure Shell Process           online    
  Network File System            online    
  DHCP Server master             online     backup                           
  FTP Server                     online    
  Syslog                         online    
  Distributed Management         online    
  SNMP Trap Forwarder            online    
  SNMP Process                   online    
  Platform Management            online    

  Interface Link Status
  ---------------------
  Management Interface           up        
  Control Plane Bridge           up        
  Control Plane LAG              up        
  CP Link [0/2]                  up        
  CP Link [0/1]                  up        
  CP Link [0/0]                  up        
  CP Link [1/2]                  down      
  CP Link [1/1]                  down      
  CP Link [1/0]                  down      
  Crossover LAG                  up        
  CP Link [0/3]                  up        
  CP Link [1/3]                  up
    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.
      [edit fabric aliases]
      root@qfabric# set director-device 0281052011000001 Director0
      root@qfabric# set director-device 0281052011000032 Director1
    3. Review your configuration and issue the commit command.
      [edit]
      root@qfabric# show fabric
      aliases {
    director-device 0281052011000001 {
        Director0;
    }
    director-device 0281052011000032 {
        Director1;
    }
}
      [edit]
      root@qfabric# commit
      commit complete
    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.
      root@qfabric> show fabric administration inventory director-group status 
      Director Group Status Tue Jun  5 15:11:26 UTC 2012

 Member Status Role     Mgmt Address    CPU Free Memory VMs Up Time
 ------ ------ -------- --------------- --- ----------- --- -------------
 dg0    online master   10.49.215.38    8%  17363152k   4   3 days, 20:55 hrs
 dg1    online backup   10.49.215.39    6%  20157440k   3   3 days, 20:55 hrs

 Member Device Id/Alias  Status  Role
 ------ ---------------- ------- ---------
 dg0    Director0        online  master   

  Master Services
  ---------------
  Database Server                online    
  Load Balancer Director         online    
  QFabric Partition Address      online    

  Director Group Managed Services
  -------------------------------
  Shared File System             online    
  Network File System            online    
  Virtual Machine Server         online    
  Load Balancer/DHCP             online    

  Hard Drive Status
  ----------------
  Volume ID:4                    optimal    
  Physical ID:1                  online     
  Physical ID:0                  online     
  SCSI ID:1                      100%       
  SCSI ID:0                      100%       


  Size  Used Avail Used% Mounted on 
  ----  ---- ----- ----- ----------
  423G 5.4G 395G  2%   /          
  99M  16M  79M   17%  /boot      
  93G  7.3G 86G   8%   /pbdata    

  Director Group Processes
  ------------------------
  Director Group Manager         online    
  Partition Manager              online    
  Software Mirroring             online    
  Shared File System master      online    
  Secure Shell Process           online    
  Network File System            online    
  DHCP Server master             online     master                           
  FTP Server                     online    
  Syslog                         online    
  Distributed Management         online    
  SNMP Trap Forwarder            online    
  SNMP Process                   online    
  Platform Management            online    

  Interface Link Status
  ---------------------
  Management Interface           up        
  Control Plane Bridge           up        
  Control Plane LAG              up        
  CP Link [0/2]                  up        
  CP Link [0/1]                  up        
  CP Link [0/0]                  up        
  CP Link [1/2]                  down      
  CP Link [1/1]                  down      
  CP Link [1/0]                  down      
  Crossover LAG                  up        
  CP Link [0/3]                  up        
  CP Link [1/3]                  up        

 Member Device Id/Alias  Status  Role
 ------ ---------------- ------- ---------
 dg1    Director1        online  backup   

  Director Group Managed Services
  -------------------------------
  Shared File System             online    
  Network File System            online    
  Virtual Machine Server         online    
  Load Balancer/DHCP             online    

  Hard Drive Status
  ----------------
  Volume ID:8                    optimal    
  Physical ID:1                  online     
  Physical ID:0                  online     
  SCSI ID:1                      100%       
  SCSI ID:0                      100%       


  Size  Used Avail Used% Mounted on 
  ----  ---- ----- ----- ----------
  423G 5.5G 395G  2%   /          
  99M  16M  79M   17%  /boot            
  93G  7.3G 86G   8%   /pbdata    

  Director Group Processes
  ------------------------
  Director Group Manager         online    
  Partition Manager              online    
  Software Mirroring             online    
  Shared File System master      online    
  Secure Shell Process           online    
  Network File System            online    
  DHCP Server master             online     backup                           
  FTP Server                     online    
  Syslog                         online    
  Distributed Management         online    
  SNMP Trap Forwarder            online    
  SNMP Process                   online    
  Platform Management            online    

  Interface Link Status
  ---------------------
  Management Interface           up        
  Control Plane Bridge           up        
  Control Plane LAG              up        
  CP Link [0/2]                  up        
  CP Link [0/1]                  up        
  CP Link [0/0]                  up        
  CP Link [1/2]                  down      
  CP Link [1/1]                  down      
  CP Link [1/0]                  down      
  Crossover LAG                  up        
  CP Link [0/3]                  up        
  CP Link [1/3]                  up

    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.
      root@qfabric# set fabric aliases interconnect-device ?
      Possible completions:
  <aliasable-item-name>   The name of the item to be aliased 
  IC-F1249             Interconnect device  
  IC-F4912             Interconnect device
[edit]

      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.

      root@qfabric> show fabric administration inventory interconnect-devices 
      Item                    Identifier              Connection      Configuration
Interconnect device
  IC-F1249                                      Connected       Configured    
    F1249/RE0                                   Connected                     
  IC-F4912                                      Connected       Configured    
    F4912/RE0                                   Connected
    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.
      [edit fabric aliases]
      root@qfabric# set interconnect-device IC-F1249 Interconnect0
      root@qfabric# set interconnect-device IC-F4912 Interconnect1
    3. Review your configuration and issue the commit command.
      [edit]
      root@qfabric# show fabric
      aliases {
    interconnect-device IC-F1249 {
        Interconnect0;
    }
    interconnect-device IC-F4912 {
        Interconnect1;
    }
}
      [edit]
      root@qfabric# commit
      commit complete
    4. To view that your aliases are operational, issue the show fabric administration inventory interconnect-devices command.
      root@qfabric> show fabric administration inventory interconnect-devices 
      Item                    Identifier              Connection      Configuration
Interconnect device
  Interconnect0         IC-F1249                Connected       Configured    
    F1249/RE0                                   Connected                     
  Interconnect1         IC-F4912                Connected       Configured    
    F4912/RE0                                   Connected
     

    Related Documentation

     

    Published: 2014-06-30

    Previous Page Next Page