idssethost

Use the idssethost command to set IP addresses for a directory server instance to bind.

Description

The idssethost command can be run only by a root user on UNIX or a member of the Administrators group on Windows systems by default. You can manually change the permissions on the instance repository files to allow other users to run the command. Users with the access to read the ibmslapd.conf files of all directory server instances on the system can run the command.

This command sets the IP addresses so that a particular directory server instance can bind to it. The administrator specifies a directory server instance name and a list of IP addresses. If the directory server instance and the administration server of the instance is running, then you must stop the processes before you update. Theidssethost command does not allow the IP addresses to be changed, if another instance is using the same ports on the specified IP addresses. The command replaces all of the current IP addresses that are configured for the directory server instance. If you specify to listen on all available IP addresses, the IP address attribute is removed from the configuration file.

Synopsis

idssethost [-I instance_name –i ip_address [-d debuglevel] 
           [-b outputfile] [-q] [-n]] | -v | -?

Options

The idssethost command takes the following parameters.

-b outputfile: Specifies the full path of a file to redirect console output. If you use this parameter with the -q parameter, errors are sent to the outputfile file. If debug mode is set, then the debug output is sent to this file.
-d debuglevel: Sets the LDAP debug level to debuglevel. If you specify this parameter, the command sends the debug output to stdout. The debuglevel value is a bit mask that controls which output is generated with values from 1 to 65535. For more information about debug levels, see Debugging levels.
-i ip_address: Specifies the IP address to which the directory server instance binds. If more than one IP address is specified, the comma separator must be used with no spaces. Spaces are allowed only if the entire argument is surrounded in quotation marks. To use all available IP addresses, use the key word, all. All available IP addresses is the default setting, if you do not specify the -i parameter.
-I instance_name: Specifies the directory server instance name to update.
-n: Specifies to run in no prompt mode. All output from the command is generated, except for messages that require user interaction.
-q: Specifies to run in quiet mode. All output from the command is suppressed, except for error messages. If you also specify the -d parameter, then the trace output is not suppressed.
-v: Specifies to show the version information of the command.
-?: Specifies to show the syntax format.

Examples

Example 1:

To update the IP addresses of the myinst directory server instance to bind on 1.3.45.668, run the following command:

idssethost -I myinst –i 1.3.45.668

Example 2:

To update the IP addresses of the myinst directory server instance to bind to all available IP addresses, run the following command:

idssethost -I myinst –i all

Note: You can change the host name by using the idsldapmodify command or Web Administration Tool. The modify command might fail, if the IP address specified is not valid. To ensure that there are no conflicts with other ports on particular IP addresses, the IP address updates are done by the root on the system.