This guide shows you how to install, upgrade, and remove OpenDJ software. Unless you are planning a throwaway evaluation or test installation, read the Release Notes before you get started. If you want only to try OpenDJ server software, and you do not plan to store any real or important data that you want to keep, then you need not read this guide right now. Instead, visit the download page, and click the link for the latest release to start the Java WebStart installer wizard directly from your browser.

This guide is written for anyone installing OpenDJ who plans to maintain directory services for client applications. Basic OpenDJ installation, especially using Java WebStart, can be simple and straightforward, particularly if you are already acquainted with directory services. Upgrading a running directory service without a single point of failure that can cause downtime requires at least a little thought and planning. Also, even in the case of basic installation, you may find yourself wanting more background about what you are doing. This guide covers the install, upgrade, and removal (a.k.a. uninstall) procedures that you theoretically perform only once per version. This guide aims to provide you with at least some idea of what happens behind the scenes when you perform the steps. You do not need to be an LDAP wizard to learn something from this guide, though a background in directory services and maintaining server software can help. You do need some background in managing servers and services on your operating system of choice. You can nevertheless get started with this guide, and then learn more as you go along.

This work is licensed under the Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. See the license for the specific language governing permissions and limitations under the license.

Pay attention to notes like this one. Some items might be formatted differently from other text, like filenames, commands, and literal values. $ echo Terminal sessions are formatted like this. Terminal sessions are formatted like this. class Test { public static void main(String [] args) { System.out.println("This is a program listing."); } } In many cases, sections pertaining to UNIX, GNU/Linux, Mac OS X, BSD, and so forth are marked (UNIX). Sections pertaining to Microsoft Windows might be marked (Windows). To avoid repetition, however, file system directory names are often given only in UNIX format as in /path/to/OpenDJ, even if the text applies to C:\path\to\OpenDJ as well. Ignore warnings at your own risk.

Core documentation, such as what you are now reading, aims to be technically accurate and complete with respect to the software documented. Core documentation therefore follows a three-phase review process designed to eliminate errors. The review process should slow authors down enough that documentation you get with a stable release has had time to bake fully. Fully baked core documentation is available at .... You need not wait until the core documentation is finished, though, to read more about OpenDJ, and also to read about related topics that involve OpenDJ without being strictly about OpenDJ. The OpenDJ Wiki regularly brings you more, fresh content. In addition, you are welcome to sign up and then edit the Wiki if you notice an error, or if you have something to share.

After you sign up at ForgeRock, you can also login to the Wiki and the issue database to follow what is happening with the project. If you have questions regarding OpenDJ which are not answered by the documentation, there is a mailing list which can be found at https://lists.forgerock.org/mailman/listinfo/opendj where you are likely to find an answer. You can join the IRC discussion in the #opendj room at irc.freenode.net. The Wiki has information on how to check out OpenDJ source code. There is also a mailing list for OpenDJ development which can be found at https://lists.forgerock.org/mailman/listinfo/opendj-dev Should you want to contribute a patch, test, or feature, or want to author part of the core documentation, first have a look on the ForgeRock site at how to get involved.