idsilist

Use the idsilist command to list directory server instances on the system.

Description

The idsilist command can be run only by root on UNIX systems or a member of the Administrators group on Windows systems. Based on the parameter that is used, the command lists a directory server instance or all directory server instances that exist on the system. The command retrieves detailed information about each instance on a system.

Note: You can manually change the permissions on the directory instance repository files to allow the command to be run by other users. Users with permissions to read the ibmslapd.conf file of all directory server instances on a system can run the command successfully.

Synopsis

idsilist [[-I instance_name][-a | -r] [-d debuglevel] [-b outputfile]] | -v | -?

Options

The idsilist takes the following parameters.

-a: Specifies to list the full information about each instance on the system. This parameter cannot be used with the -r parameter.
-b outputfile: Specifies the full path of a file to redirect console output. 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 instance_name: Specifies the directory server instance name for which to list instance information.
-r: Specifies to list the full information about each instance on the system. This parameter shows the same information as the -a parameter, but the information is printed in a raw format. The information about each instance is printed on a separate line and each data item is separated by a number sign (#). This parameter cannot be used with the -a parameter.
-v: Specifies to show the version information of the command.
-?: Specifies to show the syntax format.

Examples

Example 1:

To list details about the directory server instance, myinst1, run the following command:

idsilist -I myinst1

The command generates the following output:

Directory server instance(s):
myinst1

You can also use the -a or -r parameter with the -I instance_name parameter to get the detailed information about the instance. For example: idsilist -I myinst1 -a or idsilist -I myinst1 -r.

Example 2:

To list complete details about instances, run the idsilist command along with the -I and -a parameters. For example:

idsilist -I myinst1 -a

Directory server instance(s):

--------------------------------------
Name: myinst1
Version: 6.4
Location: /home/myinst1
Description: IBM Security Directory Server Instance V6.4
IP Addresses: All available
Port: 4389
Secure Port: 4636
Admin Server Port: 3544
Admin Server Secure Port: 3545
Type: Directory Server

Example 3:

To list complete details about instances without description for each value, run the idsilist command along with the -I and -r parameters. For example:

idsilist -I myinst1 -r

Directory server instance(s):
myinst1#6.4#/home/myinst1# IBM Security Directory Server Instance V6.4#
All available #4389#4636#3544#3545#Directory Server

Example 4:

To list all directory server instances on a system, run the following command:

idsilist

The command generates the following output:

Directory server instance(s):
myinst1
myinst2

Example 5:

To obtain information about each instance, run the command with the -a or -r parameter.

idsilist -a

This command lists the directory server instances with their versions:

Directory server instance(s):
-----------------------------
Instance 1:

Name: myinst1
Version: 6.4
Location: /home/myinst1
Description: IBM Security Directory Server Instance V6.4
IP Addresses: All available
Port: 389
Secure Port: 636
admin server Port: 3538
admin server Secure Port: 3539
Type: Directory Server

Instance 2:

Name: myinst2
Version: 6.3
Location: /home/myinst2
Description: IBM Security Directory Server Instance V6.3
IP Addresses: All available
Port: 389
Secure Port: 636
admin server Port: 3538
admin server Secure Port: 3539
Type: Proxy Server

idsilist -r

The command generates the following output:

Directory server instance(s):
myinst1#6.4#/home/myinst1#IBM Security Directory Server Instance V6.4#
All available#389#636#3538#3539#Directory Server
myinst2#6.3#/home/myinst2#IBM Security Directory Server Instance V6.3#
All available#389#636#3538#3539#Proxy Server

Note:

The directory server types are Proxy Server, Directory Server, or Unknown. If a description is not set for a directory server instance, it is not shown.
The IP address All available indicates that the directory server instance binds to all available IP addresses. If the directory server instance binds only to certain IP addresses, a list is presented, separated by comma. For example,
```
IP Addresses: 1.3.45.333,1.2.45.222
```