Bug 2224004

Summary:	doc upgrades - add a note to not copy the dse.ldif from the legacy environment, but create a new instance
Product:	Red Hat Directory Server	Reporter:	Marc Sauton <msauton>
Component:	Doc-installation-guide	Assignee:	Evgenia Martynyuk <emartyny>
Status:	NEW ---	QA Contact:	LDAP QA Team <idm-ds-qe-bugs>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	12.2	CC:	idm-ds-dev-bugs, radrao, rhel-docs, vashirov
Target Milestone:	DS12.3	Keywords:	Documentation
Target Release:	dirsrv-12.3
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Marc Sauton 2023-07-19 14:28:34 UTC

Document URL:

Section Number and Name:

CHAPTER 8. MIGRATING DIRECTORY SERVER 11 TO DIRECTORY SERVER 12

8.2. MIGRATING TO DIRECTORY SERVER 12 USING THE REPLICATION METHOD
1. Install Directory Server 12.

and

8.3. MIGRATING TO DIRECTORY SERVER 12 USING THE EXPORT AND IMPORT METHOD
2. Perform the following steps on the new host:
a. Install Directory Server 12.

and

CHAPTER 9. MIGRATING DIRECTORY SERVER 10 TO DIRECTORY SERVER 12

9.2. MIGRATING DIRECTORY SERVER 10 TO VERSION 12 USING THE REPLICATION METHOD
1. Install Directory Server 12 on a new host.

and

9.3. MIGRATING DIRECTORY SERVER 10 TO VERSION 12 USING THE EXPORT AND IMPORT METHOD
2. Perform the following steps on the new Directory Server 12 host:
a. Install Directory Server 12

Describe the issue:

there has been several situations with a RHDS-12 instance created for a migration project from either RHDS-10 or 11, and the newer RHDS-12 instance had a dse.ldif copied from the legacy environment, which is a source of problems and is not supported a supported configuration.

Suggestions for improvement:

add a note each there is a recommendation to
Install Directory Server 12
to indicate the resulting dse.ldif from the newer RHDS-12 instance should NOT be replaced by the legacy dse.ldif, but kept because they are different.
Add custom configurations using the dsconf command line utility or the Web UI.

Additional information:

( edited notes from Mark R.: )
Do not copy the dse.ldif from an older RHDS version to a new RHDS-12 instance.
The dse.ldif layout changed between RHDS version 10 and 12.
That means some necessary plugins and configurations are missing in the new RHDS-12 instance, some system indexes could be removed.
The effects of this are unknown, and it could cause problems in the future.