The information contained in this document is subject to change. This document contains proprietary information, which is protected by copyright
laws. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language or program language
without prior written consent of RFI Engineering B.V.
QIG_G-router_1.2.2
Page: 17(
21)
5 Advanced configuration, user ‘root’
All configuration of the G-router is stored in and retrieved from the Hierarchical Information Base
(HIB). The HIB is a database for storing configuration and run-time information for (embedded)
RFI products. All manipulation of configuration elements of the unit is done through the
command line interface tool called the HIB client (hipc). Only user ‘root’ has access through all
configuration settings of the G-router. Normal day-to-day operation should always be performed
by the user ‘admin’ or any of its sub-users. Root access is only applicable in case you want to
make upgrades to the software.
The HIB uses a tree-shaped hierarchical data structure for storing objects. A schema defines the
hierarchical relations of the objects in the tree, and describes the properties of each object.
The schema-tree is built from the following node types:
•
Group
: A group is a container for holding other 'child' nodes.
•
Object
: An object is the 'leaf' of the tree, which contains the actual data.
•
Array
: An array is a container which can hold zero or more copies of its sub-tree.
Every entry in an array is identified by an integer index, starting from 0. The following diagram
is an example of a simple schema:
-- config (group)
|-- network (group)
| |-- interface (array)
| | |-- ifname (object)
| | |-- ip_address (object)
| | `-- netmask (object)
`-- hostname (object)
To retrieve a configuration setting you have to give the HIB client “
hibc ls
” command followed
by the group, object or array identifier. For example to retrieve the current IP address
configuration of the G-router you would give the following command:
hibc ls -rl /config/network/eth0/
Srwp 47 Jan 1 02:09 |- ip_method "static"
Or-- 48 Jan 1 00:00 | |- static
-rwp 49 Jan 1 02:09 | | |- ip_address "192.168.168.1"
-rwp 50 Jan 1 00:00 | | |- netmask "255.255.255.0"
-rwp 51 Jan 1 00:00 | | |- gateway "192.168.168.254"
Lrwp 52 Jan 1 00:00 | | `- dns
Or-- 53 Jan 1 00:00 | `- dhcp
Lrwp 54 Jan 1 00:00 |- route
Lrwp 55 Jan 1 00:00 `- alias
The setting of configuration elements is done through the HIB client by giving the command
“
hibc set
”. For example to set the IP address of the G-router you would give the following
command:
hibc set config/network/eth0/ip_method/static/ip_address "192.168.168.1"
The following paragraphs describe a number of examples for getting and setting information in
the G-router.
