팜 및 노드 관리

  • 아티클

이 섹션에 설명된 cmdlet을 사용하여 팜 및 팜에 포함된 노드를 만들거나 삭제할 수 있습니다.

새 Service Bus for Windows Server 팜 만들기

New-SBFarm cmdlet은 Service Bus for Windows Server 노드의 새 팜을 만듭니다. 자동 생성된 인증서를 사용하는 팜을 만들려면 다음 형식을 사용합니다.

New-SBFarm [-AdminGroup <String>] [-GatewayDBConnectionString <String>] [-HttpsPort <Int32>]
[-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>] [-MessageContainerDBConnectionString <String>]
[-RunAsAccount <String>] [-TcpPort <Int32>] -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String>

사용자 지정 인증서를 사용하는 팜을 만들려면 다음 형식을 사용합니다.

New-SBFarm [-AdminGroup <String>] [-EncryptionCertificateThumbprint <String>] [-GatewayDBConnectionString
<String>] [-HttpsPort <Int32>] [-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>]
[-MessageContainerDBConnectionString <String>] [-RunAsAccount <String>] [-TcpPort <Int32>]
-FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String>

팜을 만드는 동안 오류가 발생하거나 강제로 다시 부팅되는 경우, 만들어진 팜 관리 데이터베이스가 손상될 수 있습니다. 이 경우 팜에 가입하려고 할 때 프로세스에, 팜에 추가하려는 컴퓨터가 어떠한 팜에도 속해 있지 않음을 나타내는 오류가 표시될 수 있습니다. 이러한 오류가 표시되면 팜 관리 데이터베이스를 삭제하고 다시 만들어야 팜에 새 노드를 가입시킬 수 있습니다.

다음 표에는 이 cmdlet의 옵션이 설명되어 있습니다.

옵션 효과

– SBFarmDBConnectionString <connectionstring>

구성 데이터베이스의 연결 문자열을 나타냅니다.

-Admingroup <adgroup>

구성원이 팜의 데이터베이스에 대한 관리 액세스를 받게 될 사용자 그룹을 지정합니다. 컴퓨터의 BuiltIn\Administrators 그룹이 기본적으로 지정됩니다.

-CertificateAutoGenerationKey <SecureString>]

설치 프로그램에서 서비스와 해당 클라이언트 간의 통신을 보호하는 새로운 서비스 SSL 인증서를 생성하기 위해 사용하는 키를 지정합니다.

-MessageContainerDBConnectionString <connstring>

컨테이너 데이터베이스로 사용되는 데이터베이스 인스턴스의 연결 문자열을 지정합니다.

-MessageBrokerPort <portno>

메시지 브로커 통신에 사용할 포트를 지정합니다. 기본값은 9356입니다.

-HttpsPort <portno>

HTTPS 통신에 사용할 포트를 지정합니다. 기본값은 9355입니다.

-InternalPortRangeStart <portrange>

Windows Fabric 내의 Service Bus for Windows Server 노드 간에 서로 통신하는 데 사용할 포트 범위를 지정합니다. portrange 매개 변수는 연속된 6개 포트 범위의 첫 번째 포트를 나타내는 단일 포트 번호입니다.

-GatewayDBConnectionString <connstring>

게이트웨이 데이터베이스로 사용되는 데이터베이스 인스턴스의 연결 문자열을 지정합니다. 게이트웨이 데이터베이스는 들어오는 요청을 관리하고 부하를 분산시킵니다.

-TCPPort <portno>

Service Bus for Windows Server 노드 간에 서로 통신하는 데 사용할 포트를 지정합니다. 기본값은 9354입니다.

-EncryptionCertificateThumbprint <string>

SQL 연결 문자열을 보호하는 데 사용되는 인증서입니다. 인증서가 제공되지 않은 경우 SslCertificate의 값이 사용됩니다. 암호화 인증서를 나타냅니다.

-FarmCertificateThumbprint <string>

인증서를 보호하는 데 사용되는 인증서입니다. 인증서를 자동 생성하기 위해 CertificateAutoGenerationKey를 제공하는 경우에는 이 인증서를 제공하지 마십시오.

팜에 새 노드 추가

Add-SBHost cmdlet은 노드를 기존 팜에 추가합니다. Add-SBHost cmdlet의 형식은 다음과 같습니다.

Add-SBHost [-CertificateAutogenerationKey <SecureString>] [-ExternalBrokerPort <Int32>] [-ExternalBrokerUrl <Uri>] -EnableFirewallRules <Boolean> -RunAsPassword <SecureString> -SBFarmDBConnectionString <String>

다음 표에는 이 cmdlet의 옵션이 설명되어 있습니다.

옵션 효과

– SBFarmDBConnectionString <connectionstring>

팜 관리 데이터베이스로 추가 중인 SQL Server 인스턴스에 대한 연결 문자열을 지정합니다.

-RunAsPassword <SecureString>

팜에서 실행 중인 서비스의 사용자 계정에 대한 암호를 지정합니다. 동일한 서비스 계정 및 보안 정책을 공유하는 팜의 모든 컴퓨터에서 서비스 계정 암호를 정기적으로 변경해야 하는 경우 팜에서 노드를 계속 추가하고 제거할 수 있도록 팜의 각 컴퓨터에 대해 특정 작업을 수행해야 합니다. 이 절차는 팜 암호 변경 내용 처리 섹션을 참조하십시오.

-CertificateAutoGenerationKey <SecureString>]

팜에서 자동 생성된 인증서에 대해 보안을 설정하는 데 사용하는 키를 지정합니다.

-EnableFirewallRules <Boolean>

true이면 호스트에서 방화벽 규칙이 사용하도록 설정됩니다.

-ExternalBrokerPort <Int32>

Service Bus for Windows Server에서 ExternalBroker 통신에 사용하는 포트를 나타냅니다.

-ExternalBrokerUrl <Uri>

대/소문자가 구분된 ExternalBroker URI를 지정합니다.

설치 프로그램은 노드가 팜에 추가될 때 사용자가 선택한 내용에 따라 다음 인증서를 자동으로 생성합니다.

인증서 유형 Name 발급자

CA

AppServerGeneratedSBCA

FarmCertificate

AppServerGeneratedSBCA

AppServerGeneratedSBCA

팜에서 노드 제거

Remove-SBHost cmdlet은 기존 팜에서 노드를 제거합니다. 팜이 중지된 상태에서 이 cmdlet을 실행하면 오류 또는 경고가 발생할 수 있습니다. 이 오류 및 경고를 무시하고 Remove-SBHost 이후에 Start-SBFarm을 실행하여 변경 내용을 적용할 수 있습니다. 팜이 실행 중인 상태이면 Start-SBFarm을 실행할 필요가 없습니다.

이 cmdlet의 형식은 다음과 같습니다.

Remove-SBHost [-SBFarmDBConnectionString <string>] [-HostName <string>] [<CommonParameters>]

다음 표에는 이 cmdlet의 옵션이 설명되어 있습니다.

옵션 효과

– SBFarmDBConnectionString <connectionstring>

팜에서 제거될 SQL Server 인스턴스의 연결 문자열을 지정합니다. 이 매개 변수를 지정하지 않으면 cmdlet은 레지스트리에서 연결 문자열을 찾습니다.

-HostName<String>

제거할 호스트의 이름입니다. 이 매개 변수를 제공하지 않으면 cmdlet을 실행하는 호스트가 제거됩니다.

참고

호스트를 더 이상 사용할 수 없고 팜 구성을 정리하려는 경우에 HostName을 제공해야 합니다.

팜에 속한 컴퓨터의 이름을 바꾸려면 먼저 이 cmdlet을 사용하여 팜에서 컴퓨터를 제거한 다음 Add-SBHost cmdlet을 사용하여 팜에 다시 추가해야 합니다. 이 cmdlet에서 시간 제한 오류가 발생한 경우에도 Add-SBHost cmdlet을 실행하여 컴퓨터를 팜에 다시 추가할 수 있습니다. Add-SBHost가 성공하면 시간 제한 오류를 무시할 수 있습니다.

팜을 탈퇴하면 컴퓨터에 설치된 인증서가 남게 됩니다. 이러한 인증서를 제거하려면 수동으로 제거해야 합니다.

팜을 단일 컴퓨터 팜으로 축소하려면 팜에서 모든 컴퓨터를 제거해야 합니다. 그런 다음 팜에 포함할 컴퓨터를 다시 추가해야 합니다.

빌드 날짜:

2013-07-25