Share via

SharePoint Server에서 검색 구성 요소 관리

  • 아티클

적용 대상:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

이 문서의 절차 및 예제에서는 SharePoint ServerSharePoint Server 및 Search Service 애플리케이션이 설치되어 있고 SharePoint Server 검색 인덱스에 기존 검색 토폴로지 및 항목이 있다고 가정합니다. SharePoint Server 및 Search Service 응용 프로그램이 새로 설치되었고 SharePoint Server 검색 인덱스에 항목이 없으면 SharePoint Server에서 기본 검색 토폴로지 변경의 절차를 수행합니다.

이 문서의 절차는 다음과 같은 검색 구성 요소에 적용됩니다.

  • 분석 처리 구성 요소

  • 콘텐츠 처리 구성 요소

  • 크롤링 구성 요소

  • 검색 관리 구성 요소

  • 쿼리 처리 구성 요소

인덱스 구성 요소를 관리하는 절차에 대한 자세한 내용은 SharePoint Server에서 인덱스 구성 요소 관리를 참조하세요.

시작하기 전에

시작하기 전에 다음 필수 구성 요소를 검토하세요.

  • SharePoint Server이 설치되었고 검색 토폴로지와 함께 Search Service 응용 프로그램이 만들어져 있어야 합니다. Search Service 응용 프로그램은 정상 상태이며 어떠한 이유로든 일시 중지되지 않습니다.

  • 이 문서의 절차를 수행하는 사용자 계정은 Farm Administrators 그룹의 구성원이어야 합니다.

  • 계획된 대상 검색 토폴로지가 있어야 합니다.

  • 검색 구성 요소를 호스트하려는 모든 서버에 SharePoint Server이 설치되어 있어야 합니다. 서버가 팜에 추가되어야 하고 사용자가 이러한 모든 서버에서 관리자여야 합니다. 새 응용 프로그램 서버를 만들거나 기존 배포에서 응용 프로그램 서버를 정의할 수 있습니다.

중요

이 문서의 절차에서는 Microsoft PowerShell을 사용합니다. Microsoft PowerShell 명령은 팜의 모든 서버에서 실행할 수 있습니다. 그러나 여러 검색 토폴로지 절차를 수행하는 경우 명령 간에 Microsoft PowerShell 개체 참조를 공유할 수 있도록 모든 Microsoft PowerShell 명령에 대해 동일한 SharePoint 관리 셸을 사용해야 합니다.

서버에서 Search Service 인스턴스 시작

새 서버에 검색 구성 요소를 추가하려면 먼저 서버에서 Search Service 인스턴스를 시작해야 합니다. Search Service 인스턴스는 Search Service에서 사용되는 모든 필수 Windows 서비스를 시작합니다(OSearch16 및 SPSearchHostController).

Search Service 인스턴스를 시작하려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. 팜의 서버 중 하나에서 SharePoint 관리 셸을 시작합니다.

  3. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    $<host n > = Get-SPEnterpriseSearchServiceInstance -Identity "<Server name>"
Start-SPEnterpriseSearchServiceInstance -Identity $<host n >

    여기서 각 부분이 나타내는 의미는 다음과 같습니다.

    • $ <host n>는 Search Service 인스턴스에 대한 PowerShell 개체 참조를 지정합니다.

    • <Server name> 은 인덱스 구성 요소를 추가할 서버를 지정합니다. 입력은 유효한 GUID(형식 12345678-90ab-cdef-1234-567890bcdefgh), 서버의 유효한 이름(예: myserver1 ) 또는 유효한 SearchServiceInstance 개체의 인스턴스여야 합니다.

    예를 들면

    $hostA = Get-SPEnterpriseSearchServiceInstance -Identity "myserver1"
$hostB = Get-SPEnterpriseSearchServiceInstance -Identity "myserver2"
Start-SPEnterpriseSearchServiceInstance -Identity $hostA
Start-SPEnterpriseSearchServiceInstance -Identity $hostB

    검색 구성 요소를 추가할 때 참조 ($<host n>) 를 사용하여 대상 서버를 지정합니다.

  4. 모든 Search Service 인스턴스가 실행될 때까지 기다립니다. 각 Search Service 인스턴스에 대해 Microsoft PowerShell 명령 프롬프트에서 명령이 온라인 상태를 반환할 때까지 다음 명령을 입력합니다.

    Get-SPEnterpriseSearchServiceInstance -Identity $<host n >

    예를 들면 다음과 같습니다.

    Get-SPEnterpriseSearchServiceInstance -Identity $hostA
TypeName    : SharePoint Server Search
Description : Index content and serve search queries
Id          : 82ce8815-ecbd-4cf3-a98e-33f20bd86039
Server      : SPServer Name=myserver1.example.com
Service     : SearchService Name=OSearch16
Role        : None
Status      : Online

활성 검색 토폴로지 검색

Search Service 응용 프로그램의 활성 검색 토폴로지를 보려면 Microsoft PowerShell을 사용해야 합니다.

활성 검색 토폴로지를 보려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. SharePoint 관리 셸을 시작합니다. 다시 사용할 수 있는 사용 가능한 Microsoft PowerShell 개체 참조를 만든 열린 SharePoint 관리 셸이 이미 있으면 대신 열린 셸을 사용합니다.

  3. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    $ssa = Get-SPEnterpriseSearchServiceApplication
$active = Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa 
$active

이 명령은 다음과 같이 활성 토폴로지에 대한 정보를 반환합니다. TopologyId : 2d7bb046-1ad4-43a9-9984-754c4551a3ec CreationDate : 1/25/2016 3:06:00 AM State : Active ComponentCount : 6

검색 구성 요소 목록 검색

활성 검색 토폴로지에서 해당 속성을 사용하여 검색 구성 요소 목록을 보려면 Microsoft PowerShell을 사용해야 합니다. 검색 구성 요소 속성 중 하나는 검색 구성 요소 ID입니다. 검색 구성 요소를 제거하려면 검색 구성 요소 ID만 필요합니다.

모든 검색 구성 요소의 목록을 보려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. SharePoint 관리 셸을 시작합니다. 재사용 가능한 SharePoint 관리 셸 개체 참조를 만든 열려 있는 SharePoint 관리 셸이 이미 있는 경우 열려 있는 셸을 대신 사용합니다.

  3. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    $ssa = Get-SPEnterpriseSearchServiceApplication
$active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active
Get-SPEnterpriseSearchComponent -SearchTopology $active

    이 명령은 활성 검색 토폴로지에 있는 검색 구성 요소 목록과 해당 속성을 반환합니다.

활성 검색 토폴로지 복제

검색 설치 시 검색 인덱스에 항목이 포함된 검색 토폴로지를 변경하려면 먼저 새 토폴로지 개체를 만들어야 합니다. 검색 구성 요소를 추가 또는 제거하여 활성 토폴로지의 복제본인 이 새로운 토폴로지 개체를 수정합니다. 복제 토폴로지 개체를 변경한 후에는 활성 토폴로지를 복제합니다.

활성 토폴로지를 복제하려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. SharePoint 관리 셸을 시작합니다. 다시 사용할 수 있는 사용 가능한 Microsoft PowerShell 개체 참조를 만든 열린 SharePoint 관리 셸이 이미 있으면 대신 열린 셸을 사용합니다.

  3. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    $ssa = Get-SPEnterpriseSearchServiceApplication
$active = Get-SPEnterpriseSearchTopology -SearchApplication $ssa -Active
$clone = New-SPEnterpriseSearchTopology -SearchApplication $ssa -Clone -SearchTopology $active

    이 명령은 동일한 SharePoint 관리 셸을 계속 사용하여 검색 구성 요소를 추가하거나 제거하고 검색 토폴로지를 활성화하는 경우 $clone 참조할 수 있는 복제 검색 토폴로지를 만듭니다.

  4. (선택 사항) 검색 토폴로지에서 검색 구성 요소를 제거해야 할 경우에는 검색 구성 요소 ID를 검색해야 합니다. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    Get-SPEnterpriseSearchComponent -SearchTopology $clone

    이 명령은 복제된 검색 토폴로지에 있는 검색 구성 요소 목록과 검색 구성 요소 ID를 포함한 해당 속성을 반환합니다.

검색 구성 요소 추가

활성 검색 토폴로지는 직접 변경할 수 없습니다. 이 절차에서는 활성 검색 토폴로지 복제에 설명된 대로 복제 토폴로지 개체를 만들었다고 가정합니다. 각 검색 구성 요소에 대해 다음 Microsoft PowerShell cmdlet을 사용할 수 있습니다.

  • New-SPEnterpriseSearchAdminComponent

  • New-SPEnterpriseSearchAnalyticsProcessingComponent

  • New-SPEnterpriseSearchContentProcessingComponent

  • New-SPEnterpriseSearchCrawlComponent

  • New-SPEnterpriseSearchQueryProcessingComponent

참고

인덱스 구성 요소를 추가하는 절차는 다릅니다. 자세한 내용은 SharePoint Server에서 인덱스 구성 요소 관리를 참조하세요.

검색 구성 요소를 추가하려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. SharePoint 관리 셸을 시작합니다. 다시 사용할 수 있는 사용 가능한 Microsoft PowerShell 개체 참조를 만든 열린 SharePoint 관리 셸이 이미 있으면 대신 열린 셸을 사용합니다.

  3. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    New-SPEnterpriseSearch<SearchComponent> -SearchTopology $clone -SearchServiceInstance $<host n >

    여기서 각 부분이 나타내는 의미는 다음과 같습니다.

    • <SearchComponent>는 추가할 검색 구성 요소 유형의 이름입니다.

    • $clone은 변경하려는 복제된 토폴로지입니다. 활성 검색 토폴로지 복제를 참조하세요.

    • $<host n> 은 검색 구성 요소를 추가하려는 서버에서 실행 중인 검색 서비스 인스턴스에 대한 PowerShell 개체 참조입니다. 서버에서 Search Service 인스턴스 시작을 참조하세요.

    예를 들어 다음 명령은 Search Service 인스턴스 참조인 $hostA로 식별되는 서버의 복제본 토폴로지에 콘텐츠 처리 구성 요소를 추가합니다.

    New-SPEnterpriseSearchContentProcessingComponent -SearchTopology $clone -SearchServiceInstance $hostA

  4. 새 검색 구성 요소가 복제본 토폴로지에 추가되었는지 확인합니다. 이렇게 하려면 Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    Get-SPEnterpriseSearchComponent -SearchTopology $clone

검색 구성 요소 제거

검색 구성 요소를 제거하려면 Windows PowerShell을 사용해야 합니다. 활성 검색 토폴로지를 직접 변경할 수는 없습니다. 이 절차에서는 활성 검색 토폴로지 복제에 설명된 대로 복제 토폴로지 개체를 만들었다고 가정합니다.

참고

인덱스 구성 요소를 제거하는 절차는 다릅니다. 자세한 내용은 SharePoint Server에서 인덱스 구성 요소 관리를 참조하세요.

검색 구성 요소를 제거하려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. SharePoint 관리 셸을 시작합니다. 다시 사용할 수 있는 사용 가능한 Microsoft PowerShell 개체 참조를 만든 열린 SharePoint 관리 셸이 이미 있으면 대신 열린 셸을 사용합니다.

  3. 현재 활성 토폴로지가 정상 상태이고 제거하려는 검색 구성 요소가 활성 상태인지 확인합니다. 중앙 관리의 검색 관리 페이지에서 검색 토폴로지의 상태를 보거나 Windows PowerShell cmdlet 을 Get-SPEnterpriseSearchStatus실행합니다.

  4. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    Remove-SPEnterpriseSearchComponent -Identity <Search component id> -SearchTopology $clone

    여기서 각 부분이 나타내는 의미는 다음과 같습니다.

    • <Search component id> 는 제거하려는 검색 구성 요소의 ID입니다. 복제 토폴로지에서 검색 구성 요소 ID를 사용합니다. 검색 구성 요소 ID를 검색하려면 활성 검색 토폴로지 복제의 4단계를 참조하세요.

    • $clone은 변경하려는 복제된 토폴로지입니다. 활성 검색 토폴로지 복제를 참조하세요.

  5. 메시지가 표시되면 검색 구성 요소 제거를 확인합니다.

검색 구성 요소 이동

한 서버에서 다른 서버로 검색 구성 요소를 제거할 경우에는 이전 검색 구성 요소를 제거하기 전에 새 검색 구성 요소를 검색 토폴로지에 추가하는 것이 좋습니다.

검색 구성 요소를 이동하려면

  1. 활성 검색 토폴로지를 복제합니다. 활성 검색 토폴로지 복제를 참조하세요.

  2. 검색 구성 요소를 호스트하려는 서버에 새 검색 구성 요소를 추가합니다. 검색 구성 요소 추가를 참조하세요.

  3. 검색 토폴로지를 활성화합니다. 이 토폴로지는 하나의 검색 구성 요소를 여분으로 포함합니다. 검색 토폴로지 활성화를 참조하세요.

  4. 현재 활성 토폴로지가 정상 상태인지 확인합니다. 중앙 관리의 검색 관리 페이지에서 검색 토폴로지의 상태를 보거나 Windows PowerShell cmdlet 을 Get-SPEnterpriseSearchStatus실행합니다.

  5. 검색 토폴로지를 다시 복제합니다. 활성 검색 토폴로지 복제를 참조하세요.

  6. 여분의 검색 구성 요소를 제거합니다. 검색 구성 요소 제거를 참조하세요.

  7. 검색 토폴로지를 다시 활성화합니다. 검색 토폴로지 활성화를 참조하세요.

검색 토폴로지 활성화

검색 토폴로지를 활성화하려면 Windows PowerShell을 사용해야 합니다.

검색 토폴로지를 활성화하려면

  1. 이 절차를 수행하는 사용자 계정이 Farm Administrators 그룹의 구성원인지 확인합니다.

  2. SharePoint 관리 셸을 시작합니다. 다시 사용할 수 있는 사용 가능한 Microsoft PowerShell 개체 참조를 만든 열린 SharePoint 관리 셸이 이미 있으면 대신 열린 셸을 사용합니다.

  3. Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    Set-SPEnterpriseSearchTopology -Identity $clone

    여기서 각 부분이 나타내는 의미는 다음과 같습니다.

  4. 새 토폴로지가 활성화되었는지 확인합니다. 이렇게 하려면 Windows PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

    Get-SPEnterpriseSearchTopology -Active -SearchApplication $ssa

    이 명령은 다음과 같이 활성 및 비활성 토폴로지에 대한 간략한 정보를 반환합니다.

    TopologyId     : fce8507d-61c6-4498-8038-4fd2d0a62c6e
CreationDate   : 1/30/2016 2:52:00 AM
State          : Inactive
ComponentCount : 6
TopologyId     : b63d48b2-df5c-41be-a7f4-9abaee483611
CreationDate   : 1/30/2016 4:30:00 AM
State          : Active
ComponentCount : 7

    활성 토폴로지의 구성 요소 수에 사용자의 변경 내용이 반영되는 것을 확인할 수 있습니다.