큐브리드 cubrid_broker.conf 설정내용

SERVICE

SERVICE는 해당 브로커의 구동 여부를 결정하기 위한 파라미터로, ON 또는 OFF의 값으로 설정된다. 디폴트 값은 ON이며, 이 파라미터가 ON으로 설정된 경우에만 해당 브로커를 구동할 수 있다.

BROKER_PORT

BROKER_PORT는 해당 브로커의 포트 번호를 지정하기 위한 파라미터로 시스템 내에서 유일한 값이면서 65,535 이하의 값이어야 한다. query_editor의 브로커 포트는 디폴트 값이 30,000으로 설정되며, broker1의 브로커 포트는 디폴트 값이 33,000으로 설정된다.

MIN_NUM_APPL_SERVER

MIN_NUM_APPL_SERVER는 CUBRID 브로커가 생성할 수 있는 응용서버(CAS)의 최소 개수를 지정하는 파라미터로 디폴트 값은 5이다.

MAX_NUM_APPL_SERVER

MAX_NUM_APPL_SERVER는 CUBRID 브로커가 생성할 수 있는 응용서버(CAS)의 최대 개수를 지정하는 파라미터이며, 디폴트 값은 40이다.

APPL_SERVER_SHM_ID

APPL_SERVER_SHM_ID는 응용서버(CAS)가 이용하는 공유 메모리 ID를 지정하기 위한 파라미터로 시스템 내에서 유일한 값이어야 한다. 디폴트 값은 해당 브로커의 포트와 동일하게 설정된다.

APPL_SERVER_MAX_SIZE

APPL_SERVER_MAX_SIZE는 응용서버(CAS)가 처리하는 프로세스의 최대 크기를 지정하는 파라미터로 단위는 MB이다. 디폴트 값은 20(MB)이며, 현재 프로세스의 크기가 파라미터의 설정값을 초과하는 경우 브로커는 해당 응용서버를 재구동한다.

LOG_DIR

LOG_DIR은 브로커에 대한 접속 로그가 저장되는 디렉터리를 지정하는 파라미터로, 디폴트 값은 log/broker/sql_log이다. 브로커 접속 로그 파일명은 broker_name_id.access이다.

ERROR_LOG_DIR

ERROR_LOG_DIR은 브로커에 대한 에러 로그가 저장되는 디렉터리를 지정하는 파라미터로, 디폴트 값은 log/broker/error_log이다. 브로커 에러 로그 파일명은 broker_ name_id.err이다.

SQL_LOG

SQL_LOG는 응용 클라이언트의 요청에 따라 응용서버(CAS)가 처리한 SQL 문에 대해 로그를 저장할 것인지를 결정하는 파라미터로 디폴트 값은 ON이다. 이 파라미터가 ON으로 설정되면, SQL 로그가 기록되는 파일명은broker_name_id.sql.log이며, 설치 디렉터리의 log/broker/sql_log 디렉터리에 생성된다.

TIME_TO_KILL

TIME_TO_KILL은 자동 추가된 응용서버 중 유휴 상태의 응용서버(CAS)를 제거하기 위한 기준 시간을 설정하는 파라미터로 디폴트 값은 120(sec)이다. 유휴 상태란 작업이 없이 쉬고 있는 상태를 말한다. 이 상태가 TIME_TO_KILL 시간 이상 유지되면 응용서버(CAS) 의 제거/추가가 발생한다.

이 파라미터에 설정된 값은 자동 추가된 응용서버에만 적용되므로 AUTO_ADD_APPL_SERVER 파라미터가 ON인 경우에만 적용된다. TIME_TO_KILL 파라미터의 값을 너무 작게 설정하면 응용서버(CAS)의 제거/추가가 너무 빈번하게 발생할 수 있으므로 주의한다.

SESSION_TIMEOUT

SESSION_TIMEOUT은 해당 브로커의 세션을 종료하기 위한 타임아웃 값을 설정하는 파라미터로 디폴트 값은 300(sec)이다. 이 파라미터의 설정값을 초과하는 시간 동안 작업 요청에 응답이 없는 경우 해당 세션은 종료된다.

KEEP_CONNECTION

KEEP_CONNECTION은 응용서버(CAS)와 응용 클라이언트 사이의 연결 방식을 지정하는 파라미터로 ON/OFF/AUTO 중 하나로 설정된다. 이 파라미터가 OFF로 설정되면 클라이언트는 트랜잭션 단위로 응용서버와 연결하고, ON으로 설정되면 커넥션 단위로 응용서버와 연결한다. 또한 AUTO로 설정되면 응용서버의 개수가 클라이언트 개수보다 많은 경우 커넥션 단위로 연결하고, 응용서버의 개수가 클라이언트의 개수보다 적은 경우 트랜잭션 단위로 연결한다. 디폴트 값은 AUTO이다.

ACCESS LIST

ACCESS_LIST는 CUBRID 브로커로 접근을 허용하는 응용 클라이언트의 IP 주소 리스트를 저장할 파일 이름을 지정하는 파라미터이다. 210.192.33.*와 210.194.34.*인 IP 주소의 접근을 허용하려면 이를 임의의 파일(ip_lists.txt)에 저장하여 이 파라미터의 값으로 파일명을 설정한다.

ACCESS_LOG

ACCESS_LOG는 해당 브로커의 접속 로그를 저장할 것인지 지정하는 파라미터로 디폴트 값은 ON이다. 브로커 접속 로그 파일명은 broker_name_id.access이고, LOG_DIR 파라미터에서 설정한 디렉터리에 저장된다.

APPL_SERVER_PORT

APPL_SERVER_PORT는 Windows 운영체제에서만 추가할 수 있는 파라미터로 응용 클라이언트와 통신하는 응용서버(CAS)의 통신 포트를 지정하는 파라미터이다. 디폴트 값은 BROKER_PORT 파라미터 값에 1을 더한 값으로 설정되며, 응용서버의 최대 개수가 cubrid_broker_conf의 MAX_NUM_APPL_SERVER 파라미터에 의해 제한되므로 설정할 수 있는 응용서버(CAS)의 통신 포트의 개수 역시 최대 MAX_NUM_APPL_SERVER 파라미터의 설정값으로 제한된다. Windows 운영체제에서 응용 클라이언트와 CUBRID 브로커 사이에 방화벽이 존재하는 경우에는 반드시 BROKER_PORT 및 APPL_SERVER_PORT에서 설정된 통신 포트를 열어야 한다.

APPL_SERVER

APPL_SERVER는 CUBRID 브로커가 생성하고 관리하는 응용서버의 종류를 지정하는 파라미터로 디폴트 값은 CAS이다.

LOG_BACKUP

LOG_BACKUP은 브로커의 접속 로그 파일과 에러 로그 파일을 백업할 것인지 지정하는 파라미터이다. 디폴트 값은 OFF이며, 이 파라미터가 ON으로 설정되면 CUBRID 브로커가 종료될 때 접속 로그와 에러 로그의 백업을 수행한다. 이 때, 접속 로그의 백업 파일명은 broker_name_id.access가 되고, 에러 로그의 백업 파일명은 broker_ name_id.error가 된다.

SQL_LOG_MAX_SIZE

SQL_LOG_MAX_SIZE는 SQL 로그 파일의 최대 크기를 지정하는 파라미터로 디폴트 값은 100,000(KB)이다. SQL_LOG 파라미터가 ON으로 설정됨에 따라 생성되는 SQL 로그 파일이 이 파라미터의 설정값에 도달하면 broker_name_id.sql.log.bak이 생성된다.

MAX_STRING_LENGTH

MAX_STRING_LENGTH는 bit, varbit, char, varchar, nchar, nchar varying인 데이터 타입에 대해서 최대 스트링 길이를 지정하는 파라미터이다. 디폴트 값인 -1로 설정되면 데이터베이스에서 정의된 스트링 길이가 그대로 사용되고, 파라미터의 값이 100으로 설정되면 임의의 속성이 varchar(1000)으로 정의되었어도 100으로 정의된 것처럼 동작한다.

SOURCE_ENV

SOURCE_ENV는 브로커 각각에 대해 개별적으로 운영체제 환경 변수를 설정할 수 있는 파일을 정하는 파라미터로, 파일 확장자는 반드시 env여야 한다. cubrid.conf에서 지정하는 모든 파라미터는 환경 변수를 통해서도 설정할 수 있다. 예를 들어, cubrid.conf에서 lock_timeout_in_secs는 환경 변수 CUBRID_LOCK_TIMEOUT_IN_SECS로 지정할 수 있다. 또 다른 예로, broker1에서만 데이터 정의문 수행을 차단하려면 SOURCE_ENV에서 지정한 파일에CUBRID_BLOCK_DDL_STATEMENT 1을 설정하면 된다.

환경변수가 있을 경우, cubrid.conf보다 우선한다.

디폴트 값은 cubrid.env이다.

STATEMENT_POOLING

STATEMENT_POOLING은 statement 풀링 기능의 사용 여부를 설정하는 파라미터로 기본값은 OFF이다.