콘솔 사용하기

관리자 콘솔을 제공합니다. 관리자 콘솔을 사용하려면 사이드바에서 <1콘솔terminal> 버튼을 클릭합니다.

버전을 확인하려면 콘솔에서 다음 명령어를 입력한 후 Enter 키를 누릅니다.

version

명령어

로그

`get-log-level`

현재 로그 수준을 확인하려면 다음 명령어를 입력합니다. 기본 값은 INFO입니다.

get-log-level

`change-log-level`

로그 수준을 바꾸려면 다음 명령어를 입력합니다. -level 옵션으로 수준을 설정합니다.

change-log-level -level INFO

설정 가능한 로그 수준은 다음과 같습니다.

ALL
SEVERE
WARNING
INFO
CONFIG
FINE
FINER
FINEST
OFF

로그 수준 기본값은 INFO입니다. CONFIG, FINE, FINER, FINEST, ALL처럼 INFO보다 자세한 수준으로 바꾸면 로그가 많아지고, 서버를 시작할 때 관리자에게 알림을 보냅니다. 특별한 이유가 없다면 로그 수준을 변경하지 않습니다.

웹 캐시

`enable-web-cache`

웹 뷰어 캐시 기능을 사용하려면 다음 명령어를 입력합니다.

enable-web-cache

기본으로 웹 캐시를 사용합니다.

`disable-web-cache`

웹 뷰어 캐시 기능을 사용하지 않으려면 다음 명령어를 입력합니다.

disable-web-cache

특별한 이유가 없다면 웹 캐시를 사용하는 것을 권장합니다.

`clear-web-cache`

웹 뷰어 캐시를 지우려면 다음 명령어를 입력합니다. 기존 웹 캐시를 모두 지우고 새롭게 만듭니다.

clear-web-cache

데이터베이스 연결 정보 암호화

자세한 사항은 데이터베이스 연결 정보 암호화를 참고합니다.

`get-encrypted-db-info`

암호화한 데이터베이스 연결 정보를 확인하려면 다음 명령어를 입력합니다.

get-encrypted-db-info

`encrypt-db-info`

데이터베이스 연결 정보를 암호화하려면 다음 명령어를 입력합니다.

encrypt-db-info -url jdbc:h2:h2/database; -username 사용자_이름 -password 비밀번호

-url, -username, -password 옵션은 3RABBITZ_HOME/tomcat/conf/server.xml 파일의 Resource 태그의 속성 값입니다.

문서 검색 색인 파일 관리

문서 검색에 사용하는 색인 파일을 확인하고 삭제하는 명령어입니다.

`get-search-index`

문서 검색 색인 파일을 확인하려면 다음 명령어를 입력합니다.

get-search-index -id 문서_또는_태그_아이디

`remove-search-index`

문서 검색 색인 파일을 삭제하려면 다음 명령어를 입력합니다.

remove-search-index -id 문서_또는_태그_아이디

업로드 가능한 파일 확장자 제한

업로드 가능한 파일 확장자를 제한하는 명령어입니다.

`add-upload-file-extension`

업로드 가능한 파일 확장자를 추가하려면 다음 명령어를 입력합니다.

add-upload-file-extension -extension 파일확장자

`remove-upload-file-extension`

업로드 가능한 파일 확장자를 삭제하려면 다음 명령어를 입력합니다.

remove-upload-file-extension -extension 파일확장자

`list-upload-file-extension`

업로드 가능한 파일 확장자를 확인하려면 다음 명령어를 입력합니다.

list-upload-file-extension

설정

설정 값을 확인하고 바꾸는 명령어입니다.

`get-preference`

설정 값을 확인하려면 다음 명령어를 입력합니다. -name 옵션으로 설정 이름을 지정합니다.

get-preference -name LOG_LEVEL

`set-preference`

설정 값을 바꾸려면 다음 명령어를 입력합니다. -name 옵션으로 설정 이름을, -value 옵션으로 값을 지정합니다.

set-preference -name BACKUP_KEEP_COUNT -value 5

숫자 설정에는 숫자만 입력할 수 있습니다. UPLOAD_DIR처럼 데이터 디렉터리에서 정해지는 디렉터리 설정은 바꿀 수 없습니다.

`remove-preference`

설정 값을 지우려면 다음 명령어를 입력합니다. APP_CSS, APP_JS, DEFAULT_ROLE 등 지울 수 있도록 허용한 설정만 지울 수 있습니다.

remove-preference -name APP_CSS

사용자 메뉴

메뉴에 사용자 메뉴를 추가하는 명령어입니다. 사용자 메뉴를 클릭하면 새 창으로 지정한 주소를 엽니다.

`add-menu`

사용자 메뉴를 추가하려면 다음 명령어를 입력합니다. -id 옵션으로 메뉴 아이디를, -name 옵션으로 메뉴 이름을, -url 옵션으로 주소를 지정합니다. 메뉴는 아이디 순서로 보입니다.

add-menu -id 1 -name 홈페이지 -url https://example.com

`update-menu`

사용자 메뉴를 바꾸려면 다음 명령어를 입력합니다. -name과 -url 옵션 중 바꿀 값을 지정합니다.

update-menu -id 1 -url https://example.com/support

`remove-menu`

사용자 메뉴를 삭제하려면 다음 명령어를 입력합니다.

remove-menu -id 1

`list-menu`

사용자 메뉴 목록을 확인하려면 다음 명령어를 입력합니다.

list-menu

`add-doc-ac`

모든 문서의 접근 권한을 추가할 때 사용합니다.

되돌리려면 문서마다 개별적으로 설정해야 합니다. 따라서 주의해서 사용하는 것을 권장합니다.

add-doc-ac -type [owner|collaborator|reviewer] -user [ALL_USERS|PROJECT_MEMBERS|userid|groupid]

다음을 참고합니다.

type 옵션으로 owner(소유자), collaborator(협업자), reviewer(독자) 중에 하나를 설정합니다.
user 옵션으로 ALL_USERS(모든 사용자), PROJECT_MEMBERS(프로젝트 모든 구성원), userid(사용자아이디), groupid(그룹 아이디) 중에 하나를 설정합니다.
사용자 아이디와 그룹 아이디는 UUID가 아닌 사용자 또는 그룹의 아이디를 의미합니다.
문서의 소유자로 모든 사용자를 설정할 수 없습니다.
사용자를 소유자 또는 협업자로 설정할 때는 사용자가 “글 쓰기” 권한이 있어야 합니다.

예를 들어 모든 사용자를 모든 문서의 독자로 설정하려면 다음 명령어를 실행합니다.

add-doc-ac -type reviewer -user ALL_USERS

프로젝트 모든 구성원을 모든 문서의 협업자로 설정하려면 다음 명령어를 실행합니다.

add-doc-ac -type collaborator -user PROJECT_MEMBERS

아이디가 admin 사용자를 모든 문서의 소유자로 설정하려면 다음 명령어를 실행합니다.

add-doc-ac -type owner -user admin

`clear`

콘솔 창을 지우려면 다음 명령어를 입력합니다.

clear

`clear-preview-image`

PDF 테마와 PDF 페이지 레이아웃에서 사용하는 미리 보기 이미지 파일을 삭제하려면 다음 명령어를 입력합니다.

clear-preview-image

미리 보기 파일이 없으면 미리 보기 파일을 다시 만들기 때문에 이 명령어가 시스템에 미치는 영향은 없습니다.

`generate-key`

사용자 이름과 이메일을 암호화할 때 쓰는 키를 만들려면 다음 명령어를 입력합니다. 자세한 사항은 사용자 이름과 이메일 데이터베이스에 암호화해 저장을 참고합니다.

generate-key

`java-gc`

자바 가비지 컬렉션을 실행하려면 다음 명령어를 입력합니다.

java-gc

`java-heap`

자바 힙 메모리 정보를 확인하려면 다음 명령어를 입력합니다.

java-heap

`java-version`

자바 버전을 확인하려면 다음 명령어를 입력합니다.

java-version

`monitor`

Work와 캐시 상태를 확인하려면 다음 명령어를 입력합니다. 동시에 처리할 수 있는 Work 수, 남은 Work 수, 웹 캐시와 문서 캐시 등의 크기를 보여줍니다.

monitor

`network-interface`

서버의 네트워크 인터페이스와 인터페이스별 서버 아이디를 확인하려면 다음 명령어를 입력합니다. 자세한 사항은 네트워크 인터페이스 설정을 참고합니다.

network-interface

`optimize-doc`

형식에 맞지 않는 단락 내용을 문서 단위로 일괄적으로 수정하려면 다음 명령어를 입력합니다.

optimize-doc -b f26bac2cbacec04d

-b 옵션으로 매뉴얼웍스 문서의 UUID를 지정합니다.

`remove-all-export-files`

책과 짧은 문서에서 만들기한 파일을 한꺼번에 지우려면 다음 명령어를 입력합니다. 태그로 만든 파일과 문서 전체를 형식별로 마지막에 만든 파일은 지우지 않습니다.

지운 파일은 되돌릴 수 없습니다.

remove-all-export-files

`server-id`

서버 아이디를 확인하려면 다음 명령어를 입력합니다.

server-id

`set-update-file`

매뉴얼웍스 업데이트 서버에 접속할 수 없거나 업데이트 파일을 올릴 수 없는 환경이 있습니다. 이 때는 다음 명령어를 통해서 업데이트 파일을 지정합니다.

set-update-file -f '/home/rabbitz/3rabbitz-2025-0544.tar.gz'

-f 옵션으로 매뉴얼웍스 설치 파일의 절대 경로를 지정합니다. 공백이 없다면 작은 따옴표는 생략할 수 있습니다.

매뉴얼웍스를 설치한 서버에 업데이트할 매뉴얼웍스 설치 파일이 있어야 합니다.

`version`

매뉴얼웍스 버전을 확인하려면 다음 명령어를 입력합니다.

version

자바 버전을 확인하려면 다음 명령어를 입력합니다.

version -java

`uuid`

16자의 소문자 영어와 숫자로 이뤄진 임의의 UUID를 생성하려면 다음 명령어를 입력합니다.

uuid