Bug 2228537

Summary:	[doc] add progress path for customers using winsync in upgrading from 7 to 8 document
Product:	Red Hat Enterprise Linux 8	Reporter:	Aleksandr Sharov <asharov>
Component:	Documentation	Assignee:	Filip Hanzelka <fhanzelk>
Documentation sub component:	default	QA Contact:	RHEL DPM <rhel-docs>
Status:	CLOSED CURRENTRELEASE	Docs Contact:
Severity:	unspecified
Priority:	high	CC:	fcami, rhel-docs
Version:	8.8	Keywords:	Documentation
Target Milestone:	rc
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2023-08-10 21:21:20 UTC	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 Aleksandr Sharov 2023-08-02 15:14:54 UTC

Document URL: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/migrating_to_identity_management_on_rhel_8/index#migrate-7-to-8_migrating

Section Number and Name: 1. Migrating your IdM environment from RHEL 7 servers to RHEL 8 servers

Describe the issue: A number of customers still have RHEL7 deployments with winsync in place, set up as described here:

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/windows_integration_guide/sync

This method was deprecated for RHEL 8, but it's still there in the code/binaries. So upgrading generally works, however, it's not supported anymore. 

Suggestions for improvement: We should definitely mention the fact that winsync is deprecated and not anymore supported in the corresponding migration document, as well as providing clear path for customers to move to trust, which is covered here:

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/windows_integration_guide/migrate-sync-trust

Also, it's probably a good idea to mention it around establishing trust instructions for RHEL 8+, that this option was there but was deprecated and is not supported/shipped anymore.

Additional information:

Comment 4 Filip Hanzelka 2023-08-10 21:21:20 UTC

New and updated content on the CP:

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/migrating_to_identity_management_on_rhel_8/index#migrating-an-existing-environment-from-synchronization-to-trust-in-the-context-of-integrating-a-linux-domain-with-an-active-directory-domain

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/installing_identity_management/index#installing-trust-between-idm-and-ad_installing-identity-management

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/installing_trust_between_idm_and_ad/index#ref_prerequisites-for-establishing-a-trust_installing-trust-between-idm-and-ad