System Administration Guide: IP Services

`mipagent.conf.ha-sample` File

The following listing shows the sections, labels, and values that are contained in the mipagent.conf.ha-sample file. Configuration File Sections and Labels describes the syntax, sections, labels, and values.

The mipagent.conf.ha-sample file shows a configuration that provides only home agent functionality. Otherwise, this file is the same as the mipagent.conf-sample file.

[General]
   Version = 1.0    # version number for the configuration file. (required)
   
[Advertisements hme0]
   HomeAgent = yes
   ForeignAgent = no
   PrefixFlags = yes
   AdvertiseOnBcast = yes
   RegLifetime = 200
   AdvLifetime = 200
   AdvFrequency = 5
   ReverseTunnel = yes
   ReverseTunnelRequired = no

[GlobalSecurityParameters]
   MaxClockSkew = 300
   HA-FAauth = yes
   MN-FAauth = yes
   Challenge = no
   KeyDistribution = files

[Pool 1]
   BaseAddress = 10.68.30.7
   Size = 4

[SPI 257]
   ReplayMethod = none
   Key = 11111111111111111111111111111111

[SPI 258]
   ReplayMethod = none
   Key = 15111111111111111111111111111111

[Address 10.1.1.1]
   Type = node
   SPI = 258

[Address [email protected]]
   Type = node
   SPI = 257
   Pool = 1

[Address Node-Default]
   Type = node
   SPI = 258
   Pool = 1[Address 10.68.30.36]
    Type = agent    
    SPI = 257    
    IPsecRequest = apply {auth_algs md5 sa shared} 
    IPsecReply = permit {auth_algs md5}  
    IPsecTunnel = apply {encr_algs 3des sa shared}

Configuration File Sections and Labels

The Mobile IP configuration file contains the following sections:

General (Required)
Advertisements (Required)
GlobalSecurityParameters (Optional)
Pool (Optional)
SPI (Optional)
Address (Optional)

The General and GlobalSecurityParameters sections contain information relevant to the operation of the Mobile IP agent. These sections can appear only once in the configuration file.

`General` Section

The General section contains only one label: the version number of the configuration file. The General section has the following syntax:

[General]
     Version = 1.0

`Advertisements` Section

The Advertisements section contains the HomeAgent and ForeignAgent labels, as well as other labels. You must include a different Advertisements section for each interface on the local host that provides Mobile IP services. The Advertisements section has the following syntax:

[Advertisements interface]
     HomeAgent = <yes/no>
     ForeignAgent = <yes/no>
     .
     .

Typically, your system has a single interface, such as eri0 or hme0, and supports both home agent and foreign agent operations. If this situation exists for the example hme0, then the yes value is assigned to both the HomeAgent and ForeignAgent labels as follows:

[Advertisements hme0]
     HomeAgent = yes
     ForeignAgent = yes
     .
     .

For advertisement over dynamic interfaces, use '*' for the device ID part. For example, Interface-name ppp* actually implies all PPP interfaces that are configured after the mipagent daemon has been started. All the attributes in the advertisement section of a dynamic interface type remain the same.

The following table describes the labels and values that you can use in the Advertisements section.

Table 29-1 Advertisements Section Labels and Values

Label	Value	Description
`HomeAgent`	`yes` or `no`	Determines if the `mipagent` daemon provides home agent functionality.
`ForeignAgent`	`yes` or `no`	Determines if `mipagent` provides foreign agent functionality.
`PrefixFlags`	`yes` or `no`	Specifies if advertisements include the optional prefix-length extension.
`AdvertiseOnBcast`	`yes` or `no`	If `yes`, advertisements are sent on `255.255.255.255`, rather than `224.0.0.1`.
`RegLifetime`	`n`	The maximum lifetime value that is accepted in registration requests, in seconds.
`AdvLifetime`	`n`	The maximum length of time that the advertisement is considered valid in the absence of further advertisements, in seconds.
`AdvFrequency`	`n`	Time between two consecutive advertisements, in seconds.
`ReverseTunnel`	`yes` or `noFA` or `HA` or `both`	Determines if `mipagent` provides reverse-tunnel functionality. The value `yes` means that both the foreign agent and home agent support reverse tunneling. The value `no` means that the interface does not support reverse tunneling. The value `FA` means that the foreign agent supports reverse tunneling. The value `HA` means that the home agent supports reverse tunneling. The value `both` means that both the foreign agent and home agent support reverse tunneling.
`ReverseTunnelRequired`	`yes` or `no`	Determines if `mipagent` requires reverse tunnel functionality. Consequently, determines if a mobile node must request a reverse tunnel during registration. The value `yes` means that both the foreign agent and home agent require a reverse tunnel. The value `no` means that the interface does not require a reverse tunnel. The value `FA` means that the foreign agent requires a reverse tunnel. The value `HA` means that the home agent requires a reverse tunnel.
`AdvInitCount`	`n`	Determines the initial number of unsolicited advertisements. The default value is 1. This value is meaningful only if `AdvLimitUnsolicited` is `yes`.
`AdvLimitUnsolicited`	`yes` or `no`	Enables or disables a limited number of unsolicited advertisements over the mobility interface.

mipagent.conf.ha-sample File

Configuration File Sections and Labels

General Section

Advertisements Section

`mipagent.conf.ha-sample` File

`General` Section

`Advertisements` Section