Brocade FOS REST Data Collector

12/05/2023 Contributors

Cloud Insights uses the Brocade FOS REST collector to discover inventory and performance for Brocade switch devices running FabricOS (FOS) firmware 8.2 and later.

By default, this collector will attempt to discover all the FOS devices that are a part of all the fabrics the switch is part of.

Terminology

Cloud Insights acquires the following inventory information from the Brocade FOS REST data collector. For each asset type acquired by Cloud Insights, the most common terminology used for this asset is shown. When viewing or troubleshooting this data collector, keep the following terminology in mind:

Vendor/Model Term	Cloud Insights Term
Switch	Switch
Port	Port
Virtual Fabric, Physical Fabric	Fabric
Zone	Zone
Logical Switch	Logical Switch
Virtual Volume	Volume
LSAN Zone	IVR Zone

Vendor/Model Term

Cloud Insights Term

Switch

Port

Virtual Fabric, Physical Fabric

Fabric

Zone

Logical Switch

Virtual Volume

Volume

LSAN Zone

IVR Zone

Note: These are common terminology mappings only and might not represent every case for this data collector.

Requirements

There must be TCP connectivity to all switches in the fabric. This data collector type will seamlessly try both HTTP and HTTPS for each device in the fabric. If you select the Discover all switches in the fabric check box, Cloud Insights identifies all the switches in the fabric; however, it needs TCP connectivity to these additional switches to discover them.
The same account is needed globally across all switches in the fabric. You can use the device's Web interface to confirm access.

Configuration

Field	Description
Switch IP	IP address or fully-qualified domain name of the FOS switch
User Name	User name for the switch
Password	Password for the switch

Field

Description

Switch IP

IP address or fully-qualified domain name of the FOS switch

User Name

User name for the switch

Password

Password for the switch

Advanced configuration

Field	Description
Excluded Devices	Comma-separated list of device IPv4 addresses to exclude from polling.
Inventory Poll Interval (min)	Interval between inventory polls. The default is 60.
Discover all switches in the fabric	Select to discover all switches in the fabric.
Choose Favoring HBA vs. Zone Aliases	Choose whether to favor HBA or zone aliases.
Connection type	HTTP or HTTPS.
Note that this setting only changes which protocol CI attempts to use per device first - CI will attempt the opposite protocol automatically if the default fails	Override TCP Port
Specify a port if not using the default.	Performance Poll Interval (sec)

Field

Description

Excluded Devices

Comma-separated list of device IPv4 addresses to exclude from polling.

Inventory Poll Interval (min)

Interval between inventory polls. The default is 60.

Discover all switches in the fabric

Select to discover all switches in the fabric.

Choose Favoring HBA vs. Zone Aliases

Choose whether to favor HBA or zone aliases.

Connection type

HTTP or HTTPS.

Note that this setting only changes which protocol CI attempts to use per device first - CI will attempt the opposite protocol automatically if the default fails

Override TCP Port

Specify a port if not using the default.

Performance Poll Interval (sec)

Troubleshooting

Some things to try if you encounter problems with this data collector:

Inventory

Problem:	Try this:
The Test feature warns me that a protocol is inaccessible	A given Brocade FOS 8.2+ device will only want to speak on HTTP or HTTPS - if a switch has a digital certificate installed, the switch will throw HTTP errors if one attempts to communicate to it with unencrypted HTTP versus HTTPS. The test feature attempts communication with both HTTP and HTTPS - if the Test tells you that one protocol passes, you can safely save the collector and not worry that the other protocol was unsuccessful - the collector will attempt both protocols during collection, and only fail if neither works.
Error: “Cloud Insights received Invalid Chassis Role”	Check that the user configured in this data source has been granted the chassis role permission.
Error: "Mismatched Chassis IP Address"	Change the data source configuration to use chassis IP address.
Receive a message that more than 1 node is logged into the Access Gateway port	Check that the NPV device is operating correctly and that all connected WWNs are expected. Do not directly acquire the NPV device. Instead, acquisition of the core fabric switch will collect the NPV device data.
Performance collection fails with "Timed out during sending SNMP request".	Depending on query variables and switch configuration, some queries may exceed the default timeout. Learn More.

Problem:

Try this:

The Test feature warns me that a protocol is inaccessible

A given Brocade FOS 8.2+ device will only want to speak on HTTP or HTTPS - if a switch has a digital certificate installed, the switch will throw HTTP errors if one attempts to communicate to it with unencrypted HTTP versus HTTPS. The test feature attempts communication with both HTTP and HTTPS - if the Test tells you that one protocol passes, you can safely save the collector and not worry that the other protocol was unsuccessful - the collector will attempt both protocols during collection, and only fail if neither works.

Error: “Cloud Insights received Invalid Chassis Role”

Check that the user configured in this data source has been granted the chassis role permission.

Error: "Mismatched Chassis IP Address"

Change the data source configuration to use chassis IP address.

Receive a message that more than 1 node is logged into the Access Gateway port

Check that the NPV device is operating correctly and that all connected WWNs are expected. Do not directly acquire the NPV device. Instead, acquisition of the core fabric switch will collect the NPV device data.

Performance collection fails with "Timed out during sending SNMP request".

Depending on query variables and switch configuration, some queries may exceed the default timeout. Learn More.

Additional information may be found from the Support page or in the Data Collector Support Matrix.