WebtoB 콘솔 툴

WebtoB는 엔진 프로세스 및 서버 프로세스들을 관리하기 위해서 다음과 같은 툴을 제공합니다.

Admin 툴

콘솔 툴 설명

wsadmin

WebtoB 시스템 전체적인 관리를 위해서 사용되는 툴로서, 시스템 정보 조회 및 관리자 작업 수행을 지원합니다.

콘솔 툴	설명
wsadmin	WebtoB 시스템 전체적인 관리를 위해서 사용되는 툴로서, 시스템 정보 조회 및 관리자 작업 수행을 지원합니다.

기타 툴

콘솔 툴	설명
configValidator	WebtoB 환경 파일에 대한 스키마 검증을 수행합니다.
mkpwd	SSL 인증서 키 패스워드에 대해 암호를 저장하는 파일을 생성합니다.

콘솔 툴

설명

configValidator

WebtoB 환경 파일에 대한 스키마 검증을 수행합니다.

mkpwd

SSL 인증서 키 패스워드에 대해 암호를 저장하는 파일을 생성합니다.

wsadmin

wsadmin은 텍스트 기반의 관리 환경을 제공합니다. 항상 프롬프트(prompt) 상태로 대기하면서 입력되는 명령어를 해석하여 실행합니다.

실행

wsadmin 툴을 실행하려면 wsadmin 명령을 사용합니다.
```
$ wsadmin
```
wsadmin 툴이 정상적으로 실행되면 다음과 같은 메시지와 함께 프롬프트가 표시됩니다.
```
$$1 [wsadmin]>>
```

종료

wsadmin 툴을 종료하려면 exit 명령을 사용합니다.
```
$$3 [wsadmin]>> exit
```

다음은 wsadmin이 제공하는 명령어에 대한 설명입니다.

명령어	약자	설명
cache-list		HTTP 응답 캐시에 저장된 응답의 정보를 출력합니다.
client-info	(ci)	접속 웹 브라우저를 확인합니다.
config	(cfg)	환경 설정 내용을 조회합니다.
exit		wsadmin을 종료합니다.
stat-info	(st)	프로세스, 스레드 및 서비스 상태에 대한 통계를 조회합니다.
svg-info	(si)	서버 정보를 확인합니다.

명령어

약자

설명

cache-list

HTTP 응답 캐시에 저장된 응답의 정보를 출력합니다.

client-info

(ci)

접속 웹 브라우저를 확인합니다.

config

(cfg)

환경 설정 내용을 조회합니다.

exit

wsadmin을 종료합니다.

stat-info

(st)

프로세스, 스레드 및 서비스 상태에 대한 통계를 조회합니다.

svg-info

(si)

서버 정보를 확인합니다.

configValidator

configValidator는 WebtoB 설정 파일에 대한 스키마 검증을 수행합니다.

WebtoB를 기동하기 전에 미리 configValidator 툴을 통해 설정 파일에 대한 검증 결과를 확인할 수 있습니다.

WebtoB의 설정 파일은 기본적으로 webtob-config.json이며, 환경 변수 WEBTOB6_CONFIG_FILE_NAME을 통해 설정 파일을 변경할 수 있습니다.

사용법
```
$ configValidator
```

사용 예시

정상적인 WebtoB 설정 파일 검증

$ configValidator
Config file path: ../config/webtob-config.json
Schema file path: ../config/webtob-config.schema.json
WEBTOB6_HOME_PATH = ../
WEBTOB6_CONFIG_FILE_PATH = ../config/
WEBTOB6_LIBRARY_PATH = ../lib/
WEBTOB6_SSL_PATH = ../ssl/
WEBTOB6_LICENSE_PATH = ../license/
WEBTOB6_SCHEMA_PATH = ../schema/
WEBTOB6_CONFIG_FILE_NAME = webtob-config.json
******* Start config validation *******
1. Opened schema file
2. Opened config file
3. Config parsing finished
4. Pre-validation process finished
5. Validation using json-schema finished
6. Post-validation process finished
Config file "../config/webtob-config.json" is validated with schema file "../schema/webtob-config.schema.json"
Success to load config files : webtob-config.json
******* Validation success *******

비정상적인 WebtoB 설정 파일 검증

$ configValidator
Config file path: ../config/webtob-config.json
Schema file path: ../config/webtob-config.schema.json
WEBTOB6_HOME_PATH = ../
WEBTOB6_CONFIG_FILE_PATH = ../config/
WEBTOB6_LIBRARY_PATH = ../lib/
WEBTOB6_SSL_PATH = ../ssl/
WEBTOB6_LICENSE_PATH = ../license/
WEBTOB6_SCHEMA_PATH = ../schema/
WEBTOB6_CONFIG_FILE_NAME = webtob-config.json
******* Start config validation *******
1. Opened schema file
2. Opened config file
3. Config parsing finished
4. Pre-validation process finished
[Exception on json-schema validation][Config validation failed]At /node/hth_count of -1 - instance is below minimum of 1

mkpwd

mkpwd는 SSL 절의 certificate_key_password를 지원하기 위한 툴입니다.

SSL 절에 암호화된 개인키를 설정하면 WebtoB를 기동할 때마다 암호문 입력을 요구합니다. 매번 암호문을 입력하는 번거로움을 줄이기 위해 certificate_key_password를 설정할 수 있습니다. mkpwd는 certificate_key_password에 적용할 수 있도록 passphrase 암호를 저장하는 passphrase 파일을 생성합니다.

certificate_key_password 사용법은 SSL 절 설정 항목을 참고합니다.

사용법

$ mkpwd <file_path> <ssl_name>

옵션	설명
<file_path>	certificate_key_password에 사용되는 파일 이름으로 mkpwd 실행의 결과를 해당 파일에 (추가)저장합니다.
<ssl_name>	SSL 절에 설정한 이름입니다.

옵션

설명

<file_path>

certificate_key_password에 사용되는 파일 이름으로 mkpwd 실행의 결과를 해당 파일에 (추가)저장합니다.

<ssl_name>

SSL 절에 설정한 이름입니다.

사용 예시

옵션 없이 실행

$ mkpwd
<< Usage >>
$ mkpwd file_path ssl_name
	 file_path: output file for ssl certificate key password
	 ssl_name: name of SSL section

file_path과 ssl_name을 지정하여 실행

$ mkpwd ssl.ppd ssl1
Make password for SSL certificate key password
Enter password: (암호문 입력)
Successfully Added password for [ssl1] to a file [ssl.ppd].

$ls -al ssl.ppd
-rw-rw-r--  1 webtob webtob 14 Nov 6 12:34 ssl.ppd

파일 내용 확인
```
$ cat ssl.ppd
ssl1 dGVzdA==
```