5.4.1. MySQL 인스턴스 매니저 명령어 옵션

 

MySQL 인스턴스 매니저는 여러 가지 명령어 옵션을 지원한다. 간단한 리스트를 보기 위해서는, --help 옵션을 사용해서 mysqlmanager를 호출한다. 옵션은 명령어 라인 또는 인스턴스 매니저 구성 파일 (Configuration file)에서 줄 수 있다. 윈도우 시스템의 경우, 표준 구성 파일 (Configuration file)은 인스턴스 매니저가 설치되어 있는 디렉토리의 my.ini 파일이다. 유닉스 시스템의 경우, 표준 파일은 /etc/my.cnf이다. 이것과는 다른 구성 파일 (Configuration file)을 지정하기 위해서는, 인스턴스 매니저를 --defaults-file 옵션과 함께 구동 시킨다.

 

mysqlmanager는 아래의 리스트에 있는 옵션들을 지원한다. 패스워드 파일에 있는 엔트리를 관리하기 위한 옵션은 Section 5.4.4, “MySQL 인스턴스 매니저 사용자 및 패스워드 관리”에서 설명하기로 한다.

• --help, -?

도움말 메시지를 화면에 출력한 후에 종료한다.

• --add-user

패스워드 파일에 새로운 사용자를 추가 (--username 옵션으로 지정함). 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --angel-pid-file=file_name

mysqlmanager가 데몬 모드 (즉, --run-as-service 옵션이 주어졌을 때)로 구동을 할 때 엔젤 레코드 (angel record)가 자신의 프로세스 ID를 기록하는 파일. 디폴트 파일 이름은 mysqlmanager.angel.pid이다.

 

만일 --angel-pid-file 옵션을 주지 않는다면, 디폴트 엔젤 PID 파일은 PID 파일의 확장자가 .angel.pid로 대체 (예를 들면, mysqlmanager.pid는 mysqlmanager.angel.pid가 된다)되지 않은 PID 파일과 같은 이름을 가지게 된다

 

이 옵션은 MySQL 5.1.11에서 추가되었다.

• --bind-address=IP

연결할 IP 주소.

• --check-password-file

패스워드 파일의 유효성 (validity)과 일관성을 검사한다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --clean-password-file

패스워드 파일에서 모든 사용자를 삭제한다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --debug=debug_options, -# debug_options

디버깅 로그를 작성한다. debug_options 스트링은 'd:t:o,file_name' 형태가 된다. 이 옵션은 MySQL 5.1.10에서 추가되었다.

• --default-mysqld-path=path

MySQL 서버 바이너리 경로 이름. 경로 이름은 mysqld-path 옵션이 없는 구성 파일 (Configuration file)의 모든 서버 인스턴스 섹션용으로 사용된다. 이 옵션의 디폴트 값은 컴파일 될 때의 경로 이름이 되며, 이것은 MySQL 배포판을 어떻게 구성했는지에 따라서 달라진다. 예: --default-mysqld-path=/usr/sbin/mysqld

• --defaults-file=file_name

입력된 파일에서 인스턴스 매니저와 MySQL 서버 설정 값을 읽음. 인스턴스 매니저가 변경하는 모든 구성 내용이 이 파일에 기록됨. 이 파일을 사용할 경우에는 반드시 명령어 라인의 맨 처음에 나와야 하고, 반드시 파일이 존재해야 한다.

 

만일 이 옵션을 주지 않는다면, 인스턴스 매니저는 자신의 표준 구성 파일 (Configuration file)을 사용한다. 윈도우 시스템의 경우, 표준 파일은 인스턴스 매니저를 설치한 디렉토리의 my.ini in 파일이 된다. 유닉스 시스템의 경우에는 /etc/my.cnf가 된다.

• --drop-user

패스워드 파일에서 사용자 (--username 옵션으로 지정된)를 제거한다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --edit-user

패스워드 파일에 존재하는 사용자 (--username 옵션으로 지정된)의 엔트리를 변경한다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --install

윈도우 시스템에서 인스턴스 매니저를 윈도우 서비스로 설치한다. 서비스 이름은 MySQL Manager.

• --list-users

패스워드 파일에 있는 사용자를 나열한다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --log=file_name

인스턴스 매니저 로그 파일에 대한 경로. 이 옵션은 --run-as-service 옵션을 함께 사용해야 한다. 이 옵션용으로 지정된 파일 이름이 연관성을 가지고 있다면, 로그 파일은 인스턴스 매니저가 시작한 디렉토리 밑에 생성된다. 파일이 특정 디렉토리 안에 생성되었는지를 확인하기 위해서는, 전체 경로 이름을 지정하도록 한다.

 

만일 --run-as-service를 –log 옵션 없이 주게 되면, 로그 파일은 데이터 디렉토리 안에 있는 mysqlmanager.log가 된다.

 

만일 --run-as-service를 주지 않으면, 로그 메시지는 표준 결과 값 저장 공간에 들어가게 된다.

 

로그 아웃풋을 가져오기 위해서는, 인스턴스 매니저 아웃풋이 파일로 향하도록 만들면 된다:

 

mysqlmanager > im.log

• --monitoring-interval=seconds

모니터링 서버 인스턴스에 대한 인터벌 (초 단위). 디폴트는 20초이다. 인스턴스 매니저는 존재하지 않는 MySQL_Instance_Manager 사용자 계정을 사용해서 모니터링을 하고 있는 각각의 인스턴스가 살아 있는지 확인하기 위해 연결을 시도한다. 만일 연결 시도 결과가 인스턴스를 사용하지 못하는 것을 가리키면, 인스턴스 매니저는 그 인스턴스를 여러 번 다시 시작하도록 시도한다.

 

일반적으로, MySQL_Instance_Manager 계정은 존재하지 않기 때문에, 인스턴스 매니저에 의한 연결 시도는 모니터링을 하고 있는 인스턴스가 자신의 일반 쿼리 로그에 아래와 유사한 메시지를 만들도록 한다:

 

Access denied for user 'MySQL_Instance_M'@'localhost' »

    (using password: YES)

 

적정 서버 인스턴스 섹션에 있는 nonguarded 옵션은 특정 인스턴스에 대한 모니터링을 비활성화 시킨다. 만일 인스턴스가 시작된 이후에 죽게 되면, 인스턴스 매니저는 그것을 다시 시작하지 못한다. 인스턴스 매니저는 여러분이 인스턴스의 상태 (예를 들면, SHOW INSTANCES 상태 옵션을 사용해서)를 요청하는 경우에만 보호 받지 않는 (unguarded) 인스턴스에 연결을 시도한다.

• --mysqld-safe-compatible

mysqld_safe-compatible 방식으로 구동. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --password=password, -p password

패스워드 파일에 추가되거나 또는 수정되어야 할 엔트리용 패스워드를 지정. 대부분의 MySQL 프로그램용 옵션인 --password/-P와는 달리, 패스워드 값이 반드시 필요하다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --password-file=file_name

인스턴스 매니저가 사용자 및 패스워드를 찾는 파일 이름. 윈도우 시스템의 경우, 디폴트는 인스턴스 매니저가 설치되어 있는 디렉토리에 있는 mysqlmanager.passwd가 된다. 유닉스 시스템의 경우에는 디폴트가 /etc/mysqlmanager.passwd이다.

• --pid-file=file_name

사용할 프로세스 ID 파일. 윈도우 시스템의 경우, 디폴트는 인스턴스 매니저가 설치되어 있는 디렉토리의 mysqlmanager.pid가 된다. 유닉스 시스템의 경우에는 데이터 디렉토리 안에 있는 mysqlmanager.pid가 된다.

• --port=port_num

클라이언트가 TCP/IP 연결을 하기 위해 사용하는 포트 번호. 디폴트 번호는 (IANA가 할당함) 2273이다.

• --print-defaults

현재의 디폴트 값을 출력하고 마침. 이 옵션을 사용할 경우에는, 반드시 명령어 라인 맨 처음에 나와야 한다.

• --print-password-line

패스워드 파일용 엔트리를 준비하고, 그것을 표준 아웃풋에 출력한 후에 마친다. 파일에 있는 엔트리를 저장하기 위해 인스턴스 매니저에서 파일로 방향을 변환 시킬 수 있다.

MySQL 5.1.12 이전 버전에서는, 이것은 --passwd이었다.

• --remove

윈도우 시스템의 경우, 윈도우 서비스 형태의 인스턴스 매니저를 제거. 이것은 인스턴스 매니저가 이전에 –install과 함께 구동 되었다고 가정한다.

• --run-as-service

유닉스 시스템의 경우, 엔젤 (angel) 프로세스를 데몬화 (daemonize)한 후에 시작한다. 엔젤 프로세스는 인스턴스 매니저를 감시하고 그것이 깨지는 경우에 다시 시작 하도록 만든다.

• --socket=path

유닉스 시스템의 경우, 들어오는 (incoming) 접속을 위해 사용될 유닉스 소켓. 디폴트 파일은/tmp/mysqlmanager.sock이다. 이 옵션은 윈도우에서는 의미가 없다.

• --standalone

윈도우 시스템의 경우, 단독 (standalone) 모드에서 인스턴스 매니저를 구동한다. 명령어 라인에서 인스턴스 매니저를 시작하는 경우에는 이것을 지정해야 한다.

• --user=user_name

유닉스 시스템에서 mysqlmanager를 시작하고 구동시키는데 사용하는 시스템 계정의 사용자 이름. root (자신이 효력을 가지는 사용자 ID를 변경하기 위해), 또는 네임드 사용자 자격으로 mysqlmanager를 구동시키지 않는 한 경고문이 발생하고 아무런 효력도 나타내지 않게 된다.

mysqld 서버를 구동시키기 위해 사용한 사용자 계정을 가지고 mysqlmanager를 구성할 것을 권장한다. (이 문장에서 쓰인 “사용자 (User)”는 시스템 로그인 계정을 참조하고, 그랜트 테이블에 있는 MySQL 사용자를 참조하지는 않는다.)  

• --username=user_name, -u user_name

패스워드 파일에 추가되거나 또는 수정되어야 할 엔트리용 사용자 이름을 지정한다. 이 옵션은 MySQL 5.1.12에서 추가되었다.

• --version, -V

버전 정보를 보여 주고 마침.

• --wait-timeout=N

들어오는 (incomming) 연결에 있는 액티비티를 기다려야 하는 시간 (초). 디폴트는 28800 초임 (8 시간).

 

이 옵션은 MySQL 5.1.7에서 추가되었다. 이 버전 이전에는, 타임 아웃이 30 초였으며 변경할 수 없었다.