ReplaceMagic과 SharePoint 온-프레미스 — 대량 끊어진 링크 수정
SharePoint 온-프레미스는 조직이 Microsoft 클라우드가 아닌 자체 서버에서 호스팅하는 Microsoft SharePoint 버전을 말합니다. ReplaceMagic은 현재 유지 관리 중인 모든 온-프레미스 릴리스를 지원합니다: SharePoint 2010, 2013, 2016, 2019 및 구독 에디션. 조직이 팜을 통합하거나, 서버 이름을 변경하거나, SharePoint Online으로 마이그레이션을 준비하는 경우에도 ReplaceMagic은 단일 파일을 수동으로 열지 않고 모든 문서 라이브러리에서 끊어진 링크를 찾고 수정하는 도구를 제공합니다.
ReplaceMagic이 SharePoint 온-프레미스에 연결하는 방법
ReplaceMagic은 다음 인증 방법 중 하나를 사용하여 SharePoint 클라이언트 측 개체 모델(CSOM) 및 REST API를 통해 SharePoint 온-프레미스에 연결합니다:
- Windows 인증 (도메인 자격 증명) — 가장 일반적인 방법입니다. ReplaceMagic이 Windows 도메인 사용자 이름과 비밀번호를 SharePoint에 전달하면 Active Directory에 대해 유효성이 검사됩니다. SharePoint 측에서 추가 구성이 필요하지 않습니다.
- 익명 접근 — 익명 읽기 접근이 활성화된 SharePoint 환경용입니다. 문서 처리에 거의 사용되지 않지만 지원됩니다.
- 레거시 인증 모드 — 최신 인증이 비활성화되었거나 SharePoint 서버가 양식 기반 또는 기본 인증을 요구하는 환경용입니다. 표준 Windows 인증이 실패할 때 ReplaceMagic 구성 → SharePoint 탭에서 이 기능을 활성화하세요.
SharePoint Online 대비 성능 이점
SharePoint Online과 달리 온-프레미스 SharePoint는 API 조절(HTTP 429 속도 제한)을 적용하지 않습니다. 이는 ReplaceMagic이 더 높은 지속 속도로 문서를 처리할 수 있음을 의미합니다. SharePoint Online에 권장되는 3–5 범위를 초과하여 병렬 처리 스레드 수를 안전하게 늘릴 수 있습니다 — 서버 하드웨어와 네트워크 대역폭에 따라 8~15 스레드 값이 일반적으로 온-프레미스 서버에서 잘 허용됩니다. 높은 병렬성은 대형 라이브러리의 프로젝트 완료 속도를 직접적으로 향상시킵니다.
ReplaceMagic이 보존하는 항목
메타데이터 보존은 온-프레미스에서도 클라우드와 마찬가지로 중요합니다. 문서 수정 후 ReplaceMagic은 다음 SharePoint 속성을 복원합니다:
- 마지막 수정 날짜 및 수정한 작성자
- 콘텐츠 승인 상태 (승인됨, 거부됨, 보류 중)
- 버전 기록 — 처리된 각 파일은 새 부 버전 또는 주 버전으로 체크인됩니다
- 체크인 및 체크아웃 상태 — 구성에서 체크인 강제 옵션이 활성화된 경우 잠긴 문서를 강제로 체크인할 수 있습니다
일반적인 온-프레미스 마이그레이션 시나리오
- SharePoint 온-프레미스 → SharePoint Online: URL이 인트라넷 형식(http://intranet/sites/team)에서 클라우드 형식(https://company.sharepoint.com/sites/team)으로 변경됩니다. ReplaceMagic은 소스 온-프레미스 라이브러리를 처리하고, URL 변환을 적용하고, 수정된 파일을 대상 SharePoint Online 사이트에 업로드할 수 있습니다.
- 팜 간 마이그레이션: 하드웨어 갱신, 통합 또는 재해 복구로 인해 한 온-프레미스 팜에서 다른 팜으로 이동할 때 이전 팜을 참조하는 모든 포함된 URL을 새 팜의 URL로 업데이트해야 합니다.
- 서버 이름 변경: SharePoint 웹 애플리케이션 URL이 기본 서버 또는 로드 밸런서 호스트 이름 변경으로 인해 바뀌면 하이퍼링크나 OLE 참조에 해당 호스트 이름을 포함하는 모든 문서에 끊어진 링크가 생깁니다. ReplaceMagic은 영향받는 모든 라이브러리에 단일 찾기 및 바꾸기 규칙을 적용하여 이 문제를 해결합니다.
레거시 인증 모드
일부 SharePoint 온-프레미스 환경 — 특히 오래된 SharePoint 2010 및 2013 팜 — 은 양식 기반 인증을 사용하거나 최신 인증 프로토콜이 비활성화되도록 구성되어 있습니다. 이러한 경우 ReplaceMagic의 표준 Windows 인증 연결이 서버에 의해 거부될 수 있습니다. ReplaceMagic 구성 패널에서 SharePoint 레거시 인증 모드를 활성화하면 인증 핸드셰이크가 호환 가능한 모드로 전환됩니다. 이 설정은 SharePoint Online에는 영향을 미치지 않으며 온-프레미스 연결에만 적용됩니다.
네트워크 요구 사항
ReplaceMagic은 SharePoint 온-프레미스 서버에 직접 네트워크 접근이 가능한 Windows 컴퓨터에 설치되어야 합니다. ReplaceMagic을 실행하는 컴퓨터는 HTTP 또는 HTTPS를 통해 SharePoint 웹 애플리케이션 URL에 접근할 수 있어야 합니다. VPN 연결, 방화벽 규칙, SharePoint 호스트 이름에 대한 DNS 확인이 모두 시작 전에 준비되어 있어야 합니다. SharePoint 서버 자체에는 어떤 구성 요소도 설치할 필요가 없습니다.










