You can use OpenDJ Control Panel or the command-line tools to create a new suffix — more on those in subsequent posts. But what are you actually doing?
OpenDJ stores data in what are called backends. Typically you store your data in a JE backend, which uses a Berkeley DB Java Edition underneath for data storage.
Before you add data to the directory, you must create a backend, and configure the associated suffix by indicating its base Distinguished Name (base DN). A distinguished name (DN) is an LDAP term, referring to the unique name of a directory entry, the name that distinguishes the entry from all other entries in the directory. An example of a distinguished name is
uid=bjensen,ou=people,dc=example,dc=com. As directory data is seen hierarchically,
uid=bjensen,ou=people,dc=example,dc=com is seen as being under
ou=people,dc=example,dc=com, which itself is under
dc=example,dc=com \ ou=people,dc=example,dc=com \ uid=bjensen,ou=people,dc=example,dc=com
OpenDJ Control Panel browser shows the data this way, too. The DN at the top of the hierarchy is the base DN. We refer to a directory suffix by its base DN. The base DN is literally the suffix of all other DNs beneath it in the hierarchy. For example,
dc=example,dc=com is the suffix of
uid=bjensen,ou=people,dc=example,dc=com and also of
OpenDS backends are named differently from the suffixes they hold. If you recall when you install OpenDJ, you have the option to create a base DN. The default is to create the base DN
dc=example,dc=com stored in a backend named
userRoot (to distinguish it from another default backend named
adminRoot).* That lets you import the entry with DN
dc=example,dc=com and all the test entries underneath right away.
But that default does not help if your base DN is
o=myOrg. Stay tuned for further entries that show you how to add directory data for
myCompany.com, and for
dc=example,dc=com is safe as a default because, while fine for testing, it cannot clash with real data that exist. The
dc is short for domain component. Thus,
dc=example,dc=com maps to
example.org, are reserved for documentation and cannot be registered publicly.