jetstream-api 0.6.9__tar.gz → 0.6.11__tar.gz

{jetstream_api-0.6.9 → jetstream_api-0.6.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.9
+Version: 0.6.11
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -54,6 +54,33 @@ Python으로 작성된 ILink 클라이언트 API입니다.
 ## 설치 방법
 pip install jetstream-api
 
+## 0.6.11 변경 - 메시지 크기 상한(기본 128MiB), 재시도 보호, 클러스터 편의 개선
+
+- **메시지(프레임) 크기 상한의 기본값이 128MiB 입니다**(엔진 `Runtime@MaxFrameLength` 기본과 같습니다). 넘는 메시지는 **보내기 전에** `MIMQE_MSG_SIZE_OVER` 로 막고 연결은 그대로 둡니다.
+  - 엔진은 서버의 상한을 알려 주지 않습니다. 서버에서 상한을 올렸다면 클라이언트도 같이 올리십시오 - 연결은 `setMaxFrameLength(n)`(`ILQmgr` / `ILAdminService`), producer 는 `ILProducerConfig.maxFrameLength(n)` 입니다. 범위는 1,048,576 ~ 999,999,999 입니다.
+  - producer 레코드 한 건의 실제 상한은 `maxRequestSize` 와 `maxFrameLength - 25`(헤더) 중 작은 쪽입니다.
+- **재시도 보호**: 1MiB 를 넘는 레코드를 보낸 직후 응답 없이 연결이 **연속 2번** 끊기면, producer 는 재시도를 멈추고 그 레코드를 `MIMQE_MSG_SIZE_OVER` 로 실패시킵니다. 서버 상한이 클라이언트 설정보다 작을 때 같은 큰 레코드를 시한이 다할 때까지 되풀이해 보내지 않게 하려는 것입니다. 큰 레코드는 따로 보내므로 옆 레코드는 영향을 받지 않습니다.
+- `ILClusterNode("QM1", "10.0.0.12", 21001, 27091)` 처럼 자바와 같은 순서로 만들 수 있습니다(`ILClusterProperty("C1", 27091)` 도 같습니다).
+- `getAuthorityHolderType()` 은 권한 보유자를 `"MAIN"` / `"SUB"` / `""` 로 줍니다. `getAuthorityHolder()` 는 선 코드(`"M"` / `"S"`)라 `clusterType` 과 바로 비교하면 늘 거짓입니다.
+
+★ 엔진 7.0.1.3404 전에는 엔진 쪽 상한이 999,999,999 였습니다. 그런 엔진에 128MiB 를 넘는 메시지를 보내려면 위 설정을 올리십시오.
+
+## 0.6.10 변경 - 클러스터 관리 API 를 판사/조정자 모델로 (클러스터는 엔진 7.0.1.3391 이상)
+
+클러스터 하나는 관리 서비스 셋(판사 · MAIN · SUB)에 **각자 정의를 만듭니다.** 한 서비스에 만들면 나머지에 퍼지던 옛 방식은 엔진에서 없어졌습니다.
+
+- 정의는 `ILClusterProperty.judge(name, main, sub, ilcc_port)` 와 `ILClusterProperty.coordinator(name, "MAIN" 또는 "SUB", ilcc_port)` 로 만들고, 세 서비스에서 각각 `createCluster(정의)` 합니다.
+- 노드(`ILClusterNode`)에 그 호스트 조정자의 `ilcc_port` 를 싣습니다. 판사 정의와 그 조정자 정의 **두 곳에 같은 값**을 적습니다.
+- `setClusterProperty` 로 바꿀 수 있는 것은 자동 기동(어디서나)과 하트비트(판사에서만)뿐입니다. 타입 · ilcc 포트 · 노드를 바꾸려면 세 곳에서 지우고 다시 만듭니다.
+- `removeCluster` / `startCluster` / `stopCluster` 는 **접속한 서비스만** 다룹니다. 떠 있어도 지워집니다. `stopCluster` 는 정지를 기다리지 않으므로, 곧바로 다시 띄우려면 상태가 `STOPPED` 인지 먼저 확인하십시오.
+- `getClusterDefDiag` 는 새 본문(FORMAT 2)을 읽습니다. 판사에 물으면 두 조정자의 상태가, 조정자에 물으면 판사와의 관계가 옵니다.
+- 기동/정지 실패 사유가 "-1" 대신 엔진이 준 사유로 올라옵니다.
+- **없어진 API**: `addClusterNode` / `removeClusterNode`, `getLastClusterWarning`, 이름 · 포트로 만드는 `createCluster` 형태, `ILClusterProperty` 의 `priSvc` · `secSvc` · `witSvc` · 세 포트 · `role` · `add_node` · `remove_node`, 옛 진단 접근자(`getLocal`, `getLocalAddress`, `isMissing`, `hasAgreement` 등), 상수 `CLUSTER_NO_NODES_MIN_REVISION` · `CLUSTER_DEFDIAG_MAX_FORMAT` · `CLUSTER_DEFDIAG_MAX_ELAPSED_MS`.
+
+그 밖:
+
+- 프레임 길이가 999,999,999 바이트를 넘으면 **보내기 전에** `MIMQE_MSG_SIZE_OVER` 로 막습니다. 엔진은 그런 프레임을 받으면 사유 없이 연결을 끊습니다. `maxRequestSize` 는 999,999,974 를 넘지 않게 보정됩니다.
+
 ## 0.6.9 변경 - 파티션을 클라이언트가 정한다 (엔진 7.0.1.3401 이상 필요)
 
 엔진이 더는 파티션을 고르지 않습니다. 이 판부터 producer 와 관리 API 단건 발행이 파티션을 정해 보냅니다(Kafka 와 같은 방식).

{jetstream_api-0.6.9 → jetstream_api-0.6.11}/README.md

@@ -8,6 +8,33 @@ Python으로 작성된 ILink 클라이언트 API입니다.
 ## 설치 방법
 pip install jetstream-api
 
+## 0.6.11 변경 - 메시지 크기 상한(기본 128MiB), 재시도 보호, 클러스터 편의 개선
+
+- **메시지(프레임) 크기 상한의 기본값이 128MiB 입니다**(엔진 `Runtime@MaxFrameLength` 기본과 같습니다). 넘는 메시지는 **보내기 전에** `MIMQE_MSG_SIZE_OVER` 로 막고 연결은 그대로 둡니다.
+  - 엔진은 서버의 상한을 알려 주지 않습니다. 서버에서 상한을 올렸다면 클라이언트도 같이 올리십시오 - 연결은 `setMaxFrameLength(n)`(`ILQmgr` / `ILAdminService`), producer 는 `ILProducerConfig.maxFrameLength(n)` 입니다. 범위는 1,048,576 ~ 999,999,999 입니다.
+  - producer 레코드 한 건의 실제 상한은 `maxRequestSize` 와 `maxFrameLength - 25`(헤더) 중 작은 쪽입니다.
+- **재시도 보호**: 1MiB 를 넘는 레코드를 보낸 직후 응답 없이 연결이 **연속 2번** 끊기면, producer 는 재시도를 멈추고 그 레코드를 `MIMQE_MSG_SIZE_OVER` 로 실패시킵니다. 서버 상한이 클라이언트 설정보다 작을 때 같은 큰 레코드를 시한이 다할 때까지 되풀이해 보내지 않게 하려는 것입니다. 큰 레코드는 따로 보내므로 옆 레코드는 영향을 받지 않습니다.
+- `ILClusterNode("QM1", "10.0.0.12", 21001, 27091)` 처럼 자바와 같은 순서로 만들 수 있습니다(`ILClusterProperty("C1", 27091)` 도 같습니다).
+- `getAuthorityHolderType()` 은 권한 보유자를 `"MAIN"` / `"SUB"` / `""` 로 줍니다. `getAuthorityHolder()` 는 선 코드(`"M"` / `"S"`)라 `clusterType` 과 바로 비교하면 늘 거짓입니다.
+
+★ 엔진 7.0.1.3404 전에는 엔진 쪽 상한이 999,999,999 였습니다. 그런 엔진에 128MiB 를 넘는 메시지를 보내려면 위 설정을 올리십시오.
+
+## 0.6.10 변경 - 클러스터 관리 API 를 판사/조정자 모델로 (클러스터는 엔진 7.0.1.3391 이상)
+
+클러스터 하나는 관리 서비스 셋(판사 · MAIN · SUB)에 **각자 정의를 만듭니다.** 한 서비스에 만들면 나머지에 퍼지던 옛 방식은 엔진에서 없어졌습니다.
+
+- 정의는 `ILClusterProperty.judge(name, main, sub, ilcc_port)` 와 `ILClusterProperty.coordinator(name, "MAIN" 또는 "SUB", ilcc_port)` 로 만들고, 세 서비스에서 각각 `createCluster(정의)` 합니다.
+- 노드(`ILClusterNode`)에 그 호스트 조정자의 `ilcc_port` 를 싣습니다. 판사 정의와 그 조정자 정의 **두 곳에 같은 값**을 적습니다.
+- `setClusterProperty` 로 바꿀 수 있는 것은 자동 기동(어디서나)과 하트비트(판사에서만)뿐입니다. 타입 · ilcc 포트 · 노드를 바꾸려면 세 곳에서 지우고 다시 만듭니다.
+- `removeCluster` / `startCluster` / `stopCluster` 는 **접속한 서비스만** 다룹니다. 떠 있어도 지워집니다. `stopCluster` 는 정지를 기다리지 않으므로, 곧바로 다시 띄우려면 상태가 `STOPPED` 인지 먼저 확인하십시오.
+- `getClusterDefDiag` 는 새 본문(FORMAT 2)을 읽습니다. 판사에 물으면 두 조정자의 상태가, 조정자에 물으면 판사와의 관계가 옵니다.
+- 기동/정지 실패 사유가 "-1" 대신 엔진이 준 사유로 올라옵니다.
+- **없어진 API**: `addClusterNode` / `removeClusterNode`, `getLastClusterWarning`, 이름 · 포트로 만드는 `createCluster` 형태, `ILClusterProperty` 의 `priSvc` · `secSvc` · `witSvc` · 세 포트 · `role` · `add_node` · `remove_node`, 옛 진단 접근자(`getLocal`, `getLocalAddress`, `isMissing`, `hasAgreement` 등), 상수 `CLUSTER_NO_NODES_MIN_REVISION` · `CLUSTER_DEFDIAG_MAX_FORMAT` · `CLUSTER_DEFDIAG_MAX_ELAPSED_MS`.
+
+그 밖:
+
+- 프레임 길이가 999,999,999 바이트를 넘으면 **보내기 전에** `MIMQE_MSG_SIZE_OVER` 로 막습니다. 엔진은 그런 프레임을 받으면 사유 없이 연결을 끊습니다. `maxRequestSize` 는 999,999,974 를 넘지 않게 보정됩니다.
+
 ## 0.6.9 변경 - 파티션을 클라이언트가 정한다 (엔진 7.0.1.3401 이상 필요)
 
 엔진이 더는 파티션을 고르지 않습니다. 이 판부터 producer 와 관리 API 단건 발행이 파티션을 정해 보냅니다(Kafka 와 같은 방식).

{jetstream_api-0.6.9 → jetstream_api-0.6.11}/ilink/__init__.py

@@ -1,6 +1,6 @@
 """iLink - Python client API for iLink M.O.M. (Message Oriented Middleware)."""
 
-__version__ = "0.6.9"
+__version__ = "0.6.11"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser