Setting Up the iSNS Administrative Settings (System Administration Guide: Devices and File Systems)

System Administration Guide: Devices and File Systems

Setting Up the iSNS Administrative Settings

This section provides the procedures for changing the default administrative settings of the iSNS service and for starting the iSNS daemon. If you change a setting after the iSNS server has been started, you need to refresh the iSNS server. If you change the data store location, you need to restart the iSNS server.

See the man page for the isns(1M) command details about these operations.

How to Set Notifications for Changes in Server State

By default, all clients are notified when the iSNS server is not available. To disable these notifications, change the Management_SCNs_Enabled property.

Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

Use the svccfg command to disable the property:

# svccfg -s svc:/network/isns_server setprop\config/Management_SCNs_Enabled=no

Reload the server configuration:

# svcadm refresh svc:/network/isns_server

How to Set the Number of Retries for Client Inquiries

The default number of retries is 3. If the server does not get a response to three inquiries, it registers that client as unavailable. To change the number of retries, change the value of the ESI Retry Threshold property.

Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

Use the svccfg command to change the property to, for example, 6 retries:

# svccfg -s svc:/network/isns_server setprop\config/ESI_retry_threshold_count=6

Reload the server configuration:

# svcadm refresh svc:/network/isns_server

How to Specify the Data Store Location

The default location and name for the file that contains the client data is /etc/isns/isnsdata.xml If you have a complex network environment that includes one or more backup iSNS servers, the data store must reside in a common location so that all servers can use it. Use the data_store_location property to specify the new location. You can also change the name of the file.

Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

Use the svccfg command to change the location to, for example, /etc/isns2/isns_data.xml:

svccfg -s svc:/network/isns_server setprop\config/data_store_location="/etc/isns2/isns_data.xml"

If you change the data store location after the server has been enabled, you must restart the server:
# svcadm restart svc:/network/isns_server

How to Enable the iSNS Server Daemon

Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

Set the server to start each time the system boots:

#svcadm -v enable svc:/network/isns_server
        svc:/network/isns_server:default enabled

Verify the state of the iSNS service:

#svcs svc:/network/isns_server:default
        STATE         STIME        FMRI
        online        11:50:04     svcs svc:/network/isns_server:default

How to Disable the iSNS Server Daemon

Use the “iSNS Server Management” RBAC profile to obtain the authorizations needed for managing the iSNS service.

Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

Set the server to start each time the system boots:

#svcadm -v disable svc:/network/isns_server
        svc:/network/isns_server:default disabled

Verify the state of the iSNS service:

#svcs svc:/network/isns_server:default
        STATE         STIME        FMRI
        disabled      11:51:05     svc:/network/isns_server:default