Contents
Download
* Go to OpenDJ download site at http://www.forgerock.org/opendj.html
* Download the zip file for a selected version, e.g. OpenDJ 2.4.6
Environment
* Java
[jli@openidmbox Desktop]$ java -version java version "1.6.0_24" OpenJDK Runtime Environment (IcedTea6 1.11.4) (rhel-1.49.1.11.4.el6_3-x86_64) OpenJDK 64-Bit Server VM (build 20.0-b12, mixed mode)
* File descriptors: > 64K
cat /proc/sys/fs/file-max 64000
Install
Unzip
*Unzip downloaded zip file.
[jli@openidmbox opt]$ ls jdk1.6.0_35 openidm [jli@openidmbox opt]$ mkdir opendj [jli@openidmbox opt]$ cd opendj [jli@openidmbox opendj]$ unzip /mnt/hgfs/vmshare/OpenDJ-2.4.6.zip Archive: /mnt/hgfs/vmshare/OpenDJ-2.4.6.zip creating: OpenDJ-2.4.6/ ... [jli@openidmbox opendj]$ ls OpenDJ-2.4.6 [jli@openidmbox opendj]$ cd OpenDJ-2.4.6/ [jli@openidmbox OpenDJ-2.4.6]$ ls bak db ldif QuickSetup.app Uninstall.app bat example-plugin.zip legal-notices README uninstall.bat bin import-tmp lib setup upgrade changelogDb install.html locks setup.bat upgrade.bat classes install.txt logs snmp config instance.loc opends_logo.png uninstall
Setup
* ./setup –cli
– Admin: cn=Directory Manager/password (or secret)
[jli@openidmbox OpenDJ-2.4.6]$ ./setup --cli OpenDJ 2.4.6 Please wait while the setup program initializes... What would you like to use as the initial root user DN for the Directory Server? [cn=Directory Manager]: Please provide the password to use for the initial root user: Please re-enter the password for confirmation: On which port would you like the Directory Server to accept connections from LDAP clients? [1389]: On which port would you like the Administration Connector to accept connections? [4444]: Do you want to create base DNs in the server? (yes / no) [yes]: Provide the base DN for the directory data: [dc=example,dc=com]: Options for populating the database: 1) Only create the base entry 2) Leave the database empty 3) Import data from an LDIF file 4) Load automatically-generated sample data Enter choice [1]: 3 Please specify the path to the LDIF file containing the data to import: /opt/openidm/openidm/samples/sample2/data/Example.ldif Do you want to enable SSL? (yes / no) [no]: Do you want to enable Start TLS? (yes / no) [no]: Do you want to start the server when the configuration is completed? (yes / no) [yes]: Setup Summary ============= LDAP Listener Port: 1389 Administration Connector Port: 4444 LDAP Secure Access: disabled Root User DN: cn=Directory Manager Directory Data: Create New Base DN dc=example,dc=com. Base DN Data: Import Data from LDIF File (/opt/openidm/openidm/samples/sample2/data/Example.ldif) Start Server when the configuration is completed What would you like to do? 1) Set up the server with the parameters above 2) Provide the setup parameters again 3) Print equivalent non-interactive command-line 4) Cancel and exit Enter choice [1]: See /tmp/opends-setup-4391859211492950560.log for a detailed log of this operation. Configuring Directory Server ..... Done. Importing LDIF file /opt/openidm/openidm/samples/sample2/data/Example.ldif ...... Done. Starting Directory Server ...... Done. To see basic server configuration status and configuration you can launch /opt/opendj/OpenDJ-2.4.6/bin/status
Start and Stop
Commands
$ pwd /opt/opendj/OpenDJ-2.4.6/bin $ ls backup dsjavaproperties ldappasswordmodify manage-tasks base64 dsreplication ldapsearch README_WINDOWS.txt control-panel encode-password ldif-diff rebuild-index ControlPanel.app export-ldif ldifmodify restore create-rc-script import-ldif ldifsearch start-ds dbtest ldapcompare list-backends status dsconfig ldapdelete make-ldif stop-ds dsframework ldapmodify manage-account verify-index
Start
* bin/start-ds
$ ./start-ds [05/Sep/2012:20:29:18 -0700] category=CORE severity=INFORMATION msgID=132 msg=The Directory Server is beginning the configuration bootstrapping process [05/Sep/2012:20:29:18 -0700] category=EXTENSIONS severity=INFORMATION msgID=1049147 msg=Loaded extension from file '/opt/opendj/OpenDJ-2.4.6/lib/extensions/snmp-mib2605.jar' (build 2.4.6, revision 8102) [05/Sep/2012:20:29:18 -0700] category=CORE severity=NOTICE msgID=458886 msg=OpenDJ 2.4.6 (build 20120723161910Z, R8102) starting up [05/Sep/2012:20:29:19 -0700] category=RUNTIME_INFORMATION severity=NOTICE msgID=20381717 msg=Installation Directory: /opt/opendj/OpenDJ-2.4.6 [05/Sep/2012:20:29:19 -0700] category=RUNTIME_INFORMATION severity=NOTICE msgID=20381719 msg=Instance Directory: /opt/opendj/OpenDJ-2.4.6 [05/Sep/2012:20:29:19 -0700] category=RUNTIME_INFORMATION severity=NOTICE msgID=20381713 msg=JVM Information: 1.6.0_24-b24 by Sun Microsystems Inc., 64-bit architecture, 620756992 bytes heap size [05/Sep/2012:20:29:20 -0700] category=RUNTIME_INFORMATION severity=NOTICE msgID=20381714 msg=JVM Host: openidmbox, running Linux 2.6.32-220.el6.x86_64 amd64, 2100391936 bytes physical memory size, number of processors available 2 [05/Sep/2012:20:29:20 -0700] category=RUNTIME_INFORMATION severity=NOTICE msgID=20381715 msg=JVM Arguments: "-Dorg.opends.server.scriptName=start-ds" [05/Sep/2012:20:29:20 -0700] category=ACCESS_CONTROL severity=INFORMATION msgID=12582978 msg=Added 10 Global Access Control Instruction (ACI) attribute types to the access control evaluation engine [05/Sep/2012:20:29:20 -0700] category=BACKEND severity=INFORMATION msgID=9437595 msg=Local DB backend userRoot does not specify the number of lock tables: defaulting to 97 [05/Sep/2012:20:29:20 -0700] category=BACKEND severity=INFORMATION msgID=9437594 msg=Local DB backend userRoot does not specify the number of cleaner threads: defaulting to 24 threads [05/Sep/2012:20:29:21 -0700] category=JEB severity=NOTICE msgID=8847402 msg=The database backend userRoot containing 4 entries has started [05/Sep/2012:20:29:21 -0700] category=EXTENSIONS severity=INFORMATION msgID=1048797 msg=DIGEST-MD5 SASL mechanism using a server fully qualified domain name of: openidmbox [05/Sep/2012:20:29:21 -0700] category=CORE severity=INFORMATION msgID=720 msg=No worker queue thread pool size specified: sizing automatically to use 24 threads [05/Sep/2012:20:29:21 -0700] category=PROTOCOL severity=NOTICE msgID=2556180 msg=Started listening for new connections on Administration Connector 0.0.0.0 port 4444 [05/Sep/2012:20:29:21 -0700] category=PROTOCOL severity=NOTICE msgID=2556180 msg=Started listening for new connections on LDAP Connection Handler 0.0.0.0 port 1389 [05/Sep/2012:20:29:21 -0700] category=CORE severity=NOTICE msgID=458887 msg=The Directory Server has started successfully [05/Sep/2012:20:29:21 -0700] category=CORE severity=NOTICE msgID=458891 msg=The Directory Server has sent an alert notification generated by class org.opends.server.core.DirectoryServer (alert type org.opends.server.DirectoryServerStarted, alert ID 458887): The Directory Server has started successfully
Stop OpenDJ
* bin/stop-ds
$ ./stop-ds Stopping Server... [05/Sep/2012:20:27:38 -0700] category=BACKEND severity=NOTICE msgID=9896306 msg=The backend userRoot is now taken offline [05/Sep/2012:20:27:38 -0700] category=CORE severity=NOTICE msgID=458955 msg=The Directory Server is now stopped
Check Status
* ./status
./status >>>> Specify OpenDS LDAP connection parameters Administrator user bind DN [cn=Directory Manager]: Password for user 'cn=Directory Manager': --- Server Status --- Server Run Status: Started Open Connections: 1 --- Server Details --- Host Name: openidmbox.localdomain Administrative Users: cn=Directory Manager Installation Path: /opt/opendj/OpenDJ-2.4.6 Version: OpenDJ 2.4.6 Java Version: 1.6.0_24 Administration Connector: Port 4444 (LDAPS) --- Connection Handlers --- Address:Port : Protocol : State -------------:----------:--------- -- : LDIF : Disabled 0.0.0.0:161 : SNMP : Disabled 0.0.0.0:636 : LDAPS : Disabled 0.0.0.0:1389 : LDAP : Enabled 0.0.0.0:1689 : JMX : Disabled --- Data Sources --- Base DN: dc=example,dc=com Backend ID: userRoot Entries: 4 Replication: Disabled
Control Panel
* Need X Win
* Open control panel:
$ pwd /opt/opendj/OpenDJ-2.4.6/bin $ ./control-panel
* Login (password is password in this example)
* Control Panel:
Default Port Numbers
OpenDJ directory services use the following TCP/IP port numbers by default:
• LDAP: 389 (1389 for non-root users)
• LDAPS: 636 (1636 for non-root users)
• Administration Connector: 4444
• SNMP: 161 (if configured)
• JMX: 1689
• Replication: 8989
References
* OpenDJ project home
* OpenDJ Installation Guide
* OpenDJ 2.5.0 Administration Guide