lanadmin_vlan man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

lanadmin_vlan(1M)					     lanadmin_vlan(1M)

NAME
       lanadmin_vlan: lanadmin - virtual LANs (VLANs)

SYNOPSIS
       priority] ToS_value] vppa] name] level] level] ppa

       vlanid] priority] ToS_value] name] level] level] vppa

   Remarks
       The and commands are deprecated.	 See section for more information.

DESCRIPTION
       VLANs  are logical, or "virtual," network segments that can span multi‐
       ple physical network segments.  A primary benefit of VLANs is that they
       can isolate broadcast and multicast traffic by determining which desti‐
       nations should receive that  traffic,  thereby  making  better  use  of
       switch and end-station resources.

       The commands described here are for interactive administration of HP-UX
       virtual LANs (VLANs).  However, it is recommended  that	you  use  (see
       nwmgr_vlan(1M) and nwmgr(1M)) for VLAN administration on 11i V3 release
       and forward.  Changes made to VLANs interactively with the command  are
       not preserved between system reboots.  See

   VLAN lanadmin Command Summary
       Create a VLAN.

       Modify a VLAN.

       Delete a VLAN.

       Identify all VLANs and their properties.

       Identify a single VLAN and its properties.
		 The command returns on successful completion and on failure.

       Find the minimum acceptable value for a virtual PPA (VPPA).

       Display the usage message for the
		 options.

       Display the usage information for the interface corresponding to
		 ppa.	Test if upper-layer protocols or applications are run‐
		 ning.	Use it before deleting VLANs.	See  lanadmin(1M)  for
		 details.

   VLAN lanadmin Options
       The command has the following VLAN options:

       Specify an optional name for the VLAN.
		 The  default  is the null string ("").	 displays this as name
		 is a string of 0 to 31 alphanumeric characters.

       Specify the 802.1p priority in the tag in the frame header.
		 Switches use the 802.1p priority.  The valid range for prior‐
		 ity is 0-7.  The default is 0.

       Priority override provides a mechanism to convert IP level
		 precedence  (IPV4 ToS octet) to link level 802.1p user prior‐
		 ity.  Priority override applies to outbound frames only.  The
		 priority override level strings for outbound traffic are:
		 Your specified priority value will be used.

		 The IP header ToS will be converted to 802.1p priority.

		 Your specified ToS value will be converted to 802.1 priority.

       Specify ToS, the IP precedence in the IP header.
		 Switches ignore ToS.  Routers may use it.  The valid range is
		 0-255.	 The default is 0.

       Provide a mechanism to override the IP level
		 precedence in the header of an inbound IP packet.  ToS	 over‐
		 ride level strings for inbound traffic are:
		 The ToS value in the IP header will be used.

		 The Ether header 802.1p priority will be converted to the ToS
		 value.

		 Your specified ToS value will be used.

		 Your specified 802.1 priority value will be converted to ToS.

       Uniquely identify the VLAN to which a frame belongs.
		 The valid range for vlanid is 0-4094.

       Specify the virtual PPA (VPPA) number associated with a VLAN.
		 See vppa in

   VLAN lanadmin Operands
       The command has the following VLAN operands:

       ppa	 The physical point of attachment  (PPA)  number  of  the  LAN
		 interface.  See lanadmin(1M) for details.

       vppa	 The  virtual PPA (VPPA) number associated with a VLAN.	 It is
		 virtual because it does not have a unique hardware instance.

       You can display current values of ppa and vppa with  the	 command  (see
       and lanscan(1M)).

   lanscan Options
       The command shows the number of interfaces available on the system such
       as or See lanscan(1M).  The following options can be  used  to  display
       VLAN information.

       Display the MAC addresses of all the interfaces on the system.

       Display the names of all the interfaces on the system.

       Display the MAC type for all the interfaces.

       Display the Network Management IDs for all the interfaces.

       Display the PPA or VPPA number for all the interfaces.

       Display the output in verbose mode with detailed information.

EXAMPLES
       The  examples explain the usage of the and commands and how they can be
       used to work with virtual LANs (VLANs).

   Creating a VLAN
       When VLANs are configured on a LAN card, the output under Hardware Path
       shows where x is a unique VLAN interface number.

       To  create  VLANs, you use or the command.  There are multiple required
       and optional arguments for creating VLANs.  If you don't specify any or
       all  of	the  optional  arguments,  the default values described in are
       used.

       You can either specify a virtual PPA (VPPA)  number  greater  than  the
       minimum allowed VPPA number (5000) or allow the system to assign a VPPA
       number.

       Suppose you want to create a VLAN with a VPPA of 6050 and a  vlanid  of
       on PPA 0, you can use the following command:

       Upon successful creation, the following message is displayed:

	      Successfully configured.
	      lan6050: vlanid 4 name UNNAMED pri 0 tos 0
	      tos_override IP_HEADER pri_override CONF_PRI ppa 0

       The  message  shows that you have successfully created VLAN 6050 on the
       system.	If you do not assign a name to a VLAN, a standard  string,  is
       displayed as the name.

       To  create a VLAN on PPA 1, while letting the system generate the VPPA,
       you would use the following command to create a VLAN  with  vlanid  75,
       priority	 3, ToS 100, name honey, ToS override value and priority over‐
       ride value

       Upon successful creation, the following message is displayed:

	      Successfully configured.
	      lan5000: vlanid 75 name honey pri 3 tos 100
	      tos_override CONF_TOS pri_override IP_HEADER ppa 1

       The system has allotted the VPPA 5000 and successfully created  a  VLAN
       with the specified properties.

       Let us create one more VLAN on interface 1 with different properties.

       Upon successful creation, the following message is displayed:

	      Successfully configured.
	      lan5001: vlanid 76 name bee pri 2 tos 200
	      tos_override ETHER_HEADER pri_override IP_HEADER ppa 1

       Let  us take a look at the and snapshots of the system after successful
       creation of three VLANs: VLAN 6050 on PPA 0 and VLAN 5000 and  5001  on
       PPA 1.

       Hardware Station	       Crd  Hdw	  Net-Interface	   NM MAC  HP-DLPI DLPI
       Path	Address	       In#  State NamePPA	   ID Type Support Mjr#
       0/4/0/0	0x001083FF9951	  0 UP	  lan0	  snap0	    1 ETHER Yes	   119
       VLAN6050 0x001083FF9951 6050 UP	  lan6050 snap6050 14 ETHER Yes	   119
       1/4/0/0	0x006023456789	  1 DOWN  lan1	  snap1	    2 ETHER Yes	   119
       VLAN5000 0x006023456789 5000 DOWN  lan5000 snap5000 15 ETHER Yes	   119
       VLAN5001 0x006023456789 5001 DOWN  lan5001 snap5001 16 ETHER Yes	   119

       There are a few things to be noted from the above output:

	 ·  VPPAs have as their Hardware Path where x is a unique number.

	 ·  The	 VPPA  has the same MAC address as the PPA on which it is cre‐
	    ated.

	 ·  The VPPA has the same Hardware State as the PPA  on	 which	it  is
	    created.

	 ·  The VPPA has a PPA associated with it.

	 ·  In the output, VPPA information is shown immediately after the PPA
	    on which it was created.  For example, information about  VLAN6050
	    is	displayed  after lan0 information.  Information about VLAN5000
	    and VLAN5001 is displayed after lan1 information because  VLAN5000
	    and VLAN5001 are associated with lan1.

       The  other properties which are not visible from the snapshot above but
       are common between the VPPA and the PPA on which it is created are Sta‐
       tion  Address, Speed and MTU setting.  You can verify this by using the
       commands to find out Station Address, Speed and MTU, respectively:

       Now let's explore the outputs of and

	      VLAN	Physical  VLAN	Pri Pri	      ToS  ToS		NAME
	      Interface Interface ID	    Override	   Override
	      Name			    Level	   Level
	      lan6050	lan0	  4	0   CONF_PRI  0	   IP_HEADER	UNNAMED
	      lan5000	lan1	  75	3   IP_HEADER 100  CONF_TOS	honey
	      lan5001	lan1	  76	2   IP_HEADER 200  ETHER_HEADER bee

	      0
	      6050
	      1
	      5000
	      5001

       You can alternatively use the command to get information about  a  spe‐
       cific  VPPA.  Let's say you are interested in VPPA 6050.	 The following
       command will get information regarding VPPA 6050.

	      VLAN	Physical  VLAN	Pri Pri	      ToS  ToS		NAME
	      Interface Interface ID	    Override	   Override
	      Name			    Level	   Level
	      lan6050	lan0	  4	0   CONF_PRI  0	   IP_HEADER	UNNAMED

       Note that information related only to  VPPA  6050  is  displayed	 as  a
       result of the info command.

       Let's  examine  the output now.	For the sake of simplicity, the output
       from only and newly created VPPAs has been displayed.

       -----------------------------------------------------------------------
       Hardware Station	       Crd  Hdw	  Net-Interface	   NM MAC  HP-DLPI DLPI
       Path	Address	       In#  State NamePPA	   ID Type Support Mjr#
       0/4/0/0	0x001083FF9951 0    UP	  lan0	snap0	   1  ETHER Yes	   119

       Extended Station			  LLC Encapsulation
       Address				  Methods
       0x001083FF9951			  IEEE HPEXTIEEE SNAP ETHER NOVELL

       Driver Specific Information
       gelan
       -----------------------------------------------------------------------
       Hardware Station	       Crd  Hdw	  Net-Interface	   NM MAC  HP-DLPI DLPI
       Path	Address	       In#  State NamePPA	   ID Type Support Mjr#
       VLAN6050 0x001083FF9951 6050 UP	  lan6050 snap6050 14 ETHER Yes	   119

       Extended Station			  LLC Encapsulation
       Address				  Methods
       0x001083FF9951			  IEEE HPEXTIEEE SNAP ETHER NOVELL

       Driver Specific Information
       vlan
       Vlan ID Phy-PPA Priority ToS Priority-Override ToS-Override Name
       4	   0	   0	0   CONF_PRI	      IP_HEADER	   UNNAMED
       -----------------------------------------------------------------------
       Hardware Station	       Crd  Hdw	  Net-Interface	   NM MAC  HP-DLPI DLPI
       Path	Address	       In#  State NamePPA	   ID Type Support Mjr#
       1/4/0/0	0x006023456789 1    DOWN  lan1	snap1	   1  ETHER Yes	   119

       Extended Station			  LLC Encapsulation
       Address				  Methods
       0x006023456789			  IEEE HPEXTIEEE SNAP ETHER NOVELL

       Driver Specific Information
       btlan
       -----------------------------------------------------------------------
       Hardware Station	       Crd  Hdw	  Net-Interface	   NM MAC  HP-DLPI DLPI
       Path	Address	       In#  State NamePPA	   ID Type Support Mjr#
       VLAN5000 0x006023456789 5000 DOWN  lan5000 snap5000 15 ETHER Yes	   119

       Extended Station			  LLC Encapsulation
       Address				  Methods
       0x006023456789			  IEEE HPEXTIEEE SNAP ETHER NOVELL

       Driver Specific Information
       vlan
       Vlan ID Phy-PPA Priority ToS Priority-Override ToS-Override Name
       75	   1	   3	64  CONF_PRI	      IP_HEADER	   honey
       -----------------------------------------------------------------------
       Hardware Station	       Crd  Hdw	  Net-Interface	   NM MAC  HP-DLPI DLPI
       Path	Address	       In#  State NamePPA	   ID Type Support Mjr#
       VLAN5001 0x006023456789 5001 DOWN  lan5001 snap5001 15 ETHER Yes	   119

       Extended Station			  LLC Encapsulation
       Address				  Methods
       0x006023456789			  IEEE HPEXTIEEE SNAP ETHER NOVELL

       Driver Specific Information
       vlan
       Vlan ID Phy-PPA Priority ToS Priority-Override ToS-Override Name
       76	   1	   2	200 IP_HEADER	      ETHER_HEADER bee
       -----------------------------------------------------------------------

       You can configure an IP address on the VPPAs.  Let's consider configur‐
       ing  VPPA  6050	with IP address 192.1.1.1.  This can be done using the
       command as it would be done for any PPA.

       The snapshots for and remain the same.

   Modifying a VLAN
       You can modify a vlan while it is supporting traffic.  If you modify  a
       vlanid,	traffic will be sent and received on the new vlanid but not on
       the former vlanid.

       Let's try to modify the properties of the VPPAs	already	 created,  and
       also  study  the	 corresponding changes in various and command outputs.
       Let's modify the vlanid, priority, and name of VPPA 6050.  The  follow‐
       ing command will change the vlanid from 4 to 100, priority value from 0
       to 7, and the name from the default name to for VPPA 6050.

	      Successfully modified lan6050.
	      Old value: vlanid 4 pri 0 name UNNAMED
	      New value: vlanid 100 pri 7 name candy

       Let's modify the properties tos, tos_override and pri_override for VPPA
       5000.   The following command can be used to change tos to 64 from 100,
       tos_override to from and pri_override to from

       Successfully modified lan5000.
       Old value: tos 100 tos_override CONF_TOS pri_override IP_HEADER
       New value: tos 64 tos_override IP_HEADER pri_override CONF_PRI

       Let's take a look at the and snapshot of the  system  after  successful
       modification  of	 two VPPAs: VPPA 6050 on PPA 0 and VPPA 5000 on PPA 1.
       The snapshot will remain the same as before the	modification;  however
       you can see differences in the and snapshots before and after modifica‐
       tion.

	      VLAN	Physical  VLAN	Pri Pri	      ToS  ToS		NAME
	      Interface Interface ID	    Override	   Override
	      Name			    Level	   Level
	      lan6050	lan0	  100	7   CONF_PRI  0	   IP_HEADER	candy
	      lan5000	lan1	  75	3   CONF_PRI  64   IP_HEADER	honey
	      lan5001	lan1	  76	2   IP_HEADER 64   ETHER_HEADER bee

       You can alternatively use the command to get information about  a  spe‐
       cific  VPPA.  Let's say you are interested in VPPA 6050.	 The following
       command will get information regarding VPPA 6050.

	      VLAN	Physical  VLAN	Pri Pri	      ToS  ToS		NAME
	      Interface Interface ID	    Override	   Override
	      Name			    Level	   Level
	      lan6050	   lan0	  100	7   CONF_PRI  0	   IP_HEADER	candy

   Deleting a VLAN
       Before deleting a VLAN, ensure that there are no applications or	 upper
       layer protocols active on the VLAN by running:

       This  command displays the applications and commands that are presently
       using the interface.  For example, if the only thing  done  to  was  to
       configure an IP address, the command output would look like:

	      Interface 5000 is being used by 'ifconfig'
	      Process ID of application 'ifconfig' is 8631
	      Interface 5000 is being used by 'ifconfig'
	      Process ID of application 'ifconfig' is 8631

       Since  the  command was used to configure an IP address, the command is
       displayed.  There are two entries because when an IPv4 address is  con‐
       figured using it configures both IP and ARP on the interface.

       To remove the IP and ARP streams, do:

       The output will not show any entries now, which means the interface can
       be deleted.  To delete this VLAN, use the delete option as follows:

       The command always displays the commands that use or are configured  on
       the  interface.	 Lets  take  another  example, to delete the interface
       lan5001

	      Interface 5000 is being used by 'ifconfig'
	      Process ID of application 'ifconfig' is 8631
	      Interface 5000 is being used by 'ifconfig'
	      Process ID of application 'ifconfig' is 8631
	      Interface 5000 is being used by 'mib2agt'
	      Process ID of application 'mib2agt' is 9010
	      Interface 5000 is being used by 'scopeux'
	      Process ID of application 'scopeux' is 9020

       In addition to IP and ARP being configured on the interface, two appli‐
       cations,	 and  are using the interface.	These applications are started
       during system bootup via the startup scripts and respectively.  To stop
       these  utilities,  run the stop sequence of the scripts.	 To delete the
       lan5001 interface, type the following commands:

       Now, will not display anything, and the interface can be deleted.

       Once the interface is deleted, you can restart the scripts  by  issuing
       the start sequence:

       Note:  The  start  and stop sequence of the startup scripts will affect
       all the interfaces on the system, and they must be restarted  once  the
       delete operation is completed.

       The  above examples are not restrictive.	 The applications that use the
       interfaces depend on your environment.

WARNINGS
       Interactive changes made to VLANs with the command  will	 not  be  pre‐
       served  between	system reboots.	 You must use the command or interface
       (see nwmgr_vlan(1M) and ncweb(1M)).  You can  also  manually  edit  the
       configuration file to preserve changes across reboots.

   Obsolescence
       and  commands are deprecated.These commands will be removed in a future
       HP-UX release.  HP recommends the use of replacement command  nwmgr(1M)
       to perform all network interface related tasks.

AUTHOR
       was developed by HP.

SEE ALSO
       ifconfig(1M),  lanadmin(1M),  lanscan(1M),  nwmgr(1M),  nwmgr_vlan(1M),
       vlan(7).

       available on the HP Technical Documentation web site at

       IEEE 802.1d, IEEE 802.1Q f1

				TO BE OBSOLETED		     lanadmin_vlan(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net