The inventory module allows you to discover equipment on a computer network and to use the information collected. It can be used to consult general information about machines (IP address, type, name, services in operation, etc.), or to put equipment under supervision.
In this document, we will see how to exploit all the functionalities offered by this module.
Presentation of the module
To access the interface of the census module, go to the menu level Configuration > Equipment > Census.
Figure 1 - Composition of the census module
As shown in Figure 1, the census module is composed of the elements :
- A search form
- A census start-up form
- A filter bar
- A table control bar
- A table of results
Launching a census
The start of a census is made from the button Census.
Figure 2 - Census Initiation Form
Several pieces of information can be filled in to launch a census:
- Tab Network discovery parameters
- BoxSelect the supervision box from which the census will be carried out.
- IP Addresses IP addresses: IP addresses on which network discovery is to be carried out. It is possible to specify either a range or a list of IP addresses (separated by a comma).
- PurgeIf this box is checked, all data from previous censuses will be deleted before starting the new one.
- Tab Accounts
- SNMP and SNMP v3 connection SNMP: communities to be used to retrieve information via the SNMP protocol. This entry is not mandatory but the information retrieved will be more complete if it is correctly filled in. It is possible to enter multiple communities separated by commas. In this case, the box will retrieve the information using the community that provides the most information.
- Windows Login - Admin WMI connection: Fill in the account to be used to test the WMI connection. This must be a host or domain administrator account. The format of a domain account is:
/ . Attention : these two fields are case-sensitive.
- VMware Connection Enter the account to be used to test the VMware connection. This account must be a member of the "user" group and must have Read Only rights on the hypervisor.
- Hyper-V connection Hyper-V hypervisor connection test: Fill in the account to be used to test the connection to a Hyper-V hypervisor.
- Citrix XEN Connection : fill in the account to be used to test the connection to a Xen hypervisor.
Note There can be no duplicate IP addresses in the census results. Thus, if an old census had reported information for an IP address and a new census must report information for the same IP address, the old information will be deleted and replaced.
Click on the button Validate is used to start the census. A progress bar appears. It is automatically refreshed every 15 seconds. This allows you to evaluate the progress of the census.
Figure 3 - Progress bar
Unlike the progress bar, the census data are not automatically refreshed in the results table. You can, however, explicitly request this using the "play" button.
Searching the results is possible using the search form :
Figure 4 - Search form
This form allows you to search for equipment according to several criteria:
- Name / addressOnly devices whose name or IP address contains the entered string will be displayed.
- Unanswered protocols Ping : allows you to display equipment that has not responded to Ping, SNMP or WMI. Note WMI connection is only available on Windows type equipment (Microsoft technology). Checking this box does not affect other types of equipment.
- Supervisory status : allows you to display only the equipment already in supervision / not yet in supervision / both. If no box is checked, both will be displayed.
Note all these fields are cumulative. Thus, if we search for the IP address 192.168.0.14 by checking the status UnsupervisedIf the IP address is not available, the IP address will only be searched for equipment that is not supervised.
Filter by type of equipment
Filtering according to the type of equipment can be done from the filter bar. This can be seen as a complement to the search form.
Figure 5 - Filter bar
The following types of equipment can be selected:
- All no filtering is performed, all equipment is displayed
- Windows Server Servers equipped with Windows operating system
- Linux Server : servers equipped with the Linux operating system
- Server (other)servers equipped with another operating system
- Printer printers accessible from the network
- Phone : IP phones, connected to the network
- Camera IP cameras, connected to the network
- Other equipment of which the type could not be detected
Note : just like the options of the search form, the filtering of equipment is carried out cumulatively : if a search has been validated and you click on RoutersThis search will only be performed on routers.
Checking the board
These bars are used to control the results table.
Figure 6 - Table control bar
Refreshing the data
Figure 7 - Data refresh buttons
These three buttons allow you to control the refreshing of the data in the table:
- The first launches a punctual update of the data.
- The second allows to launch an automatic refresh: every 30 seconds, the data is automatically reloaded.
- The last one is its complement: it allows to stop the automatic update.
Figure 8 - Pagination
When too many lines are displayed, the data is paginated. In green appears the current page displayed. The numbers not highlighted show the other available pages and allow access to them. The double arrow allows you to go to the last page of the table.
Perform an action on the selection
Figure 9 - Action on selection
The buttons Add to supervision and Delete from the census allow equipment to be supervised and equipment to be removed from the census.
Note : the action is launched as soon as the button is selected. It is therefore necessary to have previously selected the equipment on which the action is to be performed.
Number of responses per page
Figure 10 - Selecting the number of lines per page
The last element of the control bar allows you to choose the number of lines to be displayed on each page.
Using the table, the data reported
The results table is the central element of the census module. It enables the data collected through the discovery of the network to be consulted and used.
Figure 11 - Results Table
Each line in the table corresponds to a piece of equipment present on the network. The main information on the equipment is displayed directly in this table :
- Actions If the equipment is not yet supervised, this column allows you to select the equipment in order to apply an action to it. Next to the check box, a button in the form of an image displays a more detailed supervision form. On the other hand, if the equipment is already supervised, a specific icon indicates it.
- IP address IP address: IP address of the equipment from which it was collected.
Note If a machine has more than one IP address, it may appear more than once in the table.
- Name of host Display name : displays the name retrieved from NMAP. If no name has been retrieved, its IP address is displayed.
- Description : description of the equipment. If it is a server, its operating system is displayed.
- Services List of services in operation on the machine.
Note Some services may be in operation even though their port is closed. This information is displayed in the detailed information window.
- Protocols Ping : allows you to know if the equipment has responded to ping, SNMP or WMI protocols.
1. One registration green means that the box has:
- ping: received a reply to the ping
- snmp: succeeded in establishing an SNMP connection
- wmi: successfully established a WMI connection
2. Red The protocol in question did not allow communication with the machine in question.
3. Grey and crossed out protocol not available for the machine concerned
Detailed information window
A window displaying the machine's detailed information appears when you click its IP address.
Figure 12 - Detailed Information Window
This information is grouped into four categories:
- General identification, equipment, operating system and census information.
- Network Displays information about the machine's network interfaces.
Note : available only if SNMP responded.
- Services services in operation when the census was taken. Also allows to know the port number associated with the service, its status (closed, open, filtered) and the service protocol (udp, tcp).
Note : available only if NMAP responded.
Note 2 Service list: this tab can be directly displayed by clicking on the list of services in the results table.
- Storage Display: Displays the partitions mounted on the equipment with their total space.
Note : available only if SNMP responded.