idslink

Use the idslink command to create links to LDAP client and server command-line utilities.

Description

The idslink command creates links to LDAP client and server command-line utilities. This utility is installed with the client package. During IBM® Verify Directory installation, links for client and server utilities are not set automatically. You can use the idslink command to set the links to command-line utilities such as idsldapmodify and idsldapadd, and libraries such as libibmldap. The links point to the location where the IBM Verify Directory utilities and libraries are located. installpath/bin, installpath/sbin, and installpath/lib. Where,installpath is the IBM Verify Directory installation location.

Note: The idslink utility overwrites any existing links with the updated links.

Synopsis

idslink [-i -g -l bits -s mode [-n] [-f] [-q] ] | -v | -h 

Options

The options to the idslink command.

-i
Creates links for client command utilities that begin with ids. For example, link from /usr/bin/idsldapsearch to /opt/ibm/ldap/V11.0.1/bin/idsldapsearch.
-g
Creates links for client command utilities that do not begin with ids. For example, link from /usr/bin/ldapsearch to /opt/ibm/ldap/V11.0.1/bin/ldapsearch or /usr/bin/gsk9certutil_64 to /opt/ibm/ldap/V11.0.1/bin/gsk9certutil_64.
-l bits
Creates links for 32-bit or 64-bit client library files. The bits value can be 32 or 64.
-s mode
Creates links for server command-line utilities. The mode value can contain one of the following values.
  • base to establish links for the base server code for use with the proxy or full server
  • fullsrv if the directory server instance is a full server
-n
Specifies to demonstrate the action of the operation without actually running it. The idslink command with the -n option, lists the links that gets set. With this option, you must also specify one or more of the following options: -i, -g, or -l. After you run the command with the -n option, check the /var/idsldap/V11.0.1/idslink.preview file, which might contain any conflicts that are found during the operation.
-f
Specifies the force option. This option overrides existing files or links, and back up any conflicts. For example, /usr/bin/ldapsearch.
If you use the -f option, each conflicting link is backed up into a subdirectory with the same name as the file, directory, or link. For example, a conflict for the /usr/bin/ldapsearch command is backed up in a subdirectory called /usr/bin/V11.0.1_idslink_bkup_timestamp. Where, timestamp is the date and time when the backup was created.
If you do not use this option and conflicts with existing links are found, none of the links in the group are set.
-q
Specifies to run in quiet mode. All output is suppressed except for error messages.
-v
Specifies to show the version information of the command.
-h
Specifies to show the help.

Links created by idslink

When you run the idslink command, it creates links to client utilities, server utilities, and libraries. An example list links created by using the idslink command.

Note: The installation path on AIX® and Linux™ systems is /opt/ibmdir/ldap/V11.0.1/. Where, the value of the ibmdir variable is IBM on AIX systems, and ibm on Linux systems.
Client commands
Links that are created for client commands (that do not begin with ids) for the base client when the -g option is specified.
  • /usr/bin/ldapsearch -> /opt/ibmdir/ldap/V11.0.1/bin/ldapsearch
  • /usr/bin/ldapadd -> /opt/ibmdir/ldap/V11.0.1/bin/ldapadd
  • /usr/bin/ldapmodify -> /opt/ibmdir/ldap/V11.0.1/bin/ldapmodify
  • /usr/bin/ldapdelete -> /opt/ibmdir/ldap/V11.0.1/bin/ldapdelete
  • /usr/bin/ldapmodrdn -> /opt/ibmdir/ldap/V11.0.1/bin/ldapmodrdn
  • /usr/bin/ldapchangepwd -> /opt/ibmdir/ldap/V11.0.1/bin/ldapchangepwd
  • /usr/bin/ldaptrace -> /opt/ibmdir/ldap/V11.0.1/bin/ldaptrace
  • /usr/bin/ldapexop -> /opt/ibmdir/ldap/V11.0.1/bin/ldapexop
  • /usr/bin/ibmdirctl -> /opt/ibmdir/ldap/V11.0.1/bin/ibmdirctl
  • /usr/bin/ldapdiff -> /opt/ibmdir/ldap/V11.0.1/bin/ldapdiff
  • /usr/bin/ldapcompare -> /opt/ibmdir/ldap/V11.0.1/bin/ldapcompare
  • /usr/bin/gsk9ver_64 -> /opt/ibmdir/ldap/V11.0.1/bin/gsk9ver_64
  • /usr/bin/gsk9ver -> /opt/ibmdir/ldap/V11.0.1/bin/gsk9ver
  • /usr/bin/gsk9certutil_64 -> /opt/ibmdir/ldap/V11.0.1/bin/gsk9certutil_64
  • /usr/bin/gsk9certutil -> /opt/ibmdir/ldap/V11.0.1/bin/gsk9certutil
  • /usr/bin/ldapreplcfg -> /opt/ibmdir/ldap/V11.0.1/bin/ldapreplcfg
Links that are created for client commands (that begin with ids) for the base client when the -i option is specified.
  • /usr/bin/idsldapsearch -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapsearch
  • /usr/bin/idsldapadd -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapadd
  • /usr/bin/idsldapmodify -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapmodify
  • /usr/bin/idsldapdelete -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapdelete
  • /usr/bin/idsldapmodrdn -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapmodrdn
  • /usr/bin/idsldapchangepwd -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapchangepwd
  • /usr/bin/idsldaptrace -> /opt/ibmdir/ldap/V11.0.1/bin/idsldaptrace
  • /usr/bin/idsldapexop -> /opt/ibmdir/ldap/V11.0.1/bin/idsldapexop
  • /usr/bin/idsdirctl -> /opt/ibmdir/ldap/V11.0.1/bin/idsdirctl
Client libraries
Note: In the library path, XX denotes the library extension, such as .so, .a, or .sl.
Links created when the -l 32 option is specified

The following groups or sets of links are created when the -l bits option is specified, where bits is 32.

Note: Links common to all operating systems and links that are specific to a particular operating system are in one group or set.
Client libraries: Set of links for 32-bit client package
Common links:
  • /usr/lib/libidsldap.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldap.XX
  • /usr/lib/libidsldapstatic.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldapstatic.XX
  • /usr/lib/idsldap_plugin_sasl_digest-md5.XX -> /opt/ibmdir/ldap/V11.0.1/lib/idsldap_plugin_sasl_digest-md5.XX
Operating system-specific links:
  • /usr/lib/idsldap_plugin_ibm_gsskrb.XX -> /opt/ibmdir/ldap/V11.0.1/lib/idsldap_plugin_ibm_gsskrb.XX (Kerberos library file on AIX)
  • /usr/lib/libidsldif.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldif.XX (Linux only)
Client libraries: Set of links for 32-bit client package (support for compatibility with earlier versions)
Common links:
  • /usr/lib/libldap.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldap.XX
  • /ldap/V11.0.1/lib/libidsldap.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldap.XX
  • /usr/lib/libibmldapstatic.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldapstatic.XX
  • /usr/lib/libldapiconv.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldapiconv.XX
  • /usr/lib/ldap_plugin_sasl_digest-md5.XX -> /opt/ibmdir/ldap/V11.0.1/lib/idsldap_plugin_sasl_digest-md5.XX
Operating system-specific links:
  • /usr/lib/ldap_plugin_ibm_gsskrb.XX -> /opt/ibmdir/ldap/V11.0.1/lib/idsldap_plugin_ibm_gsskrb.XX (Kerberos library file on AIX)
  • /usr/lib/libldif.XX -> /opt/ibmdir/ldap/V11.0.1/lib/libidsldif.XX (Linux only)
Links created when the -l 64 option is specified

The following groups or sets of links are created when the -l bits option is specified, where bits is 64.

Client libraries: Set of links with 64 in name for 64-bit client package
Common links:
  • /usr/lib/libidsldap64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldap.XX
  • /usr/lib/libidsldapstatic64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldapstatic.XX
  • /usr/lib/idsldap_plugin_sasl_digest-md5_64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_sasl_digest-md5.XX
Operating system-specific links:
  • /usr/lib/idsldap_plugin_ibm_gsskrb_64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_ibm_gsskrb.XX (Kerberos library file on AIX)
  • /usr/lib/libidsldif64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldif.XX (Linux only)
Client libraries: Set of links with 64 in name for 64-bit client package (support for compatibility with earlier versions)
Common links:
  • /usr/lib/libldap64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldap.XX
  • /usr/lib/libibmldap64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldap.XX
  • /usr/lib/libibmldapstatic64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldapstatic.XX
  • /usr/lib/libldapiconv64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldapiconv.XX
  • /usr/lib/ldap_plugin_sasl_digest-md5_64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_sasl_digest-md5.XX
Operating system-specific links:
  • /usr/lib/ldap_plugin_ibm_gsskrb_64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_ibm_gsskrb.XX (Kerberos library file on AIX)
  • /usr/lib/libldif64.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldif.XX (Linux only)
Client libraries: Set of links without 64 in name for 64-bit client package
Common links:
  • /usr/lib/lib64/libidsldap.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldap.XX
  • /usr/lib/lib64/libidsldapstatic.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldapstatic.XX
  • /usr/lib/lib64/idsldap_plugin_sasl_digest-md5.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_sasl_digest-md5.XX
Operating system-specific links:
  • /usr/lib/lib64/idsldap_plugin_ibm_gsskrb.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_ibm_gsskrb.XX (Kerberos library file on AIX)
  • /usr/lib/lib64/libidsldif.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldif.XX (Linux only)
Client libraries: Set of links without 64 in name for 64-bit client package (support for compatibility with earlier versions)
Common links:
  • /usr/lib/lib64/libldap.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldap.XX
  • /usr/lib/lib64/libibmldap.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldap.XX
  • /usr/lib/lib64/libibmldapstatic.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldapstatic.XX
  • /usr/lib/lib64/libldapiconv.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldapiconv.XX
  • /usr/lib/lib64/ldap_plugin_sasl_digest-md5.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_sasl_digest-md5.XX
Operating system-specific links:
  • /usr/lib/lib64/ldap_plugin_ibm_gsskrb.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/idsldap_plugin_ibm_gsskrb.XX (Kerberos library file on AIX)
  • /usr/lib/lib64/libldif.XX -> /opt/ibmdir/ldap/V11.0.1/lib64/libidsldif.XX (Linux only)
Server commands
Links that are created for server commands for base server package when the -s base option is specified.
  • /usr/bin/slapd -> /opt/ibmdir/ldap/V11.0.1/sbin/slapd
  • /usr/bin/ibmslapd -> /opt/ibmdir/ldap/V11.0.1/sbin/ibmslapd
  • /usr/bin/idsslapd -> /opt/ibmdir/ldap/V11.0.1/sbin/idsslapd
  • /usr/bin/ibmdiradm -> /opt/ibmdir/ldap/V11.0.1/sbin/ibmdiradm
  • /usr/bin/idsdiradm -> /opt/ibmdir/ldap/V11.0.1/sbin/idsdiradm
  • /usr/bin/ldtrc -> /opt/ibmdir/ldap/V11.0.1/sbin/ldtrc
  • /usr/bin/ddsetup -> /opt/ibmdir/ldap/V11.0.1/sbin/ddsetup
  • /usr/bin/idsxcfg -> /opt/ibmdir/ldap/V11.0.1/sbin/idsxcfg
  • /usr/bin/idsxinst -> /opt/ibmdir/ldap/V11.0.1/sbin/idsxinst
  • /usr/bin/idsilist -> /opt/ibmdir/ldap/V11.0.1/sbin/idsilist
  • /usr/bin/idsicrt -> /opt/ibmdir/ldap/V11.0.1/sbin/idsicrt
  • /usr/bin/idsidrop -> /opt/ibmdir/ldap/V11.0.1/sbin/idsidrop
  • /usr/bin/idsdnpw -> /opt/ibmdir/ldap/V11.0.1/sbin/idsdnpw
  • /usr/bin/idssetport -> /opt/ibmdir/ldap/V11.0.1/sbin/idssetport
  • /usr/bin/idssethost -> /opt/ibmdir/ldap/V11.0.1/sbin/idssethost
  • /usr/bin/idsimigr -> /opt/ibmdir/ldap/V11.0.1/sbin/idsimigr
  • /usr/bin/idscfgsch -> /opt/ibmdir/ldap/V11.0.1/sbin/idscfgsch
  • /usr/bin/idsucfgsch -> /opt/ibmdir/ldap/V11.0.1/sbin/idsucfgsch
  • /usr/bin/idslogmgmt -> /opt/ibmdir/ldap/V11.0.1/sbin/idslogmgmt
  • /usr/bin/idsgendirksf -> /opt/ibmdir/ldap/V11.0.1/sbin/idsgendirksf
Links that are created for server commands for full server package when the -s fullsrv option is specified.
  • /usr/bin/bulkload -> /opt/ibmdir/ldap/V11.0.1/sbin/bulkload
  • /usr/bin/idsbulkload -> /opt/ibmdir/ldap/V11.0.1/sbin/idsbulkload
  • /usr/bin/ldif2db -> /opt/ibmdir/ldap/V11.0.1/sbin/ldif2db
  • /usr/bin/idsldif2db -> /opt/ibmdir/ldap/V11.0.1/sbin/idsldif2db
  • /usr/bin/db2ldif -> /opt/ibmdir/ldap/V11.0.1/sbin/db2ldif
  • /usr/bin/idsdb2ldif -> /opt/ibmdir/ldap/V11.0.1/sbin/idsdb2ldif
  • /usr/bin/dbback -> /opt/ibmdir/ldap/V11.0.1/sbin/dbback
  • /usr/bin/idsdbback -> /opt/ibmdir/ldap/V11.0.1/sbin/idsdbback
  • /usr/bin/dbrestore -> /opt/ibmdir/ldap/V11.0.1/sbin/dbrestore
  • /usr/bin/idsdbrestore -> /opt/ibmdir/ldap/V11.0.1/sbin/idsdbrestore
  • /usr/bin/runstats -> /opt/ibmdir/ldap/V11.0.1/sbin/runstats
  • /usr/bin/idsrunstats -> /opt/ibmdir/ldap/V11.0.1/sbin/idsrunstats
  • /usr/bin/idscfgdb -> /opt/ibmdir/ldap/V11.0.1/sbin/idscfgdb
  • /usr/bin/idsucfgdb -> /opt/ibmdir/ldap/V11.0.1/sbin/idsucfgdb
  • /usr/bin/idscfgchglg -> /opt/ibmdir/ldap/V11.0.1/sbin/idscfgchglg
  • /usr/bin/idsucfgchglg -> /opt/ibmdir/ldap/V11.0.1/sbin/idsucfgchglg
  • /usr/bin/idscfgsuf -> /opt/ibmdir/ldap/V11.0.1/sbin/idscfgsuf
  • /usr/bin/idsucfgsuf -> /opt/ibmdir/ldap/V11.0.1/sbin/idsucfgsuf