3장 AnswerBook2 서버 관리

AnswerBook2 소프트웨어의 관리 작업은 다음 기능의 수행으로 구성되는데, 각 기능에는 특정한 작업이 포함됩니다:

• "설명서 서버 관리"

• "설명서 서버 시작 및 중지"

• "문서 소스 디버깅 작동 또는 해제"

• "관리 액세스 제어"

• "문서 모음 작업"

• "설명서 서버 설정 보기"

• "기타 설명서 서버와 작업하기"

• "서버 리포트 작업"

• "일반적인 관리 페이지 이동 기능"

설명서 서버 관리

AnswerBook2 소프트웨어는 사용자가 설명서 서버를 관리하는데 사용할 수 있는 웹 브라우저 인터페이스 (AnswerBook2 관리 페이지) 및 명령어 줄 인터페이스(ab2admin)를 제공합니다. 대부분의 기능은 이 두 가지 인터페이스에서 사용 가능합니다.

만약 CD-ROM에서 설명서 서버를 실행하는 경우, 관리 기능을 사용할 수 없습니다.

주 AnswerBook2 관리 페이지를 액세스하려면, AnswerBook2 브라우저의 옵션 페이지에서 AnswerBook2 관리를 선택하거나 URL: http://server:port/ab2/@Ab2Admin을 액세스하십시오. 여기서 server는 사용자 서버의 이름이며 port는 서버가 작동하는 포트의 번호입니다 관리 페이지에 있는 모든 페이지에는 페이지의 상단에 일반 페이지 이동 기능이 있습니다.

명령어 줄 인터페이스를 액세스하려면, /usr/lib/ab2/bin/ab2admin를 사용하십시오. 명령어 줄 인터페이스에 대한 자세한 정보는, 부록 A를(을) 참조하십시오.

허가된 관리 권한을 가진 사용자만이 관리 기능을 액세스할 수 있습니다. 자세한 정보는, "관리 액세스 제어"를 참조하십시오.

설명서 서버 시작 및 중지

사용자가 설명서 서버가 실행하는 시스템을 시동하면, 서버는 (/etc/init.d/ab2mgr 스크립트를 사용해서) 자동으로 시작됩니다. 또한, 사용자가 필요에 따라 수동으로 설명서 서버를 시작하고, 중지하고, 재시작할 수 있습니다. 예를 들면, 새 문서 모음을 설치한 후에는 설명서 서버를 재시작해야 합니다.

이러한 기능을 수행하려면, 설명서 서버 시스템에 루트로 로그인하고 ab2admin 명령어 줄 인터페이스를 사용하십시오.

• 설명서 서버를 시작하려면, 다음 명령어를 사용하십시오:

  # /usr/lib/ab2/bin/ab2admin-o start

• 설명서 서버를 중지하려면, 다음 명령어를 사용하십시오:

  # /usr/lib/ab2/bin/ab2admin-o stop

• 설명서 서버를 재시작하려면, 다음 명령어를 사용하십시오:

  # /usr/lib/ab2/bin/ab2admin-o restart

  서버를 재시작해도 원하는 작업이 실행되지 않으면, 서버를 중지한 다음 시작하십시오.

• 디버깅 기능이 사용 가능한 상태로 설명서 서버를 시작하려면, 다음 형식의 시작 명령어를 사용하십시오:

  # /usr/lib/ab2/bin/ab2admin-o start -D

• 시스템이 재시동할 때 서버가 자동으로 시작하지 않도록 하려면, 이 명령어를 사용하십시오:

  # /usr/lib/ab2/bin/ab2admin-o autostart_no

문서 소스 디버깅 작동 또는 해제

AnswerBook2 서버는 디버깅 옵션을 가지고 있는데, 이것을 작동시키면, 책 소스에서 인식할 수 없는 태그를 "BUG"라는 단어와 함께 빨간색으로 뷰어에 표시합니다. 이 기능은 책이 원하는 대로 표시되지 않는 경우에 문제점을 찾는데 도움이 됩니다.

디버깅 기능을 작동시키려면, 설명서 서버 시스템에 루트로 로그인하고 환경 변수 AB2_DEBUG를 1로 설정하십시오. 예를 들면:

% su -
# setenv AB2_DEBUG 1

디버깅 기능을 해제하려면, 설명서 서버 시스템에 루트로 로그인하고 환경 변수 AB2_DEBUG를 0으로 설정하십시오. 예를 들면:

% su -
# setenv AB2_DEBUG 0

디버깅 매개변수를 변경한 후, 사용자는 설명서 서버를 반드시 재시작해야 합니다. 설명서 서버를 재시작하려면, 다음과 같이 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o restart

서버를 시작할 때 디버깅을 제어하려면, 다음 형식의 시작 명령어를 사용하십시오:

# /usr/lib/ab2/bin/ab2admin -o start -D

관리 액세스 제어

관리자자는 문서 관리 기능의 수행을 수행하도록 개별적으로 정의된 사용자입니다. AnswerBook2 제품은 암호를 사용해서 현재 관리자가 서버에서 관리 기능을 수행하도록 허가되었는지 여부를 확인합니다.

초기 관리 액세스 설정

AnswerBook2 소프트웨어는 관리 기능을 수행할 수 있도록 액세스 제어 기능이 작동하는 상태로 출하되지만, 기본적인 관리자가 정의되지 않은 상태입니다. 사용자가 AnswerBook2 관리 기능을 최초로 액세스하면, 소프트웨어는 액세스 제어 기능이 작동 중이지만 정의된 사용자가 없다는 것을 알려줍니다. 이 때, 사용자는 다음 두 가지 중 하나를 실행할 수 있습니다:

• 액세스 제어 기능을 해제합니다.

  액세스 제어 기능을 해제하고, 설명서 서버 시스템에 루트로 로그인한 다음 다음과 같이 입력합니다:

  # /usr/lib/ab2/bin/ab2admin -o auth_off

  ---

  주의 -

  사용자가 액세스 관리 기능을 해제한 경우, 문서 시스템에 액세스할 수 있는 사용자는 설명서 서버를 수정할 수 있습니다.

  ---

• 관리자 및 암호 정의

  관리자를 정의하려면, 설명서 서버 시스템에 루트로 로그인하고 다음과 같이 입력하십시오:

  # /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id

  여기서 admin-id는 이 설명서 서버를 관리하기 위한 로그인 ID입니다. admin-id는 사용자의 시스템 로그인 ID와 일치할 필요는 없습니다. 이것은 특정 서버에서 문서에 연관된 관리 기능을 수행하기 위한 개별적인 ID입니다.

  소프트웨어는 이 사용자의 암호를 입력한 다음, 확인을 위해 다시 입력하라고 요구합니다.

AnswerBook2 관리자용 액세스 추가

관리자를 추가하려면, AnswerBook2 관리 페이지에서 관리자 추가를 선택하십시오. 관리자를 추가하려면:

1. 관리자 ID 필드에 관리자의 로그인 ID를 입력합니다.

   admin-id는 사용자의 시스템 로그인 ID와 일치할 필요는 없습니다. 이것은 특정 서버에서 문서에 연관된 관리 기능을 수행하기 위한 개별적인 ID입니다.

2. 관리자용 암호를 입력합니다.

   이 암호는 AnswerBook2 암호 데이터베이스에 저장됩니다. 이것은 사용자의 시스템 암호와 일치할 필요는 없습니다.

확인할 수 있도록 암호를 두 번 입력해야 합니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id [-m server_name] [-p server_port]

관리자 암호 변경

관리자의 암호를 변경하려면, AnswerBook2 관리 페이지에서 암호 변경을 선택하십시오. 암호를 수정하려면:

1. 관리자 ID 팝업 목록에서 관리자를 선택합니다.

2. 이전 암호 필드에 관리자의 기존 암호를 입력합니다.

3. 새 암호 필드에 관리자의 새 암호를 입력합니다.

4. 새 암호 재입력 필드에 관리자의 새 암호를 다시 입력합니다.

5. 암호 변경을 클릭해서 이 변경사항을 적용합니다.

사용자가 암호 변경을 클릭하면, AnswerBook2 소프트웨어는 새 암호 필드와 새 암호 재입력 필드에 입력한 데이터가 서로 동일한지 확인합니다. 서로 동일하면 새 암호가 데이터베이스에 저장됩니다. 서로 동일하지 않으면, 소프트웨어는 오류 메시지를 표시합니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o change_password -u admin-id [-m server_name] [-p server_port]

관리자의 액세스 권한 제거

이 서버에 대한 관리자의 목록에서 사용자를 제거하려면, AnswerBook2 관리 페이지에서 관리자 삭제를 선택하십시오. 관리자를 제거하려면:

1. 사용자가 관리자 목록에서 제거하려는 관리자의 로그인 ID 옆에 있는 확인란을 클릭하십시오.

   이것은 관리자의 ID이며, 사용자의 시스템 ID 또는 사용자 ID일 필요는 없습니다.

2. 관리자 삭제를 클릭하십시오.

   ---

   주 -

   이것은 사용자로서 AnswerBook2 문서에 액세스할 수 있는 권한에 영향을 미치지 않습니다. 이것은 사용자가 관리 기능을 수행할 수 있는 권한만 제거합니다.

   ---

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o del_admin -u admin-id [-m server_name] [-p server_port]

문서 모음 작업

AnswerBook2 모음이란 책의 논리적 그룹을 말합니다. 예를 들면, 사용자는 모든 Solaris^TM 개발자용 책이 있는 모음을 가질 수 있습니다. 이 모음은 AnswerBook2 (SGML) 모음 또는 AnswerBook1 (Display PostScript^TM) 모음일 수 있습니다.

모음 목록

서버에 설치된 모든 모음의 목록을 보려면, AnswerBook2 관리 페이지에서 사용 가능한 모음 목록 보기를 선택하십시오. 이 목록에는 AnswerBook1 모음과 AnswerBook2 모음이 포함됩니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o list [-m server_name] [-p server_port]

새 모음 추가

모음을 서버의 데이터베이스에 추가하려면, AnswerBook2 관리 페이지에서 목록에 모음 추가를 선택하십시오. 이 기능은 서버의 시스템 또는 서버가 액세스할 수 있는 다른 시스템에 이미 모음이 존재한다고 가정합니다. 아직 모음이 설치되지 않은 경우라면, pkgadd를 사용해서 모음을 먼저 추가한 다음, 이 기능을 사용하십시오. 새로운 모음(예를 들어, Solaris 2.6 Documentation CD에 있는 모음)의 경우, 사용자가 서버에서 pkgadd 명령어를 실행하면, 서버의 목록에 모음을 자동으로 추가합니다.

모음을 설치하려면 다음 단계를 수행하십시오:

1. 모음 경로 필드에 모음 파일의 유효한 경로를 입력하십시오.

   예를 들면, /opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo 처럼 입력합니다. 경로는 AnswerBook2 모음의 collinfo 파일 또는 AnswerBook1 모음의 ab_cardcatalog 파일이 있는 디렉토리를 지시해야 합니다.

2. 모음 추가를 클릭하십시오.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o add_coll -d path_to_collection

모음을 설치한 후에, 반드시 설명서 서버를 재시작해야 합니다. 설명서 서버를 재시작하려면, 관리 페이지의 상태 페이지에서 재시작을 클릭하거나 명령어 줄에서 다음과 같이 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o restart

기존 모음 추가

AnswerBook2 서버는 현재 시스템을 검색해서 시스템에 설치된 AnswerBook1 및 AnswerBook2 모음을 찾아서 이것을 서버의 데이터베이스에 추가할 수 있습니다. 이 기능을 수행하려면, AnswerBook2 관리 페이지에서 지역 시스템에 설치된 모음 검색을 선택하십시오. 이 기능은 지역 시스템에서 찾아낸 모든 유효한 문서 모음의 목록을 만들어서 표시합니다.

서버의 데이터베이스에 모음을 추가하려면:

1. 추가하려는 모음 옆에 있는 확인란을 클릭하십시오.

   옆에 확인란이 없는 모음은 이미 데이터베이스에 존재하는 모음입니다.

2. 원하는 모든 모음을 선택했으면, 선택한 모음 추가를 클릭하십시오.

목록에 지역 시스템에 설치된 문서 모음이 포함되지 않았다면, 모음이 설치된 디렉토리가 다른 사람이 읽을 수 있도록 읽기 액세스 권한이 설정되어 있는지 확인하십시오.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o scan

명령어 줄 검색 기능은 찾아낸 모든 모음을 추가합니다. 사용자가 추가할 모음을 선택할 수는 없습니다.

모음을 설치한 후에, 반드시 설명서 서버를 재시작해야 합니다. 설명서 서버를 재시작하려면, AnswerBook2 관리 상태 페이지에서 재시작을 클릭하거나 명령어 줄에서 다음과 같이 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o restart

AnswerBook2 모음 제거

서버의 데이터베이스에서 AnswerBook2 모음 또는 AnswerBook1 모음을 제거하려면, AnswerBook2 관리 페이지의 목록에서 모음 삭제를 선택하십시오. 모음을 제거하려면:

1. 모음 목록에서 제거하려는 모음 제목 옆에 있는 확인란을 클릭하십시오. (선택한 항목을 선택 해제하려면, 확인란을 다시 클릭하면 됩니다.)

2. 제거할 모든 모음을 선택한 후에, 모음 삭제를 클릭하십시오.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o del_coll -t collection_title

이 기능을 사용해도 시스템에서 모음 패키지가 제거되지 않습니다. 이것은 서버의 데이터베이스에서 모음의 항목만 제거합니다. 시스템에서 패키지를 제거하려면, pkgrm 유틸리티를 사용하십시오.

모음을 설치한 후에, 반드시 설명서 서버를 재시작해야 합니다. 설명서 서버를 재시작하려면, AnswerBook2 관리 상태 페이지에서 재시작을 클릭하거나 명령어 줄에서 다음과 같이 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o restart

설명서 서버 설정

현재 서버 설정을 보려면, AnswerBook2 관리 페이지에서 현재 설정 보기를 선택하십시오. 이 설정을 변경하려면, AnswerBook2 관리 페이지에서 서버 설정 수정을 선택하십시오.

설명서 서버 설정 보기

현재 설정 보기 페이지는 표 3-1와 표 3-2에 표시된 설정을 나열합니다. 이 설정은 server_config_path/dwhttpd.cfg 파일에 저장됩니다 (기본값은 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg입니다).

만약 기본적인 NSAPI 기반 서버가 아닌 CGI 기반 서버를 사용하는 경우, 관리 페이지의 인터페이스에 일부 서버 설정 옵션만 표시됩니다. 자세한 정보는, "서버를 CGI 프로세스로 실행할 때의 설정 문제점"를(을) 참조하십시오.

문서 관리자는 표 3-2에 표시된 설정을 직접 변경해서는 안됩니다. 사용자가 서버 소프트웨어를 설치할 때 시스템이 이 설정을 변경합니다.

다음 명령어를 사용해도 현재 서버 환경설정을 볼 수 있습니다:

% /usr/lib/ab2/bin/ab2admin -o view_config [-m server_name] [-p server_port]

설명서 서버 환경설정 변경

AnswerBook2 서버 소프트웨어를 설치하면, 특정 변수는 기본값으로 설정됩니다. 서버 환경설정 수정에 있는 필드를 사용해서 이 값을 변경하십시오. 다음 표에 있는 서버 설정을 변경할 수 있습니다.

이 기능은 관리 명령어 줄 인터페이스를 통해서도 사용 가능합니다 (ab2admin). 명령어 줄 인터페이스에 대한 자세한 정보는, 부록 A를 참조하십시오. 또한, 사용자는 server_config_path/dwhttpd.cfg 파일(기본적으로 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg에 있습니다)을 편집해서 이 값을 변경할 수 있습니다.

이 값을 변경하면, 설명서 서버를 중지한 다음 시작해야 합니다. 서버 시스템에 루트로 로그인하고 다음 명령어를 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

1024 미만의 포트 번호 사용

1024 미만의 포트 번호는 시스템 사용을 위해 남겨둔 것입니다. 이 번호 중 하나(예를 들어, 포트번호 80)를 AnswerBook2 서버에 사용하려면:

1. AnswerBook2 관리 페이지에서 환경설정 수정을 사용하거나 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg 파일을 편집해서 서버의 포트 번호를 80으로 변경하십시오.

2. /usr/lib/ab2/dweb/data/config/nsapi.cfg 파일을 편집해서 서버의 포트 번호를 80으로 변경하십시오.

   다음과 같은 행이 입력되어 있어야 합니다:

   set ServerPort 80

3. /etc/init.d/ab2mgr 파일을 편집해서 다음 행을 daemon에서 root로 변경하십시오:

   su daemon -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

   을 다음과 같이 변경하십시오:

   su root -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

   이것은 상위 dwhttpd 프로세스가 root로 실행하도록 하는데, 이렇게 해서 포트 80을 사용합니다. 하위 dwhttpd 프로세스는 여전히 daemon으로 실행함을 주지하십시오.

서버를 CGI 프로세스로 실행할 때의 설정 문제점

AnswerBook2 서버가 표준 웹 프로토콜을 따르기 때문에, 사용자는 AnswerBook2를 기본 NSAPI 서버보다는, 기존 서버 상의 CGI 프로세스로 실행할 수 있습니다. 이렇게 서버를 구성하는 방법에 대한 내용은, "AnswerBook2 서버를 CGI 프로세스로 실행"를 참조하십시오.

설명서 서버를 CGI 프로세스로 실행하면, AnswerBook2 관리 페이지의 환경설정 보기 페이지에 다음의 환경설정이 표시되지 않습니다:

• 최대 쓰레드

• 최대 서버 요청

• 서버 환경설정 경로

• 서버 사용자

• 플러그 인 파일

• Mime 파일

• Doc 루트

• 로그 디렉토리

서버 환경설정 수정 페이지에서 사용할 수 있는 유일한 옵션은 액세스 제어를 작동시키거나 해제하는 것입니다. 기타 다른 기능은 모두 표시되지 않습니다.

ab2admin 명령어의 다음 옵션이 작동하지 않습니다:

• -o access_on

• -o access_off

• -o error_off

• -o error_on

• -o modify_server_name

• -o modify_server_port

기타 설명서 서버와 작업하기

사용자가 책에서 링크를 클릭하면, AnswerBook2 서버가 이 링크를 다른 AnswerBook2 서버로 연결할 수 있습니다. 현재 설명서 서버에 책이 있으면, 링크는 여기에 연결됩니다. 그러나, 연결하려는 책이 현재 서버에 없으면, AnswerBook2 서버는 액세스하도록 정의된 대체 설명서 서버로 "연결"됩니다. 사용자는 이 기능을 사용해서 다양한 서버를 통해 문서를 배포하거나 문서의 백업본을 만들 수 있습니다.

대체 설명서 서버 구별하기

정의된 대체 서버를 확인하려면, AnswerBook2 관리 페이지에서 대체 서버 목록 보기를 선택합니다. 이렇게 하면, 현재 "연결" 서버로 지정된 서버의 목록이 표시됩니다. 사용자가 책에 있는 링크를 클릭했는데 이 책이 현재 서버에 없는 경우, AnswerBook2 제품은 이 목록에 있는 서버를 확인해서 링크에 맞는 대상을 찾습니다. AnswerBook2 서버에는 미리 정의된 대체 서버인 http://docs.sun.com/이 딸려 있는데, 이것은 Sun 마스터 설명서 서버이며 릴리즈된 Sun 문서를 가지고 있습니다.

현재 서버에 정의된 각 대체 서버에 대해, 이 페이지에서는 서버의 이름, 포트 번호, 그리고 이 서버에 설치된 모음 목록에 대한 링크 등을 보여줍니다. 사용자가 모음의 쇼 목록을 클릭하면, 대체 서버에 대한 ID와 암호를 물어옵니다 (대체 서버에 대해 관리 액세스 제어가 정의된 경우). 달리 말하면, 사용자는 대체 서버에 대한 관리 액세스 권한이 없어 대체 서버를 추가할 수 있지만, 대체 서버에 대한 관리 액세스 권한을 가진 경우에는 이 서버에 있는 모음의 목록만 볼 수 있습니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o list_server  
[-m server_name] [-p server_port]

대체 설명서 서버 추가

현재 사용하는 서버가 다른 서버에 있는 책을 액세스할 수 있도록 하려면 (책 사이의 링크를 연결할 목적으로), AnswerBook2 관리 페이지에서 대체 서버 추가를 선택하십시오.

1. AnswerBook2 서버 이름 필드에 대체 서버의 이름을 입력하십시오.

2. 서버 포트 번호 필드에 대체 서버의 AnswerBook2 포트 번호를 입력하십시오. 포트 번호를 정확히 알 수 없다면, 8888을 사용해보십시오 (AnswerBook2 기본 포트 번호입니다).

3. 서버 추가를 클릭하십시오.

   ---

   주 -

   추가하려는 대체 서버가 회사 네트워크 밖에 있다면, 이것을 추가하지 못할 것입니다. 이것은 보통 "방화벽" 문제입니다.

   ---

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o add_server -M add_server_name -P add_server_port  
[-m server_name] [-p server_port]

추가 설명서 서버 제거

대체 서버의 서버 목록에서 서버를 제거하려면, AnswerBook2 관리 페이지에서 대체 서버 삭제를 선택하십시오.

1. 서버 목록에서 서버를 선택하십시오.

2. 서버 삭제를 클릭하십시오.

이렇게 하면 지역 설명서 서버에 대한 대체 서버 목록에서 서버가 제거됩니다. 이것은 설명서 서버와 마찬가지로 제거된 서버의 기능을 중지시키지는 않습니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o del_server -M del_server_name -P del_server_port  
[-m server_name] [-p server_port]

대체 서버 순서 수정

사용자의 서버가 사용할 수 있는 서버 목록에 대체 서버를 추가할 때, 대체 서버는 서버 순서의 맨 아래에 추가됩니다. 이 순서는 사용자의 서버가 문서 링크를 연결시킬 때 대체 서버를 액세스하는 순서를 결정합니다. 사용자가 라이브러리에서 특정 문서를 요구했는데 이 문서를 기본 서버에서 사용할 수 없는 경우, 서버는 정의된 순서로 대체 서버에 연결해서 문서를 찾습니다.

시스템에서 사용할 수 있는 서버의 순서를 변경하려면, AnswerBook2 관리 페이지에서 서버 순서 수정을 선택하십시오.

1. 서버 목록에서 서버를 선택하십시오.

2. 목록에서 위로 이동을 클릭하거나 목록에서 아래로 이동을 클릭하십시오.

3. 이동을 클릭하십시오.

이 기능에는 수행할 수 있는 명령어 줄 옵션이 없습니다.

서버 리포트 작업

AnswerBook2 서버 소프트웨어는 서버 오류와 서버 액세스를 보여주는 기록을 유지관리합니다. 또한, 문서 모음이 액세스된 빈도와 오류가 발생한 회수를 기록한 요약 리포트를 제공합니다.

책 액세스 요약 리포트

서버에 있는 책에 대한 액세스 요약을 보려면, AnswerBook2 관리 페이지에서 책 액세스 요약 보기를 선택하십시오. 책 액세스 리포트는 서버에 있는 각 책이 액세스된 빈도를 요약합니다. 서버에 있는 각 책에 대해, 다음과 같이 표시됩니다:

• 책 제목 - 라이브러리 페이지에서 표시되는 책 제목

• 책의 짧은 이름 - 책의 환경설정 파일에 지정된 책의 짧은 제목

• 모음 이름 - 책이 속한 모음의 짧은 이름이며, collinfo 파일에서 지정됩니다.

• 정보 - 책을 액세스한 횟수

• 오류 - 책에 관련된 오류 횟수

액세스 로그 파일

액세스 기록을 작동시키거나 해제하려면, AnswerBook2 관리 페이지에서 서버 환경설정 수정을 선택하십시오.

• 액세스 로그 파일에 기록된, 설명서 서버에 있는 정보를 액세스하는 사람에 대한 내용을 얻으려면, 켜짐 옆에 있는 단추를 클릭한 다음, 적용을 클릭하십시오. 이 파일의 기본 위치는 /var/log/ab2/logs/access-8888.log입니다.

• 액세스 로그 파일에 기록된 정보를 그만 보려면, 꺼짐 옆에 있는 단추를 클릭한 다음, 적용을 클릭하십시오.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o access_on [-m server_name] [-p server_port]
 

% /usr/lib/ab2/bin/ab2admin -o access_off [-m server_name] [-p server_port]
  

로그 기능을 변경한 후에, 반드시 설명서 서버를 재시작해야 합니다. 서버 시스템에 루트로 로그인하고 다음 명령어를 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

액세스 로그 보기

액세스 로그 파일을 보려면, AnswerBook2 관리 페이지에서 로그 파일 보기를 선택한 다음, 액세스 로그 파일 보기를 클릭하십시오. 액세스 로그 파일은 설명서 서버에 대한 모든 액세스를 기록한 텍스트 파일입니다. 액세스 로그에 있는 각 행은 다음과 유사합니다:

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800] "GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

여기서:

• 첫 번째 숫자 세트는 클라이언트의 IP (Internet Protocol) 주소입니다. 예를 들면, 129.146.83.55입니다.

• 꺽쇠괄호 사이의 정보는 액세스 날짜와 시간입니다. 예를 들면, [04/Nov/1996:15:07:05 -0800] 입니다.

• 인용 부호 사이의 정보는 발생한 액세스의 내용을 알려 줍니다. 이것은 일반적으로 URL이나 파일 이름뿐만 아니라 액세스 요청에 대한 응답에 사용한 프로토콜도 나타냅니다. 예를 들면, "GET /icons/ab2_curr_home.gif HTTP/1.0"는 HTTP 1.0 프로토콜을 사용해서 /icons/ab2_curr_home.gif 파일을 가져가기 위해 액세스한 것을 의미합니다.

• 끝에서 두 번째 숫자는 액세스가 성공했는지(200) 실패했는지(기타 이외의 것)를 나타냅니다.

• 마지막 숫자는 요청한 사람에게 돌아간 정보의 크기를 나타냅니다 (킬로바이트 단위). 예를 들면, 1938은 가져온 .gif 파일의 크기를 나타냅니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o view_access [-m server_name] [-p server_port]

오류 로그 파일

오류 기록을 작동시키거나 해제하려면, AnswerBook2 관리 페이지에서 서버 환경설정 수정을 선택하십시오.

• 오류 로그 파일에 기록된, 설명서 서버에서 발생한 오류에 대한 내용을 보려면, 켜기 옆에 있는 단추를 클릭한 다음, 적용을 클릭하십시오. 이 파일의 기본 위치는 /var/log/ab2/logs/errors-8888.log입니다.

• 오류 로그 파일에 기록된 정보를 그만 보려면, 끄기 옆의 단추를 클릭한 다음, 적용을 클릭하십시오.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o error_on [-m server_name] [-p server_port]
  

% /usr/lib/ab2/bin/ab2admin -o error_off [-m server_name] [-p server_port]

로그 기능을 변경한 후에, 반드시 설명서 서버를 재시작해야 합니다. 서버 시스템에 루트로 로그인하고 다음 명령어를 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

오류 로그 보기

오류 로그 파일을 보려면, AnswerBook2 관리 페이지에서 로그 파일 보기를 선택한 다음, 오류 로그 파일 보기를 클릭하십시오. 오류 로그 파일은 이 설명서 서버에서 발생한 모든 오류를 보여줍니다. 사용자는 이 정보를 사용해서 서버 문제점이나 비정상적인 작동의 원인을 알아낼 수 있습니다. 이 오류 로그는 오류에 관련된 서버와 포트를 지정할 뿐만 아니라, 오류를 설명하는 약간이 텍스트도 가지고 있습니다.

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o view_error [-m server_name] [-p server_port]

로그 파일 교체

사용자는 현재 액세스 또는 오류 로그를 파일로 저장하고 정보를 빈 파일에 기록할 수 있습니다.

• 오류 로그를 교체하려면, AnswerBook2 관리 페이지에서 오류 로그 파일 교체를 선택하십시오.

• 액세스 로그를 교체하려면, AnswerBook2 관리 페이지에서 액세스 로그 파일 교체를 선택하십시오.

액세스 (오류) 로그 파일 교체 페이지가 나타나면:

1. 로그 파일 저장 필드에 저장할 파일 이름을 입력하십시오.

   기본값은 current_date.current_log_file_name.log인데, 여기서 current_date는 YearYearYearYear_MonthMonth_DayDay_HourHour 형식이며 current_log_file_name은 기본적으로 access-8888.log 또는 error-8888.log입니다. (예를 들면, 1997_02_26_14.access-8888.log입니다).

   로그 파일 위치 필드는 파일이 저장된 위치를 보여줍니다. 사용자는 현재 페이지에서 이 정보를 변경할 수 없습니다.

2. 적용을 클릭하십시오.

로그 기능을 변경한 후에, 반드시 설명서 서버를 재시작해야 합니다. 서버 시스템에 루트로 로그인하고 다음 명령어를 입력하십시오:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start

다음 명령어를 사용해서 이 기능을 수행해도 됩니다:

% /usr/lib/ab2/bin/ab2admin -o rotate_error [-m server_name] [-p server_port]
 

% /usr/lib/ab2/bin/ab2admin -o rotate_access [-m server_name] [-p server_port]

일반적인 관리 페이지 이동 기능

AnswerBook2 제품에 있는 모든 페이지의 상단에는, 일반적인 이동 기능 세트가 있습니다. 다음 표는 사용자가 관리 페이지에서 이 기능을 선택했을 때 어떻게 되는지 설명합니다.

다양한 관리 페이지에서, 아이콘을 클릭하면 주 AnswerBook2 관리 페이지로 이동합니다.