@@ -102,6 +102,7 @@ The oaradmin lines are sent to STDOUT, the logging data to STDERR.
...
@@ -102,6 +102,7 @@ The oaradmin lines are sent to STDOUT, the logging data to STDERR.
== Filling the reference - Guidelines ==
== Filling the reference - Guidelines ==
=== <code>network_adapters</code> ===
=== <code>network_adapters</code> ===
Many machines have several network interfaces, which are not always all configured. We have identified 4 cases in G5K clusters:
Many machines have several network interfaces, which are not always all configured. We have identified 4 cases in G5K clusters:
...
@@ -110,30 +111,61 @@ Many machines have several network interfaces, which are not always all configur
...
@@ -110,30 +111,61 @@ Many machines have several network interfaces, which are not always all configur
# The interface is not mounted in the production environment, but users may use it in their own deployed environment.
# The interface is not mounted in the production environment, but users may use it in their own deployed environment.
# The interface is mounted in the production environment.
# The interface is mounted in the production environment.
After several discussions inside the PS team, we have fixed some attributes but some still require a decision (those with a leading *). We cannot change the names of the fixed attributes for backward compatibility reasons, only their role if necessary. <u>'''Underlined attributes'''</u> would always have to be defined.
After several discussions inside the PS team, we have fixed some attributes. All of them are mandatory, but the ones between square brackets are only <font color="#FF0000">mandatory under conditions</font>. Those conditions follow the field name, in <font color="#FF0000">red</font>.
* <u>'''interface'''</u>: the type of network interface, ∈ {"Ethernet", "Myrinet", "InfiniBand"}
* '''interface''': the type of network interface, ∈ {"Ethernet", "Myrinet", "InfiniBand"}
:: NB: It is useless to define "Myrinet 10G" or "Myri-2000" values, because the '''rate''' will differentiate them.
:: NB: It is useless to define "Myrinet 10G" or "Myri-2000" values, because the '''rate''' will differentiate them.
* <u>'''rate'''</u>: speed of the interface in b/s
* '''rate''': speed of the interface in b/s
* * <u>'''mac'''</u>: the MAC address of this interface
* '''mac''':
:: Alternate propositions: '''mac_address'''
:if '''interface''' ∈ {"Ethernet", "Myrinet"}, the MAC address of this interface,
:if '''interface'''=="InfiniBand", its GUID.
* '''vendor''': the company which made the device
* '''vendor''': the company which made the device
* '''version''': its version according to the company nomenclatura
* '''version''': its version according to the company nomenclatura
* '''driver''': name of the driver for the device in the linux kernel
* '''enabled''': <code>true</code> if there is any cable connected to this interface
* <u>'''enabled'''</u>: <code>true</code> if there is any cable connected to this interface
:* ['''management''']''<font color="#FF0000">(if '''enabled'''==true)</font>'': <code>true</code> if this interface is on the administration network (IPMI,...)
* * <u>'''management'''</u>: <code>true</code> if this interface is on the administration network (IPMI,...)
::* ['''network_address''']''<font color="#FF0000">(if '''mounted'''==true or '''management'''==true)</font>'': the DNS entry of the machine by this interface
* * <u>'''mountable'''</u>: <code>true</code> if it is usable by any user (even if it possibly requires a customized environment)
:* ['''mountable''']''<font color="#FF0000">(if '''enabled'''==true)</font>'': <code>true</code> if it is usable by any user (even if it possibly requires a customized environment)
::* ['''mounted''']''<font color="#FF0000">(if '''mountable'''==true)</font>'': <code>true</code> if the production environment mounts, configures this interface
* * <u>'''mounted'''</u>: <code>true</code> if the production environment mounts, configures this interface
:::* ['''network_address''']''<font color="#FF0000">(if '''mounted'''==true or '''management'''==true)</font>'': the DNS entry of the machine by this interface
:* ['''ip''']''<font color="#FF0000">(if '''enabled'''==true)</font>'': the IP of this interface
* * <u>'''device'''</u>: name of this interface in the production environment (would be <u>'''mandatory'''</u> if '''mounted'''==true)
:* ['''ip6''']: the IPv6 of this interface, for future use...
* '''network_address''': the DNS entry of the machine by this interface (<u>'''mandatory'''</u> if '''mounted'''==true)
* '''ip''': the IP of this interface (<u>'''mandatory'''</u> if '''enabled'''==true)
[ EDIT - 2010-09-13 ] No contestation, no more votes for the alternate propositions and no other entry proposed => the base version is validated.
* * '''ip6''': the IPv6 of this interface, for future use...
:: Alternate propositions: '''ipv6_address'''
==== script reaching IP/MAC addresses of cluster ====
There is also a proposition where '''mounted''' is renamed as '''enabled''', which preserves the backward compatibility on the attribute name, but the role of '''enabled''' would be given to an attribute '''connected''', or '''wired'''.
Some scripts have been created to ease the retrieving of MAC/IP addresses on cluster. Get them
==== how to retrieve the guid on Infiniband card ====
Here a sample of an ohai plugin (included on the useful gem [https://helpdesk.grid5000.fr/redmine/projects/reference-helper/wiki/Wiki reference-helper] ! ) :