|Attention: DocWiki has reached EOL and will be decommissioned January 25, 2019.|
This section describes how to use FACT.
Before FACT can perform other network tasks, you must first scan the network to determine which hosts and switches are in the network and to determine how they are connected. FACT scans an entire subnet at the same time, connecting to each managed Cisco switch and, optionally, to each port.
FACT has four scan types:
- Fabric scan--Finds the static configuration of the network. After collecting a fabric scan, FACT can display the network components and show how they are connected.
- Tech-support scan--Collects information that can be forwarded to a customer-support organization. A tech-support scan includes a fabric scan, which FACT can use, although FACT does not use the additional information. FACT saves that information for an expert to inspect.
- Port-counters scan--Collects port counters from the Performance Manager, in addition to the data collected in a fabric scan. See Port Counters for more information.
- Incomplete scan--A scan that has failed, either because of misconfiguration or because devices are not responding. The most common reason for an incomplete scan is either because the configuration does not include the device that is running the master Subnet Manager or because it includes two master Subnet Managers. In either case, change your configuration so that it includes exactly one master Subnet Manager. Alternately, you can force FACT to use the correct master Subnet Manager by setting subnet-manager: in the .fact.conf file or with the subnet-manager hostname command option.
Note: If you are using the High-Performance Subnet Manager, then you must allow FACT to scan the hosts running HSM.
You can use the --trace command option to show FACT communication with each managed node as it scans.
Use the following commands to scan with FACT:
- scan fabric
- scan tech-support
- scan counters raw
- scan counters monitored
- scan counters threshold
- reset port-counters
Maintaining the Repository
FACT maintains a repository that contains the results of past scans. FACT considers the last-performed scan in the repository as the current scan, which it uses for queries, annotations, port control, and firmware upgrades. Whenever you scan the network, the new scan becomes the current scan, although the repository has a history mechanism that allows the current scan to be rolled back to an earlier version.
By default, the repository is located at $HOME/.fact.
Use the show history command to view all scans. Each scan has an index number that you use to select any particular scan. Use the select command to change the current scan.
The following example shows that the current scan is scan 6, as designated by the letter “Y”:
$ fact fact> show history index current type date subnet-manager ----- ------- -------------- ------------------------- -------------- 1 fabric 2007-12-27 19:37:25 PST ibmg-r1-120-1 2 fabric 2007-12-27 19:39:28 PST ibmg-r1-360-1 3 fabric 2008-01-03 17:09:51 PST kbob-s1 4 fabric 2008-01-03 20:14:50 PST 172.29.232.102 5 fabric 2008-01-08 15:30:29 PST kbob-s1 6 Y fabric 2008-01-08 15:33:52 PST kbob-s1 fact>
From the current scan shown in the previous example, the following example shows selecting scan 4:
$ fact fact> select 4 fact> fact show history index current type date subnet-manager ----- ------- -------------- ------------------------- -------------- 1 fabric 2007-12-27 19:37:25 PST ibmg-r1-120-1 2 fabric 2007-12-27 19:39:28 PST ibmg-r1-360-1 3 fabric 2008-01-03 17:09:51 PST kbob-s1 4 Y fabric 2008-01-03 20:14:50 PST 172.29.232.102 5 fabric 2008-01-08 15:30:29 PST kbob-s1 6 fabric 2008-01-08 15:33:52 PST kbob-s1 fact>
You can delete old scans by selecting the scan number from the index and using the delete command. The following example shows deleting the first three scans from the list in the previous example:
$ fact fact> delete 1-3 fact> show history index current type date subnet-manager ----- ------- -------------- ------------------------- -------------- 1 Y fabric 2008-01-03 20:14:50 PST 172.29.232.102 2 fabric 2008-01-08 15:30:29 PST kbob-s1 3 fabric 2008-01-08 15:33:52 PST kbob-s1 fact>
Note: After you deleted scans 1 through 3, the scans that were previously listed as scans 4, 5, and 6 have remained, but they have now moved up in the index to become scans 1, 2, and 3.
You can export the current scan to a file with the export scan command, or you can export the entire repository with the export repository command. Similarly, you can import a scan with the import scan command or the import the entire repository with the import repository command.
If you need assistance in troubleshooting your network, you can use the export repository command. You can export the repository, save it to your specified location, and then make a copy to send to technical support.
You can clean out your repository with the delete scans command.
Note: Importing a repository deletes your existing repository and replaces it with the new repository that you import.
Use the following commands to maintain and manage your repository:
- show history
- export scan
- export repository
- import repository
- import scan
- delete scans