Configuring Collectors and Receivers

To configure the router to collect statistics:

1. Add names to the FTP host table for the primary and secondary (optional) receivers.

   See Copying and Redirecting Files in Managing the System , for information about adding names to the host table.

2. Specify the type of interface on which you want to collect statistics.

   host1(config)#bulkstats interface-type ppp collector 2

3. Specify the parameters for the receivers.

   host1(config)#bulkstats receiver 1 remote-name js:/ftptest/bulk%s%s.sts sysName sysUpTime

4. Assign the data collector.

   host1(config)#bulkstats collector 2

5. Specify the method for data collection.

   host1(config)#bulkstats collector 2 collect-mode auto

6. Assign the primary receiver.

   host1(config)#bulkstats collector 2 primary-receiver 1

7. (Optional) Assign the secondary receiver.

   host1(config)#bulkstats collector 2 secondary-receiver 5

8. (Optional) Specify the time for which the system transfers data.

   host1(config)#bulkstats collector 2 interval 1000

9. (Optional) Set the maximum size of the bulk statistics file.

   host1(config)#bulkstats collector 2 max-size 20480

10. (Optional) Add descriptive information to the bulk statistics file.

    host1(config)#bulkstats collector 2 description customer xyz

11. (Optional) Set the encoding scheme of the ifDescr and ifName objects.

    host1(config)#bulkstats interfaces description-format common

12. (Optional) Set the system to retrieve bulk statistics once only.

    host1(config)#bulkstats collector 2 single-interval

13. (Optional) Configure bulk statistics traps.

    host1(config)#bulkstats traps nearly-full

14. (Optional) Collect bulk statistics per virtual router.

    host1(config)#bulkstats virtual-router-group collector 2 routerISP3

    Note: The bulk statistics feature supports generating files on a per interface basis.

bulkstats collector

• Use to assign the data collector.
• Example

  host1(config)#bulkstats collector 2

• Use the no version to delete the collector.
• See bulkstats collector.

bulkstats collector

• Use to specify the way the collector retrieves bulk statistics.
• Example

  host1(config)#bulkstats collector 2 collect-mode auto

• Use the no version to specify that either the user or the system will initiate transfers manually.
• See bulkstats collector.

bulkstats collector

• Use to add descriptive information to the bulk statistics file.
• Example

  host1(config)#bulkstats collector 2 description customer xyz

• Use the no version to remove descriptive text from the bulk statistics file.
• See bulkstats collector.

bulkstats collector

• Use to specify the time interval in seconds for which the collector transfers data to the receivers.
• Example

  host1(config)#bulkstats collector 2 interval 1000

• Use the no version to set this time to the default, 360 seconds (6 minutes).
• See bulkstats collector.

bulkstats collector

• Use to set the maximum size of the bulk statistics file for all collectors combined. Even when you configure more than one collector, the first maximum file size configured is the combined size of all collectors.
• The maximum file size that you can configure is 20971520 bytes. However, if you do not configure a maximum size, then the maximum file size defaults to 5767168 bytes.
• Although the CLI accepts the commands, you cannot unconfigure or modify the configuration of the maximum file size until the router is rebooted.
• Example

  host1(config)#bulkstats collector 2 max-size 20480

• Use the no version to set the size of the bulk statistics file to the default, 5767168 bytes.
• See bulkstats collector.

bulkstats collector

• Use to assign the primary receiver to which the system transfers data.
• The index for the receiver must match the index that you specified with the bulkstats receiver remote-name command.
• Example

  host1(config)#bulkstats collector 2 primary-receiver 7

• Use the no version to clear the primary receiver and disable the collector.
• See bulkstats collector.

bulkstats collector

• Use to assign the secondary (that is, the backup) receiver to which the system transfers data.
• The index for the receiver must match the index you specified with the bulkstats receiver remote-name command.
• Example

  host1(config)#bulkstats collector 2 secondary-receiver 5

• Use the no version to clear the secondary receiver.
• See bulkstats collector.

bulkstats collector

• Use to set the system to retrieve bulk statistics once only, rather than periodically.
• Example

  host1(config)#bulkstats collector 2 single-interval

• Use the no version to set the system to retrieve bulk statistics periodically, the default situation.
• See bulkstats collector.

bulkstats interfaces description-format common

• Use to set the encoding scheme of the ifDescr object that the bulk statistics application reports to the conventional industry method.
• This command provides compatibility with software that uses the industry encoding scheme.
• For more information, see Configuring Encoding Method .
• Example

  host1(config)#bulkstats interfaces description-format common

• Use the no version to return to the proprietary method of encoding.
• See bulkstats interfaces description-format common.

bulkstats interface-type

• Use to configure the interface or subinterface type on which you want to collect statistics.
• You can provide an interface specifier (location) to identify a specific interface on which you want to collect statistics.
• If you define more than one collector, you must specify a unique collector index, in the range 1–65535.
• The supported interface types are:
  • atm—Collects statistics on ATM interfaces
  • atm1483—Collects statistics on ATM 1483 interfaces
  • ethernet—Collects statistics on Ethernet interfaces
  • frame-relay—Collects statistics on Frame Relay interfaces
  • frame-relay-sub—Collects statistics on Frame Relay subinterfaces
  • hdlc—Collects statistics on Cisco HDLC interfaces
  • ip—Collects statistics on IP interfaces
  • mplsMajor—Collects statistics on MPLS major interfaces
  • mplsMinor—Collects statistics on MPLS minor interfaces
  • mplsL2shim—Collects statistics on MPLS shim interfaces
  • ppp—Collects statistics on PPP
  • vlan—Collects statistics on VLAN subinterfaces

    Note: You cannot collect statistics on the SRP Ethernet interface.

• Example 1

  host1(config)#bulkstats interface-type ppp 3/1 collector 2

• Example 2

  host1(config)#bulkstats interface-type vlan 2/3:1 collector 1

• Example 3

  host1(config)#bulkstats interface-type mplsMajor 2/3:1 collector 1

• Use the no version to delete the interface type from bulk statistics collection. Deletion of a particular interface type takes effect at the next collection interval.
• See bulkstats interface-type.

bulkstats receiver remote-name

• Use to configure the parameters for receivers.
• Bulk statistics transfers require the configuration of a remote FTP server.
• The receivers must appear in the FTP host table. The name of the host must match the name you specify with this command. The hostname is relative to the virtual router’s context when you issue this command.
• When specifying the remote filename for bulk statistics, you must precede the filename with the hostname followed by the :/ characters.
• Example

  host1(config)#bulkstats receiver 1 remote-name js:/ftptest/bulk%s%s.sts sysName sysUpTime

  Note: The % variables in the remote name are replaced at runtime with the sysName and sysUpTime parameters to produce variable filenames on the remote host.

• Use the no version to delete the receiver.
• See bulkstats receiver remote-name.

bulkstats traps

• Use to configure bulk statistics traps.
• You must configure SNMP correctly and specify a valid trap source. Otherwise, the system will not send SNMP traps.
• Example

  host1(config)#bulkstats traps nearly-full

• Use the no version to disable the trap.
• See bulkstats traps.

bulkstats virtual-router-group

• Use to collect interface statistics for each virtual router.
• A collector can have a maximum of 64 virtual routers associated with it.
• Routers are identified by their assigned name or router index.
• Supported only on if-stats and igmp schemas.
• Supported on all interface types supported by the bulk statistics application.
• Collectors modified to use per virtual router collection or configured after a collector has started have a time delay until an active collector starts again.
• Example

  host1(config)#bulkstats virtual-router-group collector 2 routerISP3

• Use the no version to prevent bulkstats from being reported for virtual router groups.
• See bulkstats virtual-router-group.

Copyright © 2008, Juniper Networks, Inc. All rights reserved. Trademark Notice.