DS docs favor trained and expert readers who have already had a helping hand to get started with directory services in general and ForgeRock DS in particular.
A Getting Started guide would offer a helping hand to beginners and readers who manage applications or services that consume directory services, but who do not know much about directory services.
Readers of the guide could expect to get a hands-on start with directory services within an hour, whereas a full training course requires a commitment of up to several days. To achieve this, the guide would willfully omit all the but the most common features, demonstrating only how to set up a server and perform common operations. It would, however, explain where to go as a follow up, assuming the reader is interested in learning more.
The getting started scenario should demonstrate the strengths of OpenDJ, namely multimaster replication, performance, etc.
Here are suggested steps for demonstrating multimaster replication:
- Install two directory servers
- Configure replication between them
- Add an entry on DS1
- Search on DS1 to verify the entry exists there
- Search on DS2 to verify the entry has been replicated
- Stop DS2 to simulate a network partition / server crash / etc.
- Modify the previously added entry on DS1
- Search on DS1 to verify the entry has been modified there
- Start DS2 to simulate a server recovery
- Search on DS2 to verify the entry has been modified there too
- Offer the reader to do the following exercise: restart at step 6. by stopping DS1 and modifying the entry on DS2, to demonstrate this is not the usual active-passive setup
Here are suggested steps for demonstrating performance:
- run modrate on DS1 for 10 seconds
- notice the number of requests happening
- run ldapsearch on cn=monitor to see the number of update appearing there?
- run searchrate on DS1 for 10 seconds
- notice the number of requests happening (this leaves replication the time to replicate all changes)
- then, should we run ldapsearch to export all entries from the two servers and use ldif-diff to verify they are the same on both servers?