isns_servers File

Edit online

Purpose

Configures iSNS servers.

Description

The isns_servers file is used to configure iSNS servers. This file is used for the iSCSI target registration with iSNS protocol while configuring an iSCSI target. You can use comments in the isns_servers file. The comment character is "*", and must be the first character on the line. Blank lines are ignored.

The isns_servers file is a stanzas normalized file. Each stanza can be defined with the following two attributes:

  • ip_address defines the IP address of the server.
  • port defines the server listening port.

The default stanza defines the default ip_address and port that are used if one field is omitted.

The registration_period stanza allows you to set the refresh period for the iSNS registration. The iSNS server removes the registration after a period of time. A daemon has to refresh registrations before this lifetime. The period field of registration_period defines the period of time that an iSNS daemon can use. This setting is common for all iSNS servers that are defined in this file.

Examples

Example configuration Description
default:
  • ip_address: auto
  • port: 3205
registration_period:
  • period: 120
myserver:
  • ip_address: 172.16.128.4
isns_srv:
  • ip_address: 172.16.128.108
  • port: 3206
 This configuration defines the following characteristics:
  • A remote iSNS server (myserver) whose IP address is 172.16.128.4 and listens on the default iSNS server port 3205.
  • A remote iSNS server (isns_srv) whose IP address is 172.16.128.108 and listens on port 3206.
  • An iSNS daemon refreshes registrations with the iSNS server every 120 seconds.
default:
  • ip_address: 172.16.128.4
  • port: 3205
registration_period:
  • period: 900
myserver1:

myserver2:

  • port: 3206
isns_srv:
  • ip_address: 172.16.128.108
 This configuration defines the following characteristics:
  • Two remote iSNS servers (myserver1 and myserver2) that both have the default IP address 172.16.128.4. myserver1 listens on the default iSNS server port 3205. myserver2 listens on port 3206.
  • A remote iSNS server (isns_srv) whose IP address is 172.16.128.108 and listens on port 3205.
  • An iSNS daemon refreshes registrations with the iSNS server every 900 seconds (or 15 minutes).
Attention: Do not rename the following fields: default, ip_address, port, registration_period and period.

Files

Item Description
/etc/tmiscsi/isns_servers Configures iSNS servers.