idsdirctl, ibmdirctl
Use the idsdirctl or ibmdirctl command to start or stop directory server.
Description
The idsdirctl or ibmdirctl command is an administration server control program.
To run idsdirctl or ibmdirctl command, you must be the primary administrator or a member of the local administrators with start or stop server authority.
Synopsis
ibmdirctl [options] command -- [ibmslapd options]Where,
command indicates the command to run by the ibmdiradm
utility. The value of the parameter must be one of the following values:- start
- starts IBM® Verify Directory
- stop
- stops IBM Verify Directory
- restart
- stops and then starts IBM Verify Directory
- status
- indicates whether IBM Verify Directory is running or stopped
- statusreturn
- sets exit code
0=running,1=starting,2=stopped - admstop
- stops the IBM Verify Directory administration server
- startlogmgmt
- starts the log management capabilities for IBM Verify Directory
- stoplogmgmt
- stops the log management capabilities for IBM Verify Directory
- statuslogmgmt
- indicates whether the log management for IBM Verify Directory is running
Usage
You can use the administration server control program, ibmdirctl, to start, stop, restart, or query the status of IBM Verify Directory. It can also be used to stop the administration server. For this command to function, the administration server, idsdiradm, must be running. For more information about the idsdiradm utility, see the Directory administration server section in the Administering section in the IBM Verify Directory documentation.
If idsslapd options are provided, they must be preceded by --. Only the -a and -n parameters of idsslapd are supported.
To see the syntax help foribmdirctl, type ibmdirctl -?.
Options
The options to the ibmdirctl command.- -D adminDN
- Specifies the bind DN to the command. You can also use -d instead of -D option.
- -h hostname
- Specifies the host name of the system where ibmdiradm is running. You can also use -H instead of -h option.
- -K keyfile
- Specifies the file to use for keys.
- -N key_name
- Specifies the private key name to use in keyfile.
- -p port
- Specifies the port number on which ibmdiradm is listening.
- -P key_pw
- Specifies the keyfile password.
- -v
- Indicates to run in verbose mode.
- -w adminPW
- Specifies the bind password or ? for non-echoed prompt. Use backslash \? to avoid matching single character file names on UNIX™. You can also use -W instead of -w option.
- -Y
- Specifies to use a secure LDAP connection by using the startTLS protocol. The -Y option is only supported when GSKit is installed.
- -Z
- Specifies to use a secure LDAP connection by using Secure Sockets Layer (SSL) and Transport Layer Security (TLS). The -Z option is only supported for SSL component entry, and only when GSKit is installed.
- -?
- Specifies to show the help.
- -1 sec:usec
- Specifies the timeout for the
connect()function in seconds and microseconds. The values that are provided for seconds and microseconds must be positive integers.
Examples
- Example 1:
- To start the server in configuration only mode, run the following
command:
ibmdirctl -h hostname -D myDN -w mypassword -p 3538 start -- -a - Example 2:
- To stop the server, run the following
command:
ibmdirctl -h hostname -D myDN -w mypassword -p 3538 stop