기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# ActiveMQ용 Amazon MQ 브로커 구성
<a name="amazon-mq-broker-configuration-parameters"></a>

 구성에는 ActiveMQ 브로커에 대한 모든 설정이 XML 형식(ActiveMQ의 `activemq.xml` 파일과 유사)으로 포함됩니다. 브로커를 생성하기 전에 구성을 생성할 수 있습니다. 그런 다음 구성을 하나 이상의 브로커에 적용할 수 있습니다.

**중요**  
구성을 변경해도 변경 사항이 브로커에 즉시 적용되지는 *않습니다*. 변경 내용을 적용하려면 다음 유지 관리 기간을 기다리거나 [브로커를 재부팅](amazon-mq-rebooting-broker.md)해야 합니다.  
`DeleteConfiguration` API를 사용해서만 구성을 **삭제**할 수 있습니다. 자세한 내용은 *Amazon MQ API 참조*의 [구성](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)을 참조하세요.

## 속성
<a name="configuration-attributes"></a>

브로커 구성에는 여러 속성이 있습니다. 예시는 다음과 같습니다.
+ 이름 (`MyConfiguration`)
+ ID(`c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Amazon 리소스 이름(ARN)(`arn:aws:mq:us-east-2:123456789012:configuration:c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)

구성 속성의 전체 목록은 *Amazon MQ REST API 참조*의 다음 단원을 참조하세요.
+ [REST 작업 ID: 구성](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [REST 작업 ID: 구성](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

구성 개정 속성의 전체 목록은 다음 단원을 참조하세요.
+ [REST 작업 ID: 구성 개정](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [REST 작업 ID: 구성 개정](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## Spring XML 구성 파일 사용
<a name="working-with-spring-xml-configuration-files"></a>

ActiveMQ 브로커는 [Spring XML](https://docs.spring.io/spring/docs/current/spring-framework-reference/) 파일을 사용하여 구성됩니다. 사전 정의된 대상, 대상 정책, 권한 부여 정책 및 플러그 인과 같은 ActiveMQ 브로커의 여러 측면을 구성할 수 있습니다. Amazon MQ는 이러한 구성 요소 중 네트워크 전송 및 스토리지와 같은 일부 요소를 제어합니다. 브로커의 네트워크 생성과 같은 기타 구성 옵션은 현재 지원되지 않습니다.

지원되는 구성 옵션의 전체 세트는 Amazon MQ XML 스키마에 지정되어 있습니다. 다음 링크를 사용하여 지원되는 스키마의 zip 파일을 다운로드합니다.
+ [samples/amazon-mq-active-mq-5.19.1.xsd.zip](samples/amazon-mq-active-mq-5.19.1.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.18.4.xsd.zip](samples/amazon-mq-active-mq-5.18.4.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.17.6.xsd.zip](samples/amazon-mq-active-mq-5.17.6.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.16.7.xsd.zip](samples/amazon-mq-active-mq-5.16.7.xsd.zip) 
+  [samples/amazon-mq-active-mq-5.15.16.xsd.zip](samples/amazon-mq-active-mq-5.15.16.xsd.zip) 

이러한 스키마를 사용하여 구성 파일을 검증하고 폐기할 수 있습니다. Amazon MQ에서는 XML 파일을 업로드하여 구성을 제공할 수도 있습니다. XML 파일을 업로드하면 Amazon MQ는 스키마에 따라 잘못된 구성 파라미터와 금지된 구성 파라미터를 자동으로 폐기하고 제거합니다.

**참고**  
속성의 정적 값만 사용할 수 있습니다. Amazon MQ는 Spring 표현식, 변수 및 요소 참조가 포함된 요소와 속성을 구성에서 폐기합니다.

# ActiveMQ용 Amazon MQ 브로커 구성 생성
<a name="amazon-mq-creating-applying-configurations"></a>

*구성*에는 ActiveMQ 브로커에 대한 모든 설정이 XML 형식(ActiveMQ의 `activemq.xml` 파일과 유사)으로 포함됩니다. 브로커를 생성하기 전에 구성을 생성할 수 있습니다. 그런 다음 구성을 하나 이상의 브로커에 적용할 수 있습니다. 구성을 즉시 적용하거나 *유지 관리 기간* 중에 적용할 수 있습니다.

다음 예제에서는 AWS Management Console을 사용하여 Amazon MQ 브로커 구성을 생성하고 적용하는 방법을 보여줍니다.

**중요**  
`DeleteConfiguration` API를 사용해서만 구성을 **삭제**할 수 있습니다. 자세한 내용은 *Amazon MQ API 참조*의 [구성](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)을 참조하세요.

## 새 구성 생성
<a name="creating-configuration-from-scratch-console"></a>

새 브로커 구성을 생성하려면 먼저 새 구성을 생성합니다.

1. [Amazon MQ 콘솔](https://console.aws.amazon.com/amazon-mq/)에 로그인합니다.

1. 왼쪽에서 탐색 창을 확장하고 **Configurations(구성)**를 선택합니다.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. **Configurations(구성)** 페이지에서 **Create configuration(구성 생성)**을 선택합니다.

1. **구성 생성** 페이지의 **세부 정보(Details)** 섹션에서 **구성 이름(Configuration name)**(예: `MyConfiguration`)을 입력하고 **브로커 엔진(Broker engine)** 버전을 선택합니다.
**참고**  
ActiveMQ용 Amazon MQ에서 지원하는 ActiveMQ 엔진 버전에 대한 자세한 내용은 [ActiveMQ용 Amazon MQ 엔진 버전 관리](activemq-version-management.md) 단원을 참조하세요.

1. **구성 생성**을 선택합니다.

## 새로운 구성 개정 생성
<a name="creating-new-configuration-revision-console"></a>

브로커 구성을 생성한 후에는 구성 개정을 사용하여 구성을 편집해야 합니다.

1. 구성 목록에서 ***MyConfiguration***을 선택합니다.
**참고**  
첫 번째 구성 개정은 Amazon MQ가 구성을 생성할 때 항상 생성됩니다.

   ***MyConfiguration*** 페이지에 새로운 구성 개정에 사용할 브로커 엔진 유형 및 버전(예: **Apache ActiveMQ 5.15.16**)이 표시됩니다.

1. [**Configuration details**] 탭에 구성 개정 번호, 설명 및 XML 형식의 브로커 구성이 표시됩니다.
**참고**  
현재 구성을 편집하면 새 구성 개정이 생성됩니다.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. [**Edit configuration**]을 선택하고 XML 구성을 변경합니다.

1. **저장**을 선택합니다.

   **Save revision(개정 버전 저장)** 대화 상자가 표시됩니다.

1. (선택 사항) `A description of the changes in this revision`을 입력합니다.

1. **저장**을 선택합니다.

   구성의 새 개정 버전이 저장됩니다.
**중요**  
Amazon MQ 콘솔이 스키마에 따라 잘못되고 금지된 구성 파라미터를 자동으로 정리합니다. 자세한 내용과 허용된 XML 파라미터의 전체 목록은 [ActiveMQ용 Amazon MQ 브로커 구성](amazon-mq-broker-configuration-parameters.md) 단원을 참조하세요.

## 브로커에 구성 개정 적용
<a name="apply-configuration-revision-creating-console"></a>

구성을 수정한 후 브로커에 구성 개정을 적용할 수 있습니다.

1. 왼쪽에서 탐색 창을 확장하고 **Brokers(브로커)**를 선택합니다.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. 브로커 목록에서 브로커(예: **MyBroker**)를 선택한 다음 **Edit(편집)**을 선택합니다.

1. [**Edit *MyBroker***] 페이지의 [**Configuration**] 섹션에서 [**Configuration**] 및 [**Revision**]을 선택하고 [**Schedule Modifications**]를 선택합니다.

1. **Schedule broker modifications(브로커 수정 예약)** 섹션에서 **During the next scheduled maintenance window(예약된 다음 유지 관리 기간 동안)** 또는 **Immediately(즉시)** 중에 수정을 적용할 시점을 선택합니다.
**중요**  
단일 인스턴스 브로커는 재부팅되는 동안 오프라인 상태입니다. 클러스터 브로커의 경우 브로커가 재부팅되는 동안 한 번에 하나의 노드만 다운됩니다.

1. **적용**을 선택합니다.

   지정된 시간에 구성 개정이 브로커에 적용됩니다.

# ActiveMQ용 Amazon MQ 구성 개정 편집
<a name="edit-current-configuration-console"></a>

브로커에 구성 개정을 적용한 후 이를 편집할 수 있습니다. 다음 지침에 따라 구성 개정을 편집합니다.

1. [Amazon MQ 콘솔](https://console.aws.amazon.com/amazon-mq/)에 로그인합니다.

1. 브로커 목록에서 브로커(예: **MyBroker**)를 선택한 다음 **Edit(편집)**을 선택합니다.

1. ***MyBroker*** 페이지에서 **Edit(편집)**를 선택합니다.

1. **Edit *MyBroker*(MyBroker 편집)** 페이지의 **구성** 섹션에서 **구성** 및 **개정**을 선택하고 **편집**을 선택합니다.
**참고**  
브로커를 생성할 때 구성을 선택하지 않는 한 첫 번째 구성 개정은 Amazon MQ가 브로커를 생성할 때 항상 생성됩니다.

   ***MyBroker*** 페이지에서 구성에 사용되는 브로커 엔진 유형 및 버전(예: **Apache ActiveMQ 5.15.8**)을 볼 수 있습니다.

1. [**Configuration details**] 탭에 구성 개정 번호, 설명 및 XML 형식의 브로커 구성이 표시됩니다.
**참고**  
현재 구성을 편집하면 새 구성 개정이 생성됩니다.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. [**Edit configuration**]을 선택하고 XML 구성을 변경합니다.

1. **저장**을 선택합니다.

   **Save revision(개정 버전 저장)** 대화 상자가 표시됩니다.

1. (선택 사항) `A description of the changes in this revision`을 입력합니다.

1. **저장**을 선택합니다.

   구성의 새 개정 버전이 저장됩니다.
**중요**  
Amazon MQ 콘솔이 스키마에 따라 잘못되고 금지된 구성 파라미터를 자동으로 정리합니다. 자세한 내용과 허용된 XML 파라미터의 전체 목록은 [ActiveMQ용 Amazon MQ 브로커 구성](amazon-mq-broker-configuration-parameters.md) 단원을 참조하세요.

# Amazon MQ 구성에 허용되는 요소
<a name="permitted-elements"></a>

다음은 Amazon MQ 구성에서 허용되는 요소의 세부 목록입니다. 자세한 내용은 Apache ActiveMQ 설명서의 [XML 구성](http://activemq.apache.org/xml-configuration.html)을 참조하세요.


| 요소 | 
| --- | 
| abortSlowAckConsumerStrategy[(속성)](permitted-attributes.md#abortSlowAckConsumerStrategy.attributes) | 
| abortSlowConsumerStrategy[(속성)](permitted-attributes.md#abortSlowConsumerStrategy.attributes) | 
| authorizationEntry[(속성)](permitted-attributes.md#authorizationEntry.attributes) | 
| authorizationMap[(하위 컬렉션 요소)](permitted-collections.md#authorizationMap.collections) | 
| authorizationPlugin[(하위 컬렉션 요소)](permitted-collections.md#authorizationPlugin.collections) | 
| broker[(속성](permitted-attributes.md#broker.attributes) \$1 [하위 컬렉션 요소)](permitted-collections.md#broker.collections) | 
| cachedMessageGroupMapFactory[(속성)](permitted-attributes.md#cachedMessageGroupMapFactory.attributes) | 
| compositeQueue[(속성](permitted-attributes.md#compositeQueue.attributes) \$1 [하위 컬렉션 요소)](permitted-collections.md#compositeQueue.collections) | 
| compositeTopic[(속성](permitted-attributes.md#compositeTopic.attributes) \$1 [하위 컬렉션 요소)](permitted-collections.md#compositeTopic.collections) | 
| constantPendingMessageLimitStrategy[(속성)](permitted-attributes.md#constantPendingMessageLimitStrategy.attributes) | 
| discarding[(속성)](permitted-attributes.md#discarding.attributes) | 
| discardingDLQBrokerPlugin[(속성)](permitted-attributes.md#discardingDLQBrokerPlugin.attributes) | 
| fileCursor | 
| fileDurableSubscriberCursor | 
| fileQueueCursor | 
| filteredDestination[(속성)](permitted-attributes.md#filteredDestination.attributes) | 
| fixedCountSubscriptionRecoveryPolicy[(속성)](permitted-attributes.md#fixedCountSubscriptionRecoveryPolicy.attributes) | 
| fixedSizedSubscriptionRecoveryPolicy[(속성)](permitted-attributes.md#fixedSizedSubscriptionRecoveryPolicy.attributes) | 
| forcePersistencyModeBrokerPlugin[(속성)](permitted-attributes.md#forcePersistencyModeBrokerPlugin.attributes) | 
| individualDeadLetterStrategy[(속성)](permitted-attributes.md#individualDeadLetterStrategy.attributes) | 
| lastImageSubscriptionRecoveryPolicy | 
| messageGroupHashBucketFactory[(속성)](permitted-attributes.md#messageGroupHashBucketFactory.attributes) | 
| mirroredQueue[(속성)](permitted-attributes.md#mirroredQueue.attributes) | 
| noSubscriptionRecoveryPolicy | 
| oldestMessageEvictionStrategy[(속성)](permitted-attributes.md#oldestMessageEvictionStrategy.attributes) | 
| oldestMessageWithLowestPriorityEvictionStrategy[(속성)](permitted-attributes.md#oldestMessageWithLowestPriorityEvictionStrategy.attributes) | 
| policyEntry[(속성](permitted-attributes.md#policyEntry.attributes) \$1 [하위 컬렉션 요소)](permitted-collections.md#policyEntry.collections) | 
| policyMap[(하위 컬렉션 요소)](permitted-collections.md#policyMap.collections) | 
| prefetchRatePendingMessageLimitStrategy[(속성)](permitted-attributes.md#prefetchRatePendingMessageLimitStrategy.attributes) | 
| priorityDispatchPolicy | 
| priorityNetworkDispatchPolicy | 
| queryBasedSubscriptionRecoveryPolicy[(속성)](permitted-attributes.md#queryBasedSubscriptionRecoveryPolicy.attributes) | 
| queue[(속성)](permitted-attributes.md#queue.attributes) | 
| redeliveryPlugin[(속성](permitted-attributes.md#redeliveryPlugin.attributes) \$1 [하위 컬렉션 요소)](permitted-collections.md#redeliveryPlugin.collections) | 
| redeliveryPolicy[(속성)](permitted-attributes.md#redeliveryPolicy.attributes) | 
| redeliveryPolicyMap[(하위 컬렉션 요소)](permitted-collections.md#redeliveryPolicyMap.collections) | 
| retainedMessageSubscriptionRecoveryPolicy[(하위 컬렉션 요소)](permitted-collections.md#retainedMessageSubscriptionRecoveryPolicy.collections) | 
| roundRobinDispatchPolicy | 
| sharedDeadLetterStrategy[(속성](permitted-attributes.md#sharedDeadLetterStrategy.attributes) \$1 [하위 컬렉션 요소)](permitted-collections.md#sharedDeadLetterStrategy.collections) | 
| simpleDispatchPolicy | 
| simpleMessageGroupMapFactory | 
| statisticsBrokerPlugin | 
| storeCursor | 
| storeDurableSubscriberCursor[(속성)](permitted-attributes.md#storeDurableSubscriberCursor.attributes) | 
| strictOrderDispatchPolicy | 
| tempDestinationAuthorizationEntry[(속성)](permitted-attributes.md#tempDestinationAuthorizationEntry.attributes) | 
| tempQueue[(속성)](permitted-attributes.md#tempQueue.attributes) | 
| tempTopic[(속성)](permitted-attributes.md#tempTopic.attributes) | 
| timedSubscriptionRecoveryPolicy[(속성)](permitted-attributes.md#timedSubscriptionRecoveryPolicy.attributes) | 
| timeStampingBrokerPlugin[(속성)](permitted-attributes.md#timeStampingBrokerPlugin.attributes) | 
| topic[(속성)](permitted-attributes.md#topic.attributes) | 
| transportConnector[(속성)](permitted-attributes.md#transportConnector.attributes) | 
| uniquePropertyMessageEvictionStrategy[(속성)](permitted-attributes.md#uniquePropertyMessageEvictionStrategy.attributes) | 
| virtualDestinationInterceptor[(하위 컬렉션 요소)](permitted-collections.md#virtualDestinationInterceptor.collections) | 
| virtualTopic[(속성)](permitted-attributes.md#virtualTopic.attributes) | 
| vmCursor | 
| vmDurableCursor | 
| vmQueueCursor | 

# Amazon MQ 구성에서 허용되는 요소 및 해당 속성
<a name="permitted-attributes"></a>

다음은 Amazon MQ 구성에서 허용되는 요소 및 해당 속성의 세부 목록입니다. 자세한 내용은 Apache ActiveMQ 설명서의 [XML 구성](http://activemq.apache.org/xml-configuration.html)을 참조하세요.

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/permitted-attributes.html)

## Amazon MQ 상위 요소 속성
<a name="parent-element-details"></a>

다음은 상위 요소 속성에 대한 자세한 설명입니다. 자세한 내용은 Apache ActiveMQ 설명서의 [XML 구성](http://activemq.apache.org/xml-configuration.html)을 참조하세요.

**Topics**
+ [브로커](#broker-element)

### 브로커
<a name="broker-element"></a>

`broker`는 상위 컬렉션 요소입니다.

#### 속성
<a name="broker-attributes"></a>

##### networkConnectionStartAsync
<a name="networkConnectionStartAsync"></a>

네트워크 대기 시간을 줄이고 다른 네트워크가 적시에 시작하도록 하려면`<networkConnectionStartAsync>` 태그를 사용합니다. 해당 태그는 브로커가 실행기를 사용하여 브로커 시작과 비동기적으로 네트워크 연결을 병렬로 시작하도록 지시합니다.

**기본값**: `false`

#### 구성의 예제
<a name="networkConnectorStartAsync"></a>

```
<broker networkConnectorStartAsync="false"/>
```

# Amazon MQ 구성에서 허용되는 요소, 하위 컬렉션 요소 및 해당 하위 요소
<a name="permitted-collections"></a>

다음은 Amazon MQ 구성에서 허용되는 요소, 하위 컬렉션 요소 및 해당 하위 요소의 세부 목록입니다. 자세한 내용은 Apache ActiveMQ 설명서의 [XML 구성](http://activemq.apache.org/xml-configuration.html)을 참조하세요.

스크롤 막대를 사용하여 표의 나머지 부분을 확인합니다.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/amazon-mq/latest/developer-guide/permitted-collections.html)

# Amazon MQ 하위 요소 속성
<a name="child-element-details"></a>

다음은 하위 요소 속성에 대한 자세한 설명입니다. 자세한 내용은 Apache ActiveMQ 설명서의 [XML 구성](http://activemq.apache.org/xml-configuration.html)을 참조하세요.

**Topics**
+ [authorizationEntry](#authorizationEntry)
+ [networkConnector](#networkConnector)
+ [kahaDB](#kahaDB)
+ [systemUsage](#systemUsage)

## authorizationEntry
<a name="authorizationEntry"></a>

`authorizationEntry`는 `authorizationEntries` 하위 컬렉션 요소의 하위입니다.

### 속성
<a name="admin-read-write-attributes"></a>

#### admin\$1read\$1write
<a name="admin-read-write"></a>

사용자 그룹에게 부여된 권한. 자세한 정보는 [항상 권한 부여 맵 구성](using-amazon-mq-securely.md#always-configure-authorization-map)을 참조하세요.

`activemq-webconsole` 그룹을 포함하지 않는 권한 부여 맵을 지정하는 경우, 그룹이 Amazon MQ 브로커에 메시지를 보내거나 브로커에서 메시지를 수신할 권한이 없기 때문에 ActiveMQ 웹 콘솔을 사용할 수 없습니다.

**기본값**: `null`

### 구성의 예제
<a name="admin-read-write-example"></a>

```
<authorizationPlugin>
                                <map>
                                    <authorizationMap>
                                        <authorizationEntries>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" queue=">"/>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" topic=">"/>
                                        </authorizationEntries>
                                    </authorizationMap>
                                </map>
                                </authorizationPlugin>
```

**참고**  
 Amazon MQ 기반 ActiveMQ의 `activemq-webconsole` 그룹은 모든 대기열 및 주제에 대한 관리자 권한을 보유하고 있습니다. 이 그룹의 모든 사용자도 관리자 액세스 권한을 갖습니다.

## networkConnector
<a name="networkConnector"></a>

`networkConnector`는 `networkConnectors` 하위 컬렉션 요소의 하위입니다.

**Topics**
+ [속성](#networkConnector-attributes)
+ [구성의 예](#networkConnector-example)

### 속성
<a name="networkConnector-attributes"></a>

#### conduitSubscriptions
<a name="conduitSubscriptions"></a>

브로커 네트워크 내 네트워크 연결이 동일한 대상에 구독하는 여러 소비자를 한 소비자로 취급하는지 여부를 지정합니다. 예를 들어 `conduitSubscriptions`가 `true`로 설정되고 두 소비자가 브로커 B에 연결하여 대상으로부터 소비할 경우, 브로커 B는 이들의 구독을 네트워크 연결을 통한 브로커 A에 대한 단일의 논리적 구독으로 결합합니다. 그러므로 메시지의 단일 복사본만 브로커 A에서 브로커 B로 전달됩니다.

**참고**  
`conduitSubscriptions`를 `true`로 설정하면 중복 네트워크 트래픽을 줄일 수 있습니다. 하지만 이 속성을 사용하면 소비자 사이의 로드 밸런싱 문제가 발생할 수 있고 일부 시나리오(예: JMS 메시지 선택기 또는 장기적 주제)에서 잘못된 동작을 초래할 수 있습니다.

**기본값**: `true`

#### duplex
<a name="duplex"></a>

브로커 네트워크 내 연결이 메시지를 생산 *및* 소비하는 데 사용되는지 여부를 지정합니다. 예를 들어 브로커 A가 비 전이중 모드로 브로커 B와의 연결을 생성한 경우 메시지는 브로커 A에서 브로커 B로만 전달될 수 있습니다. 하지만 브로커 A가 브로커 B와 전이중 연결을 생성한 경우에는 브로커 B가 `<networkConnector>`를 구성할 필요 없이 브로커 A로 메시지를 전달할 수 있습니다.

**기본값**: `false`

#### 이름
<a name="name"></a>

브로커 네트워크 내 브리지의 이름.

**기본값**: `bridge`

#### uri
<a name="uri"></a>

브로커 네트워크를 구성하는 두 브로커 중 하나(또는 여러 브로커)의 와이어 레벨 프로토콜 엔드포인트.

**기본값**: `null`

#### 사용자 이름
<a name="username"></a>

브로커 네트워크의 브로커에 공통된 사용자 이름.

**기본값**: `null`

### 구성의 예
<a name="networkConnector-example"></a>

**참고**  
`networkConnector`를 사용하여 브로커 네트워크를 정의할 때 브로커에 공통된 사용자의 암호를 포함시키지 마세요.

#### 2개 브로커로 구성된 브로커 네트워크
<a name="example-network-of-brokers-two-brokers"></a>

이 구성에서는 2개의 브로커가 브로커 네트워크로 연결되어 있습니다. 네트워크 커넥터의 이름은 `connector_1_to_2`이고, 브로커에 공통된 사용자 이름은 `myCommonUser`이고, 연결은 `duplex`이고, OpenWire 엔드포인트 URI는 접두사 `static:`을 사용하여 브로커 간 일대일 연결을 나타냅니다.

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

자세한 정보는 [2단계: 브로커에 대한 네트워크 커넥터 구성](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors)을 참조하세요.

#### 여러 브로커로 구성된 브로커 네트워크
<a name="example-network-of-brokers-multiple-brokers"></a>

이 구성에서는 여러 개의 브로커가 브로커 네트워크로 연결되어 있습니다. 네트워크 커넥터의 이름은 `connector_1_to_2`이고, 브로커에 공통된 사용자 이름은 `myCommonUser`이며, 연결은 `duplex`이고, OpenWire 엔드포인트 URI의 쉼표로 구분된 목록은 접두사 `masterslave:`을 사용하여 브로커 간 장애 조치 연결을 나타냅니다. 브로커 간 장애 조치는 랜덤화되지 않으며 재연결 시도가 무한정 계속됩니다.

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="masterslave:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617,
                                        ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

**참고**  
브로커 네트워크에는 `masterslave:` 접두사를 사용하는 것이 좋습니다. 이 접두사는 더 명시적인 `static:failover:()?randomize=false&maxReconnectAttempts=0` 구문과 동일합니다.

**참고**  
이 XML 구성에는 공백이 허용되지 않습니다.

## kahaDB
<a name="kahaDB"></a>

`kahaDB`는 `persistenceAdapter` 하위 컬렉션 요소의 하위입니다.

### 속성
<a name="kahaDB-attributes"></a>

#### concurrentStoreAndDispatchQueues
<a name="concurrentStoreAndDispatchQueues"></a>

대기열에 동시 저장 및 디스패치를 사용할지 여부를 지정합니다. 자세한 정보는 [느린 소비자를 통해 대기열 동시 저장 및 디스패치 비활성화](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers)을 참조하세요.

**기본값**: `true`

#### cleanupOnStop
<a name="cleanupOnStop"></a>

**지원 버전:**  
Apache ActiveMQ 15.16.x 이상

비활성화된 경우 브로커가 중지될 때 가비지 수집 및 정리가 수행되지 않으므로 종료 프로세스가 빨라집니다. 속도가 증가하면 대형 데이터베이스 또는 스케줄러 데이터베이스인 경우 유용합니다.

**기본값**: `true`

#### journalDiskSyncInterval
<a name="journalDiskSyncInterval"></a>

`journalDiskSyncStrategy=periodic`의 경우 디스크 동기화를 수행할 때의 간격(ms)입니다. 자세한 내용은 [Apache ActiveMQ kahaDB 설명서](https://activemq.apache.org/kahadb)를 참조하세요.

**기본값**: `1000`

#### journalDiskSyncStrategy
<a name="journalDiskSyncStrategy"></a>

**지원 버전:**  
Apache ActiveMQ 15.14.x 이상

디스크 동기화 정책을 구성합니다. 자세한 내용은 [Apache ActiveMQ kahaDB 설명서](https://activemq.apache.org/kahadb)를 참조하세요.

**기본값**: `always`

**참고**  
[ActiveMQ 설명서](https://activemq.apache.org/kahadb)에는 데이터 손실이 `journalDiskSyncInterval`의 시간으로 제한된다고 기술되어 있습니다. 즉, 기본값은 1초입니다. 데이터 손실은 해당 간격보다 길 수는 있지만 정확하게 명시하기는 어렵습니다. 사용 시 주의해야 합니다.

#### preallocationStrategy
<a name="preallocationStrategy"></a>

새 저널 파일이 필요한 경우 브로커가 저널 파일을 미리 할당하는 방법을 구성합니다. 자세한 내용은 [Apache ActiveMQ kahaDB 설명서](https://activemq.apache.org/kahadb)를 참조하세요.

**기본값**: `sparse_file`

### 구성의 예제
<a name="kahaDB-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <persistenceAdapter>
                                <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/>
                            </persistenceAdapter>
                            </broker>
```

## systemUsage
<a name="systemUsage"></a>

`systemUsage`는 `systemUsage` 하위 컬렉션 요소의 하위입니다. 생산자 속도가 느려지기 전에 브로커가 사용할 최대 공간을 제어합니다. 자세한 내용은 Apache ActiveMQ 설명서의 [생산자 흐름 제어](http://activemq.apache.org/producer-flow-control.html)를 참조하세요.

### 하위 요소
<a name="systemUsage-child"></a>

#### memoryUsage
<a name="memoryUsage"></a>

 `memoryUsage`는 `systemUsage` 하위 요소의 하위입니다. 메모리 사용량을 관리합니다. `memoryUsage`를 이용하면 항목이 얼마나 많이 사용되고 있는지 계속 추적할 수 있으므로 작업 세트 사용을 생산적으로 제어할 수 있습니다. 자세한 내용은 Apache Active MQ 설명서의 [스키마](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html)를 참조하세요.

##### 하위 요소
<a name="memoryUsage-child"></a>

 `memoryUsage`는 `memoryUsage` 하위 요소의 하위입니다.

##### 속성
<a name="memeoryUsage-attribute"></a>

##### percentOfJvmHeap
<a name="percentOfJvmHeap"></a>

0(포함)에서 70(포함) 사이의 정수입니다.

*기본값*: `70` 

### 속성
<a name="systemUsage-attributes"></a>

#### sendFailIfNoSpace
<a name="sendFailIfNoSpace"></a>

여유 공간이 없는 경우 `send()` 메서드가 실패할지 여부를 설정합니다. 기본값은 false이며 공간을 사용할 수 있을 때까지 `send()` 메서드를 차단합니다. 자세한 내용은 Apache Active MQ 설명서의 [스키마](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html)를 참조하세요.

**기본값**: `false`

#### sendFailIfNoSpaceAfterTimeout
<a name="sendFailIfNoSpaceAfterTimeout"></a>

**기본값**: `null`

#### 구성의 예제
<a name="systemUsage-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <systemUsage>
                                <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000">
                                    <memoryUsage>
                                        <memoryUsage  percentOfJvmHeap="60" />
                                    </memoryUsage>>
                                </systemUsage>
                                </systemUsage>
                            </broker>
                            </persistenceAdapter>
```